@wo658/redpact 0.3.0 → 0.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"SubprocessTerminator.js","sourceRoot":"","sources":["../src/SubprocessTerminator.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 type * as child_process from 'child_process';\nimport process from 'process';\n\nimport { Executable } from './Executable';\n\n/**\n * Details about how the `child_process.ChildProcess` was created.\n *\n * @beta\n */\nexport interface ISubprocessOptions {\n  /**\n   * Whether or not the child process was started in detached mode.\n   *\n   * @remarks\n   * On POSIX systems, detached=true is required for killing the subtree. Attempting to kill the\n   * subtree on POSIX systems with detached=false will throw an error. On Windows, detached=true\n   * creates a separate console window and is not required for killing the subtree. In general,\n   * it is recommended to use SubprocessTerminator.RECOMMENDED_OPTIONS when forking or spawning\n   * a child process.\n   */\n  detached: boolean;\n}\n\ninterface ITrackedSubprocess {\n  subprocess: child_process.ChildProcess;\n  subprocessOptions: ISubprocessOptions;\n}\n\n/**\n * When a child process is created, registering it with the SubprocessTerminator will ensure\n * that the child gets terminated when the current process terminates.\n *\n * @remarks\n * This works by hooking the current process's events for SIGTERM/SIGINT/exit, and ensuring the\n * child process gets terminated in those cases.\n *\n * SubprocessTerminator doesn't do anything on Windows, since by default Windows automatically\n * terminates child processes when their parent is terminated.\n *\n * @beta\n */\nexport class SubprocessTerminator {\n  /**\n   * Whether the hooks are installed\n   */\n  private static _initialized: boolean = false;\n\n  /**\n   * The list of registered child processes.  Processes are removed from this set if they\n   * terminate on their own.\n   */\n  private static _subprocessesByPid: Map<number, ITrackedSubprocess> = new Map();\n\n  private static readonly _isWindows: boolean = process.platform === 'win32';\n\n  /**\n   * The recommended options when creating a child process.\n   */\n  public static readonly RECOMMENDED_OPTIONS: ISubprocessOptions = {\n    detached: process.platform !== 'win32'\n  };\n\n  /**\n   * Registers a child process so that it will be terminated automatically if the current process\n   * is terminated.\n   */\n  public static killProcessTreeOnExit(\n    subprocess: child_process.ChildProcess,\n    subprocessOptions: ISubprocessOptions\n  ): void {\n    if (typeof subprocess.exitCode === 'number') {\n      // Process has already been killed\n      return;\n    }\n\n    SubprocessTerminator._validateSubprocessOptions(subprocessOptions);\n\n    SubprocessTerminator._ensureInitialized();\n\n    // Closure variable\n    const pid: number | undefined = subprocess.pid;\n    if (pid === undefined) {\n      // The process failed to spawn.\n      return;\n    }\n\n    subprocess.on('close', (exitCode: number | null, signal: NodeJS.Signals | null): void => {\n      if (SubprocessTerminator._subprocessesByPid.delete(pid)) {\n        SubprocessTerminator._logDebug(`untracking #${pid}`);\n      }\n    });\n    SubprocessTerminator._subprocessesByPid.set(pid, {\n      subprocess,\n      subprocessOptions\n    });\n\n    SubprocessTerminator._logDebug(`tracking #${pid}`);\n  }\n\n  /**\n   * Terminate the child process and all of its children.\n   */\n  public static killProcessTree(\n    subprocess: child_process.ChildProcess,\n    subprocessOptions: ISubprocessOptions\n  ): void {\n    const pid: number | undefined = subprocess.pid;\n    if (pid === undefined) {\n      // The process failed to spawn.\n      return;\n    }\n\n    // Don't attempt to kill the same process twice\n    if (SubprocessTerminator._subprocessesByPid.delete(pid)) {\n      SubprocessTerminator._logDebug(`untracking #${pid} via killProcessTree()`);\n    }\n\n    SubprocessTerminator._validateSubprocessOptions(subprocessOptions);\n\n    if (typeof subprocess.exitCode === 'number') {\n      // Process has already been killed\n      return;\n    }\n\n    SubprocessTerminator._logDebug(`terminating #${pid}`);\n\n    if (SubprocessTerminator._isWindows) {\n      // On Windows we have a problem that CMD.exe launches child processes, but when CMD.exe is killed\n      // the child processes may continue running.  Also if we send signals to CMD.exe the child processes\n      // will not receive them.  The safest solution is not to attempt a graceful shutdown, but simply\n      // kill the entire process tree.\n      const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync('TaskKill.exe', [\n        '/T', // \"Terminates the specified process and any child processes which were started by it.\"\n        '/F', // Without this, TaskKill will try to use WM_CLOSE which doesn't work with CLI tools\n        '/PID',\n        pid.toString()\n      ]);\n\n      if (result.status) {\n        const output: string = result.output.join('\\n');\n        // Nonzero exit code\n        if (output.indexOf('not found') >= 0) {\n          // The PID does not exist\n        } else {\n          // Another error occurred, for example TaskKill.exe does not support\n          // the expected CLI syntax\n          throw new Error(`TaskKill.exe returned exit code ${result.status}:\\n` + output + '\\n');\n        }\n      }\n    } else {\n      // Passing a negative PID terminates the entire group instead of just the one process\n      process.kill(-pid, 'SIGKILL');\n    }\n  }\n\n  // Install the hooks\n  private static _ensureInitialized(): void {\n    if (!SubprocessTerminator._initialized) {\n      SubprocessTerminator._initialized = true;\n\n      SubprocessTerminator._logDebug('initialize');\n\n      process.prependListener('SIGTERM', SubprocessTerminator._onTerminateSignal);\n      process.prependListener('SIGINT', SubprocessTerminator._onTerminateSignal);\n\n      process.prependListener('exit', SubprocessTerminator._onExit);\n    }\n  }\n\n  // Uninstall the hooks and perform cleanup\n  private static _cleanupChildProcesses(): void {\n    if (SubprocessTerminator._initialized) {\n      SubprocessTerminator._initialized = false;\n\n      process.removeListener('SIGTERM', SubprocessTerminator._onTerminateSignal);\n      process.removeListener('SIGINT', SubprocessTerminator._onTerminateSignal);\n\n      const trackedSubprocesses: ITrackedSubprocess[] = Array.from(\n        SubprocessTerminator._subprocessesByPid.values()\n      );\n\n      let firstError: Error | undefined = undefined;\n\n      for (const trackedSubprocess of trackedSubprocesses) {\n        try {\n          SubprocessTerminator.killProcessTree(trackedSubprocess.subprocess, { detached: true });\n        } catch (error) {\n          if (firstError === undefined) {\n            firstError = error as Error;\n          }\n        }\n      }\n\n      if (firstError !== undefined) {\n        // This is generally an unexpected error such as the TaskKill.exe command not being found,\n        // not a trivial issue such as a nonexistent PID.   Since this occurs during process shutdown,\n        // we should not interfere with control flow by throwing an exception  or calling process.exit().\n        // So simply write to STDERR and ensure our exit code indicates the problem.\n        // eslint-disable-next-line no-console\n        console.error('\\nAn unexpected error was encountered while attempting to clean up child processes:');\n        // eslint-disable-next-line no-console\n        console.error(firstError.toString());\n        if (!process.exitCode) {\n          process.exitCode = 1;\n        }\n      }\n    }\n  }\n\n  private static _validateSubprocessOptions(subprocessOptions: ISubprocessOptions): void {\n    if (!SubprocessTerminator._isWindows) {\n      if (!subprocessOptions.detached) {\n        // Setting detached=true is what creates the process group that we use to kill the children\n        throw new Error('killProcessTree() requires detached=true on this operating system');\n      }\n    }\n  }\n\n  private static _onExit(exitCode: number): void {\n    SubprocessTerminator._logDebug(`received exit(${exitCode})`);\n\n    SubprocessTerminator._cleanupChildProcesses();\n\n    SubprocessTerminator._logDebug(`finished exit()`);\n  }\n\n  private static _onTerminateSignal(signal: string): void {\n    SubprocessTerminator._logDebug(`received signal ${signal}`);\n\n    SubprocessTerminator._cleanupChildProcesses();\n\n    // When a listener is added to SIGTERM, Node.js strangely provides no way to reference\n    // the original handler.  But we can invoke it by removing our listener and then resending\n    // the signal to our own process.\n    SubprocessTerminator._logDebug(`relaying ${signal}`);\n    process.kill(process.pid, signal);\n  }\n\n  // For debugging\n  private static _logDebug(message: string): void {\n    //const logLine: string = `SubprocessTerminator: [${process.pid}] ${message}`;\n    // fs.writeFileSync('trace.log', logLine + '\\n', { flag: 'a' });\n    //console.log(logLine);\n  }\n}\n"]}

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

@@ -0,0 +1,141 @@
+/**
+ * The allowed types of encodings, as supported by Node.js
+ * @public
+ */
+export declare enum Encoding {
+    Utf8 = "utf8"
+}
+/**
+ * Enumeration controlling conversion of newline characters.
+ * @public
+ */
+export declare enum NewlineKind {
+    /**
+     * Windows-style newlines
+     */
+    CrLf = "\r\n",
+    /**
+     * POSIX-style newlines
+     *
+     * @remarks
+     * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+     */
+    Lf = "\n",
+    /**
+     * Default newline type for this operating system (`os.EOL`).
+     */
+    OsDefault = "os"
+}
+/**
+ * Options used when calling the {@link Text.readLinesFromIterable} or
+ * {@link Text.readLinesFromIterableAsync} methods.
+ *
+ * @public
+ */
+export interface IReadLinesFromIterableOptions {
+    /**
+     * The encoding of the input iterable. The default is utf8.
+     */
+    encoding?: Encoding;
+    /**
+     * If true, empty lines will not be returned. The default is false.
+     */
+    ignoreEmptyLines?: boolean;
+}
+/**
+ * Operations for working with strings that contain text.
+ *
+ * @remarks
+ * The utilities provided by this class are intended to be simple, small, and very
+ * broadly applicable.
+ *
+ * @public
+ */
+export declare class Text {
+    private static readonly _newLineRegEx;
+    private static readonly _newLineAtEndRegEx;
+    /**
+     * Returns the same thing as targetString.replace(searchValue, replaceValue), except that
+     * all matches are replaced, rather than just the first match.
+     * @param input         - The string to be modified
+     * @param searchValue   - The value to search for
+     * @param replaceValue  - The replacement text
+     */
+    static replaceAll(input: string, searchValue: string, replaceValue: string): string;
+    /**
+     * Converts all newlines in the provided string to use Windows-style CRLF end of line characters.
+     */
+    static convertToCrLf(input: string): string;
+    /**
+     * Converts all newlines in the provided string to use POSIX-style LF end of line characters.
+     *
+     * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+     */
+    static convertToLf(input: string): string;
+    /**
+     * Converts all newlines in the provided string to use the specified newline type.
+     */
+    static convertTo(input: string, newlineKind: NewlineKind): string;
+    /**
+     * Returns the newline character sequence for the specified `NewlineKind`.
+     */
+    static getNewline(newlineKind: NewlineKind): string;
+    /**
+     * Append characters to the end of a string to ensure the result has a minimum length.
+     * @remarks
+     * If the string length already exceeds the minimum length, then the string is unchanged.
+     * The string is not truncated.
+     */
+    static padEnd(s: string, minimumLength: number, paddingCharacter?: string): string;
+    /**
+     * Append characters to the start of a string to ensure the result has a minimum length.
+     * @remarks
+     * If the string length already exceeds the minimum length, then the string is unchanged.
+     * The string is not truncated.
+     */
+    static padStart(s: string, minimumLength: number, paddingCharacter?: string): string;
+    /**
+     * If the string is longer than maximumLength characters, truncate it to that length
+     * using "..." to indicate the truncation.
+     *
+     * @remarks
+     * For example truncateWithEllipsis('1234578', 5) would produce '12...'.
+     */
+    static truncateWithEllipsis(s: string, maximumLength: number): string;
+    /**
+     * Returns the input string with a trailing `\n` character appended, if not already present.
+     */
+    static ensureTrailingNewline(s: string, newlineKind?: NewlineKind): string;
+    /**
+     * Escapes a string so that it can be treated as a literal string when used in a regular expression.
+     */
+    static escapeRegExp(literal: string): string;
+    /**
+     * Read lines from an iterable object that returns strings or buffers, and return a generator that
+     * produces the lines as strings. The lines will not include the newline characters.
+     *
+     * @param iterable - An iterable object that returns strings or buffers
+     * @param options - Options used when reading the lines from the provided iterable
+     */
+    static readLinesFromIterableAsync(iterable: AsyncIterable<string | Buffer>, options?: IReadLinesFromIterableOptions): AsyncGenerator<string>;
+    /**
+     * Read lines from an iterable object that returns strings or buffers, and return a generator that
+     * produces the lines as strings. The lines will not include the newline characters.
+     *
+     * @param iterable - An iterable object that returns strings or buffers
+     * @param options - Options used when reading the lines from the provided iterable
+     */
+    static readLinesFromIterable(iterable: Iterable<string | Buffer | null>, options?: IReadLinesFromIterableOptions): Generator<string>;
+    /**
+     * Returns a new string that is the input string with the order of characters reversed.
+     */
+    static reverse(s: string): string;
+    /**
+     * Splits the provided string by newlines. Note that leading and trailing newlines will produce
+     * leading or trailing empty string array entries.
+     */
+    static splitByNewLines(s: undefined): undefined;
+    static splitByNewLines(s: string): string[];
+    static splitByNewLines(s: string | undefined): string[] | undefined;
+}
+//# sourceMappingURL=Text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../src/Text.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,oBAAY,QAAQ;IAClB,IAAI,SAAS;CACd;AAED;;;GAGG;AACH,oBAAY,WAAW;IACrB;;OAEG;IACH,IAAI,SAAS;IAEb;;;;;OAKG;IACH,EAAE,OAAO;IAET;;OAEG;IACH,SAAS,OAAO;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAgCD;;;;;;;;GAQG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAgC;IAE1E;;;;;;OAMG;WACW,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAI1F;;OAEG;WACW,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlD;;;;OAIG;WACW,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhD;;OAEG;WACW,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM;IAIxE;;OAEG;WACW,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM;IAa1D;;;;;OAKG;WACW,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAY,GAAG,MAAM;IAc9F;;;;;OAKG;WACW,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAY,GAAG,MAAM;IAchG;;;;;;OAMG;WACW,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IAgB5E;;OAEG;WACW,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,WAA4B,GAAG,MAAM;IAQjG;;OAEG;WACW,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInD;;;;;;OAMG;WACkB,0BAA0B,CAC7C,QAAQ,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,EACxC,OAAO,GAAE,6BAAkC,GAC1C,cAAc,CAAC,MAAM,CAAC;IAYzB;;;;;;OAMG;WACY,qBAAqB,CAElC,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAC1C,OAAO,GAAE,6BAAkC,GAC1C,SAAS,CAAC,MAAM,CAAC;IAYpB;;OAEG;WACW,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAKxC;;;OAGG;WACW,eAAe,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS;WACxC,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;WACpC,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS;CAI3E"}

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

@@ -0,0 +1,310 @@
+"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;
+    };
+})();
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncDelegator = (this && this.__asyncDelegator) || function (o) {
+    var i, p;
+    return i = {}, verb("next"), verb("throw", function (e) { throw e; }), verb("return"), i[Symbol.iterator] = function () { return this; }, i;
+    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Text = exports.NewlineKind = exports.Encoding = void 0;
+const os = __importStar(require("os"));
+/**
+ * The allowed types of encodings, as supported by Node.js
+ * @public
+ */
+var Encoding;
+(function (Encoding) {
+    Encoding["Utf8"] = "utf8";
+})(Encoding || (exports.Encoding = Encoding = {}));
+/**
+ * Enumeration controlling conversion of newline characters.
+ * @public
+ */
+var NewlineKind;
+(function (NewlineKind) {
+    /**
+     * Windows-style newlines
+     */
+    NewlineKind["CrLf"] = "\r\n";
+    /**
+     * POSIX-style newlines
+     *
+     * @remarks
+     * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+     */
+    NewlineKind["Lf"] = "\n";
+    /**
+     * Default newline type for this operating system (`os.EOL`).
+     */
+    NewlineKind["OsDefault"] = "os";
+})(NewlineKind || (exports.NewlineKind = NewlineKind = {}));
+const NEWLINE_REGEX = /\r\n|\n\r|\r|\n/g;
+const NEWLINE_AT_END_REGEX = /(\r\n|\n\r|\r|\n)$/;
+function* readLinesFromChunk(
+// eslint-disable-next-line @rushstack/no-new-null
+chunk, encoding, ignoreEmptyLines, state) {
+    if (!chunk) {
+        return;
+    }
+    const remaining = state.remaining + (typeof chunk === 'string' ? chunk : chunk.toString(encoding));
+    let startIndex = 0;
+    const matches = remaining.matchAll(NEWLINE_REGEX);
+    for (const match of matches) {
+        const endIndex = match.index;
+        if (startIndex !== endIndex || !ignoreEmptyLines) {
+            yield remaining.substring(startIndex, endIndex);
+        }
+        startIndex = endIndex + match[0].length;
+    }
+    state.remaining = remaining.substring(startIndex);
+}
+/**
+ * Operations for working with strings that contain text.
+ *
+ * @remarks
+ * The utilities provided by this class are intended to be simple, small, and very
+ * broadly applicable.
+ *
+ * @public
+ */
+class Text {
+    /**
+     * Returns the same thing as targetString.replace(searchValue, replaceValue), except that
+     * all matches are replaced, rather than just the first match.
+     * @param input         - The string to be modified
+     * @param searchValue   - The value to search for
+     * @param replaceValue  - The replacement text
+     */
+    static replaceAll(input, searchValue, replaceValue) {
+        return input.split(searchValue).join(replaceValue);
+    }
+    /**
+     * Converts all newlines in the provided string to use Windows-style CRLF end of line characters.
+     */
+    static convertToCrLf(input) {
+        return input.replace(Text._newLineRegEx, '\r\n');
+    }
+    /**
+     * Converts all newlines in the provided string to use POSIX-style LF end of line characters.
+     *
+     * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.
+     */
+    static convertToLf(input) {
+        return input.replace(Text._newLineRegEx, '\n');
+    }
+    /**
+     * Converts all newlines in the provided string to use the specified newline type.
+     */
+    static convertTo(input, newlineKind) {
+        return input.replace(Text._newLineRegEx, Text.getNewline(newlineKind));
+    }
+    /**
+     * Returns the newline character sequence for the specified `NewlineKind`.
+     */
+    static getNewline(newlineKind) {
+        switch (newlineKind) {
+            case NewlineKind.CrLf:
+                return '\r\n';
+            case NewlineKind.Lf:
+                return '\n';
+            case NewlineKind.OsDefault:
+                return os.EOL;
+            default:
+                throw new Error('Unsupported newline kind');
+        }
+    }
+    /**
+     * Append characters to the end of a string to ensure the result has a minimum length.
+     * @remarks
+     * If the string length already exceeds the minimum length, then the string is unchanged.
+     * The string is not truncated.
+     */
+    static padEnd(s, minimumLength, paddingCharacter = ' ') {
+        if (paddingCharacter.length !== 1) {
+            throw new Error('The paddingCharacter parameter must be a single character.');
+        }
+        if (s.length < minimumLength) {
+            const paddingArray = new Array(minimumLength - s.length);
+            paddingArray.unshift(s);
+            return paddingArray.join(paddingCharacter);
+        }
+        else {
+            return s;
+        }
+    }
+    /**
+     * Append characters to the start of a string to ensure the result has a minimum length.
+     * @remarks
+     * If the string length already exceeds the minimum length, then the string is unchanged.
+     * The string is not truncated.
+     */
+    static padStart(s, minimumLength, paddingCharacter = ' ') {
+        if (paddingCharacter.length !== 1) {
+            throw new Error('The paddingCharacter parameter must be a single character.');
+        }
+        if (s.length < minimumLength) {
+            const paddingArray = new Array(minimumLength - s.length);
+            paddingArray.push(s);
+            return paddingArray.join(paddingCharacter);
+        }
+        else {
+            return s;
+        }
+    }
+    /**
+     * If the string is longer than maximumLength characters, truncate it to that length
+     * using "..." to indicate the truncation.
+     *
+     * @remarks
+     * For example truncateWithEllipsis('1234578', 5) would produce '12...'.
+     */
+    static truncateWithEllipsis(s, maximumLength) {
+        if (maximumLength < 0) {
+            throw new Error('The maximumLength cannot be a negative number');
+        }
+        if (s.length <= maximumLength) {
+            return s;
+        }
+        if (s.length <= 3) {
+            return s.substring(0, maximumLength);
+        }
+        return s.substring(0, maximumLength - 3) + '...';
+    }
+    /**
+     * Returns the input string with a trailing `\n` character appended, if not already present.
+     */
+    static ensureTrailingNewline(s, newlineKind = NewlineKind.Lf) {
+        // Is there already a newline?
+        if (Text._newLineAtEndRegEx.test(s)) {
+            return s; // yes, no change
+        }
+        return s + newlineKind; // no, add it
+    }
+    /**
+     * Escapes a string so that it can be treated as a literal string when used in a regular expression.
+     */
+    static escapeRegExp(literal) {
+        return literal.replace(/[^A-Za-z0-9_]/g, '\\$&');
+    }
+    /**
+     * Read lines from an iterable object that returns strings or buffers, and return a generator that
+     * produces the lines as strings. The lines will not include the newline characters.
+     *
+     * @param iterable - An iterable object that returns strings or buffers
+     * @param options - Options used when reading the lines from the provided iterable
+     */
+    static readLinesFromIterableAsync(iterable_1) {
+        return __asyncGenerator(this, arguments, function* readLinesFromIterableAsync_1(iterable, options = {}) {
+            var _a, e_1, _b, _c;
+            const { encoding = Encoding.Utf8, ignoreEmptyLines = false } = options;
+            const state = { remaining: '' };
+            try {
+                for (var _d = true, iterable_2 = __asyncValues(iterable), iterable_2_1; iterable_2_1 = yield __await(iterable_2.next()), _a = iterable_2_1.done, !_a; _d = true) {
+                    _c = iterable_2_1.value;
+                    _d = false;
+                    const chunk = _c;
+                    yield __await(yield* __asyncDelegator(__asyncValues(readLinesFromChunk(chunk, encoding, ignoreEmptyLines, state))));
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = iterable_2.return)) yield __await(_b.call(iterable_2));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            const remaining = state.remaining;
+            if (remaining.length) {
+                yield yield __await(remaining);
+            }
+        });
+    }
+    /**
+     * Read lines from an iterable object that returns strings or buffers, and return a generator that
+     * produces the lines as strings. The lines will not include the newline characters.
+     *
+     * @param iterable - An iterable object that returns strings or buffers
+     * @param options - Options used when reading the lines from the provided iterable
+     */
+    static *readLinesFromIterable(
+    // eslint-disable-next-line @rushstack/no-new-null
+    iterable, options = {}) {
+        const { encoding = Encoding.Utf8, ignoreEmptyLines = false } = options;
+        const state = { remaining: '' };
+        for (const chunk of iterable) {
+            yield* readLinesFromChunk(chunk, encoding, ignoreEmptyLines, state);
+        }
+        const remaining = state.remaining;
+        if (remaining.length) {
+            yield remaining;
+        }
+    }
+    /**
+     * Returns a new string that is the input string with the order of characters reversed.
+     */
+    static reverse(s) {
+        // Benchmarks of several algorithms: https://jsbench.me/4bkfflcm2z
+        return s.split('').reduce((newString, char) => char + newString, '');
+    }
+    static splitByNewLines(s) {
+        return s === null || s === void 0 ? void 0 : s.split(/\r?\n/);
+    }
+}
+exports.Text = Text;
+Text._newLineRegEx = NEWLINE_REGEX;
+Text._newLineAtEndRegEx = NEWLINE_AT_END_REGEX;
+//# sourceMappingURL=Text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Text.js","sourceRoot":"","sources":["../src/Text.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE3D,uCAAyB;AAEzB;;;GAGG;AACH,IAAY,QAEX;AAFD,WAAY,QAAQ;IAClB,yBAAa,CAAA;AACf,CAAC,EAFW,QAAQ,wBAAR,QAAQ,QAEnB;AAED;;;GAGG;AACH,IAAY,WAkBX;AAlBD,WAAY,WAAW;IACrB;;OAEG;IACH,4BAAa,CAAA;IAEb;;;;;OAKG;IACH,wBAAS,CAAA;IAET;;OAEG;IACH,+BAAgB,CAAA;AAClB,CAAC,EAlBW,WAAW,2BAAX,WAAW,QAkBtB;AAwBD,MAAM,aAAa,GAAW,kBAAkB,CAAC;AACjD,MAAM,oBAAoB,GAAW,oBAAoB,CAAC;AAE1D,QAAQ,CAAC,CAAC,kBAAkB;AAC1B,kDAAkD;AAClD,KAA6B,EAC7B,QAAkB,EAClB,gBAAyB,EACzB,KAAkC;IAElC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAW,KAAK,CAAC,SAAS,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3G,IAAI,UAAU,GAAW,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAuC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACtF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAW,KAAK,CAAC,KAAM,CAAC;QACtC,IAAI,UAAU,KAAK,QAAQ,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;QACD,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAa,IAAI;IAIf;;;;;;OAMG;IACI,MAAM,CAAC,UAAU,CAAC,KAAa,EAAE,WAAmB,EAAE,YAAoB;QAC/E,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,aAAa,CAAC,KAAa;QACvC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,KAAa;QACrC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,SAAS,CAAC,KAAa,EAAE,WAAwB;QAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,UAAU,CAAC,WAAwB;QAC/C,QAAQ,WAAW,EAAE,CAAC;YACpB,KAAK,WAAW,CAAC,IAAI;gBACnB,OAAO,MAAM,CAAC;YAChB,KAAK,WAAW,CAAC,EAAE;gBACjB,OAAO,IAAI,CAAC;YACd,KAAK,WAAW,CAAC,SAAS;gBACxB,OAAO,EAAE,CAAC,GAAG,CAAC;YAChB;gBACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,CAAS,EAAE,aAAqB,EAAE,mBAA2B,GAAG;QACnF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAa,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;YACnE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACxB,OAAO,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,QAAQ,CAAC,CAAS,EAAE,aAAqB,EAAE,mBAA2B,GAAG;QACrF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAa,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;YACnE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,OAAO,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,oBAAoB,CAAC,CAAS,EAAE,aAAqB;QACjE,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,qBAAqB,CAAC,CAAS,EAAE,cAA2B,WAAW,CAAC,EAAE;QACtF,8BAA8B;QAC9B,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,CAAC,CAAC,iBAAiB;QAC7B,CAAC;QACD,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,aAAa;IACvC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,YAAY,CAAC,OAAe;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAQ,0BAA0B;wFAC7C,QAAwC,EACxC,UAAyC,EAAE;;YAE3C,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;YACvE,MAAM,KAAK,GAAgC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;;gBAC7D,KAA0B,eAAA,aAAA,cAAA,QAAQ,CAAA,cAAA,2FAAE,CAAC;oBAAX,wBAAQ;oBAAR,WAAQ;oBAAvB,MAAM,KAAK,KAAA,CAAA;oBACpB,cAAA,KAAK,CAAC,CAAC,iBAAA,cAAA,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAA,CAAA,CAAA,CAAC;gBACtE,CAAC;;;;;;;;;YACD,MAAM,SAAS,GAAW,KAAK,CAAC,SAAS,CAAC;YAC1C,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;gBACrB,oBAAM,SAAS,CAAA,CAAC;YAClB,CAAC;QACH,CAAC;KAAA;IAED;;;;;;OAMG;IACI,MAAM,CAAC,CAAC,qBAAqB;IAClC,kDAAkD;IAClD,QAA0C,EAC1C,UAAyC,EAAE;QAE3C,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QACvE,MAAM,KAAK,GAAgC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,SAAS,GAAW,KAAK,CAAC,SAAS,CAAC;QAC1C,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,SAAS,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,OAAO,CAAC,CAAS;QAC7B,kEAAkE;QAClE,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IASM,MAAM,CAAC,eAAe,CAAC,CAAqB;QACjD,OAAO,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;;AArMH,oBAsMC;AArMyB,kBAAa,GAAW,aAAa,CAAC;AACtC,uBAAkB,GAAW,oBAAoB,CAAC","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 os from 'os';\n\n/**\n * The allowed types of encodings, as supported by Node.js\n * @public\n */\nexport enum Encoding {\n  Utf8 = 'utf8'\n}\n\n/**\n * Enumeration controlling conversion of newline characters.\n * @public\n */\nexport enum NewlineKind {\n  /**\n   * Windows-style newlines\n   */\n  CrLf = '\\r\\n',\n\n  /**\n   * POSIX-style newlines\n   *\n   * @remarks\n   * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.\n   */\n  Lf = '\\n',\n\n  /**\n   * Default newline type for this operating system (`os.EOL`).\n   */\n  OsDefault = 'os'\n}\n\n/**\n * Options used when calling the {@link Text.readLinesFromIterable} or\n * {@link Text.readLinesFromIterableAsync} methods.\n *\n * @public\n */\nexport interface IReadLinesFromIterableOptions {\n  /**\n   * The encoding of the input iterable. The default is utf8.\n   */\n  encoding?: Encoding;\n\n  /**\n   * If true, empty lines will not be returned. The default is false.\n   */\n  ignoreEmptyLines?: boolean;\n}\n\ninterface IReadLinesFromIterableState {\n  remaining: string;\n}\n\nconst NEWLINE_REGEX: RegExp = /\\r\\n|\\n\\r|\\r|\\n/g;\nconst NEWLINE_AT_END_REGEX: RegExp = /(\\r\\n|\\n\\r|\\r|\\n)$/;\n\nfunction* readLinesFromChunk(\n  // eslint-disable-next-line @rushstack/no-new-null\n  chunk: string | Buffer | null,\n  encoding: Encoding,\n  ignoreEmptyLines: boolean,\n  state: IReadLinesFromIterableState\n): Generator<string> {\n  if (!chunk) {\n    return;\n  }\n  const remaining: string = state.remaining + (typeof chunk === 'string' ? chunk : chunk.toString(encoding));\n  let startIndex: number = 0;\n  const matches: IterableIterator<RegExpMatchArray> = remaining.matchAll(NEWLINE_REGEX);\n  for (const match of matches) {\n    const endIndex: number = match.index!;\n    if (startIndex !== endIndex || !ignoreEmptyLines) {\n      yield remaining.substring(startIndex, endIndex);\n    }\n    startIndex = endIndex + match[0].length;\n  }\n  state.remaining = remaining.substring(startIndex);\n}\n\n/**\n * Operations for working with strings that contain text.\n *\n * @remarks\n * The utilities provided by this class are intended to be simple, small, and very\n * broadly applicable.\n *\n * @public\n */\nexport class Text {\n  private static readonly _newLineRegEx: RegExp = NEWLINE_REGEX;\n  private static readonly _newLineAtEndRegEx: RegExp = NEWLINE_AT_END_REGEX;\n\n  /**\n   * Returns the same thing as targetString.replace(searchValue, replaceValue), except that\n   * all matches are replaced, rather than just the first match.\n   * @param input         - The string to be modified\n   * @param searchValue   - The value to search for\n   * @param replaceValue  - The replacement text\n   */\n  public static replaceAll(input: string, searchValue: string, replaceValue: string): string {\n    return input.split(searchValue).join(replaceValue);\n  }\n\n  /**\n   * Converts all newlines in the provided string to use Windows-style CRLF end of line characters.\n   */\n  public static convertToCrLf(input: string): string {\n    return input.replace(Text._newLineRegEx, '\\r\\n');\n  }\n\n  /**\n   * Converts all newlines in the provided string to use POSIX-style LF end of line characters.\n   *\n   * POSIX is a registered trademark of the Institute of Electrical and Electronic Engineers, Inc.\n   */\n  public static convertToLf(input: string): string {\n    return input.replace(Text._newLineRegEx, '\\n');\n  }\n\n  /**\n   * Converts all newlines in the provided string to use the specified newline type.\n   */\n  public static convertTo(input: string, newlineKind: NewlineKind): string {\n    return input.replace(Text._newLineRegEx, Text.getNewline(newlineKind));\n  }\n\n  /**\n   * Returns the newline character sequence for the specified `NewlineKind`.\n   */\n  public static getNewline(newlineKind: NewlineKind): string {\n    switch (newlineKind) {\n      case NewlineKind.CrLf:\n        return '\\r\\n';\n      case NewlineKind.Lf:\n        return '\\n';\n      case NewlineKind.OsDefault:\n        return os.EOL;\n      default:\n        throw new Error('Unsupported newline kind');\n    }\n  }\n\n  /**\n   * Append characters to the end of a string to ensure the result has a minimum length.\n   * @remarks\n   * If the string length already exceeds the minimum length, then the string is unchanged.\n   * The string is not truncated.\n   */\n  public static padEnd(s: string, minimumLength: number, paddingCharacter: string = ' '): string {\n    if (paddingCharacter.length !== 1) {\n      throw new Error('The paddingCharacter parameter must be a single character.');\n    }\n\n    if (s.length < minimumLength) {\n      const paddingArray: string[] = new Array(minimumLength - s.length);\n      paddingArray.unshift(s);\n      return paddingArray.join(paddingCharacter);\n    } else {\n      return s;\n    }\n  }\n\n  /**\n   * Append characters to the start of a string to ensure the result has a minimum length.\n   * @remarks\n   * If the string length already exceeds the minimum length, then the string is unchanged.\n   * The string is not truncated.\n   */\n  public static padStart(s: string, minimumLength: number, paddingCharacter: string = ' '): string {\n    if (paddingCharacter.length !== 1) {\n      throw new Error('The paddingCharacter parameter must be a single character.');\n    }\n\n    if (s.length < minimumLength) {\n      const paddingArray: string[] = new Array(minimumLength - s.length);\n      paddingArray.push(s);\n      return paddingArray.join(paddingCharacter);\n    } else {\n      return s;\n    }\n  }\n\n  /**\n   * If the string is longer than maximumLength characters, truncate it to that length\n   * using \"...\" to indicate the truncation.\n   *\n   * @remarks\n   * For example truncateWithEllipsis('1234578', 5) would produce '12...'.\n   */\n  public static truncateWithEllipsis(s: string, maximumLength: number): string {\n    if (maximumLength < 0) {\n      throw new Error('The maximumLength cannot be a negative number');\n    }\n\n    if (s.length <= maximumLength) {\n      return s;\n    }\n\n    if (s.length <= 3) {\n      return s.substring(0, maximumLength);\n    }\n\n    return s.substring(0, maximumLength - 3) + '...';\n  }\n\n  /**\n   * Returns the input string with a trailing `\\n` character appended, if not already present.\n   */\n  public static ensureTrailingNewline(s: string, newlineKind: NewlineKind = NewlineKind.Lf): string {\n    // Is there already a newline?\n    if (Text._newLineAtEndRegEx.test(s)) {\n      return s; // yes, no change\n    }\n    return s + newlineKind; // no, add it\n  }\n\n  /**\n   * Escapes a string so that it can be treated as a literal string when used in a regular expression.\n   */\n  public static escapeRegExp(literal: string): string {\n    return literal.replace(/[^A-Za-z0-9_]/g, '\\\\$&');\n  }\n\n  /**\n   * Read lines from an iterable object that returns strings or buffers, and return a generator that\n   * produces the lines as strings. The lines will not include the newline characters.\n   *\n   * @param iterable - An iterable object that returns strings or buffers\n   * @param options - Options used when reading the lines from the provided iterable\n   */\n  public static async *readLinesFromIterableAsync(\n    iterable: AsyncIterable<string | Buffer>,\n    options: IReadLinesFromIterableOptions = {}\n  ): AsyncGenerator<string> {\n    const { encoding = Encoding.Utf8, ignoreEmptyLines = false } = options;\n    const state: IReadLinesFromIterableState = { remaining: '' };\n    for await (const chunk of iterable) {\n      yield* readLinesFromChunk(chunk, encoding, ignoreEmptyLines, state);\n    }\n    const remaining: string = state.remaining;\n    if (remaining.length) {\n      yield remaining;\n    }\n  }\n\n  /**\n   * Read lines from an iterable object that returns strings or buffers, and return a generator that\n   * produces the lines as strings. The lines will not include the newline characters.\n   *\n   * @param iterable - An iterable object that returns strings or buffers\n   * @param options - Options used when reading the lines from the provided iterable\n   */\n  public static *readLinesFromIterable(\n    // eslint-disable-next-line @rushstack/no-new-null\n    iterable: Iterable<string | Buffer | null>,\n    options: IReadLinesFromIterableOptions = {}\n  ): Generator<string> {\n    const { encoding = Encoding.Utf8, ignoreEmptyLines = false } = options;\n    const state: IReadLinesFromIterableState = { remaining: '' };\n    for (const chunk of iterable) {\n      yield* readLinesFromChunk(chunk, encoding, ignoreEmptyLines, state);\n    }\n    const remaining: string = state.remaining;\n    if (remaining.length) {\n      yield remaining;\n    }\n  }\n\n  /**\n   * Returns a new string that is the input string with the order of characters reversed.\n   */\n  public static reverse(s: string): string {\n    // Benchmarks of several algorithms: https://jsbench.me/4bkfflcm2z\n    return s.split('').reduce((newString, char) => char + newString, '');\n  }\n\n  /**\n   * Splits the provided string by newlines. Note that leading and trailing newlines will produce\n   * leading or trailing empty string array entries.\n   */\n  public static splitByNewLines(s: undefined): undefined;\n  public static splitByNewLines(s: string): string[];\n  public static splitByNewLines(s: string | undefined): string[] | undefined;\n  public static splitByNewLines(s: string | undefined): string[] | undefined {\n    return s?.split(/\\r?\\n/);\n  }\n}\n"]}

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

@@ -0,0 +1,48 @@
+/**
+ * Provides a version-independent implementation of the JavaScript `instanceof` operator.
+ *
+ * @remarks
+ * The JavaScript `instanceof` operator normally only identifies objects from a particular library instance.
+ * For example, suppose the NPM package `example-lib` has two published versions 1.2.0 and 1.3.0, and
+ * it exports a class called `A`.  Suppose some code consumes version `1.3.0` of the library, but it receives
+ * an object that was constructed using version `1.2.0`.  In this situation `a instanceof A` will return `false`,
+ * even though `a` is an instance of `A`.  The reason is that there are two prototypes for `A`; one for each
+ * version.
+ *
+ * The `TypeUuid` facility provides a way to make `a instanceof A` return true for both prototypes of `A`,
+ * by instead using a universally unique identifier (UUID) to detect object instances.
+ *
+ * You can use `Symbol.hasInstance` to enable the system `instanceof` operator to recognize type UUID equivalence:
+ * ```ts
+ * const uuidWidget: string = '9c340ef0-d29f-4e2e-a09f-42bacc59024b';
+ * class Widget {
+ *   public static [Symbol.hasInstance](instance: object): boolean {
+ *     return TypeUuid.isInstanceOf(instance, uuidWidget);
+ *   }
+ * }
+ * ```
+ * // Example usage:
+ * ```ts
+ * import { Widget as Widget1 } from 'v1-of-library';
+ * import { Widget as Widget2 } from 'v2-of-library';
+ * const widget = new Widget2();
+ * console.log(widget instanceof Widget1); // prints true
+ * ```
+ *
+ * @public
+ */
+export declare class TypeUuid {
+    private static _uuidRegExp;
+    /**
+     * Registers a JavaScript class as having a type identified by the specified UUID.
+     * @privateRemarks
+     * We cannot use a construct signature for `targetClass` because it may be an abstract class.
+     */
+    static registerClass(targetClass: any, typeUuid: string): void;
+    /**
+     * Returns true if the `targetObject` is an instance of a JavaScript class that was previously
+     * registered using the specified `typeUuid`.  Base classes are also considered.
+     */
+    static isInstanceOf(targetObject: unknown, typeUuid: string): boolean;
+}
+//# sourceMappingURL=TypeUuid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypeUuid.d.ts","sourceRoot":"","sources":["../src/TypeUuid.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,WAAW,CAA4E;IAEtG;;;;OAIG;WAEW,aAAa,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsBrE;;;OAGG;WACW,YAAY,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;CAkB7E"}

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

@@ -0,0 +1,87 @@
+"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.TypeUuid = void 0;
+const InternalError_1 = require("./InternalError");
+const classPrototypeUuidSymbol = Symbol.for('TypeUuid.classPrototypeUuid');
+/**
+ * Provides a version-independent implementation of the JavaScript `instanceof` operator.
+ *
+ * @remarks
+ * The JavaScript `instanceof` operator normally only identifies objects from a particular library instance.
+ * For example, suppose the NPM package `example-lib` has two published versions 1.2.0 and 1.3.0, and
+ * it exports a class called `A`.  Suppose some code consumes version `1.3.0` of the library, but it receives
+ * an object that was constructed using version `1.2.0`.  In this situation `a instanceof A` will return `false`,
+ * even though `a` is an instance of `A`.  The reason is that there are two prototypes for `A`; one for each
+ * version.
+ *
+ * The `TypeUuid` facility provides a way to make `a instanceof A` return true for both prototypes of `A`,
+ * by instead using a universally unique identifier (UUID) to detect object instances.
+ *
+ * You can use `Symbol.hasInstance` to enable the system `instanceof` operator to recognize type UUID equivalence:
+ * ```ts
+ * const uuidWidget: string = '9c340ef0-d29f-4e2e-a09f-42bacc59024b';
+ * class Widget {
+ *   public static [Symbol.hasInstance](instance: object): boolean {
+ *     return TypeUuid.isInstanceOf(instance, uuidWidget);
+ *   }
+ * }
+ * ```
+ * // Example usage:
+ * ```ts
+ * import { Widget as Widget1 } from 'v1-of-library';
+ * import { Widget as Widget2 } from 'v2-of-library';
+ * const widget = new Widget2();
+ * console.log(widget instanceof Widget1); // prints true
+ * ```
+ *
+ * @public
+ */
+class TypeUuid {
+    /**
+     * Registers a JavaScript class as having a type identified by the specified UUID.
+     * @privateRemarks
+     * We cannot use a construct signature for `targetClass` because it may be an abstract class.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static registerClass(targetClass, typeUuid) {
+        if (typeof targetClass !== 'function') {
+            throw new Error('The targetClass parameter must be a JavaScript class');
+        }
+        if (!TypeUuid._uuidRegExp.test(typeUuid)) {
+            throw new Error(`The type UUID must be specified as lowercase hexadecimal with dashes: "${typeUuid}"`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const targetClassPrototype = targetClass.prototype;
+        if (Object.hasOwnProperty.call(targetClassPrototype, classPrototypeUuidSymbol)) {
+            const existingUuid = targetClassPrototype[classPrototypeUuidSymbol];
+            throw new InternalError_1.InternalError(`Cannot register the target class ${targetClass.name || ''} typeUuid=${typeUuid}` +
+                ` because it was already registered with typeUuid=${existingUuid}`);
+        }
+        targetClassPrototype[classPrototypeUuidSymbol] = typeUuid;
+    }
+    /**
+     * Returns true if the `targetObject` is an instance of a JavaScript class that was previously
+     * registered using the specified `typeUuid`.  Base classes are also considered.
+     */
+    static isInstanceOf(targetObject, typeUuid) {
+        if (targetObject === undefined || targetObject === null) {
+            return false;
+        }
+        let objectPrototype = Object.getPrototypeOf(targetObject);
+        while (objectPrototype !== undefined && objectPrototype !== null) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const registeredUuid = objectPrototype[classPrototypeUuidSymbol];
+            if (registeredUuid === typeUuid) {
+                return true;
+            }
+            // Walk upwards an examine base class prototypes
+            objectPrototype = Object.getPrototypeOf(objectPrototype);
+        }
+        return false;
+    }
+}
+exports.TypeUuid = TypeUuid;
+TypeUuid._uuidRegExp = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/;
+//# sourceMappingURL=TypeUuid.js.map