@combeenation/3d-viewer 4.2.0 → 4.3.0-alpha1

package/src/api/classes/parameter.ts

@@ -2,407 +2,404 @@ import { Color3 } from '@babylonjs/core/Maths/math.color';
 import { Vector3 } from '@babylonjs/core/Maths/math.vector';
 import { get, isEmpty, isNumber, isString } from 'lodash-es';
 
-
 /**
  * This `Parameter` class defines all parameters that can be consumed and committed by a {@link ParameterObservable}.
  * Use {@link ParameterObservable.addParameterObserver} or {@link ParameterObservable.commitParameters} to either add or
  * commit parameters on your observable objects.
  */
 export class Parameter {
-
-	/**
-	 * Constructor.
-	 */
-	private constructor() {}
-
-	/**
-	 * Mutates the visibility. Helper methods are {@link VariantParameterizable.show} and
-	 * {@link VariantParameterizable.hide}. Getter and setter is {@link VariantParameterizable.visible}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 * * {@link ViewerLight} Available for all light types
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly VISIBLE = 'visible';
-
-	/**
-	 * Stretches or compresses some meshes. Getter and setter is {@link VariantParameterizable.scaling}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseScaling}
-	 */
-	public static readonly SCALING = 'scaling';
-
-	/**
-	 * Mutates the material. Getter and setter is {@link VariantParameterizable.material}. The value of this parameter
-	 * represents the ID of a baked-in glTF or custom created material in the {@link Variant} tree.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser string
-	 */
-	public static readonly MATERIAL = 'material';
-
-	/**
-	 * Mutates the material color.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseColor}
-	 */
-	public static readonly MATERIAL_COLOR = 'material.color';
-
-	/**
-	 * Mutates the material metallness.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly MATERIAL_METALLNESS = 'material.metallness';
-
-	/**
-	 * Mutates the material roughness.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly MATERIAL_ROUGHNESS = 'material.roughness';
-
-	/**
-	 * Mutates whether a highlight layer should be enabled.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly HIGHLIGHT_ENABLED = 'highlight.enabled';
-
-	/**
-	 * Changes the highlight color.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseColor}
-	 */
-	public static readonly HIGHLIGHT_COLOR = 'highlight.color';
-
-	/**
-	 * Mutates the highlighted state. Getter and setter is {@link VariantParameterizable.highlighted}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly HIGHLIGHTED = 'highlighted';
-
-	/**
-	 * Mutates the position relative to its origin position. Getter and setter is {@link VariantParameterizable.position}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#position), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#position), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#position)
-	 *
-	 * @parser {@link parseVector}
-	 */
-	public static readonly POSITION = 'position';
-
-	/**
-	 * Mutates the rotation relative to its origin rotation. Getter and setter is {@link VariantParameterizable.rotation}.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseRotation}
-	 */
-	public static readonly ROTATION = 'rotation';
-
-	/**
-	 * Mutates whether a shadow should be casted or not.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly CAST_SHADOW = 'castShadow';
-
-	/**
-	 * Mutates from which lights a shadow should be casted.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseCommaSeparatedList}
-	 */
-	public static readonly CAST_SHADOW_FROM_LIGHTS = 'castShadow.fromLights';
-
-	/**
-	 * Mutates whether to receive shadows or not.
-	 *
-	 * Scopes:
-	 * * {@link Element}
-	 * * {@link Variant}
-	 *
-	 * @parser {@link parseBoolean}
-	 */
-	public static readonly RECEIVE_SHADOWS = 'receiveShadows';
-
-	/**
-	 * Mutates the intensity of Lights.
-	 *
-	 * Scopes:
-	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#intensity), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#intensity), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#intensity), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#intensity)
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly INTENSITY = 'intensity';
-
-	/**
-	 * Mutates the direction of Lights.
-	 *
-	 * Scopes:
-	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#direction), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#direction), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#direction), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#direction)
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly DIRECTION = 'direction';
-
-	/**
-	 * Mutates the angle of Lights.
-	 *
-	 * Scopes:
-	 * * {@link ViewerLight} Available for [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#angle)
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly ANGLE = 'angle';
-
-	/**
-	 * Mutates the exponent of Lights.
-	 *
-	 * Scopes:
-	 * * {@link ViewerLight} Available for [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#exponent)
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly EXPONENT = 'exponent';
-
-	/**
-	 * Mutates the diffuse color of Lights.
-	 *
-	 * Scopes:
-	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#diffuse), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#diffuse), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#diffuse), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#diffuse)
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly DIFFUSE = 'diffuse';
-
-	/**
-	 * Mutates the specular color of Lights.
-	 *
-	 * Scopes:
-	 * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#specular), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#specular), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#specular), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#specular)
-	 *
-	 * @parser {@link parseNumber}
-	 */
-	public static readonly SPECULAR = 'specular';
-
-	/**
-	 * The {@link ParameterDeclarations} for all parameters in this class.
-	 */
-	public static get declarations(): ParameterDeclarations {
-		const declarations: ParameterDeclarations = {};
-		declarations[Parameter.VISIBLE] = { type: 'boolean', parser: Parameter.parseBoolean };
-		declarations[Parameter.SCALING] = { type: 'number', parser: Parameter.parseNumber };
-		declarations[Parameter.POSITION] = { type: 'vector', parser: Parameter.parseVector };
-		declarations[Parameter.ROTATION] = { type: 'vector', parser: Parameter.parseVector };
-		declarations[Parameter.HIGHLIGHTED] = { type: 'boolean', parser: Parameter.parseBoolean };
-		declarations[Parameter.MATERIAL] = { type: 'string' };
-		declarations[Parameter.MATERIAL_COLOR] = { type: 'color', parser: Parameter.parseColor };
-		declarations[Parameter.MATERIAL_METALLNESS] = { type: 'number', parser: Parameter.parseNumber };
-		declarations[Parameter.MATERIAL_ROUGHNESS] = { type: 'number', parser: Parameter.parseNumber };
-		declarations[Parameter.HIGHLIGHT_ENABLED] = { type: 'boolean', parser: Parameter.parseBoolean };
-		declarations[Parameter.HIGHLIGHT_COLOR] = { type: 'color', parser: Parameter.parseColor };
-		declarations[Parameter.HIGHLIGHTED] = { type: 'boolean', parser: Parameter.parseBoolean };
-		declarations[Parameter.CAST_SHADOW] = { type: 'boolean', parser: Parameter.parseBoolean };
-		declarations[Parameter.CAST_SHADOW_FROM_LIGHTS] = { type: 'csl', parser: Parameter.parseCommaSeparatedList };
-		declarations[Parameter.RECEIVE_SHADOWS] = { type: 'boolean', parser: Parameter.parseBoolean };
-		declarations[Parameter.INTENSITY] = { type: 'number', parser: Parameter.parseNumber };
-		declarations[Parameter.DIRECTION] = { type: 'vector', parser: Parameter.parseVector };
-		declarations[Parameter.ANGLE] = { type: 'number', parser: Parameter.parseNumber };
-		declarations[Parameter.EXPONENT] = { type: 'number', parser: Parameter.parseNumber };
-		declarations[Parameter.DIFFUSE] = { type: 'color', parser: Parameter.parseColor };
-		declarations[Parameter.SPECULAR] = { type: 'color', parser: Parameter.parseColor };
-		return declarations;
-	}
-
-	/**
-	 * Gets the {@link ParameterDeclaration} for a given {@link Parameter} declared in this class.
-	 */
-	public static getDeclaration(parameter: string): ParameterDeclaration {
-		return Parameter.declarations[parameter];
-	}
-
-	/**
-	 * All parameters defined in this class.
-	 */
-	public static get all() {
-		const all: string[] = [];
-		for( const parameter in Parameter ) {
-			const property = Object.getOwnPropertyDescriptor(Parameter, parameter);
-			if( parameter.toUpperCase() === parameter && property && isString( property.value ) ) {
-				all.push( property.value );
-			}
-		}
-		return all;
-	}
-
-	/**
-	 * Parses given {@link ParameterBag} with given {@link ParameterDeclarations}.
-	 */
-	public static parseFromDeclarations( declarations: ParameterDeclarations, parameterBag: ParameterBag ): ParsedParameterBag {
-		const parameters: ParsedParameterBag = {};
-		for( const parameter in parameterBag ) {
-			const value = get( parameterBag, parameter );
-			parameters[parameter] = value;
-			const declaration: ParameterDeclaration = declarations[parameter];
-			if( declaration ) {
-				if( !isEmpty( value ) && declaration.parser ) {
-					parameters[parameter] = declaration.parser( value );
-				}
-			}
-		}
-		return parameters;
-	}
-
-	/**
-	 * Parses a string of format `'(x,y,z)'` to a `Vector3`.
-	 */
-	public static parseVector( value: ParameterValue ): Vector3 {
-		if( !isString( value ) ) {
-			throw new Error( `Unable to convert "${value}" into a Vector: not a string.` );
-		}
-		let cleanedValue = value.split( ' ' ).join( '' );
-		if( cleanedValue.startsWith( '(' ) && cleanedValue.endsWith( ')' ) ) {
-			cleanedValue = cleanedValue.substring( 1, cleanedValue.length - 1 );
-			let [x, y, z] = cleanedValue.split( ',' ).map( value => parseFloat( value ) );
-			return new Vector3( x, y, z );
-		} else {
-			throw new Error( `Unable to parse "${value}" to a Vector: expected "(x,y,z)".` );
-		}
-	}
-
-	/**
-	 * Stringifies a Vector3 to format `(x,y,z)`.
-	 */
-	public static stringifyVector( value: Vector3 ): string {
-		return `(${value.x},${value.y},${value.z})`;
-	}
-
-	/**
-	 * Parses a string of format `'(x,y,z)'` with angular degrees to a `Vector3` with rotation information in radians.
-	 */
-	public static parseRotation( value: ParameterValue ): Vector3 {
-		const rotation = Parameter.parseVector( value );
-		const deg2rad = function( deg: number ) {
-			return deg * Math.PI / 180;
-		};
-		return rotation.set(
-			deg2rad( rotation.x ),
-			deg2rad( rotation.y ),
-			deg2rad( rotation.z )
-		);
-	}
-
-	/**
-	 * Parses a string of format `'(x,y,z)'` or a simple `number` to a `Vector3` for scaling.
-	 */
-	public static parseScaling( value: ParameterValue ): Vector3 {
-		let scaling = new Vector3();
-		if( isString( value ) ) {
-			const cleanedFactor = value.split( ' ' ).join( '' );
-			if( cleanedFactor.startsWith( '(' ) && cleanedFactor.endsWith( ')' ) ) {
-				scaling = Parameter.parseVector( cleanedFactor );
-			} else {
-				const _factor = parseFloat( value );
-				scaling = new Vector3( _factor, _factor, _factor );
-			}
-		} else if( isNumber( value ) ) {
-			scaling = new Vector3( value, value, value );
-		} else {
-			throw new Error( `Unable to convert "${value}" to a Vector: expected "(x,y,z)".` );
-		}
-		return scaling;
-	}
-
-	/**
-	 * Parses a string of format `'#rrggbb'` or `'(r,g,b)'` to a `Color3`.
-	 */
-	public static parseColor( value: ParameterValue ): Color3 {
-		let cleanedValue = value.toString().split( ' ' ).join( '' );
-		if( cleanedValue.startsWith( '#' ) ) {
-			return Color3.FromHexString( value.toString() );
-		}
-		if( cleanedValue.startsWith( '(' ) && cleanedValue.endsWith( ')' ) ) {
-			cleanedValue = cleanedValue.substring( 1, cleanedValue.length - 1 );
-			let [r, g, b] = cleanedValue.split( ',' ).map( value => parseFloat( value ) );
-			return Color3.FromInts( r, g, b );
-		}
-		throw new Error( `Unable to parse "${value}" to a Color: expected "#rrggbb" or "(r,g,b)".` );
-	}
-
-	/**
-	 * Parses a `boolean` string (`'true'`/`'1'` or `'false'`/`'0'`) or `number` (`1` or `0`) to a `boolean` or `undefined`.
-	 */
-	public static parseBoolean( value: ParameterValue ): boolean {
-		if( value.toString() === 'true' || value.toString() === '1' ) {
-			return true;
-		} else if( value.toString() === 'false' || value.toString() === '0' ) {
-			return false;
-		}
-		throw new Error( `Unable to parse "${value}" to a boolean.` );
-	}
-
-	/**
-	 * Parses a number `string` to a `number`.
-	 */
-	public static parseNumber( value: ParameterValue ): number {
-		return parseFloat( value.toString() );
-	}
-
-	/**
-	 * Parses a string with comma separated values to a list of strings.
-	 */
-	public static parseCommaSeparatedList( value: ParameterValue ): string[] {
-		return value.toString()
-			.split( ',' )
-			.map( s => s.trim() );
-	}
-
+  /**
+   * Constructor.
+   */
+  private constructor() {}
+
+  /**
+   * Mutates the visibility. Helper methods are {@link VariantParameterizable.show} and
+   * {@link VariantParameterizable.hide}. Getter and setter is {@link VariantParameterizable.visible}.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   * * {@link ViewerLight} Available for all light types
+   *
+   * @parser {@link parseBoolean}
+   */
+  public static readonly VISIBLE = 'visible';
+
+  /**
+   * Stretches or compresses some meshes. Getter and setter is {@link VariantParameterizable.scaling}.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseScaling}
+   */
+  public static readonly SCALING = 'scaling';
+
+  /**
+   * Mutates the material. Getter and setter is {@link VariantParameterizable.material}. The value of this parameter
+   * represents the ID of a baked-in glTF or custom created material in the {@link Variant} tree.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser string
+   */
+  public static readonly MATERIAL = 'material';
+
+  /**
+   * Mutates the material color.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseColor}
+   */
+  public static readonly MATERIAL_COLOR = 'material.color';
+
+  /**
+   * Mutates the material metallness.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly MATERIAL_METALLNESS = 'material.metallness';
+
+  /**
+   * Mutates the material roughness.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly MATERIAL_ROUGHNESS = 'material.roughness';
+
+  /**
+   * Mutates whether a highlight layer should be enabled.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseBoolean}
+   */
+  public static readonly HIGHLIGHT_ENABLED = 'highlight.enabled';
+
+  /**
+   * Changes the highlight color.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseColor}
+   */
+  public static readonly HIGHLIGHT_COLOR = 'highlight.color';
+
+  /**
+   * Mutates the highlighted state. Getter and setter is {@link VariantParameterizable.highlighted}.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseBoolean}
+   */
+  public static readonly HIGHLIGHTED = 'highlighted';
+
+  /**
+   * Mutates the position relative to its origin position. Getter and setter is {@link VariantParameterizable.position}.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#position), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#position), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#position)
+   *
+   * @parser {@link parseVector}
+   */
+  public static readonly POSITION = 'position';
+
+  /**
+   * Mutates the rotation relative to its origin rotation. Getter and setter is {@link VariantParameterizable.rotation}.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseRotation}
+   */
+  public static readonly ROTATION = 'rotation';
+
+  /**
+   * Mutates whether a shadow should be casted or not.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseBoolean}
+   */
+  public static readonly CAST_SHADOW = 'castShadow';
+
+  /**
+   * Mutates from which lights a shadow should be casted.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseCommaSeparatedList}
+   */
+  public static readonly CAST_SHADOW_FROM_LIGHTS = 'castShadow.fromLights';
+
+  /**
+   * Mutates whether to receive shadows or not.
+   *
+   * Scopes:
+   * * {@link Element}
+   * * {@link Variant}
+   *
+   * @parser {@link parseBoolean}
+   */
+  public static readonly RECEIVE_SHADOWS = 'receiveShadows';
+
+  /**
+   * Mutates the intensity of Lights.
+   *
+   * Scopes:
+   * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#intensity), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#intensity), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#intensity), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#intensity)
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly INTENSITY = 'intensity';
+
+  /**
+   * Mutates the direction of Lights.
+   *
+   * Scopes:
+   * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#direction), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#direction), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#direction), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#direction)
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly DIRECTION = 'direction';
+
+  /**
+   * Mutates the angle of Lights.
+   *
+   * Scopes:
+   * * {@link ViewerLight} Available for [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#angle)
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly ANGLE = 'angle';
+
+  /**
+   * Mutates the exponent of Lights.
+   *
+   * Scopes:
+   * * {@link ViewerLight} Available for [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#exponent)
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly EXPONENT = 'exponent';
+
+  /**
+   * Mutates the diffuse color of Lights.
+   *
+   * Scopes:
+   * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#diffuse), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#diffuse), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#diffuse), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#diffuse)
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly DIFFUSE = 'diffuse';
+
+  /**
+   * Mutates the specular color of Lights.
+   *
+   * Scopes:
+   * * {@link ViewerLight} Available for [PointLight](https://doc.babylonjs.com/typedoc/classes/babylon.pointlight#specular), [SpotLight](https://doc.babylonjs.com/typedoc/classes/babylon.spotlight#specular), [DirectionalLight](https://doc.babylonjs.com/typedoc/classes/babylon.directionallight#specular), [HemisphericLight](https://doc.babylonjs.com/typedoc/classes/babylon.hemisphericlight#specular)
+   *
+   * @parser {@link parseNumber}
+   */
+  public static readonly SPECULAR = 'specular';
+
+  /**
+   * The {@link ParameterDeclarations} for all parameters in this class.
+   */
+  public static get declarations(): ParameterDeclarations {
+    const declarations: ParameterDeclarations = {};
+    declarations[Parameter.VISIBLE] = { type: 'boolean', parser: Parameter.parseBoolean };
+    declarations[Parameter.SCALING] = { type: 'number', parser: Parameter.parseNumber };
+    declarations[Parameter.POSITION] = { type: 'vector', parser: Parameter.parseVector };
+    declarations[Parameter.ROTATION] = { type: 'vector', parser: Parameter.parseVector };
+    declarations[Parameter.HIGHLIGHTED] = { type: 'boolean', parser: Parameter.parseBoolean };
+    declarations[Parameter.MATERIAL] = { type: 'string' };
+    declarations[Parameter.MATERIAL_COLOR] = { type: 'color', parser: Parameter.parseColor };
+    declarations[Parameter.MATERIAL_METALLNESS] = { type: 'number', parser: Parameter.parseNumber };
+    declarations[Parameter.MATERIAL_ROUGHNESS] = { type: 'number', parser: Parameter.parseNumber };
+    declarations[Parameter.HIGHLIGHT_ENABLED] = { type: 'boolean', parser: Parameter.parseBoolean };
+    declarations[Parameter.HIGHLIGHT_COLOR] = { type: 'color', parser: Parameter.parseColor };
+    declarations[Parameter.HIGHLIGHTED] = { type: 'boolean', parser: Parameter.parseBoolean };
+    declarations[Parameter.CAST_SHADOW] = { type: 'boolean', parser: Parameter.parseBoolean };
+    declarations[Parameter.CAST_SHADOW_FROM_LIGHTS] = { type: 'csl', parser: Parameter.parseCommaSeparatedList };
+    declarations[Parameter.RECEIVE_SHADOWS] = { type: 'boolean', parser: Parameter.parseBoolean };
+    declarations[Parameter.INTENSITY] = { type: 'number', parser: Parameter.parseNumber };
+    declarations[Parameter.DIRECTION] = { type: 'vector', parser: Parameter.parseVector };
+    declarations[Parameter.ANGLE] = { type: 'number', parser: Parameter.parseNumber };
+    declarations[Parameter.EXPONENT] = { type: 'number', parser: Parameter.parseNumber };
+    declarations[Parameter.DIFFUSE] = { type: 'color', parser: Parameter.parseColor };
+    declarations[Parameter.SPECULAR] = { type: 'color', parser: Parameter.parseColor };
+    return declarations;
+  }
+
+  /**
+   * Gets the {@link ParameterDeclaration} for a given {@link Parameter} declared in this class.
+   */
+  public static getDeclaration(parameter: string): ParameterDeclaration {
+    return Parameter.declarations[parameter];
+  }
+
+  /**
+   * All parameters defined in this class.
+   */
+  public static get all() {
+    const all: string[] = [];
+    for (const parameter in Parameter) {
+      const property = Object.getOwnPropertyDescriptor(Parameter, parameter);
+      if (parameter.toUpperCase() === parameter && property && isString(property.value)) {
+        all.push(property.value);
+      }
+    }
+    return all;
+  }
+
+  /**
+   * Parses given {@link ParameterBag} with given {@link ParameterDeclarations}.
+   */
+  public static parseFromDeclarations(
+    declarations: ParameterDeclarations,
+    parameterBag: ParameterBag
+  ): ParsedParameterBag {
+    const parameters: ParsedParameterBag = {};
+    for (const parameter in parameterBag) {
+      const value = get(parameterBag, parameter);
+      parameters[parameter] = value;
+      const declaration: ParameterDeclaration = declarations[parameter];
+      if (declaration) {
+        if (!isEmpty(value) && declaration.parser) {
+          parameters[parameter] = declaration.parser(value);
+        }
+      }
+    }
+    return parameters;
+  }
+
+  /**
+   * Parses a string of format `'(x,y,z)'` to a `Vector3`.
+   */
+  public static parseVector(value: ParameterValue): Vector3 {
+    if (!isString(value)) {
+      throw new Error(`Unable to convert "${value}" into a Vector: not a string.`);
+    }
+    let cleanedValue = value.split(' ').join('');
+    if (cleanedValue.startsWith('(') && cleanedValue.endsWith(')')) {
+      cleanedValue = cleanedValue.substring(1, cleanedValue.length - 1);
+      let [x, y, z] = cleanedValue.split(',').map(value => parseFloat(value));
+      return new Vector3(x, y, z);
+    } else {
+      throw new Error(`Unable to parse "${value}" to a Vector: expected "(x,y,z)".`);
+    }
+  }
+
+  /**
+   * Stringifies a Vector3 to format `(x,y,z)`.
+   */
+  public static stringifyVector(value: Vector3): string {
+    return `(${value.x},${value.y},${value.z})`;
+  }
+
+  /**
+   * Parses a string of format `'(x,y,z)'` with angular degrees to a `Vector3` with rotation information in radians.
+   */
+  public static parseRotation(value: ParameterValue): Vector3 {
+    const rotation = Parameter.parseVector(value);
+    const deg2rad = function (deg: number) {
+      return (deg * Math.PI) / 180;
+    };
+    return rotation.set(deg2rad(rotation.x), deg2rad(rotation.y), deg2rad(rotation.z));
+  }
+
+  /**
+   * Parses a string of format `'(x,y,z)'` or a simple `number` to a `Vector3` for scaling.
+   */
+  public static parseScaling(value: ParameterValue): Vector3 {
+    let scaling = new Vector3();
+    if (isString(value)) {
+      const cleanedFactor = value.split(' ').join('');
+      if (cleanedFactor.startsWith('(') && cleanedFactor.endsWith(')')) {
+        scaling = Parameter.parseVector(cleanedFactor);
+      } else {
+        const _factor = parseFloat(value);
+        scaling = new Vector3(_factor, _factor, _factor);
+      }
+    } else if (isNumber(value)) {
+      scaling = new Vector3(value, value, value);
+    } else {
+      throw new Error(`Unable to convert "${value}" to a Vector: expected "(x,y,z)".`);
+    }
+    return scaling;
+  }
+
+  /**
+   * Parses a string of format `'#rrggbb'` or `'(r,g,b)'` to a `Color3`.
+   */
+  public static parseColor(value: ParameterValue): Color3 {
+    let cleanedValue = value.toString().split(' ').join('');
+    if (cleanedValue.startsWith('#')) {
+      return Color3.FromHexString(value.toString());
+    }
+    if (cleanedValue.startsWith('(') && cleanedValue.endsWith(')')) {
+      cleanedValue = cleanedValue.substring(1, cleanedValue.length - 1);
+      let [r, g, b] = cleanedValue.split(',').map(value => parseFloat(value));
+      return Color3.FromInts(r, g, b);
+    }
+    throw new Error(`Unable to parse "${value}" to a Color: expected "#rrggbb" or "(r,g,b)".`);
+  }
+
+  /**
+   * Parses a `boolean` string (`'true'`/`'1'` or `'false'`/`'0'`) or `number` (`1` or `0`) to a `boolean` or `undefined`.
+   */
+  public static parseBoolean(value: ParameterValue): boolean {
+    if (value.toString() === 'true' || value.toString() === '1') {
+      return true;
+    } else if (value.toString() === 'false' || value.toString() === '0') {
+      return false;
+    }
+    throw new Error(`Unable to parse "${value}" to a boolean.`);
+  }
+
+  /**
+   * Parses a number `string` to a `number`.
+   */
+  public static parseNumber(value: ParameterValue): number {
+    return parseFloat(value.toString());
+  }
+
+  /**
+   * Parses a string with comma separated values to a list of strings.
+   */
+  public static parseCommaSeparatedList(value: ParameterValue): string[] {
+    return value
+      .toString()
+      .split(',')
+      .map(s => s.trim());
+  }
 }