@opensumi/ide-utils 2.21.13 → 2.22.0

package/src/path.ts

@@ -0,0 +1,1885 @@
+import { isWindows } from './platform';
+import * as process from './process';
+
+const SystemPathSeparatorRegex = isWindows ? /\\/g : /\//g;
+/**
+ * On POSIX:
+ * ┌──────────────────────┬────────────┐
+ * │          dir         │    base    │
+ * ├──────┬               ├──────┬─────┤
+ * │ root │               │ name │ ext │
+ * "  /     home/user/dir / file  .txt "
+ * └──────┴───────────────┴──────┴─────┘
+ *
+ * On Windows:
+ * ┌──────────────────────┬────────────┐
+ * │           dir        │    base    │
+ * ├──────┬               ├──────┬─────┤
+ * │ root │               │ name │ ext │
+ * "  /c: / home/user/dir / file  .txt "
+ * └──────┴───────────────┴──────┴─────┘
+ */
+export class Path {
+  static separator: '/' = '/' as const;
+
+  static nativeSeparator = isWindows ? '\\' : '/';
+
+  static isDrive(segment: string): boolean {
+    return segment.endsWith(':');
+  }
+
+  static splitPath(path: string): string[] {
+    return path.split(Path.separator).filter((path) => !!path);
+  }
+
+  static isRelative(path: string): boolean {
+    return !path.startsWith(Path.separator);
+  }
+
+  static pathDepth(path: string): number {
+    return path.split(Path.separator).length;
+  }
+  /**
+   * vscode-uri always normalizes drive letters to lower case:
+   * https://github.com/Microsoft/vscode-uri/blob/b1d3221579f97f28a839b6f996d76fc45e9964d8/src/index.ts#L1025
+   * Theia path should be adjusted to this.
+   */
+  static normalizeDrive(path: string): string {
+    // lower-case windows drive letters in /C:/fff or C:/fff
+    if (path.length >= 3 && path.charCodeAt(0) === 47 /* '/' */ && path.charCodeAt(2) === 58 /* ':' */) {
+      const code = path.charCodeAt(1);
+      if (code >= 65 /* A */ && code <= 90 /* Z */) {
+        path = `/${String.fromCharCode(code + 32)}:${path.substr(3)}`; // "/c:".length === 3
+      }
+    } else if (path.length >= 2 && path.charCodeAt(1) === 58 /* ':' */) {
+      const code = path.charCodeAt(0);
+      if (code >= 65 /* A */ && code <= 90 /* Z */) {
+        path = `${String.fromCharCode(code + 32)}:${path.substr(2)}`; // "/c:".length === 3
+      }
+    }
+    return path;
+  }
+
+  readonly isAbsolute: boolean;
+  readonly isRoot: boolean;
+  readonly root: Path | undefined;
+  readonly base: string;
+  readonly name: string;
+  readonly ext: string;
+
+  private _dir!: Path;
+  private readonly raw: string;
+
+  /**
+   * The raw should be normalized, meaning that only '/' is allowed as a path separator.
+   */
+  constructor(raw: string) {
+    raw = raw.replace(SystemPathSeparatorRegex, Path.separator);
+    this.raw = Path.normalizeDrive(raw);
+    const firstIndex = raw.indexOf(Path.separator);
+    const lastIndex = raw.lastIndexOf(Path.separator);
+    this.isAbsolute = firstIndex === 0;
+    this.base = lastIndex === -1 ? raw : raw.substr(lastIndex + 1);
+    this.isRoot = this.isAbsolute && firstIndex === lastIndex && (!this.base || Path.isDrive(this.base));
+    this.root = this.computeRoot();
+
+    const extIndex = this.base.lastIndexOf('.');
+    // 处理无后缀文件或者 dot 打头的无后缀文件
+    // file like 'a/b/c/test'
+    if (extIndex === -1) {
+      this.name = this.base;
+      this.ext = '';
+    } else if (extIndex === 0) {
+      // dot file like `a/b/c/.eslintrc`
+      this.name = this.base;
+      this.ext = '';
+    } else {
+      this.name = this.base.substr(0, extIndex);
+      this.ext = this.base.substr(extIndex);
+    }
+  }
+
+  protected computeRoot(): Path | undefined {
+    // '/' -> '/'
+    // '/c:' -> '/c:'
+    if (this.isRoot) {
+      return this;
+    }
+    // 'foo/bar' -> `undefined`
+    if (!this.isAbsolute) {
+      return undefined;
+    }
+    const index = this.raw.indexOf(Path.separator, Path.separator.length);
+    if (index === -1) {
+      // '/foo/bar' -> '/'
+      return new Path(Path.separator);
+    }
+    // '/c:/foo/bar' -> '/c:'
+    // '/foo/bar' -> '/'
+    return new Path(this.raw.substr(0, index)).root;
+  }
+
+  get dir(): Path {
+    if (this._dir === undefined) {
+      this._dir = this.computeDir();
+    }
+    return this._dir;
+  }
+
+  protected computeDir(): Path {
+    if (this.isRoot) {
+      return this;
+    }
+    const lastIndex = this.raw.lastIndexOf(Path.separator);
+    if (lastIndex === -1) {
+      return this;
+    }
+    if (this.isAbsolute) {
+      const firstIndex = this.raw.indexOf(Path.separator);
+      if (firstIndex === lastIndex) {
+        return new Path(this.raw.substr(0, firstIndex + 1));
+      }
+    }
+    return new Path(this.raw.substr(0, lastIndex));
+  }
+
+  join(...paths: string[]): Path {
+    const code = this.raw.charCodeAt(0);
+    const isWindows = isWindowsDeviceRoot(code);
+
+    /**
+     * 只针对 IDE 后端运行在 Windows 的情况
+     * join('C:\\path\\to\\file', 'path/to/other') === 'C:\\path\\to\\file\\path\\to\\other'
+     */
+    if (isWindows) {
+      return new Path(win32.join(this.raw, ...paths));
+    }
+
+    const relativePath = paths.filter((s) => !!s).join(Path.separator);
+    if (!relativePath) {
+      return this;
+    }
+
+    if (this.raw.endsWith(Path.separator) || relativePath.startsWith(Path.separator)) {
+      return new Path(posix.join(this.raw, relativePath));
+    }
+    return new Path(posix.join(this.raw, Path.separator, relativePath));
+  }
+
+  toString(): string {
+    return this.raw;
+  }
+
+  relative(path: Path): Path | undefined {
+    if (this.raw === path.raw) {
+      return new Path('');
+    }
+    if (!this.raw || !path.raw) {
+      return undefined;
+    }
+    const raw = this.base ? this.raw + Path.separator : this.raw;
+    if (!path.raw.startsWith(raw)) {
+      return undefined;
+    }
+    const relativePath = path.raw.substr(raw.length);
+    return new Path(relativePath);
+  }
+
+  isEqualOrParent(path: Path): boolean {
+    return !!this.relative(path);
+  }
+
+  isEqual(path: Path): boolean {
+    return this.raw === path.raw;
+  }
+
+  relativity(path: Path): number {
+    const relative = this.relative(path);
+    if (relative) {
+      const relativeStr = relative.toString();
+      if (relativeStr === '') {
+        return 0;
+      }
+      return relativeStr.split(Path.separator).length;
+    }
+    return -1;
+  }
+}
+
+const CHAR_UPPERCASE_A = 65; /* A */
+const CHAR_LOWERCASE_A = 97; /* a */
+const CHAR_UPPERCASE_Z = 90; /* Z */
+const CHAR_LOWERCASE_Z = 122; /* z */
+const CHAR_DOT = 46; /* . */
+const CHAR_FORWARD_SLASH = 47; /* / */
+const CHAR_BACKWARD_SLASH = 92; /* \ */
+const CHAR_COLON = 58; /* : */
+const CHAR_QUESTION_MARK = 63; /* ? */
+
+class ErrorInvalidArgType extends Error {
+  code: 'ERR_INVALID_ARG_TYPE';
+  constructor(name: string, expected: string, actual: any) {
+    // determiner: 'must be' or 'must not be'
+    let determiner;
+    if (typeof expected === 'string' && expected.indexOf('not ') === 0) {
+      determiner = 'must not be';
+      expected = expected.replace(/^not /, '');
+    } else {
+      determiner = 'must be';
+    }
+
+    const type = name.indexOf('.') !== -1 ? 'property' : 'argument';
+    let msg = `The "${name}" ${type} ${determiner} of type ${expected}`;
+
+    msg += `. Received type ${typeof actual}`;
+    super(msg);
+  }
+}
+
+function validateString(value: string, name: string) {
+  if (typeof value !== 'string') {
+    throw new ErrorInvalidArgType(name, 'string', value);
+  }
+}
+
+function isPathSeparator(code?: number | undefined) {
+  return code === CHAR_FORWARD_SLASH || code === CHAR_BACKWARD_SLASH;
+}
+
+function isPosixPathSeparator(code?: number | undefined): boolean {
+  return code === CHAR_FORWARD_SLASH;
+}
+
+function isWindowsDeviceRoot(code: number) {
+  return (
+    (code >= CHAR_UPPERCASE_A && code <= CHAR_UPPERCASE_Z) || (code >= CHAR_LOWERCASE_A && code <= CHAR_LOWERCASE_Z)
+  );
+}
+
+// Resolves . and .. elements in a path with directory names
+function normalizeString(
+  path: string,
+  allowAboveRoot: boolean,
+  separator: string,
+  isPathSeparator: (code?: number) => boolean,
+) {
+  let res = '';
+  let lastSegmentLength = 0;
+  let lastSlash = -1;
+  let dots = 0;
+  let code;
+  for (let i = 0; i <= path.length; ++i) {
+    if (i < path.length) {
+      code = path.charCodeAt(i);
+    } else if (isPathSeparator(code)) {
+      break;
+    } else {
+      code = CHAR_FORWARD_SLASH;
+    }
+
+    if (isPathSeparator(code)) {
+      if (lastSlash === i - 1 || dots === 1) {
+        // NOOP
+      } else if (lastSlash !== i - 1 && dots === 2) {
+        if (
+          res.length < 2 ||
+          lastSegmentLength !== 2 ||
+          res.charCodeAt(res.length - 1) !== CHAR_DOT ||
+          res.charCodeAt(res.length - 2) !== CHAR_DOT
+        ) {
+          if (res.length > 2) {
+            const lastSlashIndex = res.lastIndexOf(separator);
+            if (lastSlashIndex === -1) {
+              res = '';
+              lastSegmentLength = 0;
+            } else {
+              res = res.slice(0, lastSlashIndex);
+              lastSegmentLength = res.length - 1 - res.lastIndexOf(separator);
+            }
+            lastSlash = i;
+            dots = 0;
+            continue;
+          } else if (res.length === 2 || res.length === 1) {
+            res = '';
+            lastSegmentLength = 0;
+            lastSlash = i;
+            dots = 0;
+            continue;
+          }
+        }
+        if (allowAboveRoot) {
+          if (res.length > 0) {
+            res += `${separator}..`;
+          } else {
+            res = '..';
+          }
+          lastSegmentLength = 2;
+        }
+      } else {
+        if (res.length > 0) {
+          res += separator + path.slice(lastSlash + 1, i);
+        } else {
+          res = path.slice(lastSlash + 1, i);
+        }
+        lastSegmentLength = i - lastSlash - 1;
+      }
+      lastSlash = i;
+      dots = 0;
+    } else if (code === CHAR_DOT && dots !== -1) {
+      ++dots;
+    } else {
+      dots = -1;
+    }
+  }
+  return res;
+}
+
+function _format(sep: string, pathObject: ParsedPath) {
+  const dir = pathObject.dir || pathObject.root;
+  const base = pathObject.base || (pathObject.name || '') + (pathObject.ext || '');
+  if (!dir) {
+    return base;
+  }
+  if (dir === pathObject.root) {
+    return dir + base;
+  }
+  return dir + sep + base;
+}
+
+interface ParsedPath {
+  root: string;
+  dir: string;
+  base: string;
+  ext: string;
+  name: string;
+}
+
+export interface IPath {
+  normalize(path: string): string;
+  isAbsolute(path: string): boolean;
+  join(...paths: string[]): string;
+  resolve(...pathSegments: string[]): string;
+  relative(from: string, to: string): string;
+  dirname(path: string): string;
+  basename(path: string, ext?: string): string;
+  extname(path: string): string;
+  format(pathObject: ParsedPath): string;
+  parse(path: string): ParsedPath;
+  toNamespacedPath(path: string): string;
+  sep: '\\' | '/';
+  delimiter: string;
+  win32: IPath | null;
+  posix: IPath | null;
+}
+
+export const win32: IPath = {
+  // path.resolve([from ...], to)
+  resolve(...pathSegments: string[]): string {
+    let resolvedDevice = '';
+    let resolvedTail = '';
+    let resolvedAbsolute = false;
+
+    for (let i = pathSegments.length - 1; i >= -1; i--) {
+      let path;
+      if (i >= 0) {
+        path = pathSegments[i];
+      } else if (!resolvedDevice) {
+        path = process.cwd();
+      } else {
+        // Windows has the concept of drive-specific current working
+        // directories. If we've resolved a drive letter but not yet an
+        // absolute path, get cwd for that drive, or the process cwd if
+        // the drive cwd is not available. We're sure the device is not
+        // a UNC path at this points, because UNC paths are always absolute.
+        path = process.env['=' + resolvedDevice] || process.cwd();
+
+        // Verify that a cwd was found and that it actually points
+        // to our drive. If not, default to the drive's root.
+        if (path === undefined || path.slice(0, 3).toLowerCase() !== resolvedDevice.toLowerCase() + '\\') {
+          path = resolvedDevice + '\\';
+        }
+      }
+
+      validateString(path, 'path');
+
+      // Skip empty entries
+      if (path.length === 0) {
+        continue;
+      }
+
+      const len = path.length;
+      let rootEnd = 0;
+      let device = '';
+      let isAbsolute = false;
+      const code = path.charCodeAt(0);
+
+      // Try to match a root
+      if (len > 1) {
+        if (isPathSeparator(code)) {
+          // Possible UNC root
+
+          // If we started with a separator, we know we at least have an
+          // absolute path of some kind (UNC or otherwise)
+          isAbsolute = true;
+
+          if (isPathSeparator(path.charCodeAt(1))) {
+            // Matched double path separator at beginning
+            let j = 2;
+            let last = j;
+            // Match 1 or more non-path separators
+            for (; j < len; ++j) {
+              if (isPathSeparator(path.charCodeAt(j))) {
+                break;
+              }
+            }
+            if (j < len && j !== last) {
+              const firstPart = path.slice(last, j);
+              // Matched!
+              last = j;
+              // Match 1 or more path separators
+              for (; j < len; ++j) {
+                if (!isPathSeparator(path.charCodeAt(j))) {
+                  break;
+                }
+              }
+              if (j < len && j !== last) {
+                // Matched!
+                last = j;
+                // Match 1 or more non-path separators
+                for (; j < len; ++j) {
+                  if (isPathSeparator(path.charCodeAt(j))) {
+                    break;
+                  }
+                }
+                if (j === len) {
+                  // We matched a UNC root only
+
+                  device = '\\\\' + firstPart + '\\' + path.slice(last);
+                  rootEnd = j;
+                } else if (j !== last) {
+                  // We matched a UNC root with leftovers
+
+                  device = '\\\\' + firstPart + '\\' + path.slice(last, j);
+                  rootEnd = j;
+                }
+              }
+            }
+          } else {
+            rootEnd = 1;
+          }
+        } else if (isWindowsDeviceRoot(code)) {
+          // Possible device root
+
+          if (path.charCodeAt(1) === CHAR_COLON) {
+            device = path.slice(0, 2);
+            rootEnd = 2;
+            if (len > 2) {
+              if (isPathSeparator(path.charCodeAt(2))) {
+                // Treat separator following drive name as an absolute path
+                // indicator
+                isAbsolute = true;
+                rootEnd = 3;
+              }
+            }
+          }
+        }
+      } else if (isPathSeparator(code)) {
+        // `path` contains just a path separator
+        rootEnd = 1;
+        isAbsolute = true;
+      }
+
+      if (device.length > 0 && resolvedDevice.length > 0 && device.toLowerCase() !== resolvedDevice.toLowerCase()) {
+        // This path points to another device so it is not applicable
+        continue;
+      }
+
+      if (resolvedDevice.length === 0 && device.length > 0) {
+        resolvedDevice = device;
+      }
+      if (!resolvedAbsolute) {
+        resolvedTail = path.slice(rootEnd) + '\\' + resolvedTail;
+        resolvedAbsolute = isAbsolute;
+      }
+
+      if (resolvedDevice.length > 0 && resolvedAbsolute) {
+        break;
+      }
+    }
+
+    // At this point the path should be resolved to a full absolute path,
+    // but handle relative paths to be safe (might happen when process.cwd()
+    // fails)
+
+    // Normalize the tail path
+    resolvedTail = normalizeString(resolvedTail, !resolvedAbsolute, '\\', isPathSeparator);
+
+    return resolvedDevice + (resolvedAbsolute ? '\\' : '') + resolvedTail || '.';
+  },
+
+  normalize(path: string): string {
+    validateString(path, 'path');
+    const len = path.length;
+    if (len === 0) {
+      return '.';
+    }
+    let rootEnd = 0;
+    let device;
+    let isAbsolute = false;
+    const code = path.charCodeAt(0);
+
+    // Try to match a root
+    if (len > 1) {
+      if (isPathSeparator(code)) {
+        // Possible UNC root
+
+        // If we started with a separator, we know we at least have an absolute
+        // path of some kind (UNC or otherwise)
+        isAbsolute = true;
+
+        if (isPathSeparator(path.charCodeAt(1))) {
+          // Matched double path separator at beginning
+          let j = 2;
+          let last = j;
+          // Match 1 or more non-path separators
+          for (; j < len; ++j) {
+            if (isPathSeparator(path.charCodeAt(j))) {
+              break;
+            }
+          }
+          if (j < len && j !== last) {
+            const firstPart = path.slice(last, j);
+            // Matched!
+            last = j;
+            // Match 1 or more path separators
+            for (; j < len; ++j) {
+              if (!isPathSeparator(path.charCodeAt(j))) {
+                break;
+              }
+            }
+            if (j < len && j !== last) {
+              // Matched!
+              last = j;
+              // Match 1 or more non-path separators
+              for (; j < len; ++j) {
+                if (isPathSeparator(path.charCodeAt(j))) {
+                  break;
+                }
+              }
+              if (j === len) {
+                // We matched a UNC root only
+                // Return the normalized version of the UNC root since there
+                // is nothing left to process
+
+                return '\\\\' + firstPart + '\\' + path.slice(last) + '\\';
+              } else if (j !== last) {
+                // We matched a UNC root with leftovers
+
+                device = '\\\\' + firstPart + '\\' + path.slice(last, j);
+                rootEnd = j;
+              }
+            }
+          }
+        } else {
+          rootEnd = 1;
+        }
+      } else if (isWindowsDeviceRoot(code)) {
+        // Possible device root
+
+        if (path.charCodeAt(1) === CHAR_COLON) {
+          device = path.slice(0, 2);
+          rootEnd = 2;
+          if (len > 2) {
+            if (isPathSeparator(path.charCodeAt(2))) {
+              // Treat separator following drive name as an absolute path
+              // indicator
+              isAbsolute = true;
+              rootEnd = 3;
+            }
+          }
+        }
+      }
+    } else if (isPathSeparator(code)) {
+      // `path` contains just a path separator, exit early to avoid unnecessary
+      // work
+      return '\\';
+    }
+
+    let tail;
+    if (rootEnd < len) {
+      tail = normalizeString(path.slice(rootEnd), !isAbsolute, '\\', isPathSeparator);
+    } else {
+      tail = '';
+    }
+    if (tail.length === 0 && !isAbsolute) {
+      tail = '.';
+    }
+    if (tail.length > 0 && isPathSeparator(path.charCodeAt(len - 1))) {
+      tail += '\\';
+    }
+    if (device === undefined) {
+      if (isAbsolute) {
+        if (tail.length > 0) {
+          return '\\' + tail;
+        } else {
+          return '\\';
+        }
+      } else if (tail.length > 0) {
+        return tail;
+      } else {
+        return '';
+      }
+    } else if (isAbsolute) {
+      if (tail.length > 0) {
+        return device + '\\' + tail;
+      } else {
+        return device + '\\';
+      }
+    } else if (tail.length > 0) {
+      return device + tail;
+    } else {
+      return device;
+    }
+  },
+
+  isAbsolute(path: string): boolean {
+    validateString(path, 'path');
+    const len = path.length;
+    if (len === 0) {
+      return false;
+    }
+
+    const code = path.charCodeAt(0);
+    if (isPathSeparator(code)) {
+      return true;
+    } else if (isWindowsDeviceRoot(code)) {
+      // Possible device root
+
+      if (len > 2 && path.charCodeAt(1) === CHAR_COLON) {
+        if (isPathSeparator(path.charCodeAt(2))) {
+          return true;
+        }
+      }
+    }
+    return false;
+  },
+
+  join(...paths: string[]): string {
+    if (paths.length === 0) {
+      return '.';
+    }
+
+    let joined;
+    let firstPart: string | undefined;
+    // eslint-disable-next-line @typescript-eslint/prefer-for-of
+    for (let i = 0; i < paths.length; ++i) {
+      const arg = paths[i];
+      validateString(arg, 'path');
+      if (arg.length > 0) {
+        if (joined === undefined) {
+          joined = firstPart = arg;
+        } else {
+          joined += '\\' + arg;
+        }
+      }
+    }
+
+    if (joined === undefined) {
+      return '.';
+    }
+
+    // Make sure that the joined path doesn't start with two slashes, because
+    // normalize() will mistake it for an UNC path then.
+    //
+    // This step is skipped when it is very clear that the user actually
+    // intended to point at an UNC path. This is assumed when the first
+    // non-empty string arguments starts with exactly two slashes followed by
+    // at least one more non-slash character.
+    //
+    // Note that for normalize() to treat a path as an UNC path it needs to
+    // have at least 2 components, so we don't filter for that here.
+    // This means that the user can use join to construct UNC paths from
+    // a server name and a share name; for example:
+    //   path.join('//server', 'share') -> '\\\\server\\share\\')
+    let needsReplace = true;
+    let slashCount = 0;
+    if (typeof firstPart === 'string' && isPathSeparator(firstPart.charCodeAt(0))) {
+      ++slashCount;
+      const firstLen = firstPart.length;
+      if (firstLen > 1) {
+        if (isPathSeparator(firstPart.charCodeAt(1))) {
+          ++slashCount;
+          if (firstLen > 2) {
+            if (isPathSeparator(firstPart.charCodeAt(2))) {
+              ++slashCount;
+            } else {
+              // We matched a UNC path in the first part
+              needsReplace = false;
+            }
+          }
+        }
+      }
+    }
+    if (needsReplace) {
+      // Find any more consecutive slashes we need to replace
+      for (; slashCount < joined.length; ++slashCount) {
+        if (!isPathSeparator(joined.charCodeAt(slashCount))) {
+          break;
+        }
+      }
+
+      // Replace the slashes if needed
+      if (slashCount >= 2) {
+        joined = '\\' + joined.slice(slashCount);
+      }
+    }
+
+    return win32.normalize(joined);
+  },
+
+  // It will solve the relative path from `from` to `to`, for instance:
+  //  from = 'C:\\orandea\\test\\aaa'
+  //  to = 'C:\\orandea\\impl\\bbb'
+  // The output of the function should be: '..\\..\\impl\\bbb'
+  relative(from: string, to: string): string {
+    validateString(from, 'from');
+    validateString(to, 'to');
+
+    if (from === to) {
+      return '';
+    }
+
+    const fromOrig = win32.resolve(from);
+    const toOrig = win32.resolve(to);
+
+    if (fromOrig === toOrig) {
+      return '';
+    }
+
+    from = fromOrig.toLowerCase();
+    to = toOrig.toLowerCase();
+
+    if (from === to) {
+      return '';
+    }
+
+    // Trim any leading backslashes
+    let fromStart = 0;
+    for (; fromStart < from.length; ++fromStart) {
+      if (from.charCodeAt(fromStart) !== CHAR_BACKWARD_SLASH) {
+        break;
+      }
+    }
+    // Trim trailing backslashes (applicable to UNC paths only)
+    let fromEnd = from.length;
+    for (; fromEnd - 1 > fromStart; --fromEnd) {
+      if (from.charCodeAt(fromEnd - 1) !== CHAR_BACKWARD_SLASH) {
+        break;
+      }
+    }
+    const fromLen = fromEnd - fromStart;
+
+    // Trim any leading backslashes
+    let toStart = 0;
+    for (; toStart < to.length; ++toStart) {
+      if (to.charCodeAt(toStart) !== CHAR_BACKWARD_SLASH) {
+        break;
+      }
+    }
+    // Trim trailing backslashes (applicable to UNC paths only)
+    let toEnd = to.length;
+    for (; toEnd - 1 > toStart; --toEnd) {
+      if (to.charCodeAt(toEnd - 1) !== CHAR_BACKWARD_SLASH) {
+        break;
+      }
+    }
+    const toLen = toEnd - toStart;
+
+    // Compare paths to find the longest common path from root
+    const length = fromLen < toLen ? fromLen : toLen;
+    let lastCommonSep = -1;
+    let i = 0;
+    for (; i <= length; ++i) {
+      if (i === length) {
+        if (toLen > length) {
+          if (to.charCodeAt(toStart + i) === CHAR_BACKWARD_SLASH) {
+            // We get here if `from` is the exact base path for `to`.
+            // For example: from='C:\\foo\\bar'; to='C:\\foo\\bar\\baz'
+            return toOrig.slice(toStart + i + 1);
+          } else if (i === 2) {
+            // We get here if `from` is the device root.
+            // For example: from='C:\\'; to='C:\\foo'
+            return toOrig.slice(toStart + i);
+          }
+        }
+        if (fromLen > length) {
+          if (from.charCodeAt(fromStart + i) === CHAR_BACKWARD_SLASH) {
+            // We get here if `to` is the exact base path for `from`.
+            // For example: from='C:\\foo\\bar'; to='C:\\foo'
+            lastCommonSep = i;
+          } else if (i === 2) {
+            // We get here if `to` is the device root.
+            // For example: from='C:\\foo\\bar'; to='C:\\'
+            lastCommonSep = 3;
+          }
+        }
+        break;
+      }
+      const fromCode = from.charCodeAt(fromStart + i);
+      const toCode = to.charCodeAt(toStart + i);
+      if (fromCode !== toCode) {
+        break;
+      } else if (fromCode === CHAR_BACKWARD_SLASH) {
+        lastCommonSep = i;
+      }
+    }
+
+    // We found a mismatch before the first common path separator was seen, so
+    // return the original `to`.
+    if (i !== length && lastCommonSep === -1) {
+      return toOrig;
+    }
+
+    let out = '';
+    if (lastCommonSep === -1) {
+      lastCommonSep = 0;
+    }
+    // Generate the relative path based on the path difference between `to` and
+    // `from`
+    for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
+      if (i === fromEnd || from.charCodeAt(i) === CHAR_BACKWARD_SLASH) {
+        if (out.length === 0) {
+          out += '..';
+        } else {
+          out += '\\..';
+        }
+      }
+    }
+
+    // Lastly, append the rest of the destination (`to`) path that comes after
+    // the common path parts
+    if (out.length > 0) {
+      return out + toOrig.slice(toStart + lastCommonSep, toEnd);
+    } else {
+      toStart += lastCommonSep;
+      if (toOrig.charCodeAt(toStart) === CHAR_BACKWARD_SLASH) {
+        ++toStart;
+      }
+      return toOrig.slice(toStart, toEnd);
+    }
+  },
+
+  toNamespacedPath(path: string): string {
+    // Note: this will *probably* throw somewhere.
+    if (typeof path !== 'string') {
+      return path;
+    }
+
+    if (path.length === 0) {
+      return '';
+    }
+
+    const resolvedPath = win32.resolve(path);
+
+    if (resolvedPath.length >= 3) {
+      if (resolvedPath.charCodeAt(0) === CHAR_BACKWARD_SLASH) {
+        // Possible UNC root
+
+        if (resolvedPath.charCodeAt(1) === CHAR_BACKWARD_SLASH) {
+          const code = resolvedPath.charCodeAt(2);
+          if (code !== CHAR_QUESTION_MARK && code !== CHAR_DOT) {
+            // Matched non-long UNC root, convert the path to a long UNC path
+            return '\\\\?\\UNC\\' + resolvedPath.slice(2);
+          }
+        }
+      } else if (isWindowsDeviceRoot(resolvedPath.charCodeAt(0))) {
+        // Possible device root
+
+        if (resolvedPath.charCodeAt(1) === CHAR_COLON && resolvedPath.charCodeAt(2) === CHAR_BACKWARD_SLASH) {
+          // Matched device root, convert the path to a long UNC path
+          return '\\\\?\\' + resolvedPath;
+        }
+      }
+    }
+
+    return path;
+  },
+
+  dirname(path: string): string {
+    validateString(path, 'path');
+    const len = path.length;
+    if (len === 0) {
+      return '.';
+    }
+    let rootEnd = -1;
+    let end = -1;
+    let matchedSlash = true;
+    let offset = 0;
+    const code = path.charCodeAt(0);
+
+    // Try to match a root
+    if (len > 1) {
+      if (isPathSeparator(code)) {
+        // Possible UNC root
+
+        rootEnd = offset = 1;
+
+        if (isPathSeparator(path.charCodeAt(1))) {
+          // Matched double path separator at beginning
+          let j = 2;
+          let last = j;
+          // Match 1 or more non-path separators
+          for (; j < len; ++j) {
+            if (isPathSeparator(path.charCodeAt(j))) {
+              break;
+            }
+          }
+          if (j < len && j !== last) {
+            // Matched!
+            last = j;
+            // Match 1 or more path separators
+            for (; j < len; ++j) {
+              if (!isPathSeparator(path.charCodeAt(j))) {
+                break;
+              }
+            }
+            if (j < len && j !== last) {
+              // Matched!
+              last = j;
+              // Match 1 or more non-path separators
+              for (; j < len; ++j) {
+                if (isPathSeparator(path.charCodeAt(j))) {
+                  break;
+                }
+              }
+              if (j === len) {
+                // We matched a UNC root only
+                return path;
+              }
+              if (j !== last) {
+                // We matched a UNC root with leftovers
+
+                // Offset by 1 to include the separator after the UNC root to
+                // treat it as a "normal root" on top of a (UNC) root
+                rootEnd = offset = j + 1;
+              }
+            }
+          }
+        }
+      } else if (isWindowsDeviceRoot(code)) {
+        // Possible device root
+
+        if (path.charCodeAt(1) === CHAR_COLON) {
+          rootEnd = offset = 2;
+          if (len > 2) {
+            if (isPathSeparator(path.charCodeAt(2))) {
+              rootEnd = offset = 3;
+            }
+          }
+        }
+      }
+    } else if (isPathSeparator(code)) {
+      // `path` contains just a path separator, exit early to avoid
+      // unnecessary work
+      return path;
+    }
+
+    for (let i = len - 1; i >= offset; --i) {
+      if (isPathSeparator(path.charCodeAt(i))) {
+        if (!matchedSlash) {
+          end = i;
+          break;
+        }
+      } else {
+        // We saw the first non-path separator
+        matchedSlash = false;
+      }
+    }
+
+    if (end === -1) {
+      if (rootEnd === -1) {
+        return '.';
+      } else {
+        end = rootEnd;
+      }
+    }
+    return path.slice(0, end);
+  },
+
+  basename(path: string, ext?: string): string {
+    if (ext !== undefined) {
+      validateString(ext, 'ext');
+    }
+    validateString(path, 'path');
+    let start = 0;
+    let end = -1;
+    let matchedSlash = true;
+    let i;
+
+    // Check for a drive letter prefix so as not to mistake the following
+    // path separator as an extra separator at the end of the path that can be
+    // disregarded
+    if (path.length >= 2) {
+      const drive = path.charCodeAt(0);
+      if (isWindowsDeviceRoot(drive)) {
+        if (path.charCodeAt(1) === CHAR_COLON) {
+          start = 2;
+        }
+      }
+    }
+
+    if (ext !== undefined && ext.length > 0 && ext.length <= path.length) {
+      if (ext.length === path.length && ext === path) {
+        return '';
+      }
+      let extIdx = ext.length - 1;
+      let firstNonSlashEnd = -1;
+      for (i = path.length - 1; i >= start; --i) {
+        const code = path.charCodeAt(i);
+        if (isPathSeparator(code)) {
+          // If we reached a path separator that was not part of a set of path
+          // separators at the end of the string, stop now
+          if (!matchedSlash) {
+            start = i + 1;
+            break;
+          }
+        } else {
+          if (firstNonSlashEnd === -1) {
+            // We saw the first non-path separator, remember this index in case
+            // we need it if the extension ends up not matching
+            matchedSlash = false;
+            firstNonSlashEnd = i + 1;
+          }
+          if (extIdx >= 0) {
+            // Try to match the explicit extension
+            if (code === ext.charCodeAt(extIdx)) {
+              if (--extIdx === -1) {
+                // We matched the extension, so mark this as the end of our path
+                // component
+                end = i;
+              }
+            } else {
+              // Extension does not match, so our result is the entire path
+              // component
+              extIdx = -1;
+              end = firstNonSlashEnd;
+            }
+          }
+        }
+      }
+
+      if (start === end) {
+        end = firstNonSlashEnd;
+      } else if (end === -1) {
+        end = path.length;
+      }
+      return path.slice(start, end);
+    } else {
+      for (i = path.length - 1; i >= start; --i) {
+        if (isPathSeparator(path.charCodeAt(i))) {
+          // If we reached a path separator that was not part of a set of path
+          // separators at the end of the string, stop now
+          if (!matchedSlash) {
+            start = i + 1;
+            break;
+          }
+        } else if (end === -1) {
+          // We saw the first non-path separator, mark this as the end of our
+          // path component
+          matchedSlash = false;
+          end = i + 1;
+        }
+      }
+
+      if (end === -1) {
+        return '';
+      }
+      return path.slice(start, end);
+    }
+  },
+
+  extname(path: string): string {
+    validateString(path, 'path');
+    let start = 0;
+    let startDot = -1;
+    let startPart = 0;
+    let end = -1;
+    let matchedSlash = true;
+    // Track the state of characters (if any) we see before our first dot and
+    // after any path separator we find
+    let preDotState = 0;
+
+    // Check for a drive letter prefix so as not to mistake the following
+    // path separator as an extra separator at the end of the path that can be
+    // disregarded
+
+    if (path.length >= 2 && path.charCodeAt(1) === CHAR_COLON && isWindowsDeviceRoot(path.charCodeAt(0))) {
+      start = startPart = 2;
+    }
+
+    for (let i = path.length - 1; i >= start; --i) {
+      const code = path.charCodeAt(i);
+      if (isPathSeparator(code)) {
+        // If we reached a path separator that was not part of a set of path
+        // separators at the end of the string, stop now
+        if (!matchedSlash) {
+          startPart = i + 1;
+          break;
+        }
+        continue;
+      }
+      if (end === -1) {
+        // We saw the first non-path separator, mark this as the end of our
+        // extension
+        matchedSlash = false;
+        end = i + 1;
+      }
+      if (code === CHAR_DOT) {
+        // If this is our first dot, mark it as the start of our extension
+        if (startDot === -1) {
+          startDot = i;
+        } else if (preDotState !== 1) {
+          preDotState = 1;
+        }
+      } else if (startDot !== -1) {
+        // We saw a non-dot and non-path separator before our dot, so we should
+        // have a good chance at having a non-empty extension
+        preDotState = -1;
+      }
+    }
+
+    if (
+      startDot === -1 ||
+      end === -1 ||
+      // We saw a non-dot character immediately before the dot
+      preDotState === 0 ||
+      // The (right-most) trimmed path component is exactly '..'
+      (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)
+    ) {
+      return '';
+    }
+    return path.slice(startDot, end);
+  },
+
+  format(pathObject): string {
+    if (pathObject === null || typeof pathObject !== 'object') {
+      throw new ErrorInvalidArgType('pathObject', 'Object', pathObject);
+    }
+
+    return _format('\\', pathObject);
+  },
+
+  parse(path) {
+    validateString(path, 'path');
+
+    const ret = { root: '', dir: '', base: '', ext: '', name: '' };
+    if (path.length === 0) {
+      return ret;
+    }
+
+    const len = path.length;
+    let rootEnd = 0;
+    let code = path.charCodeAt(0);
+
+    // Try to match a root
+    if (len > 1) {
+      if (isPathSeparator(code)) {
+        // Possible UNC root
+
+        rootEnd = 1;
+        if (isPathSeparator(path.charCodeAt(1))) {
+          // Matched double path separator at beginning
+          let j = 2;
+          let last = j;
+          // Match 1 or more non-path separators
+          for (; j < len; ++j) {
+            if (isPathSeparator(path.charCodeAt(j))) {
+              break;
+            }
+          }
+          if (j < len && j !== last) {
+            // Matched!
+            last = j;
+            // Match 1 or more path separators
+            for (; j < len; ++j) {
+              if (!isPathSeparator(path.charCodeAt(j))) {
+                break;
+              }
+            }
+            if (j < len && j !== last) {
+              // Matched!
+              last = j;
+              // Match 1 or more non-path separators
+              for (; j < len; ++j) {
+                if (isPathSeparator(path.charCodeAt(j))) {
+                  break;
+                }
+              }
+              if (j === len) {
+                // We matched a UNC root only
+
+                rootEnd = j;
+              } else if (j !== last) {
+                // We matched a UNC root with leftovers
+
+                rootEnd = j + 1;
+              }
+            }
+          }
+        }
+      } else if (isWindowsDeviceRoot(code)) {
+        // Possible device root
+
+        if (path.charCodeAt(1) === CHAR_COLON) {
+          rootEnd = 2;
+          if (len > 2) {
+            if (isPathSeparator(path.charCodeAt(2))) {
+              if (len === 3) {
+                // `path` contains just a drive root, exit early to avoid
+                // unnecessary work
+                ret.root = ret.dir = path;
+                return ret;
+              }
+              rootEnd = 3;
+            }
+          } else {
+            // `path` contains just a drive root, exit early to avoid
+            // unnecessary work
+            ret.root = ret.dir = path;
+            return ret;
+          }
+        }
+      }
+    } else if (isPathSeparator(code)) {
+      // `path` contains just a path separator, exit early to avoid
+      // unnecessary work
+      ret.root = ret.dir = path;
+      return ret;
+    }
+
+    if (rootEnd > 0) {
+      ret.root = path.slice(0, rootEnd);
+    }
+
+    let startDot = -1;
+    let startPart = rootEnd;
+    let end = -1;
+    let matchedSlash = true;
+    let i = path.length - 1;
+
+    // Track the state of characters (if any) we see before our first dot and
+    // after any path separator we find
+    let preDotState = 0;
+
+    // Get non-dir info
+    for (; i >= rootEnd; --i) {
+      code = path.charCodeAt(i);
+      if (isPathSeparator(code)) {
+        // If we reached a path separator that was not part of a set of path
+        // separators at the end of the string, stop now
+        if (!matchedSlash) {
+          startPart = i + 1;
+          break;
+        }
+        continue;
+      }
+      if (end === -1) {
+        // We saw the first non-path separator, mark this as the end of our
+        // extension
+        matchedSlash = false;
+        end = i + 1;
+      }
+      if (code === CHAR_DOT) {
+        // If this is our first dot, mark it as the start of our extension
+        if (startDot === -1) {
+          startDot = i;
+        } else if (preDotState !== 1) {
+          preDotState = 1;
+        }
+      } else if (startDot !== -1) {
+        // We saw a non-dot and non-path separator before our dot, so we should
+        // have a good chance at having a non-empty extension
+        preDotState = -1;
+      }
+    }
+
+    if (
+      startDot === -1 ||
+      end === -1 ||
+      // We saw a non-dot character immediately before the dot
+      preDotState === 0 ||
+      // The (right-most) trimmed path component is exactly '..'
+      (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)
+    ) {
+      if (end !== -1) {
+        ret.base = ret.name = path.slice(startPart, end);
+      }
+    } else {
+      ret.name = path.slice(startPart, startDot);
+      ret.base = path.slice(startPart, end);
+      ret.ext = path.slice(startDot, end);
+    }
+
+    // If the directory is the root, use the entire root as the `dir` including
+    // the trailing slash if any (`C:\abc` -> `C:\`). Otherwise, strip out the
+    // trailing slash (`C:\abc\def` -> `C:\abc`).
+    if (startPart > 0 && startPart !== rootEnd) {
+      ret.dir = path.slice(0, startPart - 1);
+    } else {
+      ret.dir = ret.root;
+    }
+
+    return ret;
+  },
+
+  sep: '\\',
+  delimiter: ';',
+  win32: null,
+  posix: null,
+};
+
+export const posix: IPath = {
+  // path.resolve([from ...], to)
+  resolve(...pathSegments: string[]): string {
+    let resolvedPath = '';
+    let resolvedAbsolute = false;
+
+    for (let i = pathSegments.length - 1; i >= -1 && !resolvedAbsolute; i--) {
+      let path;
+      if (i >= 0) {
+        path = pathSegments[i];
+      } else {
+        path = process.cwd();
+      }
+
+      validateString(path, 'path');
+
+      // Skip empty entries
+      if (path.length === 0) {
+        continue;
+      }
+
+      resolvedPath = path + '/' + resolvedPath;
+      resolvedAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    }
+
+    // At this point the path should be resolved to a full absolute path, but
+    // handle relative paths to be safe (might happen when process.cwd() fails)
+
+    // Normalize the path
+    resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute, '/', isPosixPathSeparator);
+
+    if (resolvedAbsolute) {
+      if (resolvedPath.length > 0) {
+        return '/' + resolvedPath;
+      } else {
+        return '/';
+      }
+    } else if (resolvedPath.length > 0) {
+      return resolvedPath;
+    } else {
+      return '.';
+    }
+  },
+
+  normalize(path: string): string {
+    validateString(path, 'path');
+
+    if (path.length === 0) {
+      return '.';
+    }
+
+    const isAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    const trailingSeparator = path.charCodeAt(path.length - 1) === CHAR_FORWARD_SLASH;
+
+    // Normalize the path
+    path = normalizeString(path, !isAbsolute, '/', isPosixPathSeparator);
+
+    if (path.length === 0 && !isAbsolute) {
+      path = '.';
+    }
+    if (path.length > 0 && trailingSeparator) {
+      path += '/';
+    }
+
+    if (isAbsolute) {
+      return '/' + path;
+    }
+    return path;
+  },
+
+  isAbsolute(path: string): boolean {
+    validateString(path, 'path');
+    return path.length > 0 && path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+  },
+
+  join(...paths: string[]): string {
+    if (paths.length === 0) {
+      return '.';
+    }
+    let joined;
+    for (let i = 0; i < paths.length; ++i) {
+      const arg = arguments[i];
+      validateString(arg, 'path');
+      if (arg.length > 0) {
+        if (joined === undefined) {
+          joined = arg;
+        } else {
+          joined += '/' + arg;
+        }
+      }
+    }
+    if (joined === undefined) {
+      return '.';
+    }
+    return posix.normalize(joined);
+  },
+
+  relative(from: string, to: string): string {
+    validateString(from, 'from');
+    validateString(to, 'to');
+
+    if (from === to) {
+      return '';
+    }
+
+    from = posix.resolve(from);
+    to = posix.resolve(to);
+
+    if (from === to) {
+      return '';
+    }
+
+    // Trim any leading backslashes
+    let fromStart = 1;
+    for (; fromStart < from.length; ++fromStart) {
+      if (from.charCodeAt(fromStart) !== CHAR_FORWARD_SLASH) {
+        break;
+      }
+    }
+    const fromEnd = from.length;
+    const fromLen = fromEnd - fromStart;
+
+    // Trim any leading backslashes
+    let toStart = 1;
+    for (; toStart < to.length; ++toStart) {
+      if (to.charCodeAt(toStart) !== CHAR_FORWARD_SLASH) {
+        break;
+      }
+    }
+    const toEnd = to.length;
+    const toLen = toEnd - toStart;
+
+    // Compare paths to find the longest common path from root
+    const length = fromLen < toLen ? fromLen : toLen;
+    let lastCommonSep = -1;
+    let i = 0;
+    for (; i <= length; ++i) {
+      if (i === length) {
+        if (toLen > length) {
+          if (to.charCodeAt(toStart + i) === CHAR_FORWARD_SLASH) {
+            // We get here if `from` is the exact base path for `to`.
+            // For example: from='/foo/bar'; to='/foo/bar/baz'
+            return to.slice(toStart + i + 1);
+          } else if (i === 0) {
+            // We get here if `from` is the root
+            // For example: from='/'; to='/foo'
+            return to.slice(toStart + i);
+          }
+        } else if (fromLen > length) {
+          if (from.charCodeAt(fromStart + i) === CHAR_FORWARD_SLASH) {
+            // We get here if `to` is the exact base path for `from`.
+            // For example: from='/foo/bar/baz'; to='/foo/bar'
+            lastCommonSep = i;
+          } else if (i === 0) {
+            // We get here if `to` is the root.
+            // For example: from='/foo'; to='/'
+            lastCommonSep = 0;
+          }
+        }
+        break;
+      }
+      const fromCode = from.charCodeAt(fromStart + i);
+      const toCode = to.charCodeAt(toStart + i);
+      if (fromCode !== toCode) {
+        break;
+      } else if (fromCode === CHAR_FORWARD_SLASH) {
+        lastCommonSep = i;
+      }
+    }
+
+    let out = '';
+    // Generate the relative path based on the path difference between `to`
+    // and `from`
+    for (i = fromStart + lastCommonSep + 1; i <= fromEnd; ++i) {
+      if (i === fromEnd || from.charCodeAt(i) === CHAR_FORWARD_SLASH) {
+        if (out.length === 0) {
+          out += '..';
+        } else {
+          out += '/..';
+        }
+      }
+    }
+
+    // Lastly, append the rest of the destination (`to`) path that comes after
+    // the common path parts
+    if (out.length > 0) {
+      return out + to.slice(toStart + lastCommonSep);
+    } else {
+      toStart += lastCommonSep;
+      if (to.charCodeAt(toStart) === CHAR_FORWARD_SLASH) {
+        ++toStart;
+      }
+      return to.slice(toStart);
+    }
+  },
+
+  toNamespacedPath(path: string): string {
+    // Non-op on posix systems
+    return path;
+  },
+
+  dirname(path: string): string {
+    validateString(path, 'path');
+    if (path.length === 0) {
+      return '.';
+    }
+    const hasRoot = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    let end = -1;
+    let matchedSlash = true;
+    for (let i = path.length - 1; i >= 1; --i) {
+      if (path.charCodeAt(i) === CHAR_FORWARD_SLASH) {
+        if (!matchedSlash) {
+          end = i;
+          break;
+        }
+      } else {
+        // We saw the first non-path separator
+        matchedSlash = false;
+      }
+    }
+
+    if (end === -1) {
+      return hasRoot ? '/' : '.';
+    }
+    if (hasRoot && end === 1) {
+      return '//';
+    }
+    return path.slice(0, end);
+  },
+
+  basename(path: string, ext?: string): string {
+    if (ext !== undefined) {
+      validateString(ext, 'ext');
+    }
+    validateString(path, 'path');
+
+    let start = 0;
+    let end = -1;
+    let matchedSlash = true;
+    let i;
+
+    if (ext !== undefined && ext.length > 0 && ext.length <= path.length) {
+      if (ext.length === path.length && ext === path) {
+        return '';
+      }
+      let extIdx = ext.length - 1;
+      let firstNonSlashEnd = -1;
+      for (i = path.length - 1; i >= 0; --i) {
+        const code = path.charCodeAt(i);
+        if (code === CHAR_FORWARD_SLASH) {
+          // If we reached a path separator that was not part of a set of path
+          // separators at the end of the string, stop now
+          if (!matchedSlash) {
+            start = i + 1;
+            break;
+          }
+        } else {
+          if (firstNonSlashEnd === -1) {
+            // We saw the first non-path separator, remember this index in case
+            // we need it if the extension ends up not matching
+            matchedSlash = false;
+            firstNonSlashEnd = i + 1;
+          }
+          if (extIdx >= 0) {
+            // Try to match the explicit extension
+            if (code === ext.charCodeAt(extIdx)) {
+              if (--extIdx === -1) {
+                // We matched the extension, so mark this as the end of our path
+                // component
+                end = i;
+              }
+            } else {
+              // Extension does not match, so our result is the entire path
+              // component
+              extIdx = -1;
+              end = firstNonSlashEnd;
+            }
+          }
+        }
+      }
+
+      if (start === end) {
+        end = firstNonSlashEnd;
+      } else if (end === -1) {
+        end = path.length;
+      }
+      return path.slice(start, end);
+    } else {
+      for (i = path.length - 1; i >= 0; --i) {
+        if (path.charCodeAt(i) === CHAR_FORWARD_SLASH) {
+          // If we reached a path separator that was not part of a set of path
+          // separators at the end of the string, stop now
+          if (!matchedSlash) {
+            start = i + 1;
+            break;
+          }
+        } else if (end === -1) {
+          // We saw the first non-path separator, mark this as the end of our
+          // path component
+          matchedSlash = false;
+          end = i + 1;
+        }
+      }
+
+      if (end === -1) {
+        return '';
+      }
+      return path.slice(start, end);
+    }
+  },
+
+  extname(path: string): string {
+    validateString(path, 'path');
+    let startDot = -1;
+    let startPart = 0;
+    let end = -1;
+    let matchedSlash = true;
+    // Track the state of characters (if any) we see before our first dot and
+    // after any path separator we find
+    let preDotState = 0;
+    for (let i = path.length - 1; i >= 0; --i) {
+      const code = path.charCodeAt(i);
+      if (code === CHAR_FORWARD_SLASH) {
+        // If we reached a path separator that was not part of a set of path
+        // separators at the end of the string, stop now
+        if (!matchedSlash) {
+          startPart = i + 1;
+          break;
+        }
+        continue;
+      }
+      if (end === -1) {
+        // We saw the first non-path separator, mark this as the end of our
+        // extension
+        matchedSlash = false;
+        end = i + 1;
+      }
+      if (code === CHAR_DOT) {
+        // If this is our first dot, mark it as the start of our extension
+        if (startDot === -1) {
+          startDot = i;
+        } else if (preDotState !== 1) {
+          preDotState = 1;
+        }
+      } else if (startDot !== -1) {
+        // We saw a non-dot and non-path separator before our dot, so we should
+        // have a good chance at having a non-empty extension
+        preDotState = -1;
+      }
+    }
+
+    if (
+      startDot === -1 ||
+      end === -1 ||
+      // We saw a non-dot character immediately before the dot
+      preDotState === 0 ||
+      // The (right-most) trimmed path component is exactly '..'
+      (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)
+    ) {
+      return '';
+    }
+    return path.slice(startDot, end);
+  },
+
+  format(pathObject): string {
+    if (pathObject === null || typeof pathObject !== 'object') {
+      throw new ErrorInvalidArgType('pathObject', 'Object', pathObject);
+    }
+
+    return _format('/', pathObject);
+  },
+
+  parse(path: string): ParsedPath {
+    validateString(path, 'path');
+
+    const ret = { root: '', dir: '', base: '', ext: '', name: '' };
+    if (path.length === 0) {
+      return ret;
+    }
+    const isAbsolute = path.charCodeAt(0) === CHAR_FORWARD_SLASH;
+    let start;
+    if (isAbsolute) {
+      ret.root = '/';
+      start = 1;
+    } else {
+      start = 0;
+    }
+    let startDot = -1;
+    let startPart = 0;
+    let end = -1;
+    let matchedSlash = true;
+    let i = path.length - 1;
+
+    // Track the state of characters (if any) we see before our first dot and
+    // after any path separator we find
+    let preDotState = 0;
+
+    // Get non-dir info
+    for (; i >= start; --i) {
+      const code = path.charCodeAt(i);
+      if (code === CHAR_FORWARD_SLASH) {
+        // If we reached a path separator that was not part of a set of path
+        // separators at the end of the string, stop now
+        if (!matchedSlash) {
+          startPart = i + 1;
+          break;
+        }
+        continue;
+      }
+      if (end === -1) {
+        // We saw the first non-path separator, mark this as the end of our
+        // extension
+        matchedSlash = false;
+        end = i + 1;
+      }
+      if (code === CHAR_DOT) {
+        // If this is our first dot, mark it as the start of our extension
+        if (startDot === -1) {
+          startDot = i;
+        } else if (preDotState !== 1) {
+          preDotState = 1;
+        }
+      } else if (startDot !== -1) {
+        // We saw a non-dot and non-path separator before our dot, so we should
+        // have a good chance at having a non-empty extension
+        preDotState = -1;
+      }
+    }
+
+    if (
+      startDot === -1 ||
+      end === -1 ||
+      // We saw a non-dot character immediately before the dot
+      preDotState === 0 ||
+      // The (right-most) trimmed path component is exactly '..'
+      (preDotState === 1 && startDot === end - 1 && startDot === startPart + 1)
+    ) {
+      if (end !== -1) {
+        if (startPart === 0 && isAbsolute) {
+          ret.base = ret.name = path.slice(1, end);
+        } else {
+          ret.base = ret.name = path.slice(startPart, end);
+        }
+      }
+    } else {
+      if (startPart === 0 && isAbsolute) {
+        ret.name = path.slice(1, startDot);
+        ret.base = path.slice(1, end);
+      } else {
+        ret.name = path.slice(startPart, startDot);
+        ret.base = path.slice(startPart, end);
+      }
+      ret.ext = path.slice(startDot, end);
+    }
+
+    if (startPart > 0) {
+      ret.dir = path.slice(0, startPart - 1);
+    } else if (isAbsolute) {
+      ret.dir = '/';
+    }
+
+    return ret;
+  },
+
+  sep: '/',
+  delimiter: ':',
+  win32: null,
+  posix: null,
+};
+
+posix.win32 = win32.win32 = win32;
+posix.posix = win32.posix = posix;
+
+/**
+ * Takes a Windows OS path and changes backward slashes to forward slashes.
+ * This should only be done for OS paths from Windows (or user provided paths potentially from Windows).
+ * Using it on a Linux or MaxOS path might change it.
+ */
+export function toSlashes(osPath: string) {
+  return osPath.replace(/[\\/]/g, posix.sep);
+}
+
+export const normalize = process.platform === 'win32' ? win32.normalize : posix.normalize;
+export const isAbsolute = process.platform === 'win32' ? win32.isAbsolute : posix.isAbsolute;
+export const join = process.platform === 'win32' ? win32.join : posix.join;
+export const resolve = process.platform === 'win32' ? win32.resolve : posix.resolve;
+export const relative = process.platform === 'win32' ? win32.relative : posix.relative;
+export const dirname = process.platform === 'win32' ? win32.dirname : posix.dirname;
+export const basename = process.platform === 'win32' ? win32.basename : posix.basename;
+export const extname = process.platform === 'win32' ? win32.extname : posix.extname;
+export const format = process.platform === 'win32' ? win32.format : posix.format;
+export const parse = process.platform === 'win32' ? win32.parse : posix.parse;
+export const toNamespacedPath = process.platform === 'win32' ? win32.toNamespacedPath : posix.toNamespacedPath;
+export const sep = process.platform === 'win32' ? win32.sep : posix.sep;
+export const delimiter = process.platform === 'win32' ? win32.delimiter : posix.delimiter;
+
+export function replaceAsarInPath(pathMayInAsar: string) {
+  parse(pathMayInAsar);
+  const parts = pathMayInAsar.split(normalize('/'));
+  parts.forEach((part, i) => {
+    if (part.endsWith('.asar')) {
+      parts[i] = part + '.unpacked';
+    }
+  });
+  return parts.join(normalize('/'));
+}
+
+// Reference: https://en.wikipedia.org/wiki/Filename
+const WINDOWS_INVALID_FILE_CHARS = /[\\/:*?"<>|]/g;
+const UNIX_INVALID_FILE_CHARS = /[\\/]/g;
+const WINDOWS_FORBIDDEN_NAMES = /^(con|prn|aux|clock\$|nul|lpt[0-9]|com[0-9])$/i;
+export function isValidBasename(name: string | null | undefined, isWindowsOS: boolean = isWindows): boolean {
+  const invalidFileChars = isWindowsOS ? WINDOWS_INVALID_FILE_CHARS : UNIX_INVALID_FILE_CHARS;
+
+  if (!name || name.length === 0 || /^\s+$/.test(name)) {
+    return false; // require a name that is not just whitespace
+  }
+
+  invalidFileChars.lastIndex = 0; // the holy grail of software development
+  if (invalidFileChars.test(name)) {
+    return false; // check for certain invalid file characters
+  }
+
+  if (isWindowsOS && WINDOWS_FORBIDDEN_NAMES.test(name)) {
+    return false; // check for certain invalid file names
+  }
+
+  if (name === '.' || name === '..') {
+    return false; // check for reserved values
+  }
+
+  if (isWindowsOS && name[name.length - 1] === '.') {
+    return false; // Windows: file cannot end with a "."
+  }
+
+  if (isWindowsOS && name.length !== name.trim().length) {
+    return false; // Windows: file cannot end with a whitespace
+  }
+
+  if (name.length > 255) {
+    return false; // most file systems do not allow files > 255 length
+  }
+
+  return true;
+}