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

package/src/api/classes/parameterObservable.ts

@@ -1,100 +1,100 @@
-import { merge } from 'lodash-es';
-import { uuidv4 } from '../util/stringHelper';
-import { EventBroadcaster } from './eventBroadcaster';
-
-export abstract class ParameterObservable extends EventBroadcaster {
-  public readonly uuid: string;
-
-  public readonly parameters: ParameterBag = {};
-
-  protected readonly parameterDeclaration: ParameterDeclarations = {};
-
-  protected parameterObservers: Map<string, ParameterObserver[]> = new Map();
-
-  protected constructor(parameterDeclaration: ParameterDeclarations = {}, parameters: ParameterBag = {}) {
-    super();
-    this.uuid = uuidv4();
-    this.parameterDeclaration = merge(this.parameterDeclaration, parameterDeclaration);
-    this.parameters = merge(this.parameters, parameters);
-  }
-
-  /**
-   * The uuid (if not overloaded).
-   */
-  get id(): string {
-    return this.uuid;
-  }
-
-  /**
-   * Adds an observer function for parameter changes.
-   * The {@link ParameterObserver} gets 3 parameters: the {@link ParameterObservable}, the old {@link ParameterValue}
-   * and the new {@link ParameterValue}.
-   *
-   * See {@page Parameters} for an example.
-   */
-  public addParameterObserver(parameter: string, observer: ParameterObserver): ParameterObservable {
-    if (this.parameterObservers.has(parameter)) {
-      this.parameterObservers.get(parameter)!.push(observer);
-      return this;
-    }
-    this.parameterObservers.set(parameter, [observer]);
-    return this;
-  }
-
-  /**
-   * Removes all {@link ParameterObserver}s for given parameter.
-   */
-  public removeParameterObservers(parameter: string): ParameterObservable {
-    this.parameterObservers.delete(parameter);
-    return this;
-  }
-
-  /**
-   * Invoke parameter observers for given parameter.
-   */
-  public async commitParameter(parameter: string, value: ParameterValue): Promise<ParameterObservable> {
-    const parameters: ParameterBag = {};
-    parameters[parameter] = value;
-    return this.commitParameters(parameters);
-  }
-
-  /**
-   * Invoke parameter observers for given parameters.
-   */
-  public abstract commitParameters(parameters?: ParameterBag): Promise<ParameterObservable>;
-
-  /**
-   * Asserts whether given parameter is declared and valid.
-   */
-  public assertParameter(parameterDeclaration: ParameterDeclarations, parameter: string, value: ParameterValue) {
-    if (!(parameter in parameterDeclaration)) {
-      // This is a valid case since we are not able to check parameters that are not declared.
-      // We just ignore parameters that are not declared.
-      return;
-    }
-    const declaration = parameterDeclaration[parameter];
-    const genericError =
-      `"${value}" is not a valid value for parameter "${parameter}" of type. ` +
-      `"${declaration.type}" for ${this.constructor.name} "${this.id}".`;
-    if (declaration.parser) {
-      try {
-        declaration.parser(value);
-      } catch (e) {
-        throw Error(genericError + e.message);
-      }
-    }
-    switch (declaration.type) {
-      case 'select':
-        if (!declaration.options) {
-          throw Error(
-            `No options defined for parameter declaration "${parameter}"` +
-              `of type "${declaration.type}" for ${this.constructor.name} "${this.id}".`
-          );
-        }
-        if (declaration.options.indexOf(value) === -1) {
-          throw Error(genericError + ` Valid values are: "${declaration.options.join('", "')}".`);
-        }
-        break;
-    }
-  }
-}
+import { uuidv4 } from '../util/stringHelper';
+import { EventBroadcaster } from './eventBroadcaster';
+import { merge } from 'lodash-es';
+
+export abstract class ParameterObservable extends EventBroadcaster {
+  public readonly uuid: string;
+
+  public readonly parameters: ParameterBag = {};
+
+  protected readonly parameterDeclaration: ParameterDeclarations = {};
+
+  protected parameterObservers: Map<string, ParameterObserver[]> = new Map();
+
+  protected constructor(parameterDeclaration: ParameterDeclarations = {}, parameters: ParameterBag = {}) {
+    super();
+    this.uuid = uuidv4();
+    this.parameterDeclaration = merge(this.parameterDeclaration, parameterDeclaration);
+    this.parameters = merge(this.parameters, parameters);
+  }
+
+  /**
+   * The uuid (if not overloaded).
+   */
+  get id(): string {
+    return this.uuid;
+  }
+
+  /**
+   * Adds an observer function for parameter changes.
+   * The {@link ParameterObserver} gets 3 parameters: the {@link ParameterObservable}, the old {@link ParameterValue}
+   * and the new {@link ParameterValue}.
+   *
+   * See {@page ../../../doc/documentation/Parameters.md} for an example.
+   */
+  public addParameterObserver(parameter: string, observer: ParameterObserver): ParameterObservable {
+    if (this.parameterObservers.has(parameter)) {
+      this.parameterObservers.get(parameter)!.push(observer);
+      return this;
+    }
+    this.parameterObservers.set(parameter, [observer]);
+    return this;
+  }
+
+  /**
+   * Removes all {@link ParameterObserver}s for given parameter.
+   */
+  public removeParameterObservers(parameter: string): ParameterObservable {
+    this.parameterObservers.delete(parameter);
+    return this;
+  }
+
+  /**
+   * Invoke parameter observers for given parameter.
+   */
+  public async commitParameter(parameter: string, value: ParameterValue): Promise<ParameterObservable> {
+    const parameters: ParameterBag = {};
+    parameters[parameter] = value;
+    return this.commitParameters(parameters);
+  }
+
+  /**
+   * Invoke parameter observers for given parameters.
+   */
+  public abstract commitParameters(parameters?: ParameterBag): Promise<ParameterObservable>;
+
+  /**
+   * Asserts whether given parameter is declared and valid.
+   */
+  public assertParameter(parameterDeclaration: ParameterDeclarations, parameter: string, value: ParameterValue) {
+    if (!(parameter in parameterDeclaration)) {
+      // This is a valid case since we are not able to check parameters that are not declared.
+      // We just ignore parameters that are not declared.
+      return;
+    }
+    const declaration = parameterDeclaration[parameter];
+    const genericError =
+      `"${value}" is not a valid value for parameter "${parameter}" of type. ` +
+      `"${declaration.type}" for ${this.constructor.name} "${this.id}".`;
+    if (declaration.parser) {
+      try {
+        declaration.parser(value);
+      } catch (e: any) {
+        throw Error(genericError + e.message);
+      }
+    }
+    switch (declaration.type) {
+      case 'select':
+        if (!declaration.options) {
+          throw Error(
+            `No options defined for parameter declaration "${parameter}"` +
+              `of type "${declaration.type}" for ${this.constructor.name} "${this.id}".`
+          );
+        }
+        if (declaration.options.indexOf(value) === -1) {
+          throw Error(genericError + ` Valid values are: "${declaration.options.join('", "')}".`);
+        }
+        break;
+    }
+  }
+}

package/src/api/classes/parameterizable.ts

@@ -1,87 +1,87 @@
-import { Parameter } from './parameter';
-import { ParameterObservable } from './parameterObservable';
-
-export abstract class Parameterizable extends ParameterObservable {
-  protected parameterDeclaration: ParameterDeclarations = Parameter.declarations;
-
-  get visible(): boolean | undefined {
-    if (!(Parameter.VISIBLE in this.parameters)) {
-      return undefined;
-    }
-    try {
-      return Parameter.parseBoolean(this.parameters[Parameter.VISIBLE]);
-    } catch (e) {
-      return undefined;
-    }
-  }
-
-  get highlighted(): boolean | undefined {
-    if (!(Parameter.HIGHLIGHTED in this.parameters)) {
-      return undefined;
-    }
-    try {
-      return Parameter.parseBoolean(this.parameters[Parameter.HIGHLIGHTED]);
-    } catch (e) {
-      return undefined;
-    }
-  }
-
-  get material(): string | undefined {
-    if (!(Parameter.MATERIAL in this.parameters)) {
-      return undefined;
-    }
-    return this.parameters[Parameter.MATERIAL].toString();
-  }
-
-  get scaling(): string | undefined {
-    if (!(Parameter.SCALING in this.parameters)) {
-      return undefined;
-    }
-    return this.parameters[Parameter.SCALING].toString();
-  }
-
-  get position(): string | undefined {
-    if (!(Parameter.POSITION in this.parameters)) {
-      return undefined;
-    }
-    return this.parameters[Parameter.POSITION].toString();
-  }
-
-  get rotation(): string | undefined {
-    if (!(Parameter.ROTATION in this.parameters)) {
-      return undefined;
-    }
-    return this.parameters[Parameter.ROTATION].toString();
-  }
-
-  get castShadow(): boolean | undefined {
-    if (!(Parameter.CAST_SHADOW in this.parameters)) {
-      return undefined;
-    }
-    try {
-      return Parameter.parseBoolean(this.parameters[Parameter.CAST_SHADOW]);
-    } catch (e) {
-      return undefined;
-    }
-  }
-
-  public async show(): Promise<ParameterObservable> {
-    await this.commitParameter(Parameter.VISIBLE, true);
-    return this;
-  }
-
-  public async hide(): Promise<ParameterObservable> {
-    await this.commitParameter(Parameter.VISIBLE, false);
-    return this;
-  }
-
-  public async toggle(): Promise<ParameterObservable> {
-    await this.commitParameter(Parameter.VISIBLE, !this.visible);
-    return this;
-  }
-
-  public async toggleHighlight(): Promise<ParameterObservable> {
-    await this.commitParameter(Parameter.HIGHLIGHTED, !this.highlighted);
-    return this;
-  }
-}
+import { Parameter } from './parameter';
+import { ParameterObservable } from './parameterObservable';
+
+export abstract class Parameterizable extends ParameterObservable {
+  protected parameterDeclaration: ParameterDeclarations = Parameter.declarations;
+
+  get visible(): boolean | undefined {
+    if (!(Parameter.VISIBLE in this.parameters)) {
+      return undefined;
+    }
+    try {
+      return Parameter.parseBoolean(this.parameters[Parameter.VISIBLE]);
+    } catch (e) {
+      return undefined;
+    }
+  }
+
+  get highlighted(): boolean | undefined {
+    if (!(Parameter.HIGHLIGHTED in this.parameters)) {
+      return undefined;
+    }
+    try {
+      return Parameter.parseBoolean(this.parameters[Parameter.HIGHLIGHTED]);
+    } catch (e) {
+      return undefined;
+    }
+  }
+
+  get material(): string | undefined {
+    if (!(Parameter.MATERIAL in this.parameters)) {
+      return undefined;
+    }
+    return this.parameters[Parameter.MATERIAL].toString();
+  }
+
+  get scaling(): string | undefined {
+    if (!(Parameter.SCALING in this.parameters)) {
+      return undefined;
+    }
+    return this.parameters[Parameter.SCALING].toString();
+  }
+
+  get position(): string | undefined {
+    if (!(Parameter.POSITION in this.parameters)) {
+      return undefined;
+    }
+    return this.parameters[Parameter.POSITION].toString();
+  }
+
+  get rotation(): string | undefined {
+    if (!(Parameter.ROTATION in this.parameters)) {
+      return undefined;
+    }
+    return this.parameters[Parameter.ROTATION].toString();
+  }
+
+  get castShadow(): boolean | undefined {
+    if (!(Parameter.CAST_SHADOW in this.parameters)) {
+      return undefined;
+    }
+    try {
+      return Parameter.parseBoolean(this.parameters[Parameter.CAST_SHADOW]);
+    } catch (e) {
+      return undefined;
+    }
+  }
+
+  public async show(): Promise<ParameterObservable> {
+    await this.commitParameter(Parameter.VISIBLE, true);
+    return this;
+  }
+
+  public async hide(): Promise<ParameterObservable> {
+    await this.commitParameter(Parameter.VISIBLE, false);
+    return this;
+  }
+
+  public async toggle(): Promise<ParameterObservable> {
+    await this.commitParameter(Parameter.VISIBLE, !this.visible);
+    return this;
+  }
+
+  public async toggleHighlight(): Promise<ParameterObservable> {
+    await this.commitParameter(Parameter.HIGHLIGHTED, !this.highlighted);
+    return this;
+  }
+}