@rushstack/terminal 0.21.0 → 0.22.0

package/CHANGELOG.json

@@ -1,6 +1,26 @@
 {
   "name": "@rushstack/terminal",
   "entries": [
+    {
+      "version": "0.22.0",
+      "tag": "@rushstack/terminal_v0.22.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/problem-matcher\" to `0.2.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.21.0",
       "tag": "@rushstack/terminal_v0.21.0",

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Change Log - @rushstack/terminal
 
-This log was last generated on Wed, 07 Jan 2026 01:12:24 GMT and should not be manually modified.
+This log was last generated on Thu, 19 Feb 2026 00:04:53 GMT and should not be manually modified.
+
+## 0.22.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
 
 ## 0.21.0
 Wed, 07 Jan 2026 01:12:24 GMT

package/lib-esm/AnsiEscape.js

@@ -0,0 +1,131 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { SgrParameterAttribute } from './Colorize';
+/**
+ * Operations for working with text strings that contain
+ * {@link https://en.wikipedia.org/wiki/ANSI_escape_code | ANSI escape codes}.
+ * The most commonly used escape codes set the foreground/background color for console output.
+ * @public
+ */
+export class AnsiEscape {
+    static getEscapeSequenceForAnsiCode(code) {
+        return `\u001b[${code}m`;
+    }
+    /**
+     * Returns the input text with all ANSI escape codes removed.  For example, this is useful when saving
+     * colorized console output to a log file.
+     */
+    static removeCodes(text) {
+        return text.replace(AnsiEscape._csiRegExp, '');
+    }
+    /**
+     * Replaces ANSI escape codes with human-readable tokens.  This is useful for unit tests
+     * that compare text strings in test assertions or snapshot files.
+     */
+    static formatForTests(text, options) {
+        if (!options) {
+            options = {};
+        }
+        let result = text.replace(AnsiEscape._csiRegExp, (capture, csiCode) => {
+            // If it is an SGR code, then try to show a friendly token
+            const match = csiCode.match(AnsiEscape._sgrRegExp);
+            if (match) {
+                const sgrParameter = parseInt(match[1], 10);
+                const sgrParameterName = AnsiEscape._tryGetSgrFriendlyName(sgrParameter);
+                if (sgrParameterName) {
+                    // Example: "[black-bg]"
+                    return `[${sgrParameterName}]`;
+                }
+            }
+            // Otherwise show the raw code, but without the "[" from the CSI prefix
+            // Example: "[31m]"
+            return `[${csiCode}]`;
+        });
+        if (options.encodeNewlines) {
+            result = result
+                .replace(AnsiEscape._backslashNRegExp, '[n]')
+                .replace(AnsiEscape._backslashRRegExp, `[r]`);
+        }
+        return result;
+    }
+    // Returns a human-readable token representing an SGR parameter, or undefined for parameter that is not well-known.
+    // The SGR parameter numbers are documented in this table:
+    // https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters
+    static _tryGetSgrFriendlyName(sgiParameter) {
+        switch (sgiParameter) {
+            case SgrParameterAttribute.BlackForeground:
+                return 'black';
+            case SgrParameterAttribute.RedForeground:
+                return 'red';
+            case SgrParameterAttribute.GreenForeground:
+                return 'green';
+            case SgrParameterAttribute.YellowForeground:
+                return 'yellow';
+            case SgrParameterAttribute.BlueForeground:
+                return 'blue';
+            case SgrParameterAttribute.MagentaForeground:
+                return 'magenta';
+            case SgrParameterAttribute.CyanForeground:
+                return 'cyan';
+            case SgrParameterAttribute.WhiteForeground:
+                return 'white';
+            case SgrParameterAttribute.GrayForeground:
+                return 'gray';
+            case SgrParameterAttribute.DefaultForeground:
+                return 'default';
+            case SgrParameterAttribute.BlackBackground:
+                return 'black-bg';
+            case SgrParameterAttribute.RedBackground:
+                return 'red-bg';
+            case SgrParameterAttribute.GreenBackground:
+                return 'green-bg';
+            case SgrParameterAttribute.YellowBackground:
+                return 'yellow-bg';
+            case SgrParameterAttribute.BlueBackground:
+                return 'blue-bg';
+            case SgrParameterAttribute.MagentaBackground:
+                return 'magenta-bg';
+            case SgrParameterAttribute.CyanBackground:
+                return 'cyan-bg';
+            case SgrParameterAttribute.WhiteBackground:
+                return 'white-bg';
+            case SgrParameterAttribute.GrayBackground:
+                return 'gray-bg';
+            case SgrParameterAttribute.DefaultBackground:
+                return 'default-bg';
+            case SgrParameterAttribute.Bold:
+                return 'bold';
+            case SgrParameterAttribute.Dim:
+                return 'dim';
+            case SgrParameterAttribute.NormalColorOrIntensity:
+                return 'normal';
+            case SgrParameterAttribute.Underline:
+                return 'underline';
+            case SgrParameterAttribute.UnderlineOff:
+                return 'underline-off';
+            case SgrParameterAttribute.Blink:
+                return 'blink';
+            case SgrParameterAttribute.BlinkOff:
+                return 'blink-off';
+            case SgrParameterAttribute.InvertColor:
+                return 'invert';
+            case SgrParameterAttribute.InvertColorOff:
+                return 'invert-off';
+            case SgrParameterAttribute.Hidden:
+                return 'hidden';
+            case SgrParameterAttribute.HiddenOff:
+                return 'hidden-off';
+            default:
+                return undefined;
+        }
+    }
+}
+// For now, we only care about the Control Sequence Introducer (CSI) commands which always start with "[".
+// eslint-disable-next-line no-control-regex
+AnsiEscape._csiRegExp = /\x1b\[([\x30-\x3f]*[\x20-\x2f]*[\x40-\x7e])/gu;
+// Text coloring is performed using Select Graphic Rendition (SGR) codes, which come after the
+// CSI introducer "ESC [".  The SGR sequence is a number followed by "m".
+AnsiEscape._sgrRegExp = /([0-9]+)m/u;
+AnsiEscape._backslashNRegExp = /\n/g;
+AnsiEscape._backslashRRegExp = /\r/g;
+//# sourceMappingURL=AnsiEscape.js.map

package/lib-esm/AnsiEscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnsiEscape.js","sourceRoot":"","sources":["../src/AnsiEscape.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 { SgrParameterAttribute } from './Colorize';\n\n/**\n * Options for {@link AnsiEscape.formatForTests}.\n * @public\n */\nexport interface IAnsiEscapeConvertForTestsOptions {\n  /**\n   * If true then `\\n` will be replaced by `[n]`, and `\\r` will be replaced by `[r]`.\n   */\n  encodeNewlines?: boolean;\n}\n\n/**\n * Operations for working with text strings that contain\n * {@link https://en.wikipedia.org/wiki/ANSI_escape_code | ANSI escape codes}.\n * The most commonly used escape codes set the foreground/background color for console output.\n * @public\n */\nexport class AnsiEscape {\n  // For now, we only care about the Control Sequence Introducer (CSI) commands which always start with \"[\".\n  // eslint-disable-next-line no-control-regex\n  private static readonly _csiRegExp: RegExp = /\\x1b\\[([\\x30-\\x3f]*[\\x20-\\x2f]*[\\x40-\\x7e])/gu;\n\n  // Text coloring is performed using Select Graphic Rendition (SGR) codes, which come after the\n  // CSI introducer \"ESC [\".  The SGR sequence is a number followed by \"m\".\n  private static readonly _sgrRegExp: RegExp = /([0-9]+)m/u;\n\n  private static readonly _backslashNRegExp: RegExp = /\\n/g;\n  private static readonly _backslashRRegExp: RegExp = /\\r/g;\n\n  public static getEscapeSequenceForAnsiCode(code: number): string {\n    return `\\u001b[${code}m`;\n  }\n\n  /**\n   * Returns the input text with all ANSI escape codes removed.  For example, this is useful when saving\n   * colorized console output to a log file.\n   */\n  public static removeCodes(text: string): string {\n    return text.replace(AnsiEscape._csiRegExp, '');\n  }\n\n  /**\n   * Replaces ANSI escape codes with human-readable tokens.  This is useful for unit tests\n   * that compare text strings in test assertions or snapshot files.\n   */\n  public static formatForTests(text: string, options?: IAnsiEscapeConvertForTestsOptions): string {\n    if (!options) {\n      options = {};\n    }\n\n    let result: string = text.replace(AnsiEscape._csiRegExp, (capture: string, csiCode: string) => {\n      // If it is an SGR code, then try to show a friendly token\n      const match: RegExpMatchArray | null = csiCode.match(AnsiEscape._sgrRegExp);\n      if (match) {\n        const sgrParameter: number = parseInt(match[1], 10);\n        const sgrParameterName: string | undefined = AnsiEscape._tryGetSgrFriendlyName(sgrParameter);\n        if (sgrParameterName) {\n          // Example: \"[black-bg]\"\n          return `[${sgrParameterName}]`;\n        }\n      }\n\n      // Otherwise show the raw code, but without the \"[\" from the CSI prefix\n      // Example: \"[31m]\"\n      return `[${csiCode}]`;\n    });\n\n    if (options.encodeNewlines) {\n      result = result\n        .replace(AnsiEscape._backslashNRegExp, '[n]')\n        .replace(AnsiEscape._backslashRRegExp, `[r]`);\n    }\n    return result;\n  }\n\n  // Returns a human-readable token representing an SGR parameter, or undefined for parameter that is not well-known.\n  // The SGR parameter numbers are documented in this table:\n  // https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_parameters\n  private static _tryGetSgrFriendlyName(sgiParameter: number): string | undefined {\n    switch (sgiParameter) {\n      case SgrParameterAttribute.BlackForeground:\n        return 'black';\n      case SgrParameterAttribute.RedForeground:\n        return 'red';\n      case SgrParameterAttribute.GreenForeground:\n        return 'green';\n      case SgrParameterAttribute.YellowForeground:\n        return 'yellow';\n      case SgrParameterAttribute.BlueForeground:\n        return 'blue';\n      case SgrParameterAttribute.MagentaForeground:\n        return 'magenta';\n      case SgrParameterAttribute.CyanForeground:\n        return 'cyan';\n      case SgrParameterAttribute.WhiteForeground:\n        return 'white';\n      case SgrParameterAttribute.GrayForeground:\n        return 'gray';\n      case SgrParameterAttribute.DefaultForeground:\n        return 'default';\n\n      case SgrParameterAttribute.BlackBackground:\n        return 'black-bg';\n      case SgrParameterAttribute.RedBackground:\n        return 'red-bg';\n      case SgrParameterAttribute.GreenBackground:\n        return 'green-bg';\n      case SgrParameterAttribute.YellowBackground:\n        return 'yellow-bg';\n      case SgrParameterAttribute.BlueBackground:\n        return 'blue-bg';\n      case SgrParameterAttribute.MagentaBackground:\n        return 'magenta-bg';\n      case SgrParameterAttribute.CyanBackground:\n        return 'cyan-bg';\n      case SgrParameterAttribute.WhiteBackground:\n        return 'white-bg';\n      case SgrParameterAttribute.GrayBackground:\n        return 'gray-bg';\n      case SgrParameterAttribute.DefaultBackground:\n        return 'default-bg';\n\n      case SgrParameterAttribute.Bold:\n        return 'bold';\n      case SgrParameterAttribute.Dim:\n        return 'dim';\n      case SgrParameterAttribute.NormalColorOrIntensity:\n        return 'normal';\n      case SgrParameterAttribute.Underline:\n        return 'underline';\n      case SgrParameterAttribute.UnderlineOff:\n        return 'underline-off';\n      case SgrParameterAttribute.Blink:\n        return 'blink';\n      case SgrParameterAttribute.BlinkOff:\n        return 'blink-off';\n      case SgrParameterAttribute.InvertColor:\n        return 'invert';\n      case SgrParameterAttribute.InvertColorOff:\n        return 'invert-off';\n      case SgrParameterAttribute.Hidden:\n        return 'hidden';\n      case SgrParameterAttribute.HiddenOff:\n        return 'hidden-off';\n      default:\n        return undefined;\n    }\n  }\n}\n"]}

package/lib-esm/CallbackWritable.js

@@ -0,0 +1,27 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { TerminalWritable } from './TerminalWritable';
+/**
+ * This class enables very basic {@link TerminalWritable.onWriteChunk} operations to be implemented
+ * as a callback function, avoiding the need to define a subclass of `TerminalWritable`.
+ *
+ * @remarks
+ * `CallbackWritable` is provided as a convenience for very simple situations. For most cases,
+ * it is generally preferable to create a proper subclass.
+ *
+ * @privateRemarks
+ * We intentionally do not expose a callback for {@link TerminalWritable.onClose}; if special
+ * close behavior is required, it is better to create a subclass.
+ *
+ * @public
+ */
+export class CallbackWritable extends TerminalWritable {
+    constructor(options) {
+        super();
+        this._callback = options.onWriteChunk;
+    }
+    onWriteChunk(chunk) {
+        this._callback(chunk);
+    }
+}
+//# sourceMappingURL=CallbackWritable.js.map

package/lib-esm/CallbackWritable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallbackWritable.js","sourceRoot":"","sources":["../src/CallbackWritable.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAWtD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IAGpD,YAAmB,OAAiC;QAClD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IACxC,CAAC;IAES,YAAY,CAAC,KAAqB;QAC1C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF","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 { TerminalWritable } from './TerminalWritable';\nimport type { ITerminalChunk } from './ITerminalChunk';\n\n/**\n * Constructor options for {@link CallbackWritable}.\n * @public\n */\nexport interface ICallbackWritableOptions {\n  onWriteChunk: (chunk: ITerminalChunk) => void;\n}\n\n/**\n * This class enables very basic {@link TerminalWritable.onWriteChunk} operations to be implemented\n * as a callback function, avoiding the need to define a subclass of `TerminalWritable`.\n *\n * @remarks\n * `CallbackWritable` is provided as a convenience for very simple situations. For most cases,\n * it is generally preferable to create a proper subclass.\n *\n * @privateRemarks\n * We intentionally do not expose a callback for {@link TerminalWritable.onClose}; if special\n * close behavior is required, it is better to create a subclass.\n *\n * @public\n */\nexport class CallbackWritable extends TerminalWritable {\n  private readonly _callback: (chunk: ITerminalChunk) => void;\n\n  public constructor(options: ICallbackWritableOptions) {\n    super();\n    this._callback = options.onWriteChunk;\n  }\n\n  protected onWriteChunk(chunk: ITerminalChunk): void {\n    this._callback(chunk);\n  }\n}\n"]}

package/lib-esm/Colorize.js

@@ -0,0 +1,158 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { AnsiEscape } from './AnsiEscape';
+export var SgrParameterAttribute;
+(function (SgrParameterAttribute) {
+    SgrParameterAttribute[SgrParameterAttribute["BlackForeground"] = 30] = "BlackForeground";
+    SgrParameterAttribute[SgrParameterAttribute["RedForeground"] = 31] = "RedForeground";
+    SgrParameterAttribute[SgrParameterAttribute["GreenForeground"] = 32] = "GreenForeground";
+    SgrParameterAttribute[SgrParameterAttribute["YellowForeground"] = 33] = "YellowForeground";
+    SgrParameterAttribute[SgrParameterAttribute["BlueForeground"] = 34] = "BlueForeground";
+    SgrParameterAttribute[SgrParameterAttribute["MagentaForeground"] = 35] = "MagentaForeground";
+    SgrParameterAttribute[SgrParameterAttribute["CyanForeground"] = 36] = "CyanForeground";
+    SgrParameterAttribute[SgrParameterAttribute["WhiteForeground"] = 37] = "WhiteForeground";
+    SgrParameterAttribute[SgrParameterAttribute["GrayForeground"] = 90] = "GrayForeground";
+    SgrParameterAttribute[SgrParameterAttribute["DefaultForeground"] = 39] = "DefaultForeground";
+    SgrParameterAttribute[SgrParameterAttribute["BlackBackground"] = 40] = "BlackBackground";
+    SgrParameterAttribute[SgrParameterAttribute["RedBackground"] = 41] = "RedBackground";
+    SgrParameterAttribute[SgrParameterAttribute["GreenBackground"] = 42] = "GreenBackground";
+    SgrParameterAttribute[SgrParameterAttribute["YellowBackground"] = 43] = "YellowBackground";
+    SgrParameterAttribute[SgrParameterAttribute["BlueBackground"] = 44] = "BlueBackground";
+    SgrParameterAttribute[SgrParameterAttribute["MagentaBackground"] = 45] = "MagentaBackground";
+    SgrParameterAttribute[SgrParameterAttribute["CyanBackground"] = 46] = "CyanBackground";
+    SgrParameterAttribute[SgrParameterAttribute["WhiteBackground"] = 47] = "WhiteBackground";
+    SgrParameterAttribute[SgrParameterAttribute["GrayBackground"] = 100] = "GrayBackground";
+    SgrParameterAttribute[SgrParameterAttribute["DefaultBackground"] = 49] = "DefaultBackground";
+    SgrParameterAttribute[SgrParameterAttribute["Bold"] = 1] = "Bold";
+    // On Linux, the "BoldOff" code instead causes the text to be double-underlined:
+    // https://en.wikipedia.org/wiki/Talk:ANSI_escape_code#SGR_21%E2%80%94%60Bold_off%60_not_widely_supported
+    // Use "NormalColorOrIntensity" instead
+    // BoldOff = 21,
+    SgrParameterAttribute[SgrParameterAttribute["Dim"] = 2] = "Dim";
+    SgrParameterAttribute[SgrParameterAttribute["NormalColorOrIntensity"] = 22] = "NormalColorOrIntensity";
+    SgrParameterAttribute[SgrParameterAttribute["Underline"] = 4] = "Underline";
+    SgrParameterAttribute[SgrParameterAttribute["UnderlineOff"] = 24] = "UnderlineOff";
+    SgrParameterAttribute[SgrParameterAttribute["Blink"] = 5] = "Blink";
+    SgrParameterAttribute[SgrParameterAttribute["BlinkOff"] = 25] = "BlinkOff";
+    SgrParameterAttribute[SgrParameterAttribute["InvertColor"] = 7] = "InvertColor";
+    SgrParameterAttribute[SgrParameterAttribute["InvertColorOff"] = 27] = "InvertColorOff";
+    SgrParameterAttribute[SgrParameterAttribute["Hidden"] = 8] = "Hidden";
+    SgrParameterAttribute[SgrParameterAttribute["HiddenOff"] = 28] = "HiddenOff";
+})(SgrParameterAttribute || (SgrParameterAttribute = {}));
+const RAINBOW_SEQUENCE = [
+    SgrParameterAttribute.RedForeground,
+    SgrParameterAttribute.YellowForeground,
+    SgrParameterAttribute.GreenForeground,
+    SgrParameterAttribute.CyanForeground,
+    SgrParameterAttribute.BlueForeground,
+    SgrParameterAttribute.MagentaForeground
+];
+/**
+ * The static functions on this class are used to produce colored text
+ * for use with a terminal that supports ANSI escape codes.
+ *
+ * Note that this API always generates color codes, regardless of whether
+ * the process's stdout is a TTY. The reason is that, in a complex program, the
+ * code that is generating strings often does not know were those strings will end
+ * up. In some cases, the same log message may get printed both to a shell
+ * that supports color AND to a log file that does not.
+ *
+ * @example
+ * ```ts
+ * console.log(Colorize.red('Red Text!'))
+ * terminal.writeLine(Colorize.green('Green Text!'), ' ', Colorize.blue('Blue Text!'));
+ *```
+ *
+ * @public
+ */
+export class Colorize {
+    static black(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlackForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static red(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.RedForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static green(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GreenForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static yellow(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.YellowForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static blue(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlueForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static magenta(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.MagentaForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static cyan(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.CyanForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static white(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.WhiteForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static gray(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GrayForeground, SgrParameterAttribute.DefaultForeground, text);
+    }
+    static blackBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlackBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static redBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.RedBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static greenBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GreenBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static yellowBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.YellowBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static blueBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.BlueBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static magentaBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.MagentaBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static cyanBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.CyanBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static whiteBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.WhiteBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static grayBackground(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.GrayBackground, SgrParameterAttribute.DefaultBackground, text);
+    }
+    static bold(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Bold, SgrParameterAttribute.NormalColorOrIntensity, text);
+    }
+    static dim(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Dim, SgrParameterAttribute.NormalColorOrIntensity, text);
+    }
+    static underline(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Underline, SgrParameterAttribute.UnderlineOff, text);
+    }
+    static blink(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Blink, SgrParameterAttribute.BlinkOff, text);
+    }
+    static invertColor(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.InvertColor, SgrParameterAttribute.InvertColorOff, text);
+    }
+    static hidden(text) {
+        return Colorize._wrapTextInAnsiEscapeCodes(SgrParameterAttribute.Hidden, SgrParameterAttribute.HiddenOff, text);
+    }
+    static rainbow(text) {
+        return Colorize._applyColorSequence(text, RAINBOW_SEQUENCE);
+    }
+    static _applyColorSequence(text, sequence) {
+        let result = '';
+        const sequenceLength = sequence.length;
+        for (let i = 0; i < text.length; i++) {
+            result += AnsiEscape.getEscapeSequenceForAnsiCode(sequence[i % sequenceLength]) + text[i];
+        }
+        return result + AnsiEscape.getEscapeSequenceForAnsiCode(SgrParameterAttribute.DefaultForeground);
+    }
+    static _wrapTextInAnsiEscapeCodes(startCode, endCode, text) {
+        return (AnsiEscape.getEscapeSequenceForAnsiCode(startCode) +
+            text +
+            AnsiEscape.getEscapeSequenceForAnsiCode(endCode));
+    }
+}
+//# sourceMappingURL=Colorize.js.map

package/lib-esm/Colorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Colorize.js","sourceRoot":"","sources":["../src/Colorize.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 { AnsiEscape } from './AnsiEscape';\n\nexport enum SgrParameterAttribute {\n  BlackForeground = 30,\n  RedForeground = 31,\n  GreenForeground = 32,\n  YellowForeground = 33,\n  BlueForeground = 34,\n  MagentaForeground = 35,\n  CyanForeground = 36,\n  WhiteForeground = 37,\n  GrayForeground = 90,\n  DefaultForeground = 39,\n\n  BlackBackground = 40,\n  RedBackground = 41,\n  GreenBackground = 42,\n  YellowBackground = 43,\n  BlueBackground = 44,\n  MagentaBackground = 45,\n  CyanBackground = 46,\n  WhiteBackground = 47,\n  GrayBackground = 100,\n  DefaultBackground = 49,\n\n  Bold = 1,\n\n  // On Linux, the \"BoldOff\" code instead causes the text to be double-underlined:\n  // https://en.wikipedia.org/wiki/Talk:ANSI_escape_code#SGR_21%E2%80%94%60Bold_off%60_not_widely_supported\n  // Use \"NormalColorOrIntensity\" instead\n  // BoldOff = 21,\n\n  Dim = 2,\n  NormalColorOrIntensity = 22,\n  Underline = 4,\n  UnderlineOff = 24,\n  Blink = 5,\n  BlinkOff = 25,\n  InvertColor = 7,\n  InvertColorOff = 27,\n  Hidden = 8,\n  HiddenOff = 28\n}\n\nconst RAINBOW_SEQUENCE: SgrParameterAttribute[] = [\n  SgrParameterAttribute.RedForeground,\n  SgrParameterAttribute.YellowForeground,\n  SgrParameterAttribute.GreenForeground,\n  SgrParameterAttribute.CyanForeground,\n  SgrParameterAttribute.BlueForeground,\n  SgrParameterAttribute.MagentaForeground\n];\n\n/**\n * The static functions on this class are used to produce colored text\n * for use with a terminal that supports ANSI escape codes.\n *\n * Note that this API always generates color codes, regardless of whether\n * the process's stdout is a TTY. The reason is that, in a complex program, the\n * code that is generating strings often does not know were those strings will end\n * up. In some cases, the same log message may get printed both to a shell\n * that supports color AND to a log file that does not.\n *\n * @example\n * ```ts\n * console.log(Colorize.red('Red Text!'))\n * terminal.writeLine(Colorize.green('Green Text!'), ' ', Colorize.blue('Blue Text!'));\n *```\n *\n * @public\n */\nexport class Colorize {\n  public static black(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlackForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static red(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.RedForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static green(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GreenForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static yellow(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.YellowForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static blue(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlueForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static magenta(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.MagentaForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static cyan(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.CyanForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static white(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.WhiteForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static gray(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GrayForeground,\n      SgrParameterAttribute.DefaultForeground,\n      text\n    );\n  }\n\n  public static blackBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlackBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static redBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.RedBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static greenBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GreenBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static yellowBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.YellowBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static blueBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.BlueBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static magentaBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.MagentaBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static cyanBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.CyanBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static whiteBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.WhiteBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static grayBackground(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.GrayBackground,\n      SgrParameterAttribute.DefaultBackground,\n      text\n    );\n  }\n\n  public static bold(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Bold,\n      SgrParameterAttribute.NormalColorOrIntensity,\n      text\n    );\n  }\n\n  public static dim(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Dim,\n      SgrParameterAttribute.NormalColorOrIntensity,\n      text\n    );\n  }\n\n  public static underline(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Underline,\n      SgrParameterAttribute.UnderlineOff,\n      text\n    );\n  }\n\n  public static blink(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Blink,\n      SgrParameterAttribute.BlinkOff,\n      text\n    );\n  }\n\n  public static invertColor(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.InvertColor,\n      SgrParameterAttribute.InvertColorOff,\n      text\n    );\n  }\n\n  public static hidden(text: string): string {\n    return Colorize._wrapTextInAnsiEscapeCodes(\n      SgrParameterAttribute.Hidden,\n      SgrParameterAttribute.HiddenOff,\n      text\n    );\n  }\n\n  public static rainbow(text: string): string {\n    return Colorize._applyColorSequence(text, RAINBOW_SEQUENCE);\n  }\n\n  private static _applyColorSequence(text: string, sequence: SgrParameterAttribute[]): string {\n    let result: string = '';\n    const sequenceLength: number = sequence.length;\n    for (let i: number = 0; i < text.length; i++) {\n      result += AnsiEscape.getEscapeSequenceForAnsiCode(sequence[i % sequenceLength]) + text[i];\n    }\n\n    return result + AnsiEscape.getEscapeSequenceForAnsiCode(SgrParameterAttribute.DefaultForeground);\n  }\n\n  private static _wrapTextInAnsiEscapeCodes(startCode: number, endCode: number, text: string): string {\n    return (\n      AnsiEscape.getEscapeSequenceForAnsiCode(startCode) +\n      text +\n      AnsiEscape.getEscapeSequenceForAnsiCode(endCode)\n    );\n  }\n}\n"]}

package/lib-esm/ConsoleTerminalProvider.js

@@ -0,0 +1,58 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { EOL } from 'node:os';
+import supportsColor from 'supports-color';
+import { TerminalProviderSeverity } from './ITerminalProvider';
+/**
+ * Terminal provider that prints to STDOUT (for log- and verbose-level messages) and
+ * STDERR (for warning- and error-level messages).
+ *
+ * @beta
+ */
+export class ConsoleTerminalProvider {
+    constructor(options = {}) {
+        /**
+         * {@inheritDoc ITerminalProvider.supportsColor}
+         */
+        this.supportsColor = ConsoleTerminalProvider.supportsColor;
+        this.verboseEnabled = !!options.verboseEnabled;
+        this.debugEnabled = !!options.debugEnabled;
+    }
+    /**
+     * {@inheritDoc ITerminalProvider.write}
+     */
+    write(data, severity) {
+        switch (severity) {
+            case TerminalProviderSeverity.warning:
+            case TerminalProviderSeverity.error: {
+                process.stderr.write(data);
+                break;
+            }
+            case TerminalProviderSeverity.verbose: {
+                if (this.verboseEnabled) {
+                    process.stdout.write(data);
+                }
+                break;
+            }
+            case TerminalProviderSeverity.debug: {
+                if (this.debugEnabled) {
+                    process.stdout.write(data);
+                }
+                break;
+            }
+            case TerminalProviderSeverity.log:
+            default: {
+                process.stdout.write(data);
+                break;
+            }
+        }
+    }
+    /**
+     * {@inheritDoc ITerminalProvider.eolCharacter}
+     */
+    get eolCharacter() {
+        return EOL;
+    }
+}
+ConsoleTerminalProvider.supportsColor = !!supportsColor.stdout && !!supportsColor.stderr;
+//# sourceMappingURL=ConsoleTerminalProvider.js.map

package/lib-esm/ConsoleTerminalProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleTerminalProvider.js","sourceRoot":"","sources":["../src/ConsoleTerminalProvider.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAA0B,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAqBvF;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IAkBlC,YAAmB,UAAoD,EAAE;QALzE;;WAEG;QACa,kBAAa,GAAY,uBAAuB,CAAC,aAAa,CAAC;QAG7E,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,IAAY,EAAE,QAAkC;QAC3D,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,wBAAwB,CAAC,OAAO,CAAC;YACtC,KAAK,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM;YACR,CAAC;YAED,KAAK,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACtC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,wBAAwB,CAAC,GAAG,CAAC;YAClC,OAAO,CAAC,CAAC,CAAC;gBACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACrB,OAAO,GAAG,CAAC;IACb,CAAC;;AA5DsB,qCAAa,GAAY,CAAC,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,CAAC,MAAM,AAA5D,CAA6D","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 { EOL } from 'node:os';\n\nimport supportsColor from 'supports-color';\n\nimport { type ITerminalProvider, TerminalProviderSeverity } from './ITerminalProvider';\n\n/**\n * Options to be provided to a {@link ConsoleTerminalProvider}\n *\n * @beta\n */\nexport interface IConsoleTerminalProviderOptions {\n  /**\n   * If true, print verbose logging messages.\n   */\n  verboseEnabled: boolean;\n\n  /**\n   * If true, print debug logging messages. Note that \"verbose\" and \"debug\" are considered\n   * separate message filters; if you want debug to imply verbose, it is up to your\n   * application code to enforce that.\n   */\n  debugEnabled: boolean;\n}\n\n/**\n * Terminal provider that prints to STDOUT (for log- and verbose-level messages) and\n * STDERR (for warning- and error-level messages).\n *\n * @beta\n */\nexport class ConsoleTerminalProvider implements ITerminalProvider {\n  public static readonly supportsColor: boolean = !!supportsColor.stdout && !!supportsColor.stderr;\n\n  /**\n   * If true, verbose-level messages should be written to the console.\n   */\n  public verboseEnabled: boolean;\n\n  /**\n   * If true, debug-level messages should be written to the console.\n   */\n  public debugEnabled: boolean;\n\n  /**\n   * {@inheritDoc ITerminalProvider.supportsColor}\n   */\n  public readonly supportsColor: boolean = ConsoleTerminalProvider.supportsColor;\n\n  public constructor(options: Partial<IConsoleTerminalProviderOptions> = {}) {\n    this.verboseEnabled = !!options.verboseEnabled;\n    this.debugEnabled = !!options.debugEnabled;\n  }\n\n  /**\n   * {@inheritDoc ITerminalProvider.write}\n   */\n  public write(data: string, severity: TerminalProviderSeverity): void {\n    switch (severity) {\n      case TerminalProviderSeverity.warning:\n      case TerminalProviderSeverity.error: {\n        process.stderr.write(data);\n        break;\n      }\n\n      case TerminalProviderSeverity.verbose: {\n        if (this.verboseEnabled) {\n          process.stdout.write(data);\n        }\n        break;\n      }\n\n      case TerminalProviderSeverity.debug: {\n        if (this.debugEnabled) {\n          process.stdout.write(data);\n        }\n        break;\n      }\n\n      case TerminalProviderSeverity.log:\n      default: {\n        process.stdout.write(data);\n        break;\n      }\n    }\n  }\n\n  /**\n   * {@inheritDoc ITerminalProvider.eolCharacter}\n   */\n  public get eolCharacter(): string {\n    return EOL;\n  }\n}\n"]}

package/lib-esm/DiscardStdoutTransform.js

@@ -0,0 +1,90 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { TerminalChunkKind } from './ITerminalChunk';
+import { TerminalTransform } from './TerminalTransform';
+var State;
+(function (State) {
+    State[State["Okay"] = 0] = "Okay";
+    State[State["StderrFragment"] = 1] = "StderrFragment";
+    State[State["InsertLinefeed"] = 2] = "InsertLinefeed";
+})(State || (State = {}));
+/**
+ * `DiscardStdoutTransform` discards `stdout` chunks while fixing up malformed `stderr` lines.
+ *
+ * @remarks
+ * Suppose that a poorly behaved process produces output like this:
+ *
+ * ```ts
+ * process.stdout.write('Starting operation...\n');
+ * process.stderr.write('An error occurred');
+ * process.stdout.write('\nFinishing up\n');
+ * process.stderr.write('The process completed with errors\n');
+ * ```
+ *
+ * When `stdout` and `stderr` are combined on the console, the mistake in the output would not be noticeable:
+ * ```
+ * Starting operation...
+ * An error occurred
+ * Finishing up
+ * The process completed with errors
+ * ```
+ *
+ * However, if we discard `stdout`, then `stderr` is missing a newline:
+ * ```
+ * An error occurredThe process completed with errors
+ * ```
+ *
+ * Tooling scripts can introduce these sorts of problems via edge cases that are difficult to find and fix.
+ * `DiscardStdoutTransform` can discard the `stdout` stream and fix up `stderr`:
+ *
+ * ```
+ * An error occurred
+ * The process completed with errors
+ * ```
+ *
+ * @privateRemarks
+ * This class is experimental and marked as `@beta`.  The algorithm may need some fine-tuning, or there may
+ * be better solutions to this problem.
+ *
+ * @beta
+ */
+export class DiscardStdoutTransform extends TerminalTransform {
+    constructor(options) {
+        super(options);
+        this._state = State.Okay;
+    }
+    onWriteChunk(chunk) {
+        if (chunk.text.indexOf('\r') >= 0) {
+            throw new Error('DiscardStdoutTransform expects chunks with normalized newlines');
+        }
+        if (chunk.kind === TerminalChunkKind.Stdout) {
+            if (this._state === State.StderrFragment) {
+                if (chunk.text.indexOf('\n') >= 0) {
+                    this._state = State.InsertLinefeed;
+                }
+            }
+        }
+        else if (chunk.kind === TerminalChunkKind.Stderr) {
+            let correctedText;
+            if (this._state === State.InsertLinefeed) {
+                correctedText = '\n' + chunk.text;
+            }
+            else {
+                correctedText = chunk.text;
+            }
+            this.destination.writeChunk({ kind: TerminalChunkKind.Stderr, text: correctedText });
+            if (correctedText.length > 0) {
+                if (correctedText[correctedText.length - 1] === '\n') {
+                    this._state = State.Okay;
+                }
+                else {
+                    this._state = State.StderrFragment;
+                }
+            }
+        }
+        else {
+            this.destination.writeChunk(chunk);
+        }
+    }
+}
+//# sourceMappingURL=DiscardStdoutTransform.js.map

package/lib-esm/DiscardStdoutTransform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscardStdoutTransform.js","sourceRoot":"","sources":["../src/DiscardStdoutTransform.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAuB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAkC,MAAM,qBAAqB,CAAC;AASxF,IAAK,KAIJ;AAJD,WAAK,KAAK;IACR,iCAAI,CAAA;IACJ,qDAAc,CAAA;IACd,qDAAc,CAAA;AAChB,CAAC,EAJI,KAAK,KAAL,KAAK,QAIT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,OAAO,sBAAuB,SAAQ,iBAAiB;IAG3D,YAAmB,OAAuC;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IAES,YAAY,CAAC,KAAqB;QAC1C,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,MAAM,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,CAAC,MAAM,EAAE,CAAC;YACnD,IAAI,aAAqB,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzC,aAAa,GAAG,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC;YAC7B,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;YAErF,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,IAAI,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBACrD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF","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 ITerminalChunk, TerminalChunkKind } from './ITerminalChunk';\nimport { TerminalTransform, type ITerminalTransformOptions } from './TerminalTransform';\n\n/**\n * Constructor options for {@link DiscardStdoutTransform}\n *\n * @beta\n */\nexport interface IDiscardStdoutTransformOptions extends ITerminalTransformOptions {}\n\nenum State {\n  Okay,\n  StderrFragment,\n  InsertLinefeed\n}\n\n/**\n * `DiscardStdoutTransform` discards `stdout` chunks while fixing up malformed `stderr` lines.\n *\n * @remarks\n * Suppose that a poorly behaved process produces output like this:\n *\n * ```ts\n * process.stdout.write('Starting operation...\\n');\n * process.stderr.write('An error occurred');\n * process.stdout.write('\\nFinishing up\\n');\n * process.stderr.write('The process completed with errors\\n');\n * ```\n *\n * When `stdout` and `stderr` are combined on the console, the mistake in the output would not be noticeable:\n * ```\n * Starting operation...\n * An error occurred\n * Finishing up\n * The process completed with errors\n * ```\n *\n * However, if we discard `stdout`, then `stderr` is missing a newline:\n * ```\n * An error occurredThe process completed with errors\n * ```\n *\n * Tooling scripts can introduce these sorts of problems via edge cases that are difficult to find and fix.\n * `DiscardStdoutTransform` can discard the `stdout` stream and fix up `stderr`:\n *\n * ```\n * An error occurred\n * The process completed with errors\n * ```\n *\n * @privateRemarks\n * This class is experimental and marked as `@beta`.  The algorithm may need some fine-tuning, or there may\n * be better solutions to this problem.\n *\n * @beta\n */\nexport class DiscardStdoutTransform extends TerminalTransform {\n  private _state: State;\n\n  public constructor(options: IDiscardStdoutTransformOptions) {\n    super(options);\n\n    this._state = State.Okay;\n  }\n\n  protected onWriteChunk(chunk: ITerminalChunk): void {\n    if (chunk.text.indexOf('\\r') >= 0) {\n      throw new Error('DiscardStdoutTransform expects chunks with normalized newlines');\n    }\n\n    if (chunk.kind === TerminalChunkKind.Stdout) {\n      if (this._state === State.StderrFragment) {\n        if (chunk.text.indexOf('\\n') >= 0) {\n          this._state = State.InsertLinefeed;\n        }\n      }\n    } else if (chunk.kind === TerminalChunkKind.Stderr) {\n      let correctedText: string;\n      if (this._state === State.InsertLinefeed) {\n        correctedText = '\\n' + chunk.text;\n      } else {\n        correctedText = chunk.text;\n      }\n\n      this.destination.writeChunk({ kind: TerminalChunkKind.Stderr, text: correctedText });\n\n      if (correctedText.length > 0) {\n        if (correctedText[correctedText.length - 1] === '\\n') {\n          this._state = State.Okay;\n        } else {\n          this._state = State.StderrFragment;\n        }\n      }\n    } else {\n      this.destination.writeChunk(chunk);\n    }\n  }\n}\n"]}

package/lib-esm/IProblemCollector.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=IProblemCollector.js.map

package/lib-esm/IProblemCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProblemCollector.js","sourceRoot":"","sources":["../src/IProblemCollector.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\nimport type { IProblem } from '@rushstack/problem-matcher';\n\n/**\n * Collects problems (errors/warnings/info) encountered during an operation.\n *\n * @beta\n */\nexport interface IProblemCollector {\n  /**\n   * Returns the collected problems so far.\n   */\n  get problems(): ReadonlySet<IProblem>;\n}\n"]}

package/lib-esm/ITerminal.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=ITerminal.js.map

package/lib-esm/ITerminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITerminal.js","sourceRoot":"","sources":["../src/ITerminal.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\nimport type { ITerminalProvider } from './ITerminalProvider';\n\n/**\n * @beta\n */\nexport interface ITerminalWriteOptions {\n  /**\n   * If set to true, SGR parameters will not be replaced by the terminal\n   * standard (i.e. - red for errors, yellow for warnings).\n   */\n  doNotOverrideSgrCodes?: boolean;\n}\n\n/**\n * @beta\n */\nexport type TerminalWriteParameters = string[] | [...string[], ITerminalWriteOptions];\n\n/**\n * @beta\n */\nexport interface ITerminal {\n  /**\n   * Subscribe a new terminal provider.\n   */\n  registerProvider(provider: ITerminalProvider): void;\n\n  /**\n   * Unsubscribe a terminal provider. If the provider isn't subscribed, this function does nothing.\n   */\n  unregisterProvider(provider: ITerminalProvider): void;\n\n  /**\n   * Write a generic message to the terminal\n   */\n  write(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a generic message to the terminal, followed by a newline\n   */\n  writeLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a warning message to the console with yellow text.\n   *\n   * @remarks\n   * The yellow color takes precedence over any other foreground colors set.\n   */\n  writeWarning(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a warning message to the console with yellow text, followed by a newline.\n   *\n   * @remarks\n   * The yellow color takes precedence over any other foreground colors set.\n   */\n  writeWarningLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write an error message to the console with red text.\n   *\n   * @remarks\n   * The red color takes precedence over any other foreground colors set.\n   */\n  writeError(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write an error message to the console with red text, followed by a newline.\n   *\n   * @remarks\n   * The red color takes precedence over any other foreground colors set.\n   */\n  writeErrorLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a verbose-level message.\n   */\n  writeVerbose(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a verbose-level message followed by a newline.\n   */\n  writeVerboseLine(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a debug-level message.\n   */\n  writeDebug(...messageParts: TerminalWriteParameters): void;\n\n  /**\n   * Write a debug-level message followed by a newline.\n   */\n  writeDebugLine(...messageParts: TerminalWriteParameters): void;\n}\n"]}

package/lib-esm/ITerminalChunk.js

@@ -0,0 +1,18 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+/**
+ * Specifies the kind of data represented by a {@link ITerminalChunk} object.
+ * @public
+ */
+export var TerminalChunkKind;
+(function (TerminalChunkKind) {
+    /**
+     * Indicates a `ITerminalChunk` object representing `stdout` console output.
+     */
+    TerminalChunkKind["Stdout"] = "O";
+    /**
+     * Indicates a `ITerminalChunk` object representing `stderr` console output.
+     */
+    TerminalChunkKind["Stderr"] = "E";
+})(TerminalChunkKind || (TerminalChunkKind = {}));
+//# sourceMappingURL=ITerminalChunk.js.map