@combeenation/3d-viewer 4.0.0-beta2 → 4.0.0-rc1

package/src/api/classes/parameterObservable.ts

@@ -1,121 +1,99 @@
-import { merge } from 'lodash-es';
-import { Parameter } from '../classes/parameter';
-import { uuidv4 } from '../util/resourceHelper';
-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}".`;
-		switch( declaration.type ) {
-			case 'boolean':
-				try {
-					Parameter.parseBoolean( value );
-				} catch( e ) {
-					throw Error( genericError );
-				}
-				break;
-			case 'number':
-				try {
-					Parameter.parseNumber( value );
-				} catch( e ) {
-					throw Error( genericError );
-				}
-				break;
-			case 'color':
-				try {
-					Parameter.parseColor( value );
-				} catch( e ) {
-					throw Error( genericError +	` It must be hex with leading "#" or of format "(r,g,b)".` );
-				}
-				break;
-			case 'vector':
-				try {
-					Parameter.parseVector( value );
-				} catch( e ) {
-					throw Error( genericError + ` It must be of format "(x,y,z)".` );
-				}
-				break;
-			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 { 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;
+		}
+	}
+
+}

package/src/api/classes/{elementParameterizable.ts → parameterizable.ts}

@@ -1,78 +1,89 @@
-import { Parameter } from './parameter';
-import { ParameterObservable } from './parameterObservable';
-
-export abstract class ElementParameterizable 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();
-	}
-
-	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;
+	}
+
+}