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

package/dist/lib-es6/{api → src/api}/classes/parameterizable.d.ts

@@ -1,15 +1,15 @@
-import { ParameterObservable } from './parameterObservable';
-export declare abstract class Parameterizable extends ParameterObservable {
-    protected parameterDeclaration: ParameterDeclarations;
-    get visible(): boolean | undefined;
-    get highlighted(): boolean | undefined;
-    get material(): string | undefined;
-    get scaling(): string | undefined;
-    get position(): string | undefined;
-    get rotation(): string | undefined;
-    get castShadow(): boolean | undefined;
-    show(): Promise<ParameterObservable>;
-    hide(): Promise<ParameterObservable>;
-    toggle(): Promise<ParameterObservable>;
-    toggleHighlight(): Promise<ParameterObservable>;
-}
+import { ParameterObservable } from './parameterObservable';
+export declare abstract class Parameterizable extends ParameterObservable {
+    protected parameterDeclaration: ParameterDeclarations;
+    get visible(): boolean | undefined;
+    get highlighted(): boolean | undefined;
+    get material(): string | undefined;
+    get scaling(): string | undefined;
+    get position(): string | undefined;
+    get rotation(): string | undefined;
+    get castShadow(): boolean | undefined;
+    show(): Promise<ParameterObservable>;
+    hide(): Promise<ParameterObservable>;
+    toggle(): Promise<ParameterObservable>;
+    toggleHighlight(): Promise<ParameterObservable>;
+}

package/dist/lib-es6/src/api/classes/parameterizable.js

@@ -0,0 +1,99 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Parameter } from './parameter';
+import { ParameterObservable } from './parameterObservable';
+export class Parameterizable extends ParameterObservable {
+    constructor() {
+        super(...arguments);
+        this.parameterDeclaration = Parameter.declarations;
+    }
+    get visible() {
+        if (!(Parameter.VISIBLE in this.parameters)) {
+            return undefined;
+        }
+        try {
+            return Parameter.parseBoolean(this.parameters[Parameter.VISIBLE]);
+        }
+        catch (e) {
+            return undefined;
+        }
+    }
+    get highlighted() {
+        if (!(Parameter.HIGHLIGHTED in this.parameters)) {
+            return undefined;
+        }
+        try {
+            return Parameter.parseBoolean(this.parameters[Parameter.HIGHLIGHTED]);
+        }
+        catch (e) {
+            return undefined;
+        }
+    }
+    get material() {
+        if (!(Parameter.MATERIAL in this.parameters)) {
+            return undefined;
+        }
+        return this.parameters[Parameter.MATERIAL].toString();
+    }
+    get scaling() {
+        if (!(Parameter.SCALING in this.parameters)) {
+            return undefined;
+        }
+        return this.parameters[Parameter.SCALING].toString();
+    }
+    get position() {
+        if (!(Parameter.POSITION in this.parameters)) {
+            return undefined;
+        }
+        return this.parameters[Parameter.POSITION].toString();
+    }
+    get rotation() {
+        if (!(Parameter.ROTATION in this.parameters)) {
+            return undefined;
+        }
+        return this.parameters[Parameter.ROTATION].toString();
+    }
+    get castShadow() {
+        if (!(Parameter.CAST_SHADOW in this.parameters)) {
+            return undefined;
+        }
+        try {
+            return Parameter.parseBoolean(this.parameters[Parameter.CAST_SHADOW]);
+        }
+        catch (e) {
+            return undefined;
+        }
+    }
+    show() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.commitParameter(Parameter.VISIBLE, true);
+            return this;
+        });
+    }
+    hide() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.commitParameter(Parameter.VISIBLE, false);
+            return this;
+        });
+    }
+    toggle() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.commitParameter(Parameter.VISIBLE, !this.visible);
+            return this;
+        });
+    }
+    toggleHighlight() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.commitParameter(Parameter.HIGHLIGHTED, !this.highlighted);
+            return this;
+        });
+    }
+}
+//# sourceMappingURL=parameterizable.js.map

package/dist/lib-es6/src/api/classes/parameterizable.js.map

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

package/dist/lib-es6/{api → src/api}/classes/placementAnimation.d.ts

@@ -1,44 +1,45 @@
-/// <reference types="gsap" />
-/**
- * An {@link PlacementAnimation} handling `Tweens` of the `GSAP` API using configured {@link PlacementDefinition}s
- * and {@link AnimationDefinition}s. It mutates the attributes in the given {@link PlacementDefinition} with the given
- * {@link AnimationDefinition}. The latter can be anything the `GSAP` allows in its API. Please consider using the
- * API of the {@link AnimationManager} to handle instances of this class in your consuming project.
- */
-export declare class PlacementAnimation implements AnimationInterface {
-    readonly mutable: object;
-    protected _placement: PlacementDefinition | string;
-    protected _animation?: string | AnimationDefinition | undefined;
-    protected _placementDefinition: PlacementDefinition;
-    protected _animationDefinition: AnimationDefinition;
-    protected _timeline: GSAPTimeline;
-    /**
-     * Constructor.
-     */
-    constructor(mutable: object, _placement: PlacementDefinition | string, _animation?: string | AnimationDefinition | undefined);
-    /**
-     * Plays all `Tweens` of this {@link PlacementAnimation}.
-     */
-    play(): Promise<AnimationInterface>;
-    /**
-     * Pause all `Tweens` of this {@link PlacementAnimation}.
-     */
-    pause(): AnimationInterface;
-    /**
-     * Kills all `Tweens` of this {@link PlacementAnimation}.
-     */
-    kill(): AnimationInterface;
-    /**
-     * Creates a {@link AnimationDefinition} definition if not provided in the constructor and sets some defaults.
-     * Only custom properties from {@link AnimationDefinition} are adjusted, all {@link GSAPTweenVars} remain untouched.
-     */
-    protected prepareAnimationDefinition(): void;
-    /**
-     * Prepares different types of {@link PlacementDefinition} and sets some defaults.
-     */
-    protected preparePlacementDefinition(): void;
-    /**
-     * Creates `Tweens` for the {@link PlacementDefinition} configured for this {@link PlacementAnimation}.
-     */
-    protected createTweens(): void;
-}
+/// <reference types="gsap" />
+import { AnimationInterface } from './animationInterface';
+/**
+ * An {@link PlacementAnimation} handling `Tweens` of the `GSAP` API using configured {@link PlacementDefinition}s
+ * and {@link AnimationDefinition}s. It mutates the attributes in the given {@link PlacementDefinition} with the given
+ * {@link AnimationDefinition}. The latter can be anything the `GSAP` allows in its API. Please consider using the
+ * API of the {@link AnimationManager} to handle instances of this class in your consuming project.
+ */
+export declare class PlacementAnimation implements AnimationInterface {
+    readonly mutable: object;
+    protected _placement: PlacementDefinition | string;
+    protected _animation?: string | AnimationDefinition | undefined;
+    protected _placementDefinition: PlacementDefinition;
+    protected _animationDefinition: AnimationDefinition;
+    protected _timeline: GSAPTimeline;
+    /**
+     * Constructor.
+     */
+    constructor(mutable: object, _placement: PlacementDefinition | string, _animation?: string | AnimationDefinition | undefined);
+    /**
+     * Plays all `Tweens` of this {@link PlacementAnimation}.
+     */
+    play(): Promise<AnimationInterface>;
+    /**
+     * Pause all `Tweens` of this {@link PlacementAnimation}.
+     */
+    pause(): AnimationInterface;
+    /**
+     * Kills all `Tweens` of this {@link PlacementAnimation}.
+     */
+    kill(): AnimationInterface;
+    /**
+     * Creates a {@link AnimationDefinition} definition if not provided in the constructor and sets some defaults.
+     * Only custom properties from {@link AnimationDefinition} are adjusted, all {@link GSAPTweenVars} remain untouched.
+     */
+    protected prepareAnimationDefinition(): void;
+    /**
+     * Prepares different types of {@link PlacementDefinition} and sets some defaults.
+     */
+    protected preparePlacementDefinition(): void;
+    /**
+     * Creates `Tweens` for the {@link PlacementDefinition} configured for this {@link PlacementAnimation}.
+     */
+    protected createTweens(): void;
+}

package/dist/lib-es6/{api → src/api}/classes/placementAnimation.js

@@ -1,161 +1,172 @@
-import { __awaiter, __generator, __rest } from "tslib";
-import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera';
-import { Vector3 } from '@babylonjs/core/Maths/math.vector';
-import { gsap } from 'gsap';
-import { cloneDeep, get, isString, merge, set } from 'lodash-es';
-import { Parameter } from '../classes/parameter';
-import { SpecStorage } from '../store/specStorage';
-/**
- * An {@link PlacementAnimation} handling `Tweens` of the `GSAP` API using configured {@link PlacementDefinition}s
- * and {@link AnimationDefinition}s. It mutates the attributes in the given {@link PlacementDefinition} with the given
- * {@link AnimationDefinition}. The latter can be anything the `GSAP` allows in its API. Please consider using the
- * API of the {@link AnimationManager} to handle instances of this class in your consuming project.
- */
-var PlacementAnimation = /** @class */ (function () {
-    /**
-     * Constructor.
-     */
-    function PlacementAnimation(mutable, _placement, _animation) {
-        var _a;
-        this.mutable = mutable;
-        this._placement = _placement;
-        this._animation = _animation;
-        if (isString(_placement)) {
-            var placementDefinitions = SpecStorage.get('scene.placements');
-            if (!placementDefinitions) {
-                throw new Error("No PlacementDefinitions defined in JSON structure.");
-            }
-            var placementDefinition = placementDefinitions[_placement];
-            if (!placementDefinition) {
-                throw new Error("PlacementDefinition \"" + _placement + "\" not defined in JSON structure.");
-            }
-            this._placementDefinition = cloneDeep(placementDefinition);
-        }
-        else {
-            this._placementDefinition = cloneDeep(_placement);
-        }
-        if (isString(_animation)) {
-            var animationDefinition = (_a = SpecStorage.get('scene.animations')) === null || _a === void 0 ? void 0 : _a[_animation];
-            if (!animationDefinition) {
-                throw new Error("AnimationDefinition \"" + _animation + "\" not defined in JSON structure.");
-            }
-            this._animationDefinition = cloneDeep(animationDefinition);
-        }
-        else {
-            this._animationDefinition = cloneDeep(_animation);
-        }
-        this.prepareAnimationDefinition();
-        // create (shallow) copy for GSAP which doesn't contain `shortestWay`,
-        // because that's not part of the original `TweenVars` input typing and therefore leads to warnings
-        var _b = this._animationDefinition, shortestWay = _b.shortestWay, gsapTweenVars = __rest(_b, ["shortestWay"]);
-        this._timeline = gsap.timeline({
-            defaults: gsapTweenVars,
-            paused: true,
-        });
-        this.preparePlacementDefinition();
-        this.createTweens();
-    }
-    /**
-     * Plays all `Tweens` of this {@link PlacementAnimation}.
-     */
-    PlacementAnimation.prototype.play = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this._timeline.play().then()];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, this];
-                }
-            });
-        });
-    };
-    /**
-     * Pause all `Tweens` of this {@link PlacementAnimation}.
-     */
-    PlacementAnimation.prototype.pause = function () {
-        this._timeline.pause();
-        return this;
-    };
-    /**
-     * Kills all `Tweens` of this {@link PlacementAnimation}.
-     */
-    PlacementAnimation.prototype.kill = function () {
-        this._timeline.kill();
-        return this;
-    };
-    /**
-     * Creates a {@link AnimationDefinition} definition if not provided in the constructor and sets some defaults.
-     * Only custom properties from {@link AnimationDefinition} are adjusted, all {@link GSAPTweenVars} remain untouched.
-     */
-    PlacementAnimation.prototype.prepareAnimationDefinition = function () {
-        // create an animation definition if not available yet
-        this._animationDefinition = this._animationDefinition || {};
-        // parse shortest way flag or set to `true` if not configured
-        if (this._animationDefinition.shortestWay !== undefined) {
-            this._animationDefinition.shortestWay = Parameter.parseBoolean(this._animationDefinition.shortestWay);
-        }
-        else {
-            this._animationDefinition.shortestWay = true;
-        }
-    };
-    /**
-     * Prepares different types of {@link PlacementDefinition} and sets some defaults.
-     */
-    PlacementAnimation.prototype.preparePlacementDefinition = function () {
-        var position = this._placementDefinition.position;
-        if (isString(position)) {
-            position = Parameter.parseVector(position);
-            this._placementDefinition.position = position;
-        }
-        if (this.mutable instanceof ArcRotateCamera) {
-            // parse the target
-            if (isString(this._placementDefinition.target)) {
-                this._placementDefinition.target = Parameter.parseVector(this._placementDefinition.target);
-            }
-            if (position) {
-                // parse the position and calculate alpha, beta and radius with a "ghost camera"
-                // @see https://www.babylonjs-playground.com/#4IVMG#0
-                var ghostCam = this.mutable.clone('ghost');
-                ghostCam.setPosition(position);
-                merge(this._placementDefinition, {
-                    alpha: ghostCam.alpha,
-                    beta: ghostCam.beta,
-                    radius: ghostCam.radius,
-                });
-                delete this._placementDefinition.position;
-                ghostCam.dispose();
-            }
-            else if (this._animationDefinition.shortestWay && this._placementDefinition.alpha !== undefined) {
-                // transform the target's alpha value into the same turn as the current camera position to avoid movements > 360 degrees
-                var alphaGap = this.mutable.alpha - this._placementDefinition.alpha;
-                var cntTurns = Math.round(alphaGap / (2 * Math.PI));
-                this._placementDefinition.alpha += 2 * Math.PI * cntTurns;
-            }
-        }
-    };
-    /**
-     * Creates `Tweens` for the {@link PlacementDefinition} configured for this {@link PlacementAnimation}.
-     */
-    PlacementAnimation.prototype.createTweens = function () {
-        for (var property in this._placementDefinition) {
-            var propertyValue = get(this._placementDefinition, property);
-            var tweenVars = {};
-            var _mutable = this.mutable;
-            if (propertyValue instanceof Vector3) {
-                // GSAP does not support mutation of complex objects, so we are forced
-                // to use the properties on the object as mutable directly and mutate
-                // the coordinates separately.
-                _mutable = get(this.mutable, property);
-                merge(tweenVars, { x: propertyValue.x, y: propertyValue.y, z: propertyValue.z });
-            }
-            else {
-                set(tweenVars, property, propertyValue);
-            }
-            this._timeline.to(_mutable, tweenVars, 0); // Note: position 0 does the "parallel" stuff here
-        }
-    };
-    return PlacementAnimation;
-}());
-export { PlacementAnimation };
+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());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { Parameter } from '../classes/parameter';
+import { SpecStorage } from '../store/specStorage';
+import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera';
+import { Vector3 } from '@babylonjs/core/Maths/math.vector';
+import { gsap } from 'gsap';
+import { cloneDeep, get, isString, merge, set } from 'lodash-es';
+/**
+ * An {@link PlacementAnimation} handling `Tweens` of the `GSAP` API using configured {@link PlacementDefinition}s
+ * and {@link AnimationDefinition}s. It mutates the attributes in the given {@link PlacementDefinition} with the given
+ * {@link AnimationDefinition}. The latter can be anything the `GSAP` allows in its API. Please consider using the
+ * API of the {@link AnimationManager} to handle instances of this class in your consuming project.
+ */
+export class PlacementAnimation {
+    /**
+     * Constructor.
+     */
+    constructor(mutable, _placement, _animation) {
+        var _a;
+        this.mutable = mutable;
+        this._placement = _placement;
+        this._animation = _animation;
+        if (isString(_placement)) {
+            const placementDefinitions = SpecStorage.get('scene.placements');
+            if (!placementDefinitions) {
+                throw new Error(`No PlacementDefinitions defined in JSON structure.`);
+            }
+            const placementDefinition = placementDefinitions[_placement];
+            if (!placementDefinition) {
+                throw new Error(`PlacementDefinition "${_placement}" not defined in JSON structure.`);
+            }
+            this._placementDefinition = cloneDeep(placementDefinition);
+        }
+        else {
+            this._placementDefinition = cloneDeep(_placement);
+        }
+        if (isString(_animation)) {
+            const animationDefinition = (_a = SpecStorage.get('scene.animations')) === null || _a === void 0 ? void 0 : _a[_animation];
+            if (!animationDefinition) {
+                throw new Error(`AnimationDefinition "${_animation}" not defined in JSON structure.`);
+            }
+            this._animationDefinition = cloneDeep(animationDefinition);
+        }
+        else {
+            this._animationDefinition = cloneDeep(_animation);
+        }
+        this.prepareAnimationDefinition();
+        // create (shallow) copy for GSAP which doesn't contain `shortestWay`,
+        // because that's not part of the original `TweenVars` input typing and therefore leads to warnings
+        const _b = this._animationDefinition, { shortestWay } = _b, gsapTweenVars = __rest(_b, ["shortestWay"]);
+        this._timeline = gsap.timeline({
+            defaults: gsapTweenVars,
+            paused: true,
+        });
+        this.preparePlacementDefinition();
+        this.createTweens();
+    }
+    /**
+     * Plays all `Tweens` of this {@link PlacementAnimation}.
+     */
+    play() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this._timeline.play().then();
+            return this;
+        });
+    }
+    /**
+     * Pause all `Tweens` of this {@link PlacementAnimation}.
+     */
+    pause() {
+        this._timeline.pause();
+        return this;
+    }
+    /**
+     * Kills all `Tweens` of this {@link PlacementAnimation}.
+     */
+    kill() {
+        this._timeline.kill();
+        return this;
+    }
+    /**
+     * Creates a {@link AnimationDefinition} definition if not provided in the constructor and sets some defaults.
+     * Only custom properties from {@link AnimationDefinition} are adjusted, all {@link GSAPTweenVars} remain untouched.
+     */
+    prepareAnimationDefinition() {
+        // create an animation definition if not available yet
+        this._animationDefinition = this._animationDefinition || {};
+        // parse shortest way flag or set to `true` if not configured
+        if (this._animationDefinition.shortestWay !== undefined) {
+            this._animationDefinition.shortestWay = Parameter.parseBoolean(this._animationDefinition.shortestWay);
+        }
+        else {
+            this._animationDefinition.shortestWay = true;
+        }
+    }
+    /**
+     * Prepares different types of {@link PlacementDefinition} and sets some defaults.
+     */
+    preparePlacementDefinition() {
+        let position = this._placementDefinition.position;
+        if (isString(position)) {
+            position = Parameter.parseVector(position);
+            this._placementDefinition.position = position;
+        }
+        if (this.mutable instanceof ArcRotateCamera) {
+            // parse the target
+            if (isString(this._placementDefinition.target)) {
+                this._placementDefinition.target = Parameter.parseVector(this._placementDefinition.target);
+            }
+            if (position) {
+                // parse the position and calculate alpha, beta and radius with a "ghost camera"
+                // @see https://www.babylonjs-playground.com/#4IVMG#0
+                const ghostCam = this.mutable.clone('ghost');
+                ghostCam.setPosition(position);
+                merge(this._placementDefinition, {
+                    alpha: ghostCam.alpha,
+                    beta: ghostCam.beta,
+                    radius: ghostCam.radius,
+                });
+                delete this._placementDefinition.position;
+                ghostCam.dispose();
+            }
+            else if (this._animationDefinition.shortestWay && this._placementDefinition.alpha !== undefined) {
+                // transform the target's alpha value into the same turn as the current camera position to avoid movements > 360 degrees
+                const alphaGap = this.mutable.alpha - this._placementDefinition.alpha;
+                const cntTurns = Math.round(alphaGap / (2 * Math.PI));
+                this._placementDefinition.alpha += 2 * Math.PI * cntTurns;
+            }
+        }
+    }
+    /**
+     * Creates `Tweens` for the {@link PlacementDefinition} configured for this {@link PlacementAnimation}.
+     */
+    createTweens() {
+        for (const property in this._placementDefinition) {
+            const propertyValue = get(this._placementDefinition, property);
+            const tweenVars = {};
+            let _mutable = this.mutable;
+            if (propertyValue instanceof Vector3) {
+                // GSAP does not support mutation of complex objects, so we are forced
+                // to use the properties on the object as mutable directly and mutate
+                // the coordinates separately.
+                _mutable = get(this.mutable, property);
+                merge(tweenVars, { x: propertyValue.x, y: propertyValue.y, z: propertyValue.z });
+            }
+            else {
+                set(tweenVars, property, propertyValue);
+            }
+            this._timeline.to(_mutable, tweenVars, 0); // Note: position 0 does the "parallel" stuff here
+        }
+    }
+}
 //# sourceMappingURL=placementAnimation.js.map

package/dist/lib-es6/src/api/classes/placementAnimation.js.map

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