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

package/src/api/classes/dottedPath.ts

@@ -1,189 +1,189 @@
-export class DottedPath {
-
-	static DELIMITER: string = '.';
-
-	static SAFE_CHAR: string = '·';
-
-	public parts: string[] = [];
-
-	/**
-	 * Magic factory function that creates a DottedPath based on the argument type.
-	 */
-	public static create( dottedPath?: DottedPathArgument ): DottedPath {
-		if( dottedPath?.constructor === DottedPath ) {
-			return (dottedPath as DottedPath).clone();
-		}
-		if( dottedPath?.constructor === String ) {
-			return DottedPath.createFromPath( dottedPath as string );
-		}
-		if( dottedPath?.constructor === Array ) {
-			return DottedPath.createFromParts( dottedPath as string[] );
-		}
-		return DottedPath.createEmpty();
-	}
-
-	/**
-	 * Creates a DottedPath from a string.
-	 * Allows patterns with unsafe characters wrapped in apostrophes or quotes.
-	 * E.g. "part1.part2.'part.3'.part_4"
-	 */
-	public static createFromPath( path: string ): DottedPath {
-		if( path.length === 0 ) {
-			return this.createEmpty();
-		}
-		if ( path.indexOf("'") > -1 || path.indexOf('"') > -1 ) {
-			const bd = '[\'|"]';
-			const search = new RegExp(`${bd}(.*)${bd}`, 'g');
-			let matches = search.exec(path);
-			while (matches !== null) {
-				const _search = new RegExp(`${bd}${matches[1]}${bd}`, 'g');
-				path = path.replace(_search, this.sanitizePart(matches[1]));
-				matches = search.exec(path);
-			}
-		}
-		return this.createFromParts( path.split( DottedPath.DELIMITER ) );
-	}
-
-	/**
-	 * Creates a DottedPath from a string list.
-	 */
-	public static createFromParts( parts: string[] ): DottedPath {
-		const dottedPath = new DottedPath();
-		parts.forEach( part => dottedPath.addPart( part ) );
-		return dottedPath;
-	}
-
-	/**
-	 * Creates an empty DottedPath.
-	 */
-	public static createEmpty(): DottedPath {
-		return new DottedPath();
-	}
-
-	/**
-	 * Sanitizes given part: replaces all characters like {@link DottedPath.DELIMITER}
-	 * with a "safe" character like {@link DottedPath.SAFE_CHAR}.
-	 * (i) Does not trim whitespace.
-	 */
-	public static sanitizePart(part: string): string {
-		return part.split( DottedPath.DELIMITER ).join( DottedPath.SAFE_CHAR );
-	}
-
-	/**
-	 * Constructor
-	 */
-	private constructor() {
-	}
-
-	/**
-	 * The path.
-	 * (i) Does not return an empty dot for no path.
-	 */
-	get path(): string {
-		return this.parts.length > 0
-			? this.parts.join(DottedPath.DELIMITER)
-			: '';
-	}
-
-	/**
-	 * The first part.
-	 */
-	get firstPart(): string | null {
-		if( this.parts.length > 0 ) {
-			return this.parts[0];
-		}
-		return null;
-	}
-
-	/**
-	 * The last part.
-	 */
-	get lastPart(): string | null {
-		if( this.parts.length > 0 ) {
-			return this.parts[this.parts.length - 1];
-		}
-		return null;
-	}
-
-	/**
-	 * Gets the tokens to each leaf of the DottedPath tree.
-	 * E.g. "part1.part2.part_3" will return an array like
-	 *      ["part1", "part1.part2", "part1.part2.part_3"]
-	 */
-	get leafTokens(): string[] {
-		let parents: string[] = [];
-		return this.parts.map( part => {
-			parents.push( part );
-			return DottedPath.create( parents ).path;
-		} );
-	}
-
-	/**
-	 * Removes the first part and returns it.
-	 */
-	public shiftPart(): string | undefined {
-		return this.parts.shift();
-	}
-
-	/**
-	 * Adds part to the beginning of parts list.
-	 */
-	public unshiftPart( part: string, duplicateCheck: boolean = false ): DottedPath {
-		part = DottedPath.sanitizePart( part );
-		if( duplicateCheck && this.firstPart === part ) {
-			return this;
-		}
-		this.parts.unshift( part );
-		return this;
-	}
-
-	/**
-	 * Adds part to the end of parts list.
-	 * (i) Does not add a part if the last char already is the delimiter or if an empty string was passed.
-	 */
-	public addPart(part: string, duplicateCheck: boolean = false): DottedPath {
-		if (
-			part.length < 1
-			|| this.lastPart === DottedPath.DELIMITER
-		) {
-			return this
-		}
-		part = DottedPath.sanitizePart(part);
-		if (duplicateCheck && this.lastPart === part) {
-			return this;
-		}
-		this.parts.push( part );
-		return this;
-	}
-
-	/**
-	 * Adds multiple parts to the end of parts list.
-	 */
-	public addParts( parts: string[], duplicateCheck: boolean = false ): DottedPath {
-		parts.forEach( part => this.addPart( part, duplicateCheck ) );
-		return this;
-	}
-
-	/**
-	 * Removes the last part and returns it.
-	 */
-	public popPart(): string | undefined {
-		return this.parts.pop();
-	}
-
-	public toString(): string {
-		return this.path;
-	}
-
-	public valueOf(): string {
-		return this.path;
-	}
-
-	/**
-	 * Clones the DottedPath.
-	 */
-	public clone(): DottedPath {
-		return DottedPath.createFromParts( this.parts );
-	}
-
-}
+export class DottedPath {
+
+	static DELIMITER: string = '.';
+
+	static SAFE_CHAR: string = '·';
+
+	public parts: string[] = [];
+
+	/**
+	 * Magic factory function that creates a DottedPath based on the argument type.
+	 */
+	public static create( dottedPath?: DottedPathArgument ): DottedPath {
+		if( dottedPath?.constructor === DottedPath ) {
+			return (dottedPath as DottedPath).clone();
+		}
+		if( dottedPath?.constructor === String ) {
+			return DottedPath.createFromPath( dottedPath as string );
+		}
+		if( dottedPath?.constructor === Array ) {
+			return DottedPath.createFromParts( dottedPath as string[] );
+		}
+		return DottedPath.createEmpty();
+	}
+
+	/**
+	 * Creates a DottedPath from a string.
+	 * Allows patterns with unsafe characters wrapped in apostrophes or quotes.
+	 * E.g. "part1.part2.'part.3'.part_4"
+	 */
+	public static createFromPath( path: string ): DottedPath {
+		if( path.length === 0 ) {
+			return this.createEmpty();
+		}
+		if ( path.indexOf("'") > -1 || path.indexOf('"') > -1 ) {
+			const bd = '[\'|"]';
+			const search = new RegExp(`${bd}(.*)${bd}`, 'g');
+			let matches = search.exec(path);
+			while (matches !== null) {
+				const _search = new RegExp(`${bd}${matches[1]}${bd}`, 'g');
+				path = path.replace(_search, this.sanitizePart(matches[1]));
+				matches = search.exec(path);
+			}
+		}
+		return this.createFromParts( path.split( DottedPath.DELIMITER ) );
+	}
+
+	/**
+	 * Creates a DottedPath from a string list.
+	 */
+	public static createFromParts( parts: string[] ): DottedPath {
+		const dottedPath = new DottedPath();
+		parts.forEach( part => dottedPath.addPart( part ) );
+		return dottedPath;
+	}
+
+	/**
+	 * Creates an empty DottedPath.
+	 */
+	public static createEmpty(): DottedPath {
+		return new DottedPath();
+	}
+
+	/**
+	 * Sanitizes given part: replaces all characters like {@link DottedPath.DELIMITER}
+	 * with a "safe" character like {@link DottedPath.SAFE_CHAR}.
+	 * (i) Does not trim whitespace.
+	 */
+	public static sanitizePart(part: string): string {
+		return part.split( DottedPath.DELIMITER ).join( DottedPath.SAFE_CHAR );
+	}
+
+	/**
+	 * Constructor
+	 */
+	private constructor() {
+	}
+
+	/**
+	 * The path.
+	 * (i) Does not return an empty dot for no path.
+	 */
+	get path(): string {
+		return this.parts.length > 0
+			? this.parts.join(DottedPath.DELIMITER)
+			: '';
+	}
+
+	/**
+	 * The first part.
+	 */
+	get firstPart(): string | null {
+		if( this.parts.length > 0 ) {
+			return this.parts[0];
+		}
+		return null;
+	}
+
+	/**
+	 * The last part.
+	 */
+	get lastPart(): string | null {
+		if( this.parts.length > 0 ) {
+			return this.parts[this.parts.length - 1];
+		}
+		return null;
+	}
+
+	/**
+	 * Gets the tokens to each leaf of the DottedPath tree.
+	 * E.g. "part1.part2.part_3" will return an array like
+	 *      ["part1", "part1.part2", "part1.part2.part_3"]
+	 */
+	get leafTokens(): string[] {
+		let parents: string[] = [];
+		return this.parts.map( part => {
+			parents.push( part );
+			return DottedPath.create( parents ).path;
+		} );
+	}
+
+	/**
+	 * Removes the first part and returns it.
+	 */
+	public shiftPart(): string | undefined {
+		return this.parts.shift();
+	}
+
+	/**
+	 * Adds part to the beginning of parts list.
+	 */
+	public unshiftPart( part: string, duplicateCheck: boolean = false ): DottedPath {
+		part = DottedPath.sanitizePart( part );
+		if( duplicateCheck && this.firstPart === part ) {
+			return this;
+		}
+		this.parts.unshift( part );
+		return this;
+	}
+
+	/**
+	 * Adds part to the end of parts list.
+	 * (i) Does not add a part if the last char already is the delimiter or if an empty string was passed.
+	 */
+	public addPart(part: string, duplicateCheck: boolean = false): DottedPath {
+		if (
+			part.length < 1
+			|| this.lastPart === DottedPath.DELIMITER
+		) {
+			return this
+		}
+		part = DottedPath.sanitizePart(part);
+		if (duplicateCheck && this.lastPart === part) {
+			return this;
+		}
+		this.parts.push( part );
+		return this;
+	}
+
+	/**
+	 * Adds multiple parts to the end of parts list.
+	 */
+	public addParts( parts: string[], duplicateCheck: boolean = false ): DottedPath {
+		parts.forEach( part => this.addPart( part, duplicateCheck ) );
+		return this;
+	}
+
+	/**
+	 * Removes the last part and returns it.
+	 */
+	public popPart(): string | undefined {
+		return this.parts.pop();
+	}
+
+	public toString(): string {
+		return this.path;
+	}
+
+	public valueOf(): string {
+		return this.path;
+	}
+
+	/**
+	 * Clones the DottedPath.
+	 */
+	public clone(): DottedPath {
+		return DottedPath.createFromParts( this.parts );
+	}
+
+}