@combeenation/3d-viewer 7.0.0 → 7.1.0

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

@@ -1,420 +1,420 @@
-"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.TagManager = void 0;
-const event_1 = require("../classes/event");
-const fuzzyMap_1 = require("../classes/fuzzyMap");
-const parameter_1 = require("../classes/parameter");
-const babylonHelper_1 = require("../util/babylonHelper");
-const tags_1 = require("@babylonjs/core/Misc/tags");
-const lodash_es_1 = require("lodash-es");
-class TagManager {
-    /**
-     * Constructor.
-     */
-    constructor(viewer) {
-        this.viewer = viewer;
-        this.parameters = new fuzzyMap_1.FuzzyMap();
-        this.parameterObservers = new Map();
-        this.addParameterObservers();
-    }
-    /**
-     * Calls the {@link ParameterObserver} for given {@link Parameter} and applies the {@link ParameterValue} on all
-     * nodes with given tagName.
-     */
-    setTagParameterValue(tagName, parameterName, value) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleParameter({ tagName: tagName }, parameterName, value);
-        });
-    }
-    /**
-     * Calls the {@link ParameterObserver} for given {@link Parameter} and applies the {@link ParameterValue} on all
-     * nodes with given nodeName.
-     */
-    setNodeParameterValue(nodeName, parameterName, value) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.handleParameter({ nodeName: nodeName }, parameterName, value);
-        });
-    }
-    /**
-     * Splits the passed {@link TagManagerParameterValue}s into individual values and calls all {@link ParameterObserver}s
-     * of all {@link Parameter}s with the respective {@link TagManagerSubject} and {@link ParameterValue}. The result is a
-     * map of passed {@link TagManagerParameterValue}s and the associated {@link ParameterObserverResult} of the
-     * {@link ParameterObserver}.
-     */
-    setParameterValues(values) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const observerResultMap = new Map();
-            const tagPromises = [];
-            const nodePromises = [];
-            for (const value of values) {
-                const subject = {};
-                if (value.tagName) {
-                    subject.tagName = value.tagName;
-                }
-                if (value.nodeName) {
-                    subject.nodeName = value.nodeName;
-                }
-                const promise = this.handleParameter(subject, value.parameterName, value.value);
-                promise.then(result => observerResultMap.set(value, result));
-                if (value.tagName) {
-                    tagPromises.push(promise);
-                }
-                if (value.nodeName) {
-                    nodePromises.push(promise);
-                }
-            }
-            yield Promise.all(tagPromises);
-            yield Promise.all(nodePromises);
-            return observerResultMap;
-        });
-    }
-    /**
-     * Gets a list of {@link TagManagerSubject}s that are present in both the state of the {@link TagManager}'s
-     * {@link parameters} and the given node.
-     */
-    getSubjectsFor(node) {
-        return [...this.parameters.keys()].filter(subject => (subject.tagName && tags_1.Tags.MatchesQuery(node, subject.tagName)) ||
-            (subject.nodeName && node.name === subject.nodeName));
-    }
-    /**
-     * Gets a list of {@link TagManagerSubject}s that are present in both the state of the {@link TagManager}'s
-     * {@link parameters} and the given nodes.
-     */
-    getApplicableSubjectsFor(nodes) {
-        let applicableSubjects = [];
-        for (const node of nodes) {
-            const subjects = this.getSubjectsFor(node);
-            applicableSubjects = [...applicableSubjects, ...subjects];
-        }
-        return (0, lodash_es_1.uniq)(applicableSubjects);
-    }
-    /**
-     * Applies all existing states of the {@link TagManager}'s {@link parameters} for given {@link TagManagerSubject}s.
-     */
-    applyExistingParameterValuesFor(subjects) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const observerResultMap = new Map();
-            let tagPromises = [];
-            let nodePromises = [];
-            for (const subject of subjects) {
-                this.clearAppliedNodeMetadataParameters(this.getNodesBySubject(subject));
-                const promises = this.handleParameterBag(subject, this.parameters.get(subject));
-                for (const promise of promises) {
-                    promise.then(result => observerResultMap.set(subject, result));
-                }
-                if (subject.tagName) {
-                    tagPromises = [...tagPromises, ...promises];
-                }
-                if (subject.nodeName) {
-                    nodePromises = [...nodePromises, ...promises];
-                }
-            }
-            yield Promise.all(tagPromises);
-            yield Promise.all(nodePromises);
-            return observerResultMap;
-        });
-    }
-    /**
-     * Does the same as {@link setParameterValues} with the difference that all existing states of the
-     * {@link TagManager}'s {@link parameters} are applied to all given nodes.
-     */
-    applyExistingParameterValuesTo(nodes) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.applyExistingParameterValuesFor(this.getApplicableSubjectsFor(nodes));
-        });
-    }
-    /**
-     * Applies all existing states of the {@link TagManager}'s {@link parameters} for all {@link TagManagerSubject}s.
-     */
-    applyExistingParameterValues() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.applyExistingParameterValuesFor([...this.parameters.keys()]);
-        });
-    }
-    /**
-     * Maps all tags on given nodes with the {@link TagMapping} and updates the state of the {@link TagManager}'s
-     * {@link parameters} for all new tags.
-     * Also updates the state of all nodes in the tag managers parameter state.
-     */
-    mapNodesAndTags(nodes, tagMapping) {
-        this.updateParametersWithNodeAndTagMapping(nodes, tagMapping);
-        (0, babylonHelper_1.mapTags)(nodes, tagMapping);
-        return this;
-    }
-    /**
-     * Prints the state of the {@link TagManager}'s {@link parameters} to the console.
-     */
-    printAllTags() {
-        const printable = [];
-        for (const subject of this.parameters.keys()) {
-            const parameterBag = this.parameters.get(subject);
-            for (const parameter in parameterBag) {
-                printable.push({
-                    subject: JSON.stringify(subject),
-                    parameter: parameter,
-                    value: parameterBag[parameter],
-                    nodes: this.getNodesBySubject(subject),
-                });
-            }
-        }
-        console.table(printable);
-    }
-    /**
-     * Prints the state of the {@link TagManager}'s {@link parameters} for one tagName to the console.
-     */
-    printTagInfo(tagName) {
-        const parameterBag = this.parameters.get({ tagName: tagName });
-        const printable = [];
-        for (const parameter in parameterBag) {
-            printable.push({
-                parameter: parameter,
-                value: parameterBag[parameter],
-                nodes: this.getNodesBySubject({ tagName: tagName }),
-            });
-        }
-        console.table(printable);
-    }
-    /**
-     * Sets a {@link ParameterObserver} for the given {@link Parameter}.
-     */
-    setParameterObserver(parameter, observer) {
-        this.parameterObservers.set(parameter, observer);
-        return this;
-    }
-    /**
-     * Gets all nodes for given {@link TagManagerSubject} on the Babylon.js scene.
-     */
-    getNodesBySubject(subject, predicate) {
-        let nodes = [];
-        if (subject.tagName) {
-            nodes = [
-                ...nodes,
-                ...this.viewer.scene.getTransformNodesByTags(subject.tagName, predicate),
-                ...this.viewer.scene.getMeshesByTags(subject.tagName, predicate),
-            ];
-        }
-        if (subject.nodeName) {
-            nodes = [
-                ...nodes,
-                this.viewer.scene.getTransformNodeByName(subject.nodeName),
-                this.viewer.scene.getMeshByName(subject.nodeName),
-            ].filter(t => !!t && (!predicate || predicate(t)));
-        }
-        return nodes;
-    }
-    /**
-     * Registers observers that are called on every new node added to the Babylon.js scene. The observers ensure that each
-     * new node gets the state of the {@link TagManager}'s {@link parameters} applied.
-     */
-    registerNewTransformNodeObservers(scene) {
-        const onNewTransformNodeAdded = (node) => __awaiter(this, void 0, void 0, function* () {
-            yield this.viewer.scene.whenReadyAsync();
-            yield this.applyExistingParameterValuesTo([node]);
-        });
-        scene.onNewTransformNodeAddedObservable.makeObserverBottomPriority(scene.onNewTransformNodeAddedObservable.add(onNewTransformNodeAdded));
-        scene.onNewMeshAddedObservable.makeObserverBottomPriority(scene.onNewMeshAddedObservable.add(onNewTransformNodeAdded));
-    }
-    /**
-     * Adds the default {@link ParameterObserver}s.
-     * @protected
-     */
-    addParameterObservers() {
-        this.parameterObservers.set(parameter_1.Parameter.VISIBLE, (payload) => __awaiter(this, void 0, void 0, function* () {
-            let visible;
-            try {
-                visible = parameter_1.Parameter.parseBoolean(payload.newValue);
-            }
-            catch (e) {
-                return;
-            }
-            if (visible === true) {
-                for (const node of payload.nodes) {
-                    node.setEnabled(true);
-                }
-            }
-            else if (visible === false) {
-                for (const node of payload.nodes) {
-                    node.setEnabled(false);
-                }
-            }
-            return payload;
-        }));
-        this.parameterObservers.set(parameter_1.Parameter.SCALING, (payload) => __awaiter(this, void 0, void 0, function* () {
-            for (const node of payload.nodes) {
-                node.scaling = parameter_1.Parameter.parseVector(payload.newValue);
-            }
-            return payload;
-        }));
-        this.parameterObservers.set(parameter_1.Parameter.POSITION, (payload) => __awaiter(this, void 0, void 0, function* () {
-            for (const node of payload.nodes) {
-                node.position = parameter_1.Parameter.parseVector(payload.newValue);
-            }
-            return payload;
-        }));
-        this.parameterObservers.set(parameter_1.Parameter.ROTATION, (payload) => __awaiter(this, void 0, void 0, function* () {
-            for (const node of payload.nodes) {
-                node.rotation = parameter_1.Parameter.parseRotation(payload.newValue);
-            }
-            return payload;
-        }));
-        this.parameterObservers.set(parameter_1.Parameter.MATERIAL, (payload) => __awaiter(this, void 0, void 0, function* () {
-            for (const node of payload.nodes) {
-                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL);
-                (0, babylonHelper_1.setMaterial)(node, payload.newValue.toString(), false);
-            }
-            return payload;
-        }));
-        this.parameterObservers.set(parameter_1.Parameter.MATERIAL_COLOR, (payload) => __awaiter(this, void 0, void 0, function* () {
-            const parsedValue = parameter_1.Parameter.parseColor(payload.newValue);
-            for (const node of payload.nodes) {
-                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL_COLOR);
-                if (this.viewer.cloneMaterialsOnMutation) {
-                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material')) {
-                        (0, babylonHelper_1.cloneTransformNodeMaterial)(node);
-                    }
-                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material.color')) {
-                        // inject initial value and mark as dirty
-                        (0, babylonHelper_1.injectNodeMetadata)(node, { dirty: { material: { color: payload.oldValue } } }, false);
-                    }
-                }
-                (0, babylonHelper_1.setMaterialColor)(node, parsedValue, false);
-            }
-            return payload;
-        }));
-        this.parameterObservers.set(parameter_1.Parameter.MATERIAL_ROUGHNESS, (payload) => __awaiter(this, void 0, void 0, function* () {
-            const parsedValue = parameter_1.Parameter.parseNumber(payload.newValue);
-            for (const node of payload.nodes) {
-                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL_ROUGHNESS);
-                if (this.viewer.cloneMaterialsOnMutation) {
-                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material')) {
-                        (0, babylonHelper_1.cloneTransformNodeMaterial)(node);
-                    }
-                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material.roughness')) {
-                        // inject initial value and mark as dirty
-                        (0, babylonHelper_1.injectNodeMetadata)(node, { dirty: { material: { color: payload.oldValue } } }, false);
-                    }
-                }
-                (0, babylonHelper_1.setMaterialRoughness)(node, parsedValue, false);
-            }
-            return payload;
-        }));
-        this.parameterObservers.set(parameter_1.Parameter.MATERIAL_METALLNESS, (payload) => __awaiter(this, void 0, void 0, function* () {
-            const parsedValue = parameter_1.Parameter.parseNumber(payload.newValue);
-            for (const node of payload.nodes) {
-                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL_METALLNESS);
-                if (this.viewer.cloneMaterialsOnMutation) {
-                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material')) {
-                        (0, babylonHelper_1.cloneTransformNodeMaterial)(node);
-                    }
-                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material.metallness')) {
-                        // inject initial value and mark as dirty
-                        (0, babylonHelper_1.injectNodeMetadata)(node, { dirty: { material: { color: payload.oldValue } } }, false);
-                    }
-                }
-                (0, babylonHelper_1.setMaterialMetallness)(node, parsedValue, false);
-            }
-            return payload;
-        }));
-        return this;
-    }
-    /**
-     * Passes all {@link ParameterValue}s of the given {@link ParameterBag} for given {@link TagManagerSubject} to
-     * {@link handleParameter}.
-     * @protected
-     */
-    handleParameterBag(subject, parameters) {
-        const observerPromises = [];
-        for (const parameter in parameters) {
-            observerPromises.push(this.handleParameter(subject, parameter, parameters[parameter]));
-        }
-        return observerPromises;
-    }
-    /**
-     * Asserts the given {@link Parameter} and its {@link ParameterValue}, stores the state in the {@link TagManager}'s
-     * {@link parameters}, calculates the applicable nodes, injects the {@link ParameterValue} in the node's metadata,
-     * calls the responsible {@link ParameterObserver}s and emits the event {@link Event.TAG_MANAGER_PARAMETER_COMMITTED}.
-     * @protected
-     */
-    handleParameter(subject, parameter, parameterValue) {
-        parameter_1.Parameter.assertParameter(parameter_1.Parameter.declarations, parameter, parameterValue);
-        if (!this.parameterObservers.has(parameter)) {
-            return Promise.resolve(() => undefined);
-        }
-        const parameterBag = this.parameters.get(subject) || {};
-        const oldValue = parameterBag[parameter];
-        this.parameters.set(subject, parameterBag);
-        this.parameters.get(subject)[parameter] = parameterValue;
-        const predicate = (node) => { var _a, _b; return ((_b = (_a = node.metadata) === null || _a === void 0 ? void 0 : _a.tagManager) === null || _b === void 0 ? void 0 : _b.parameters[parameter]) !== parameterValue; };
-        const nodes = this.getNodesBySubject(subject, predicate);
-        if (nodes.length === 0) {
-            return Promise.resolve(() => undefined);
-        }
-        for (const node of nodes) {
-            (0, babylonHelper_1.injectNodeMetadata)(node, { tagManager: { parameters: { [parameter]: parameterValue } } }, false);
-        }
-        const observer = this.parameterObservers.get(parameter);
-        const observerResult = observer({ subject: subject, nodes: nodes, newValue: parameterValue, oldValue: oldValue });
-        return Promise.resolve(observerResult).then(result => {
-            event_1.emitter.emit(event_1.Event.TAG_MANAGER_PARAMETER_COMMITTED, {
-                subject: subject,
-                parameter: parameter,
-                value: parameterValue,
-                nodes: nodes,
-                result: result,
-            });
-        });
-    }
-    /**
-     * Updates the state of the {@link TagManager}'s {@link parameters} for all new nodes and tags given in
-     * {@link TagMapping}.
-     * @protected
-     */
-    updateParametersWithNodeAndTagMapping(nodes, tagMapping) {
-        // create node mapping by linking the clone source name to the new node name
-        const nodeMapping = nodes.reduce((accNodeMapping, curNode) => {
-            const oldNode = (0, lodash_es_1.get)(curNode.metadata, 'cloneSource');
-            if (oldNode) {
-                accNodeMapping[oldNode.name] = curNode.name;
-            }
-            return accNodeMapping;
-        }, {});
-        for (const subject of this.parameters.keys()) {
-            const isNode = subject.nodeName;
-            const newName = isNode ? nodeMapping[subject.nodeName] : tagMapping[subject.tagName];
-            if (!newName) {
-                continue;
-            }
-            const newSubject = (0, lodash_es_1.clone)(subject);
-            newSubject[isNode ? 'nodeName' : 'tagName'] = newName;
-            const parameterBag = (0, lodash_es_1.clone)(this.parameters.get(subject));
-            (0, lodash_es_1.merge)(parameterBag, this.parameters.get(newSubject));
-            this.parameters.set(newSubject, parameterBag);
-        }
-    }
-    /**
-     * Clears the applied {@link ParameterBag} state of the node's metadata to ensure that observers trigger (once again).
-     * This is necessary e.g. after mapping tags when a nodeName subject shall override the parameterValue of a mapped
-     * tag.
-     * @protected
-     */
-    clearAppliedNodeMetadataParameters(nodes) {
-        var _a, _b;
-        for (const node of nodes) {
-            if (!((_b = (_a = node.metadata) === null || _a === void 0 ? void 0 : _a.tagManager) === null || _b === void 0 ? void 0 : _b.parameters)) {
-                continue;
-            }
-            node.metadata.tagManager.parameters = {};
-        }
-    }
-}
-exports.TagManager = TagManager;
+"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.TagManager = void 0;
+const event_1 = require("../classes/event");
+const fuzzyMap_1 = require("../classes/fuzzyMap");
+const parameter_1 = require("../classes/parameter");
+const babylonHelper_1 = require("../util/babylonHelper");
+const tags_1 = require("@babylonjs/core/Misc/tags");
+const lodash_es_1 = require("lodash-es");
+class TagManager {
+    /**
+     * Constructor.
+     */
+    constructor(viewer) {
+        this.viewer = viewer;
+        this.parameters = new fuzzyMap_1.FuzzyMap();
+        this.parameterObservers = new Map();
+        this.addParameterObservers();
+    }
+    /**
+     * Calls the {@link ParameterObserver} for given {@link Parameter} and applies the {@link ParameterValue} on all
+     * nodes with given tagName.
+     */
+    setTagParameterValue(tagName, parameterName, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.handleParameter({ tagName: tagName }, parameterName, value);
+        });
+    }
+    /**
+     * Calls the {@link ParameterObserver} for given {@link Parameter} and applies the {@link ParameterValue} on all
+     * nodes with given nodeName.
+     */
+    setNodeParameterValue(nodeName, parameterName, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return yield this.handleParameter({ nodeName: nodeName }, parameterName, value);
+        });
+    }
+    /**
+     * Splits the passed {@link TagManagerParameterValue}s into individual values and calls all {@link ParameterObserver}s
+     * of all {@link Parameter}s with the respective {@link TagManagerSubject} and {@link ParameterValue}. The result is a
+     * map of passed {@link TagManagerParameterValue}s and the associated {@link ParameterObserverResult} of the
+     * {@link ParameterObserver}.
+     */
+    setParameterValues(values) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const observerResultMap = new Map();
+            const tagPromises = [];
+            const nodePromises = [];
+            for (const value of values) {
+                const subject = {};
+                if (value.tagName) {
+                    subject.tagName = value.tagName;
+                }
+                if (value.nodeName) {
+                    subject.nodeName = value.nodeName;
+                }
+                const promise = this.handleParameter(subject, value.parameterName, value.value);
+                promise.then(result => observerResultMap.set(value, result));
+                if (value.tagName) {
+                    tagPromises.push(promise);
+                }
+                if (value.nodeName) {
+                    nodePromises.push(promise);
+                }
+            }
+            yield Promise.all(tagPromises);
+            yield Promise.all(nodePromises);
+            return observerResultMap;
+        });
+    }
+    /**
+     * Gets a list of {@link TagManagerSubject}s that are present in both the state of the {@link TagManager}'s
+     * {@link parameters} and the given node.
+     */
+    getSubjectsFor(node) {
+        return [...this.parameters.keys()].filter(subject => (subject.tagName && tags_1.Tags.MatchesQuery(node, subject.tagName)) ||
+            (subject.nodeName && node.name === subject.nodeName));
+    }
+    /**
+     * Gets a list of {@link TagManagerSubject}s that are present in both the state of the {@link TagManager}'s
+     * {@link parameters} and the given nodes.
+     */
+    getApplicableSubjectsFor(nodes) {
+        let applicableSubjects = [];
+        for (const node of nodes) {
+            const subjects = this.getSubjectsFor(node);
+            applicableSubjects = [...applicableSubjects, ...subjects];
+        }
+        return (0, lodash_es_1.uniq)(applicableSubjects);
+    }
+    /**
+     * Applies all existing states of the {@link TagManager}'s {@link parameters} for given {@link TagManagerSubject}s.
+     */
+    applyExistingParameterValuesFor(subjects) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const observerResultMap = new Map();
+            let tagPromises = [];
+            let nodePromises = [];
+            for (const subject of subjects) {
+                this.clearAppliedNodeMetadataParameters(this.getNodesBySubject(subject));
+                const promises = this.handleParameterBag(subject, this.parameters.get(subject));
+                for (const promise of promises) {
+                    promise.then(result => observerResultMap.set(subject, result));
+                }
+                if (subject.tagName) {
+                    tagPromises = [...tagPromises, ...promises];
+                }
+                if (subject.nodeName) {
+                    nodePromises = [...nodePromises, ...promises];
+                }
+            }
+            yield Promise.all(tagPromises);
+            yield Promise.all(nodePromises);
+            return observerResultMap;
+        });
+    }
+    /**
+     * Does the same as {@link setParameterValues} with the difference that all existing states of the
+     * {@link TagManager}'s {@link parameters} are applied to all given nodes.
+     */
+    applyExistingParameterValuesTo(nodes) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.applyExistingParameterValuesFor(this.getApplicableSubjectsFor(nodes));
+        });
+    }
+    /**
+     * Applies all existing states of the {@link TagManager}'s {@link parameters} for all {@link TagManagerSubject}s.
+     */
+    applyExistingParameterValues() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.applyExistingParameterValuesFor([...this.parameters.keys()]);
+        });
+    }
+    /**
+     * Maps all tags on given nodes with the {@link TagMapping} and updates the state of the {@link TagManager}'s
+     * {@link parameters} for all new tags.
+     * Also updates the state of all nodes in the tag managers parameter state.
+     */
+    mapNodesAndTags(nodes, tagMapping) {
+        this.updateParametersWithNodeAndTagMapping(nodes, tagMapping);
+        (0, babylonHelper_1.mapTags)(nodes, tagMapping);
+        return this;
+    }
+    /**
+     * Prints the state of the {@link TagManager}'s {@link parameters} to the console.
+     */
+    printAllTags() {
+        const printable = [];
+        for (const subject of this.parameters.keys()) {
+            const parameterBag = this.parameters.get(subject);
+            for (const parameter in parameterBag) {
+                printable.push({
+                    subject: JSON.stringify(subject),
+                    parameter: parameter,
+                    value: parameterBag[parameter],
+                    nodes: this.getNodesBySubject(subject),
+                });
+            }
+        }
+        console.table(printable);
+    }
+    /**
+     * Prints the state of the {@link TagManager}'s {@link parameters} for one tagName to the console.
+     */
+    printTagInfo(tagName) {
+        const parameterBag = this.parameters.get({ tagName: tagName });
+        const printable = [];
+        for (const parameter in parameterBag) {
+            printable.push({
+                parameter: parameter,
+                value: parameterBag[parameter],
+                nodes: this.getNodesBySubject({ tagName: tagName }),
+            });
+        }
+        console.table(printable);
+    }
+    /**
+     * Sets a {@link ParameterObserver} for the given {@link Parameter}.
+     */
+    setParameterObserver(parameter, observer) {
+        this.parameterObservers.set(parameter, observer);
+        return this;
+    }
+    /**
+     * Gets all nodes for given {@link TagManagerSubject} on the Babylon.js scene.
+     */
+    getNodesBySubject(subject, predicate) {
+        let nodes = [];
+        if (subject.tagName) {
+            nodes = [
+                ...nodes,
+                ...this.viewer.scene.getTransformNodesByTags(subject.tagName, predicate),
+                ...this.viewer.scene.getMeshesByTags(subject.tagName, predicate),
+            ];
+        }
+        if (subject.nodeName) {
+            nodes = [
+                ...nodes,
+                this.viewer.scene.getTransformNodeByName(subject.nodeName),
+                this.viewer.scene.getMeshByName(subject.nodeName),
+            ].filter(t => !!t && (!predicate || predicate(t)));
+        }
+        return nodes;
+    }
+    /**
+     * Registers observers that are called on every new node added to the Babylon.js scene. The observers ensure that each
+     * new node gets the state of the {@link TagManager}'s {@link parameters} applied.
+     */
+    registerNewTransformNodeObservers(scene) {
+        const onNewTransformNodeAdded = (node) => __awaiter(this, void 0, void 0, function* () {
+            yield this.viewer.scene.whenReadyAsync();
+            yield this.applyExistingParameterValuesTo([node]);
+        });
+        scene.onNewTransformNodeAddedObservable.makeObserverBottomPriority(scene.onNewTransformNodeAddedObservable.add(onNewTransformNodeAdded));
+        scene.onNewMeshAddedObservable.makeObserverBottomPriority(scene.onNewMeshAddedObservable.add(onNewTransformNodeAdded));
+    }
+    /**
+     * Adds the default {@link ParameterObserver}s.
+     * @protected
+     */
+    addParameterObservers() {
+        this.parameterObservers.set(parameter_1.Parameter.VISIBLE, (payload) => __awaiter(this, void 0, void 0, function* () {
+            let visible;
+            try {
+                visible = parameter_1.Parameter.parseBoolean(payload.newValue);
+            }
+            catch (e) {
+                return;
+            }
+            if (visible === true) {
+                for (const node of payload.nodes) {
+                    node.setEnabled(true);
+                }
+            }
+            else if (visible === false) {
+                for (const node of payload.nodes) {
+                    node.setEnabled(false);
+                }
+            }
+            return payload;
+        }));
+        this.parameterObservers.set(parameter_1.Parameter.SCALING, (payload) => __awaiter(this, void 0, void 0, function* () {
+            for (const node of payload.nodes) {
+                node.scaling = parameter_1.Parameter.parseVector(payload.newValue);
+            }
+            return payload;
+        }));
+        this.parameterObservers.set(parameter_1.Parameter.POSITION, (payload) => __awaiter(this, void 0, void 0, function* () {
+            for (const node of payload.nodes) {
+                node.position = parameter_1.Parameter.parseVector(payload.newValue);
+            }
+            return payload;
+        }));
+        this.parameterObservers.set(parameter_1.Parameter.ROTATION, (payload) => __awaiter(this, void 0, void 0, function* () {
+            for (const node of payload.nodes) {
+                node.rotation = parameter_1.Parameter.parseRotation(payload.newValue);
+            }
+            return payload;
+        }));
+        this.parameterObservers.set(parameter_1.Parameter.MATERIAL, (payload) => __awaiter(this, void 0, void 0, function* () {
+            for (const node of payload.nodes) {
+                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL);
+                (0, babylonHelper_1.setMaterial)(node, payload.newValue.toString(), false);
+            }
+            return payload;
+        }));
+        this.parameterObservers.set(parameter_1.Parameter.MATERIAL_COLOR, (payload) => __awaiter(this, void 0, void 0, function* () {
+            const parsedValue = parameter_1.Parameter.parseColor(payload.newValue);
+            for (const node of payload.nodes) {
+                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL_COLOR);
+                if (this.viewer.cloneMaterialsOnMutation) {
+                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material')) {
+                        (0, babylonHelper_1.cloneTransformNodeMaterial)(node);
+                    }
+                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material.color')) {
+                        // inject initial value and mark as dirty
+                        (0, babylonHelper_1.injectNodeMetadata)(node, { dirty: { material: { color: payload.oldValue } } }, false);
+                    }
+                }
+                (0, babylonHelper_1.setMaterialColor)(node, parsedValue, false);
+            }
+            return payload;
+        }));
+        this.parameterObservers.set(parameter_1.Parameter.MATERIAL_ROUGHNESS, (payload) => __awaiter(this, void 0, void 0, function* () {
+            const parsedValue = parameter_1.Parameter.parseNumber(payload.newValue);
+            for (const node of payload.nodes) {
+                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL_ROUGHNESS);
+                if (this.viewer.cloneMaterialsOnMutation) {
+                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material')) {
+                        (0, babylonHelper_1.cloneTransformNodeMaterial)(node);
+                    }
+                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material.roughness')) {
+                        // inject initial value and mark as dirty
+                        (0, babylonHelper_1.injectNodeMetadata)(node, { dirty: { material: { color: payload.oldValue } } }, false);
+                    }
+                }
+                (0, babylonHelper_1.setMaterialRoughness)(node, parsedValue, false);
+            }
+            return payload;
+        }));
+        this.parameterObservers.set(parameter_1.Parameter.MATERIAL_METALLNESS, (payload) => __awaiter(this, void 0, void 0, function* () {
+            const parsedValue = parameter_1.Parameter.parseNumber(payload.newValue);
+            for (const node of payload.nodes) {
+                (0, babylonHelper_1.assertMeshCapability)(node, parameter_1.Parameter.MATERIAL_METALLNESS);
+                if (this.viewer.cloneMaterialsOnMutation) {
+                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material')) {
+                        (0, babylonHelper_1.cloneTransformNodeMaterial)(node);
+                    }
+                    if (!(0, lodash_es_1.has)(node.metadata, 'dirty.material.metallness')) {
+                        // inject initial value and mark as dirty
+                        (0, babylonHelper_1.injectNodeMetadata)(node, { dirty: { material: { color: payload.oldValue } } }, false);
+                    }
+                }
+                (0, babylonHelper_1.setMaterialMetallness)(node, parsedValue, false);
+            }
+            return payload;
+        }));
+        return this;
+    }
+    /**
+     * Passes all {@link ParameterValue}s of the given {@link ParameterBag} for given {@link TagManagerSubject} to
+     * {@link handleParameter}.
+     * @protected
+     */
+    handleParameterBag(subject, parameters) {
+        const observerPromises = [];
+        for (const parameter in parameters) {
+            observerPromises.push(this.handleParameter(subject, parameter, parameters[parameter]));
+        }
+        return observerPromises;
+    }
+    /**
+     * Asserts the given {@link Parameter} and its {@link ParameterValue}, stores the state in the {@link TagManager}'s
+     * {@link parameters}, calculates the applicable nodes, injects the {@link ParameterValue} in the node's metadata,
+     * calls the responsible {@link ParameterObserver}s and emits the event {@link Event.TAG_MANAGER_PARAMETER_COMMITTED}.
+     * @protected
+     */
+    handleParameter(subject, parameter, parameterValue) {
+        parameter_1.Parameter.assertParameter(parameter_1.Parameter.declarations, parameter, parameterValue);
+        if (!this.parameterObservers.has(parameter)) {
+            return Promise.resolve(() => undefined);
+        }
+        const parameterBag = this.parameters.get(subject) || {};
+        const oldValue = parameterBag[parameter];
+        this.parameters.set(subject, parameterBag);
+        this.parameters.get(subject)[parameter] = parameterValue;
+        const predicate = (node) => { var _a, _b; return ((_b = (_a = node.metadata) === null || _a === void 0 ? void 0 : _a.tagManager) === null || _b === void 0 ? void 0 : _b.parameters[parameter]) !== parameterValue; };
+        const nodes = this.getNodesBySubject(subject, predicate);
+        if (nodes.length === 0) {
+            return Promise.resolve(() => undefined);
+        }
+        for (const node of nodes) {
+            (0, babylonHelper_1.injectNodeMetadata)(node, { tagManager: { parameters: { [parameter]: parameterValue } } }, false);
+        }
+        const observer = this.parameterObservers.get(parameter);
+        const observerResult = observer({ subject: subject, nodes: nodes, newValue: parameterValue, oldValue: oldValue });
+        return Promise.resolve(observerResult).then(result => {
+            event_1.emitter.emit(event_1.Event.TAG_MANAGER_PARAMETER_COMMITTED, {
+                subject: subject,
+                parameter: parameter,
+                value: parameterValue,
+                nodes: nodes,
+                result: result,
+            });
+        });
+    }
+    /**
+     * Updates the state of the {@link TagManager}'s {@link parameters} for all new nodes and tags given in
+     * {@link TagMapping}.
+     * @protected
+     */
+    updateParametersWithNodeAndTagMapping(nodes, tagMapping) {
+        // create node mapping by linking the clone source name to the new node name
+        const nodeMapping = nodes.reduce((accNodeMapping, curNode) => {
+            const oldNode = (0, lodash_es_1.get)(curNode.metadata, 'cloneSource');
+            if (oldNode) {
+                accNodeMapping[oldNode.name] = curNode.name;
+            }
+            return accNodeMapping;
+        }, {});
+        for (const subject of this.parameters.keys()) {
+            const isNode = subject.nodeName;
+            const newName = isNode ? nodeMapping[subject.nodeName] : tagMapping[subject.tagName];
+            if (!newName) {
+                continue;
+            }
+            const newSubject = (0, lodash_es_1.clone)(subject);
+            newSubject[isNode ? 'nodeName' : 'tagName'] = newName;
+            const parameterBag = (0, lodash_es_1.clone)(this.parameters.get(subject));
+            (0, lodash_es_1.merge)(parameterBag, this.parameters.get(newSubject));
+            this.parameters.set(newSubject, parameterBag);
+        }
+    }
+    /**
+     * Clears the applied {@link ParameterBag} state of the node's metadata to ensure that observers trigger (once again).
+     * This is necessary e.g. after mapping tags when a nodeName subject shall override the parameterValue of a mapped
+     * tag.
+     * @protected
+     */
+    clearAppliedNodeMetadataParameters(nodes) {
+        var _a, _b;
+        for (const node of nodes) {
+            if (!((_b = (_a = node.metadata) === null || _a === void 0 ? void 0 : _a.tagManager) === null || _b === void 0 ? void 0 : _b.parameters)) {
+                continue;
+            }
+            node.metadata.tagManager.parameters = {};
+        }
+    }
+}
+exports.TagManager = TagManager;
 //# sourceMappingURL=tagManager.js.map