@combeenation/3d-viewer 7.0.0 → 7.1.0

package/src/api/classes/dottedPath.ts

@@ -1,181 +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[] {
-    const 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[] {
+    const 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);
+  }
+}