@wo658/redpact 0.3.0 → 0.5.0

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

@@ -0,0 +1,142 @@
+/**
+ * A package name that has been separated into its scope and unscoped name.
+ *
+ * @public
+ */
+export interface IParsedPackageName {
+    /**
+     * The parsed NPM scope, or an empty string if there was no scope.  The scope value will
+     * always include the at-sign.
+     * @remarks
+     * For example, if the parsed input was "\@scope/example", then scope would be "\@scope".
+     */
+    scope: string;
+    /**
+     * The parsed NPM package name without the scope.
+     * @remarks
+     * For example, if the parsed input was "\@scope/example", then the name would be "example".
+     */
+    unscopedName: string;
+}
+/**
+ * Result object returned by {@link PackageName.tryParse}
+ *
+ * @public
+ */
+export interface IParsedPackageNameOrError extends IParsedPackageName {
+    /**
+     * If the input string could not be parsed, then this string will contain a nonempty
+     * error message.  Otherwise it will be an empty string.
+     */
+    error: string;
+}
+/**
+ * Options that configure the validation rules used by a {@link PackageNameParser} instance.
+ *
+ * @remarks
+ * The default validation is based on the npmjs.com registry's policy for published packages, and includes these
+ * restrictions:
+ *
+ * - The package name cannot be longer than 214 characters.
+ *
+ * - The package name must not be empty.
+ *
+ * - Other than the `@` and `/` delimiters used for scopes, the only allowed characters
+ *   are letters, numbers, `-`, `_`, and `.`.
+ *
+ * - The name must not start with a `.` or `_`.
+ *
+ * @public
+ */
+export interface IPackageNameParserOptions {
+    /**
+     * If true, allows upper-case letters in package names.
+     * This improves compatibility with some legacy private registries that still allow that.
+     */
+    allowUpperCase?: boolean;
+}
+/**
+ * A configurable parser for validating and manipulating NPM package names such as `my-package` or `@scope/my-package`.
+ *
+ * @remarks
+ * If you do not need to customize the parser configuration, it is recommended to use {@link PackageName}
+ * which exposes these operations as a simple static class.
+ *
+ * @public
+ */
+export declare class PackageNameParser {
+    private static readonly _invalidNameCharactersRegExp;
+    private readonly _options;
+    constructor(options?: IPackageNameParserOptions);
+    /**
+     * This attempts to parse a package name that may include a scope component.
+     * The packageName must not be an empty string.
+     * @remarks
+     * This function will not throw an exception.
+     *
+     * @returns an {@link IParsedPackageNameOrError} structure whose `error` property will be
+     * nonempty if the string could not be parsed.
+     */
+    tryParse(packageName: string): IParsedPackageNameOrError;
+    /**
+     * Same as {@link PackageName.tryParse}, except this throws an exception if the input
+     * cannot be parsed.
+     * @remarks
+     * The packageName must not be an empty string.
+     */
+    parse(packageName: string): IParsedPackageName;
+    /**
+     * {@inheritDoc IParsedPackageName.scope}
+     */
+    getScope(packageName: string): string;
+    /**
+     * {@inheritDoc IParsedPackageName.unscopedName}
+     */
+    getUnscopedName(packageName: string): string;
+    /**
+     * Returns true if the specified package name is valid, or false otherwise.
+     * @remarks
+     * This function will not throw an exception.
+     */
+    isValidName(packageName: string): boolean;
+    /**
+     * Throws an exception if the specified name is not a valid package name.
+     * The packageName must not be an empty string.
+     */
+    validate(packageName: string): void;
+    /**
+     * Combines an optional package scope with an unscoped root name.
+     * @param scope - Must be either an empty string, or a scope name such as "\@example"
+     * @param unscopedName - Must be a nonempty package name that does not contain a scope
+     * @returns A full package name such as "\@example/some-library".
+     */
+    combineParts(scope: string, unscopedName: string): string;
+}
+/**
+ * Provides basic operations for validating and manipulating NPM package names such as `my-package`
+ * or `@scope/my-package`.
+ *
+ * @remarks
+ * This is the default implementation of {@link PackageNameParser}, exposed as a convenient static class.
+ * If you need to configure the parsing rules, use `PackageNameParser` instead.
+ *
+ * @public
+ */
+export declare class PackageName {
+    private static readonly _parser;
+    /** {@inheritDoc PackageNameParser.tryParse} */
+    static tryParse(packageName: string): IParsedPackageNameOrError;
+    /** {@inheritDoc PackageNameParser.parse} */
+    static parse(packageName: string): IParsedPackageName;
+    /** {@inheritDoc PackageNameParser.getScope} */
+    static getScope(packageName: string): string;
+    /** {@inheritDoc PackageNameParser.getUnscopedName} */
+    static getUnscopedName(packageName: string): string;
+    /** {@inheritDoc PackageNameParser.isValidName} */
+    static isValidName(packageName: string): boolean;
+    /** {@inheritDoc PackageNameParser.validate} */
+    static validate(packageName: string): void;
+    /** {@inheritDoc PackageNameParser.combineParts} */
+    static combineParts(scope: string, unscopedName: string): string;
+}
+//# sourceMappingURL=PackageName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageName.d.ts","sourceRoot":"","sources":["../src/PackageName.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAG5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAA+B;IAEnF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAElC,OAAO,GAAE,yBAA8B;IAI1D;;;;;;;;OAQG;IACI,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,yBAAyB;IAmF/D;;;;;OAKG;IACI,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB;IAQrD;;OAEG;IACI,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI5C;;OAEG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAInD;;;;OAIG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKhD;;;OAGG;IACI,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI1C;;;;;OAKG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;CA6BjE;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAE7E,+CAA+C;WACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,yBAAyB;IAItE,4CAA4C;WAC9B,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB;IAI5D,+CAA+C;WACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAInD,sDAAsD;WACxC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI1D,kDAAkD;WACpC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIvD,+CAA+C;WACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIjD,mDAAmD;WACrC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;CAGxE"}

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

@@ -0,0 +1,213 @@
+"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.PackageName = exports.PackageNameParser = void 0;
+/**
+ * A configurable parser for validating and manipulating NPM package names such as `my-package` or `@scope/my-package`.
+ *
+ * @remarks
+ * If you do not need to customize the parser configuration, it is recommended to use {@link PackageName}
+ * which exposes these operations as a simple static class.
+ *
+ * @public
+ */
+class PackageNameParser {
+    constructor(options = {}) {
+        this._options = Object.assign({}, options);
+    }
+    /**
+     * This attempts to parse a package name that may include a scope component.
+     * The packageName must not be an empty string.
+     * @remarks
+     * This function will not throw an exception.
+     *
+     * @returns an {@link IParsedPackageNameOrError} structure whose `error` property will be
+     * nonempty if the string could not be parsed.
+     */
+    tryParse(packageName) {
+        const result = {
+            scope: '',
+            unscopedName: '',
+            error: ''
+        };
+        let input = packageName;
+        if (input === null || input === undefined) {
+            result.error = 'The package name must not be null or undefined';
+            return result;
+        }
+        // Rule from npmjs.com:
+        // "The name must be less than or equal to 214 characters. This includes the scope for scoped packages."
+        if (packageName.length > 214) {
+            // Don't attempt to parse a ridiculously long input
+            result.error = 'The package name cannot be longer than 214 characters';
+            return result;
+        }
+        if (input[0] === '@') {
+            const indexOfScopeSlash = input.indexOf('/');
+            if (indexOfScopeSlash <= 0) {
+                result.scope = input;
+                result.error = `Error parsing "${packageName}": The scope must be followed by a slash`;
+                return result;
+            }
+            // Extract the scope substring
+            result.scope = input.substr(0, indexOfScopeSlash);
+            input = input.substr(indexOfScopeSlash + 1);
+        }
+        result.unscopedName = input;
+        if (result.scope === '@') {
+            result.error = `Error parsing "${packageName}": The scope name cannot be empty`;
+            return result;
+        }
+        if (result.unscopedName === '') {
+            result.error = 'The package name must not be empty';
+            return result;
+        }
+        // Rule from npmjs.com:
+        // "The name can't start with a dot or an underscore."
+        if (result.unscopedName[0] === '.' || result.unscopedName[0] === '_') {
+            result.error = `The package name "${packageName}" starts with an invalid character`;
+            return result;
+        }
+        // Convert "@scope/unscoped-name" --> "scopeunscoped-name"
+        const nameWithoutScopeSymbols = (result.scope ? result.scope.slice(1, -1) : '') + result.unscopedName;
+        if (!this._options.allowUpperCase) {
+            // "New packages must not have uppercase letters in the name."
+            // This can't be enforced because "old" packages are still actively maintained.
+            // Example: https://www.npmjs.com/package/Base64
+            // However it's pretty reasonable to require the scope to be lower case
+            if (result.scope !== result.scope.toLowerCase()) {
+                result.error = `The package scope "${result.scope}" must not contain upper case characters`;
+                return result;
+            }
+        }
+        // "The name ends up being part of a URL, an argument on the command line, and a folder name.
+        // Therefore, the name can't contain any non-URL-safe characters"
+        const match = nameWithoutScopeSymbols.match(PackageNameParser._invalidNameCharactersRegExp);
+        if (match) {
+            result.error = `The package name "${packageName}" contains an invalid character: "${match[0]}"`;
+            return result;
+        }
+        return result;
+    }
+    /**
+     * Same as {@link PackageName.tryParse}, except this throws an exception if the input
+     * cannot be parsed.
+     * @remarks
+     * The packageName must not be an empty string.
+     */
+    parse(packageName) {
+        const result = this.tryParse(packageName);
+        if (result.error) {
+            throw new Error(result.error);
+        }
+        return result;
+    }
+    /**
+     * {@inheritDoc IParsedPackageName.scope}
+     */
+    getScope(packageName) {
+        return this.parse(packageName).scope;
+    }
+    /**
+     * {@inheritDoc IParsedPackageName.unscopedName}
+     */
+    getUnscopedName(packageName) {
+        return this.parse(packageName).unscopedName;
+    }
+    /**
+     * Returns true if the specified package name is valid, or false otherwise.
+     * @remarks
+     * This function will not throw an exception.
+     */
+    isValidName(packageName) {
+        const result = this.tryParse(packageName);
+        return !result.error;
+    }
+    /**
+     * Throws an exception if the specified name is not a valid package name.
+     * The packageName must not be an empty string.
+     */
+    validate(packageName) {
+        this.parse(packageName);
+    }
+    /**
+     * Combines an optional package scope with an unscoped root name.
+     * @param scope - Must be either an empty string, or a scope name such as "\@example"
+     * @param unscopedName - Must be a nonempty package name that does not contain a scope
+     * @returns A full package name such as "\@example/some-library".
+     */
+    combineParts(scope, unscopedName) {
+        if (scope !== '') {
+            if (scope[0] !== '@') {
+                throw new Error('The scope must start with an "@" character');
+            }
+        }
+        if (scope.indexOf('/') >= 0) {
+            throw new Error('The scope must not contain a "/" character');
+        }
+        if (unscopedName[0] === '@') {
+            throw new Error('The unscopedName cannot start with an "@" character');
+        }
+        if (unscopedName.indexOf('/') >= 0) {
+            throw new Error('The unscopedName must not contain a "/" character');
+        }
+        let result;
+        if (scope === '') {
+            result = unscopedName;
+        }
+        else {
+            result = scope + '/' + unscopedName;
+        }
+        // Make sure the result is a valid package name
+        this.validate(result);
+        return result;
+    }
+}
+exports.PackageNameParser = PackageNameParser;
+// encodeURIComponent() escapes all characters except:  A-Z a-z 0-9 - _ . ! ~ * ' ( )
+// However, these are disallowed because they are shell characters:       ! ~ * ' ( )
+PackageNameParser._invalidNameCharactersRegExp = /[^A-Za-z0-9\-_\.]/;
+/**
+ * Provides basic operations for validating and manipulating NPM package names such as `my-package`
+ * or `@scope/my-package`.
+ *
+ * @remarks
+ * This is the default implementation of {@link PackageNameParser}, exposed as a convenient static class.
+ * If you need to configure the parsing rules, use `PackageNameParser` instead.
+ *
+ * @public
+ */
+class PackageName {
+    /** {@inheritDoc PackageNameParser.tryParse} */
+    static tryParse(packageName) {
+        return PackageName._parser.tryParse(packageName);
+    }
+    /** {@inheritDoc PackageNameParser.parse} */
+    static parse(packageName) {
+        return this._parser.parse(packageName);
+    }
+    /** {@inheritDoc PackageNameParser.getScope} */
+    static getScope(packageName) {
+        return this._parser.getScope(packageName);
+    }
+    /** {@inheritDoc PackageNameParser.getUnscopedName} */
+    static getUnscopedName(packageName) {
+        return this._parser.getUnscopedName(packageName);
+    }
+    /** {@inheritDoc PackageNameParser.isValidName} */
+    static isValidName(packageName) {
+        return this._parser.isValidName(packageName);
+    }
+    /** {@inheritDoc PackageNameParser.validate} */
+    static validate(packageName) {
+        return this._parser.validate(packageName);
+    }
+    /** {@inheritDoc PackageNameParser.combineParts} */
+    static combineParts(scope, unscopedName) {
+        return this._parser.combineParts(scope, unscopedName);
+    }
+}
+exports.PackageName = PackageName;
+PackageName._parser = new PackageNameParser();
+//# sourceMappingURL=PackageName.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageName.js","sourceRoot":"","sources":["../src/PackageName.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\n/**\n * A package name that has been separated into its scope and unscoped name.\n *\n * @public\n */\nexport interface IParsedPackageName {\n  /**\n   * The parsed NPM scope, or an empty string if there was no scope.  The scope value will\n   * always include the at-sign.\n   * @remarks\n   * For example, if the parsed input was \"\\@scope/example\", then scope would be \"\\@scope\".\n   */\n  scope: string;\n\n  /**\n   * The parsed NPM package name without the scope.\n   * @remarks\n   * For example, if the parsed input was \"\\@scope/example\", then the name would be \"example\".\n   */\n  unscopedName: string;\n}\n\n/**\n * Result object returned by {@link PackageName.tryParse}\n *\n * @public\n */\nexport interface IParsedPackageNameOrError extends IParsedPackageName {\n  /**\n   * If the input string could not be parsed, then this string will contain a nonempty\n   * error message.  Otherwise it will be an empty string.\n   */\n  error: string;\n}\n\n/**\n * Options that configure the validation rules used by a {@link PackageNameParser} instance.\n *\n * @remarks\n * The default validation is based on the npmjs.com registry's policy for published packages, and includes these\n * restrictions:\n *\n * - The package name cannot be longer than 214 characters.\n *\n * - The package name must not be empty.\n *\n * - Other than the `@` and `/` delimiters used for scopes, the only allowed characters\n *   are letters, numbers, `-`, `_`, and `.`.\n *\n * - The name must not start with a `.` or `_`.\n *\n * @public\n */\nexport interface IPackageNameParserOptions {\n  /**\n   * If true, allows upper-case letters in package names.\n   * This improves compatibility with some legacy private registries that still allow that.\n   */\n  allowUpperCase?: boolean;\n}\n\n/**\n * A configurable parser for validating and manipulating NPM package names such as `my-package` or `@scope/my-package`.\n *\n * @remarks\n * If you do not need to customize the parser configuration, it is recommended to use {@link PackageName}\n * which exposes these operations as a simple static class.\n *\n * @public\n */\nexport class PackageNameParser {\n  // encodeURIComponent() escapes all characters except:  A-Z a-z 0-9 - _ . ! ~ * ' ( )\n  // However, these are disallowed because they are shell characters:       ! ~ * ' ( )\n  private static readonly _invalidNameCharactersRegExp: RegExp = /[^A-Za-z0-9\\-_\\.]/;\n\n  private readonly _options: IPackageNameParserOptions;\n\n  public constructor(options: IPackageNameParserOptions = {}) {\n    this._options = { ...options };\n  }\n\n  /**\n   * This attempts to parse a package name that may include a scope component.\n   * The packageName must not be an empty string.\n   * @remarks\n   * This function will not throw an exception.\n   *\n   * @returns an {@link IParsedPackageNameOrError} structure whose `error` property will be\n   * nonempty if the string could not be parsed.\n   */\n  public tryParse(packageName: string): IParsedPackageNameOrError {\n    const result: IParsedPackageNameOrError = {\n      scope: '',\n      unscopedName: '',\n      error: ''\n    };\n\n    let input: string = packageName;\n\n    if (input === null || input === undefined) {\n      result.error = 'The package name must not be null or undefined';\n      return result;\n    }\n\n    // Rule from npmjs.com:\n    // \"The name must be less than or equal to 214 characters. This includes the scope for scoped packages.\"\n    if (packageName.length > 214) {\n      // Don't attempt to parse a ridiculously long input\n      result.error = 'The package name cannot be longer than 214 characters';\n      return result;\n    }\n\n    if (input[0] === '@') {\n      const indexOfScopeSlash: number = input.indexOf('/');\n      if (indexOfScopeSlash <= 0) {\n        result.scope = input;\n        result.error = `Error parsing \"${packageName}\": The scope must be followed by a slash`;\n        return result;\n      }\n\n      // Extract the scope substring\n      result.scope = input.substr(0, indexOfScopeSlash);\n\n      input = input.substr(indexOfScopeSlash + 1);\n    }\n\n    result.unscopedName = input;\n\n    if (result.scope === '@') {\n      result.error = `Error parsing \"${packageName}\": The scope name cannot be empty`;\n      return result;\n    }\n\n    if (result.unscopedName === '') {\n      result.error = 'The package name must not be empty';\n      return result;\n    }\n\n    // Rule from npmjs.com:\n    // \"The name can't start with a dot or an underscore.\"\n    if (result.unscopedName[0] === '.' || result.unscopedName[0] === '_') {\n      result.error = `The package name \"${packageName}\" starts with an invalid character`;\n      return result;\n    }\n\n    // Convert \"@scope/unscoped-name\" --> \"scopeunscoped-name\"\n    const nameWithoutScopeSymbols: string =\n      (result.scope ? result.scope.slice(1, -1) : '') + result.unscopedName;\n\n    if (!this._options.allowUpperCase) {\n      // \"New packages must not have uppercase letters in the name.\"\n      // This can't be enforced because \"old\" packages are still actively maintained.\n      // Example: https://www.npmjs.com/package/Base64\n      // However it's pretty reasonable to require the scope to be lower case\n      if (result.scope !== result.scope.toLowerCase()) {\n        result.error = `The package scope \"${result.scope}\" must not contain upper case characters`;\n        return result;\n      }\n    }\n\n    // \"The name ends up being part of a URL, an argument on the command line, and a folder name.\n    // Therefore, the name can't contain any non-URL-safe characters\"\n    const match: RegExpMatchArray | null = nameWithoutScopeSymbols.match(\n      PackageNameParser._invalidNameCharactersRegExp\n    );\n    if (match) {\n      result.error = `The package name \"${packageName}\" contains an invalid character: \"${match[0]}\"`;\n      return result;\n    }\n\n    return result;\n  }\n\n  /**\n   * Same as {@link PackageName.tryParse}, except this throws an exception if the input\n   * cannot be parsed.\n   * @remarks\n   * The packageName must not be an empty string.\n   */\n  public parse(packageName: string): IParsedPackageName {\n    const result: IParsedPackageNameOrError = this.tryParse(packageName);\n    if (result.error) {\n      throw new Error(result.error);\n    }\n    return result;\n  }\n\n  /**\n   * {@inheritDoc IParsedPackageName.scope}\n   */\n  public getScope(packageName: string): string {\n    return this.parse(packageName).scope;\n  }\n\n  /**\n   * {@inheritDoc IParsedPackageName.unscopedName}\n   */\n  public getUnscopedName(packageName: string): string {\n    return this.parse(packageName).unscopedName;\n  }\n\n  /**\n   * Returns true if the specified package name is valid, or false otherwise.\n   * @remarks\n   * This function will not throw an exception.\n   */\n  public isValidName(packageName: string): boolean {\n    const result: IParsedPackageNameOrError = this.tryParse(packageName);\n    return !result.error;\n  }\n\n  /**\n   * Throws an exception if the specified name is not a valid package name.\n   * The packageName must not be an empty string.\n   */\n  public validate(packageName: string): void {\n    this.parse(packageName);\n  }\n\n  /**\n   * Combines an optional package scope with an unscoped root name.\n   * @param scope - Must be either an empty string, or a scope name such as \"\\@example\"\n   * @param unscopedName - Must be a nonempty package name that does not contain a scope\n   * @returns A full package name such as \"\\@example/some-library\".\n   */\n  public combineParts(scope: string, unscopedName: string): string {\n    if (scope !== '') {\n      if (scope[0] !== '@') {\n        throw new Error('The scope must start with an \"@\" character');\n      }\n    }\n    if (scope.indexOf('/') >= 0) {\n      throw new Error('The scope must not contain a \"/\" character');\n    }\n\n    if (unscopedName[0] === '@') {\n      throw new Error('The unscopedName cannot start with an \"@\" character');\n    }\n    if (unscopedName.indexOf('/') >= 0) {\n      throw new Error('The unscopedName must not contain a \"/\" character');\n    }\n\n    let result: string;\n    if (scope === '') {\n      result = unscopedName;\n    } else {\n      result = scope + '/' + unscopedName;\n    }\n\n    // Make sure the result is a valid package name\n    this.validate(result);\n\n    return result;\n  }\n}\n\n/**\n * Provides basic operations for validating and manipulating NPM package names such as `my-package`\n * or `@scope/my-package`.\n *\n * @remarks\n * This is the default implementation of {@link PackageNameParser}, exposed as a convenient static class.\n * If you need to configure the parsing rules, use `PackageNameParser` instead.\n *\n * @public\n */\nexport class PackageName {\n  private static readonly _parser: PackageNameParser = new PackageNameParser();\n\n  /** {@inheritDoc PackageNameParser.tryParse} */\n  public static tryParse(packageName: string): IParsedPackageNameOrError {\n    return PackageName._parser.tryParse(packageName);\n  }\n\n  /** {@inheritDoc PackageNameParser.parse} */\n  public static parse(packageName: string): IParsedPackageName {\n    return this._parser.parse(packageName);\n  }\n\n  /** {@inheritDoc PackageNameParser.getScope} */\n  public static getScope(packageName: string): string {\n    return this._parser.getScope(packageName);\n  }\n\n  /** {@inheritDoc PackageNameParser.getUnscopedName} */\n  public static getUnscopedName(packageName: string): string {\n    return this._parser.getUnscopedName(packageName);\n  }\n\n  /** {@inheritDoc PackageNameParser.isValidName} */\n  public static isValidName(packageName: string): boolean {\n    return this._parser.isValidName(packageName);\n  }\n\n  /** {@inheritDoc PackageNameParser.validate} */\n  public static validate(packageName: string): void {\n    return this._parser.validate(packageName);\n  }\n\n  /** {@inheritDoc PackageNameParser.combineParts} */\n  public static combineParts(scope: string, unscopedName: string): string {\n    return this._parser.combineParts(scope, unscopedName);\n  }\n}\n"]}

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

@@ -0,0 +1,155 @@
+/**
+ * The format that the FileError message should conform to. The supported formats are:
+ *  - Unix: `<path>:<line>:<column> - <message>`
+ *  - VisualStudio: `<path>(<line>,<column>) - <message>`
+ *
+ * @public
+ */
+export type FileLocationStyle = 'Unix' | 'VisualStudio';
+/**
+ * Options for {@link Path.formatFileLocation}.
+ * @public
+ */
+export interface IPathFormatFileLocationOptions {
+    /**
+     * The base path to use when converting `pathToFormat` to a relative path. If not specified,
+     * `pathToFormat` will be used as-is.
+     */
+    baseFolder?: string;
+    /**
+     * The path that will be used to specify the file location.
+     */
+    pathToFormat: string;
+    /**
+     * The message related to the file location.
+     */
+    message: string;
+    /**
+     * The style of file location formatting to use.
+     */
+    format: FileLocationStyle;
+    /**
+     * The optional line number. If not specified, the line number will not be included
+     * in the formatted string.
+     */
+    line?: number;
+    /**
+     * The optional column number. If not specified, the column number will not be included
+     * in the formatted string.
+     */
+    column?: number;
+}
+/**
+ * Options for {@link Path.formatConcisely}.
+ * @public
+ */
+export interface IPathFormatConciselyOptions {
+    /**
+     * The path to be converted.
+     */
+    pathToConvert: string;
+    /**
+     * The base path to use when converting `pathToConvert` to a relative path.
+     */
+    baseFolder: string;
+    /**
+     * If set to true, don't include the leading `./` if the path is under the base folder.
+     */
+    trimLeadingDotSlash?: boolean;
+}
+/**
+ * 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
+ */
+export declare class Path {
+    private static _relativePathRegex;
+    private static _upwardPathSegmentRegex;
+    /**
+     * 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: string, parentFolderPath: string): boolean;
+    /**
+     * 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: string, parentFolderPath: string): boolean;
+    /**
+     * Returns true if `path1` and `path2` refer to the same underlying path.
+     *
+     * @remarks
+     *
+     * The comparison is performed using `path.relative()`.
+     */
+    static isEqual(path1: string, path2: string): boolean;
+    /**
+     * 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: IPathFormatConciselyOptions): string;
+    /**
+     * 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: IPathFormatFileLocationOptions): string;
+    /**
+     * 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: string): string;
+    /**
+     * 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: string): string;
+    /**
+     * Replaces slashes or backslashes with the appropriate slash for the current operating system.
+     */
+    static convertToPlatformDefault(inputPath: string): string;
+    /**
+     * 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: string): boolean;
+}
+//# sourceMappingURL=Path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../src/Path.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,cAAc,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,IAAI;IAGf,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAwB;IAIzD,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAsC;IAE5E;;;;;;;;;OASG;WACW,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO;IAQ3E;;;;;;;;OAQG;WACW,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO;IAKlF;;;;;;OAMG;WACW,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAI5D;;;;;;;;OAQG;WACW,eAAe,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM;IAqB3E;;;;;;;OAOG;WACW,kBAAkB,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM;IA+CjF;;;;;OAKG;WACW,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIzD;;;;;OAKG;WACW,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAG7D;;OAEG;WACW,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIjE;;;;;;;;;;;;;;;;;OAiBG;WACW,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAU7D"}