@wo658/redpact 0.3.0 → 0.5.0

package/node_modules/@rushstack/node-core-library/lib/Path.js

@@ -0,0 +1,224 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Path = void 0;
+const path = __importStar(require("path"));
+/**
+ * Common operations for manipulating file and directory paths.
+ * @remarks
+ * This API is intended to eventually be a complete replacement for the NodeJS "path" API.
+ * @public
+ */
+class Path {
+    /**
+     * Returns true if "childPath" is located inside the "parentFolderPath" folder
+     * or one of its child folders.  Note that "parentFolderPath" is not considered to be
+     * under itself.  The "childPath" can refer to any type of file system object.
+     *
+     * @remarks
+     * The indicated file/folder objects are not required to actually exist on disk.
+     * For example, "parentFolderPath" is interpreted as a folder name even if it refers to a file.
+     * If the paths are relative, they will first be resolved using path.resolve().
+     */
+    static isUnder(childPath, parentFolderPath) {
+        // If childPath is under parentPath, then relativePath will be something like
+        // "../.." or "..\\..", which consists entirely of periods and slashes.
+        // (Note that something like "....t" is actually a valid filename, but "...." is not.)
+        const relativePath = path.relative(childPath, parentFolderPath);
+        return Path._relativePathRegex.test(relativePath);
+    }
+    /**
+     * Returns true if "childPath" is equal to "parentFolderPath", or if it is inside that folder
+     * or one of its children.  The "childPath" can refer to any type of file system object.
+     *
+     * @remarks
+     * The indicated file/folder objects are not required to actually exist on disk.
+     * For example, "parentFolderPath" is interpreted as a folder name even if it refers to a file.
+     * If the paths are relative, they will first be resolved using path.resolve().
+     */
+    static isUnderOrEqual(childPath, parentFolderPath) {
+        const relativePath = path.relative(childPath, parentFolderPath);
+        return relativePath === '' || Path._relativePathRegex.test(relativePath);
+    }
+    /**
+     * Returns true if `path1` and `path2` refer to the same underlying path.
+     *
+     * @remarks
+     *
+     * The comparison is performed using `path.relative()`.
+     */
+    static isEqual(path1, path2) {
+        return path.relative(path1, path2) === '';
+    }
+    /**
+     * Formats a path to look nice for reporting purposes.
+     * @remarks
+     * If `pathToConvert` is under the `baseFolder`, then it will be converted to a relative with the `./` prefix
+     * unless the {@link IPathFormatConciselyOptions.trimLeadingDotSlash} option is set to `true`.
+     * Otherwise, it will be converted to an absolute path.
+     *
+     * Backslashes will be converted to slashes, unless the path starts with an OS-specific string like `C:\`.
+     */
+    static formatConcisely(options) {
+        // Same logic as Path.isUnderOrEqual()
+        const relativePath = path.relative(options.pathToConvert, options.baseFolder);
+        const isUnderOrEqual = relativePath === '' || Path._relativePathRegex.test(relativePath);
+        if (isUnderOrEqual) {
+            // Note that isUnderOrEqual()'s relativePath is the reverse direction
+            const convertedPath = Path.convertToSlashes(path.relative(options.baseFolder, options.pathToConvert));
+            if (options.trimLeadingDotSlash) {
+                return convertedPath;
+            }
+            else {
+                return `./${convertedPath}`;
+            }
+        }
+        const absolutePath = path.resolve(options.pathToConvert);
+        return absolutePath;
+    }
+    /**
+     * Formats a file location to look nice for reporting purposes.
+     * @remarks
+     * If `pathToFormat` is under the `baseFolder`, then it will be converted to a relative with the `./` prefix.
+     * Otherwise, it will be converted to an absolute path.
+     *
+     * Backslashes will be converted to slashes, unless the path starts with an OS-specific string like `C:\`.
+     */
+    static formatFileLocation(options) {
+        const { message, format, pathToFormat, baseFolder, line, column } = options;
+        // Convert the path to be relative to the base folder, if specified. Otherwise, use
+        // the path as-is.
+        const filePath = baseFolder
+            ? Path.formatConcisely({
+                pathToConvert: pathToFormat,
+                baseFolder,
+                trimLeadingDotSlash: true
+            })
+            : path.resolve(pathToFormat);
+        let formattedFileLocation;
+        switch (format) {
+            case 'Unix': {
+                if (line !== undefined && column !== undefined) {
+                    formattedFileLocation = `:${line}:${column}`;
+                }
+                else if (line !== undefined) {
+                    formattedFileLocation = `:${line}`;
+                }
+                else {
+                    formattedFileLocation = '';
+                }
+                break;
+            }
+            case 'VisualStudio': {
+                if (line !== undefined && column !== undefined) {
+                    formattedFileLocation = `(${line},${column})`;
+                }
+                else if (line !== undefined) {
+                    formattedFileLocation = `(${line})`;
+                }
+                else {
+                    formattedFileLocation = '';
+                }
+                break;
+            }
+            default: {
+                throw new Error(`Unknown format: ${format}`);
+            }
+        }
+        return `${filePath}${formattedFileLocation} - ${message}`;
+    }
+    /**
+     * Replaces Windows-style backslashes with POSIX-style slashes.
+     *
+     * @remarks
+     * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+     */
+    static convertToSlashes(inputPath) {
+        return inputPath.replace(/\\/g, '/');
+    }
+    /**
+     * Replaces POSIX-style slashes with Windows-style backslashes
+     *
+     * @remarks
+     * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+     */
+    static convertToBackslashes(inputPath) {
+        return inputPath.replace(/\//g, '\\');
+    }
+    /**
+     * Replaces slashes or backslashes with the appropriate slash for the current operating system.
+     */
+    static convertToPlatformDefault(inputPath) {
+        return path.sep === '/' ? Path.convertToSlashes(inputPath) : Path.convertToBackslashes(inputPath);
+    }
+    /**
+     * Returns true if the specified path is a relative path and does not use `..` to walk upwards.
+     *
+     * @example
+     * ```ts
+     * // These evaluate to true
+     * isDownwardRelative('folder');
+     * isDownwardRelative('file');
+     * isDownwardRelative('folder/');
+     * isDownwardRelative('./folder/');
+     * isDownwardRelative('./folder/file');
+     *
+     * // These evaluate to false
+     * isDownwardRelative('../folder');
+     * isDownwardRelative('folder/../file');
+     * isDownwardRelative('/folder/file');
+     * ```
+     */
+    static isDownwardRelative(inputPath) {
+        if (path.isAbsolute(inputPath)) {
+            return false;
+        }
+        // Does it contain ".."
+        if (Path._upwardPathSegmentRegex.test(inputPath)) {
+            return false;
+        }
+        return true;
+    }
+}
+exports.Path = Path;
+// Matches a relative path consisting entirely of periods and slashes
+// Example: ".", "..", "../..", etc
+Path._relativePathRegex = /^[.\/\\]+$/;
+// Matches a relative path segment that traverses upwards
+// Example: "a/../b"
+Path._upwardPathSegmentRegex = /([\/\\]|^)\.\.([\/\\]|$)/;
+//# sourceMappingURL=Path.js.map

package/node_modules/@rushstack/node-core-library/lib/Path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Path.js","sourceRoot":"","sources":["../src/Path.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport * as path from 'path';\n\n/**\n * The format that the FileError message should conform to. The supported formats are:\n *  - Unix: `<path>:<line>:<column> - <message>`\n *  - VisualStudio: `<path>(<line>,<column>) - <message>`\n *\n * @public\n */\nexport type FileLocationStyle = 'Unix' | 'VisualStudio';\n\n/**\n * Options for {@link Path.formatFileLocation}.\n * @public\n */\nexport interface IPathFormatFileLocationOptions {\n  /**\n   * The base path to use when converting `pathToFormat` to a relative path. If not specified,\n   * `pathToFormat` will be used as-is.\n   */\n  baseFolder?: string;\n  /**\n   * The path that will be used to specify the file location.\n   */\n  pathToFormat: string;\n  /**\n   * The message related to the file location.\n   */\n  message: string;\n  /**\n   * The style of file location formatting to use.\n   */\n  format: FileLocationStyle;\n  /**\n   * The optional line number. If not specified, the line number will not be included\n   * in the formatted string.\n   */\n  line?: number;\n  /**\n   * The optional column number. If not specified, the column number will not be included\n   * in the formatted string.\n   */\n  column?: number;\n}\n\n/**\n * Options for {@link Path.formatConcisely}.\n * @public\n */\nexport interface IPathFormatConciselyOptions {\n  /**\n   * The path to be converted.\n   */\n  pathToConvert: string;\n\n  /**\n   * The base path to use when converting `pathToConvert` to a relative path.\n   */\n  baseFolder: string;\n\n  /**\n   * If set to true, don't include the leading `./` if the path is under the base folder.\n   */\n  trimLeadingDotSlash?: boolean;\n}\n\n/**\n * Common operations for manipulating file and directory paths.\n * @remarks\n * This API is intended to eventually be a complete replacement for the NodeJS \"path\" API.\n * @public\n */\nexport class Path {\n  // Matches a relative path consisting entirely of periods and slashes\n  // Example: \".\", \"..\", \"../..\", etc\n  private static _relativePathRegex: RegExp = /^[.\\/\\\\]+$/;\n\n  // Matches a relative path segment that traverses upwards\n  // Example: \"a/../b\"\n  private static _upwardPathSegmentRegex: RegExp = /([\\/\\\\]|^)\\.\\.([\\/\\\\]|$)/;\n\n  /**\n   * Returns true if \"childPath\" is located inside the \"parentFolderPath\" folder\n   * or one of its child folders.  Note that \"parentFolderPath\" is not considered to be\n   * under itself.  The \"childPath\" can refer to any type of file system object.\n   *\n   * @remarks\n   * The indicated file/folder objects are not required to actually exist on disk.\n   * For example, \"parentFolderPath\" is interpreted as a folder name even if it refers to a file.\n   * If the paths are relative, they will first be resolved using path.resolve().\n   */\n  public static isUnder(childPath: string, parentFolderPath: string): boolean {\n    // If childPath is under parentPath, then relativePath will be something like\n    // \"../..\" or \"..\\\\..\", which consists entirely of periods and slashes.\n    // (Note that something like \"....t\" is actually a valid filename, but \"....\" is not.)\n    const relativePath: string = path.relative(childPath, parentFolderPath);\n    return Path._relativePathRegex.test(relativePath);\n  }\n\n  /**\n   * Returns true if \"childPath\" is equal to \"parentFolderPath\", or if it is inside that folder\n   * or one of its children.  The \"childPath\" can refer to any type of file system object.\n   *\n   * @remarks\n   * The indicated file/folder objects are not required to actually exist on disk.\n   * For example, \"parentFolderPath\" is interpreted as a folder name even if it refers to a file.\n   * If the paths are relative, they will first be resolved using path.resolve().\n   */\n  public static isUnderOrEqual(childPath: string, parentFolderPath: string): boolean {\n    const relativePath: string = path.relative(childPath, parentFolderPath);\n    return relativePath === '' || Path._relativePathRegex.test(relativePath);\n  }\n\n  /**\n   * Returns true if `path1` and `path2` refer to the same underlying path.\n   *\n   * @remarks\n   *\n   * The comparison is performed using `path.relative()`.\n   */\n  public static isEqual(path1: string, path2: string): boolean {\n    return path.relative(path1, path2) === '';\n  }\n\n  /**\n   * Formats a path to look nice for reporting purposes.\n   * @remarks\n   * If `pathToConvert` is under the `baseFolder`, then it will be converted to a relative with the `./` prefix\n   * unless the {@link IPathFormatConciselyOptions.trimLeadingDotSlash} option is set to `true`.\n   * Otherwise, it will be converted to an absolute path.\n   *\n   * Backslashes will be converted to slashes, unless the path starts with an OS-specific string like `C:\\`.\n   */\n  public static formatConcisely(options: IPathFormatConciselyOptions): string {\n    // Same logic as Path.isUnderOrEqual()\n    const relativePath: string = path.relative(options.pathToConvert, options.baseFolder);\n    const isUnderOrEqual: boolean = relativePath === '' || Path._relativePathRegex.test(relativePath);\n\n    if (isUnderOrEqual) {\n      // Note that isUnderOrEqual()'s relativePath is the reverse direction\n      const convertedPath: string = Path.convertToSlashes(\n        path.relative(options.baseFolder, options.pathToConvert)\n      );\n      if (options.trimLeadingDotSlash) {\n        return convertedPath;\n      } else {\n        return `./${convertedPath}`;\n      }\n    }\n\n    const absolutePath: string = path.resolve(options.pathToConvert);\n    return absolutePath;\n  }\n\n  /**\n   * Formats a file location to look nice for reporting purposes.\n   * @remarks\n   * If `pathToFormat` is under the `baseFolder`, then it will be converted to a relative with the `./` prefix.\n   * Otherwise, it will be converted to an absolute path.\n   *\n   * Backslashes will be converted to slashes, unless the path starts with an OS-specific string like `C:\\`.\n   */\n  public static formatFileLocation(options: IPathFormatFileLocationOptions): string {\n    const { message, format, pathToFormat, baseFolder, line, column } = options;\n\n    // Convert the path to be relative to the base folder, if specified. Otherwise, use\n    // the path as-is.\n    const filePath: string = baseFolder\n      ? Path.formatConcisely({\n          pathToConvert: pathToFormat,\n          baseFolder,\n          trimLeadingDotSlash: true\n        })\n      : path.resolve(pathToFormat);\n\n    let formattedFileLocation: string;\n    switch (format) {\n      case 'Unix': {\n        if (line !== undefined && column !== undefined) {\n          formattedFileLocation = `:${line}:${column}`;\n        } else if (line !== undefined) {\n          formattedFileLocation = `:${line}`;\n        } else {\n          formattedFileLocation = '';\n        }\n\n        break;\n      }\n\n      case 'VisualStudio': {\n        if (line !== undefined && column !== undefined) {\n          formattedFileLocation = `(${line},${column})`;\n        } else if (line !== undefined) {\n          formattedFileLocation = `(${line})`;\n        } else {\n          formattedFileLocation = '';\n        }\n\n        break;\n      }\n\n      default: {\n        throw new Error(`Unknown format: ${format}`);\n      }\n    }\n\n    return `${filePath}${formattedFileLocation} - ${message}`;\n  }\n\n  /**\n   * Replaces Windows-style backslashes with POSIX-style slashes.\n   *\n   * @remarks\n   * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.\n   */\n  public static convertToSlashes(inputPath: string): string {\n    return inputPath.replace(/\\\\/g, '/');\n  }\n\n  /**\n   * Replaces POSIX-style slashes with Windows-style backslashes\n   *\n   * @remarks\n   * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.\n   */\n  public static convertToBackslashes(inputPath: string): string {\n    return inputPath.replace(/\\//g, '\\\\');\n  }\n  /**\n   * Replaces slashes or backslashes with the appropriate slash for the current operating system.\n   */\n  public static convertToPlatformDefault(inputPath: string): string {\n    return path.sep === '/' ? Path.convertToSlashes(inputPath) : Path.convertToBackslashes(inputPath);\n  }\n\n  /**\n   * Returns true if the specified path is a relative path and does not use `..` to walk upwards.\n   *\n   * @example\n   * ```ts\n   * // These evaluate to true\n   * isDownwardRelative('folder');\n   * isDownwardRelative('file');\n   * isDownwardRelative('folder/');\n   * isDownwardRelative('./folder/');\n   * isDownwardRelative('./folder/file');\n   *\n   * // These evaluate to false\n   * isDownwardRelative('../folder');\n   * isDownwardRelative('folder/../file');\n   * isDownwardRelative('/folder/file');\n   * ```\n   */\n  public static isDownwardRelative(inputPath: string): boolean {\n    if (path.isAbsolute(inputPath)) {\n      return false;\n    }\n    // Does it contain \"..\"\n    if (Path._upwardPathSegmentRegex.test(inputPath)) {\n      return false;\n    }\n    return true;\n  }\n}\n"]}

package/node_modules/@rushstack/node-core-library/lib/PosixModeBits.d.ts

@@ -0,0 +1,73 @@
+/**
+ * An integer value used to specify file permissions for POSIX-like operating systems.
+ *
+ * @remarks
+ *
+ * This bitfield corresponds to the "mode_t" structure described in this document:
+ * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_stat.h.html
+ *
+ * It is used with NodeJS APIs such as fs.Stat.mode and fs.chmodSync().  These values
+ * represent a set of permissions and can be combined using bitwise arithmetic.
+ *
+ * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+ *
+ * @public
+ */
+export declare enum PosixModeBits {
+    /**
+     * Indicates that the item's owner can read the item.
+     */
+    UserRead = 256,
+    /**
+     * Indicates that the item's owner can modify the item.
+     */
+    UserWrite = 128,
+    /**
+     * Indicates that the item's owner can execute the item (if it is a file)
+     * or search the item (if it is a directory).
+     */
+    UserExecute = 64,
+    /**
+     * Indicates that users belonging to the item's group can read the item.
+     */
+    GroupRead = 32,
+    /**
+     * Indicates that users belonging to the item's group can modify the item.
+     */
+    GroupWrite = 16,
+    /**
+     * Indicates that users belonging to the item's group can execute the item (if it is a file)
+     * or search the item (if it is a directory).
+     */
+    GroupExecute = 8,
+    /**
+     * Indicates that other users (besides the item's owner user or group) can read the item.
+     */
+    OthersRead = 4,
+    /**
+     * Indicates that other users (besides the item's owner user or group) can modify the item.
+     */
+    OthersWrite = 2,
+    /**
+     * Indicates that other users (besides the item's owner user or group) can execute the item (if it is a file)
+     * or search the item (if it is a directory).
+     */
+    OthersExecute = 1,
+    /**
+     * A zero value where no permissions bits are set.
+     */
+    None = 0,
+    /**
+     * An alias combining OthersRead, GroupRead, and UserRead permission bits.
+     */
+    AllRead = 292,
+    /**
+     * An alias combining OthersWrite, GroupWrite, and UserWrite permission bits.
+     */
+    AllWrite = 146,
+    /**
+     * An alias combining OthersExecute, GroupExecute, and UserExecute permission bits.
+     */
+    AllExecute = 73
+}
+//# sourceMappingURL=PosixModeBits.d.ts.map

package/node_modules/@rushstack/node-core-library/lib/PosixModeBits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PosixModeBits.d.ts","sourceRoot":"","sources":["../src/PosixModeBits.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,oBAAY,aAAa;IAGvB;;OAEG;IACH,QAAQ,MAAS;IAEjB;;OAEG;IACH,SAAS,MAAS;IAElB;;;OAGG;IACH,WAAW,KAAS;IAEpB;;OAEG;IACH,SAAS,KAAS;IAElB;;OAEG;IACH,UAAU,KAAS;IAEnB;;;OAGG;IACH,YAAY,IAAS;IAErB;;OAEG;IACH,UAAU,IAAS;IAEnB;;OAEG;IACH,WAAW,IAAS;IAEpB;;;OAGG;IACH,aAAa,IAAS;IAItB;;OAEG;IACH,IAAI,IAAI;IAER;;OAEG;IACH,OAAO,MAAoC;IAE3C;;OAEG;IACH,QAAQ,MAAuC;IAE/C;;OAEG;IACH,UAAU,KAA6C;CACxD"}

package/node_modules/@rushstack/node-core-library/lib/PosixModeBits.js

@@ -0,0 +1,83 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PosixModeBits = void 0;
+// The PosixModeBits are intended to be used with bitwise operations.
+/* eslint-disable no-bitwise */
+/**
+ * An integer value used to specify file permissions for POSIX-like operating systems.
+ *
+ * @remarks
+ *
+ * This bitfield corresponds to the "mode_t" structure described in this document:
+ * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_stat.h.html
+ *
+ * It is used with NodeJS APIs such as fs.Stat.mode and fs.chmodSync().  These values
+ * represent a set of permissions and can be combined using bitwise arithmetic.
+ *
+ * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+ *
+ * @public
+ */
+var PosixModeBits;
+(function (PosixModeBits) {
+    // The bits
+    /**
+     * Indicates that the item's owner can read the item.
+     */
+    PosixModeBits[PosixModeBits["UserRead"] = 256] = "UserRead";
+    /**
+     * Indicates that the item's owner can modify the item.
+     */
+    PosixModeBits[PosixModeBits["UserWrite"] = 128] = "UserWrite";
+    /**
+     * Indicates that the item's owner can execute the item (if it is a file)
+     * or search the item (if it is a directory).
+     */
+    PosixModeBits[PosixModeBits["UserExecute"] = 64] = "UserExecute";
+    /**
+     * Indicates that users belonging to the item's group can read the item.
+     */
+    PosixModeBits[PosixModeBits["GroupRead"] = 32] = "GroupRead";
+    /**
+     * Indicates that users belonging to the item's group can modify the item.
+     */
+    PosixModeBits[PosixModeBits["GroupWrite"] = 16] = "GroupWrite";
+    /**
+     * Indicates that users belonging to the item's group can execute the item (if it is a file)
+     * or search the item (if it is a directory).
+     */
+    PosixModeBits[PosixModeBits["GroupExecute"] = 8] = "GroupExecute";
+    /**
+     * Indicates that other users (besides the item's owner user or group) can read the item.
+     */
+    PosixModeBits[PosixModeBits["OthersRead"] = 4] = "OthersRead";
+    /**
+     * Indicates that other users (besides the item's owner user or group) can modify the item.
+     */
+    PosixModeBits[PosixModeBits["OthersWrite"] = 2] = "OthersWrite";
+    /**
+     * Indicates that other users (besides the item's owner user or group) can execute the item (if it is a file)
+     * or search the item (if it is a directory).
+     */
+    PosixModeBits[PosixModeBits["OthersExecute"] = 1] = "OthersExecute";
+    // Helpful aliases
+    /**
+     * A zero value where no permissions bits are set.
+     */
+    PosixModeBits[PosixModeBits["None"] = 0] = "None";
+    /**
+     * An alias combining OthersRead, GroupRead, and UserRead permission bits.
+     */
+    PosixModeBits[PosixModeBits["AllRead"] = 292] = "AllRead";
+    /**
+     * An alias combining OthersWrite, GroupWrite, and UserWrite permission bits.
+     */
+    PosixModeBits[PosixModeBits["AllWrite"] = 146] = "AllWrite";
+    /**
+     * An alias combining OthersExecute, GroupExecute, and UserExecute permission bits.
+     */
+    PosixModeBits[PosixModeBits["AllExecute"] = 73] = "AllExecute";
+})(PosixModeBits || (exports.PosixModeBits = PosixModeBits = {}));
+//# sourceMappingURL=PosixModeBits.js.map

package/node_modules/@rushstack/node-core-library/lib/PosixModeBits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PosixModeBits.js","sourceRoot":"","sources":["../src/PosixModeBits.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,qEAAqE;AACrE,+BAA+B;AAE/B;;;;;;;;;;;;;;GAcG;AACH,IAAY,aAwEX;AAxED,WAAY,aAAa;IACvB,WAAW;IAEX;;OAEG;IACH,2DAAiB,CAAA;IAEjB;;OAEG;IACH,6DAAkB,CAAA;IAElB;;;OAGG;IACH,gEAAoB,CAAA;IAEpB;;OAEG;IACH,4DAAkB,CAAA;IAElB;;OAEG;IACH,8DAAmB,CAAA;IAEnB;;;OAGG;IACH,iEAAqB,CAAA;IAErB;;OAEG;IACH,6DAAmB,CAAA;IAEnB;;OAEG;IACH,+DAAoB,CAAA;IAEpB;;;OAGG;IACH,mEAAsB,CAAA;IAEtB,kBAAkB;IAElB;;OAEG;IACH,iDAAQ,CAAA;IAER;;OAEG;IACH,yDAA2C,CAAA;IAE3C;;OAEG;IACH,2DAA+C,CAAA;IAE/C;;OAEG;IACH,8DAAuD,CAAA;AACzD,CAAC,EAxEW,aAAa,6BAAb,aAAa,QAwExB","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n// The PosixModeBits are intended to be used with bitwise operations.\n/* eslint-disable no-bitwise */\n\n/**\n * An integer value used to specify file permissions for POSIX-like operating systems.\n *\n * @remarks\n *\n * This bitfield corresponds to the \"mode_t\" structure described in this document:\n * http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_stat.h.html\n *\n * It is used with NodeJS APIs such as fs.Stat.mode and fs.chmodSync().  These values\n * represent a set of permissions and can be combined using bitwise arithmetic.\n *\n * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.\n *\n * @public\n */\nexport enum PosixModeBits {\n  // The bits\n\n  /**\n   * Indicates that the item's owner can read the item.\n   */\n  UserRead = 1 << 8,\n\n  /**\n   * Indicates that the item's owner can modify the item.\n   */\n  UserWrite = 1 << 7,\n\n  /**\n   * Indicates that the item's owner can execute the item (if it is a file)\n   * or search the item (if it is a directory).\n   */\n  UserExecute = 1 << 6,\n\n  /**\n   * Indicates that users belonging to the item's group can read the item.\n   */\n  GroupRead = 1 << 5,\n\n  /**\n   * Indicates that users belonging to the item's group can modify the item.\n   */\n  GroupWrite = 1 << 4,\n\n  /**\n   * Indicates that users belonging to the item's group can execute the item (if it is a file)\n   * or search the item (if it is a directory).\n   */\n  GroupExecute = 1 << 3,\n\n  /**\n   * Indicates that other users (besides the item's owner user or group) can read the item.\n   */\n  OthersRead = 1 << 2,\n\n  /**\n   * Indicates that other users (besides the item's owner user or group) can modify the item.\n   */\n  OthersWrite = 1 << 1,\n\n  /**\n   * Indicates that other users (besides the item's owner user or group) can execute the item (if it is a file)\n   * or search the item (if it is a directory).\n   */\n  OthersExecute = 1 << 0,\n\n  // Helpful aliases\n\n  /**\n   * A zero value where no permissions bits are set.\n   */\n  None = 0,\n\n  /**\n   * An alias combining OthersRead, GroupRead, and UserRead permission bits.\n   */\n  AllRead = OthersRead | GroupRead | UserRead,\n\n  /**\n   * An alias combining OthersWrite, GroupWrite, and UserWrite permission bits.\n   */\n  AllWrite = OthersWrite | GroupWrite | UserWrite,\n\n  /**\n   * An alias combining OthersExecute, GroupExecute, and UserExecute permission bits.\n   */\n  AllExecute = OthersExecute | GroupExecute | UserExecute\n}\n"]}

package/node_modules/@rushstack/node-core-library/lib/PrimitiveTypes.d.ts

@@ -0,0 +1,41 @@
+/**
+ * A "branded type" is a primitive type with a compile-type key that makes it incompatible with other
+ * aliases for the primitive type.
+ *
+ * @remarks
+ *
+ * Example usage:
+ *
+ * ```ts
+ * // PhoneNumber is a branded type based on the "string" primitive.
+ * type PhoneNumber = Brand<string, 'PhoneNumber'>;
+ *
+ * function createPhoneNumber(input: string): PhoneNumber {
+ *   if (!/\d+(\-\d+)+/.test(input)) {
+ *     throw new Error('Invalid phone number: ' + JSON.stringify(input));
+ *   }
+ *   return input as PhoneNumber;
+ * }
+ *
+ * const p1: PhoneNumber = createPhoneNumber('123-456-7890');
+ *
+ * // PhoneNumber is a string and can be used as one:
+ * const p2: string = p1;
+ *
+ * // But an arbitrary string cannot be implicitly type cast as PhoneNumber.
+ * // ERROR: Type 'string' is not assignable to type 'PhoneNumber'
+ * const p3: PhoneNumber = '123-456-7890';
+ * ```
+ *
+ * For more information about this pattern, see {@link
+ * https://github.com/Microsoft/TypeScript/blob/7b48a182c05ea4dea81bab73ecbbe9e013a79e99/src/compiler/types.ts#L693-L698
+ * | this comment} explaining the TypeScript compiler's introduction of this pattern, and
+ * {@link https://spin.atomicobject.com/2018/01/15/typescript-flexible-nominal-typing/ | this article}
+ * explaining the technique in depth.
+ *
+ * @public
+ */
+export type Brand<T, BrandTag extends string> = T & {
+    __brand: BrandTag;
+};
+//# sourceMappingURL=PrimitiveTypes.d.ts.map

package/node_modules/@rushstack/node-core-library/lib/PrimitiveTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrimitiveTypes.d.ts","sourceRoot":"","sources":["../src/PrimitiveTypes.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,QAAQ,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC"}

package/node_modules/@rushstack/node-core-library/lib/PrimitiveTypes.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=PrimitiveTypes.js.map

package/node_modules/@rushstack/node-core-library/lib/PrimitiveTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrimitiveTypes.js","sourceRoot":"","sources":["../src/PrimitiveTypes.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * A \"branded type\" is a primitive type with a compile-type key that makes it incompatible with other\n * aliases for the primitive type.\n *\n * @remarks\n *\n * Example usage:\n *\n * ```ts\n * // PhoneNumber is a branded type based on the \"string\" primitive.\n * type PhoneNumber = Brand<string, 'PhoneNumber'>;\n *\n * function createPhoneNumber(input: string): PhoneNumber {\n *   if (!/\\d+(\\-\\d+)+/.test(input)) {\n *     throw new Error('Invalid phone number: ' + JSON.stringify(input));\n *   }\n *   return input as PhoneNumber;\n * }\n *\n * const p1: PhoneNumber = createPhoneNumber('123-456-7890');\n *\n * // PhoneNumber is a string and can be used as one:\n * const p2: string = p1;\n *\n * // But an arbitrary string cannot be implicitly type cast as PhoneNumber.\n * // ERROR: Type 'string' is not assignable to type 'PhoneNumber'\n * const p3: PhoneNumber = '123-456-7890';\n * ```\n *\n * For more information about this pattern, see {@link\n * https://github.com/Microsoft/TypeScript/blob/7b48a182c05ea4dea81bab73ecbbe9e013a79e99/src/compiler/types.ts#L693-L698\n * | this comment} explaining the TypeScript compiler's introduction of this pattern, and\n * {@link https://spin.atomicobject.com/2018/01/15/typescript-flexible-nominal-typing/ | this article}\n * explaining the technique in depth.\n *\n * @public\n */\nexport type Brand<T, BrandTag extends string> = T & { __brand: BrandTag };\n"]}

package/node_modules/@rushstack/node-core-library/lib/ProtectableMap.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Constructor parameters for {@link ProtectableMap}
+ *
+ * @public
+ */
+export interface IProtectableMapParameters<K, V> {
+    /**
+     * An optional hook that will be invoked before Map.clear() is performed.
+     */
+    onClear?: (source: ProtectableMap<K, V>) => void;
+    /**
+     * An optional hook that will be invoked before Map.delete() is performed.
+     */
+    onDelete?: (source: ProtectableMap<K, V>, key: K) => void;
+    /**
+     * An optional hook that will be invoked before Map.set() is performed.
+     * @remarks
+     * If this hook is provided, the function MUST return the `value` parameter.
+     * This provides the opportunity to modify the value before it is added
+     * to the map.
+     */
+    onSet?: (source: ProtectableMap<K, V>, key: K, value: V) => V;
+}
+/**
+ * The ProtectableMap provides an easy way for an API to expose a `Map<K, V>` property
+ * while intercepting and validating any write operations that are performed by
+ * consumers of the API.
+ *
+ * @remarks
+ * The ProtectableMap itself is intended to be a private object that only its owner
+ * can access directly.  Any operations performed directly on the ProtectableMap will
+ * bypass the hooks and any validation they perform.  The public property that is exposed
+ * to API consumers should return {@link ProtectableMap.protectedView} instead.
+ *
+ * For example, suppose you want to share your `Map<string, number>` data structure,
+ * but you want to enforce that the key must always be an upper case string:
+ * You could use the onSet() hook to validate the keys and throw an exception
+ * if the key is not uppercase.
+ *
+ * @public
+ */
+export declare class ProtectableMap<K, V> {
+    private readonly _protectedView;
+    constructor(parameters: IProtectableMapParameters<K, V>);
+    /**
+     * The owner of the protectable map should return this object via its public API.
+     */
+    get protectedView(): Map<K, V>;
+    /**
+     * Removes all entries from the map.
+     * This operation does NOT invoke the ProtectableMap onClear() hook.
+     */
+    clear(): void;
+    /**
+     * Removes the specified key from the map.
+     * This operation does NOT invoke the ProtectableMap onDelete() hook.
+     */
+    delete(key: K): boolean;
+    /**
+     * Sets a value for the specified key.
+     * This operation does NOT invoke the ProtectableMap onSet() hook.
+     */
+    set(key: K, value: V): this;
+    /**
+     * Performs an operation for each (key, value) entries in the map.
+     */
+    forEach(callbackfn: (value: V, key: K, map: Map<K, V>) => void, thisArg?: any): void;
+    /**
+     * Retrieves the value for the specified key.
+     * @returns undefined if the value is undefined OR if the key is missing;
+     * otherwise returns the value associated with the key.
+     */
+    get(key: K): V | undefined;
+    /**
+     * Returns true if the specified key belongs to the map.
+     */
+    has(key: K): boolean;
+    /**
+     * Returns the number of (key, value) entries in the map.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=ProtectableMap.d.ts.map

package/node_modules/@rushstack/node-core-library/lib/ProtectableMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtectableMap.d.ts","sourceRoot":"","sources":["../src/ProtectableMap.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC,EAAE,CAAC;IAC7C;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAE1D;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc,CAAC,CAAC,EAAE,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;gBAEvC,UAAU,EAAE,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC;IAI9D;;OAEG;IACH,IAAW,aAAa,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAEpC;IAKD;;;OAGG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAI9B;;;OAGG;IACI,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQlC;;OAEG;IAEI,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,IAAI;IAI3F;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAIjC;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAI3B;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;CACF"}

package/node_modules/@rushstack/node-core-library/lib/ProtectableMap.js

@@ -0,0 +1,90 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtectableMap = void 0;
+const ProtectableMapView_1 = require("./ProtectableMapView");
+/**
+ * The ProtectableMap provides an easy way for an API to expose a `Map<K, V>` property
+ * while intercepting and validating any write operations that are performed by
+ * consumers of the API.
+ *
+ * @remarks
+ * The ProtectableMap itself is intended to be a private object that only its owner
+ * can access directly.  Any operations performed directly on the ProtectableMap will
+ * bypass the hooks and any validation they perform.  The public property that is exposed
+ * to API consumers should return {@link ProtectableMap.protectedView} instead.
+ *
+ * For example, suppose you want to share your `Map<string, number>` data structure,
+ * but you want to enforce that the key must always be an upper case string:
+ * You could use the onSet() hook to validate the keys and throw an exception
+ * if the key is not uppercase.
+ *
+ * @public
+ */
+class ProtectableMap {
+    constructor(parameters) {
+        this._protectedView = new ProtectableMapView_1.ProtectableMapView(this, parameters);
+    }
+    /**
+     * The owner of the protectable map should return this object via its public API.
+     */
+    get protectedView() {
+        return this._protectedView;
+    }
+    // ---------------------------------------------------------------------------
+    // lib.es2015.collections contract - write operations
+    /**
+     * Removes all entries from the map.
+     * This operation does NOT invoke the ProtectableMap onClear() hook.
+     */
+    clear() {
+        this._protectedView._clearUnprotected();
+    }
+    /**
+     * Removes the specified key from the map.
+     * This operation does NOT invoke the ProtectableMap onDelete() hook.
+     */
+    delete(key) {
+        return this._protectedView._deleteUnprotected(key);
+    }
+    /**
+     * Sets a value for the specified key.
+     * This operation does NOT invoke the ProtectableMap onSet() hook.
+     */
+    set(key, value) {
+        this._protectedView._setUnprotected(key, value);
+        return this;
+    }
+    // ---------------------------------------------------------------------------
+    // lib.es2015.collections contract - read operations
+    /**
+     * Performs an operation for each (key, value) entries in the map.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    forEach(callbackfn, thisArg) {
+        this._protectedView.forEach(callbackfn);
+    }
+    /**
+     * Retrieves the value for the specified key.
+     * @returns undefined if the value is undefined OR if the key is missing;
+     * otherwise returns the value associated with the key.
+     */
+    get(key) {
+        return this._protectedView.get(key);
+    }
+    /**
+     * Returns true if the specified key belongs to the map.
+     */
+    has(key) {
+        return this._protectedView.has(key);
+    }
+    /**
+     * Returns the number of (key, value) entries in the map.
+     */
+    get size() {
+        return this._protectedView.size;
+    }
+}
+exports.ProtectableMap = ProtectableMap;
+//# sourceMappingURL=ProtectableMap.js.map