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

package/src/api/classes/dottedPath.ts

@@ -1,189 +1,181 @@
 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 );
-	}
-
+  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);
+  }
 }