@carbon/upgrade 11.5.0 → 11.6.0

package/cli.js

@@ -21,6 +21,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -867,6 +871,8 @@ var require_route = __commonJS({
       const models = Object.keys(conversions);
       for (let len = models.length, i = 0; i < len; i++) {
         graph[models[i]] = {
+          // http://jsperf.com/1-vs-infinity
+          // micro-opt, but this is simple.
           distance: -1,
           parent: null
         };
@@ -1042,6 +1048,7 @@ var require_ansi_styles = __commonJS({
       const styles = {
         modifier: {
           reset: [0, 0],
+          // 21 isn't widely supported and 22 does the same thing
           bold: [1, 22],
           dim: [2, 22],
           italic: [3, 23],
@@ -1059,6 +1066,7 @@ var require_ansi_styles = __commonJS({
           magenta: [35, 39],
           cyan: [36, 39],
           white: [37, 39],
+          // Bright color
           blackBright: [90, 39],
           redBright: [91, 39],
           greenBright: [92, 39],
@@ -1077,6 +1085,7 @@ var require_ansi_styles = __commonJS({
           bgMagenta: [45, 49],
           bgCyan: [46, 49],
           bgWhite: [47, 49],
+          // Bright color
           bgBlackBright: [100, 49],
           bgRedBright: [101, 49],
           bgGreenBright: [102, 49],
@@ -4276,6 +4285,10 @@ var require_separator = __commonJS({
         this.type = "separator";
         this.line = chalk4.dim(line || new Array(15).join(figures.line));
       }
+      /**
+       * Stringify separator
+       * @return {String} the separator display string
+       */
       toString() {
         return this.line;
       }
@@ -4525,11 +4538,18 @@ var require_baseUI = __commonJS({
         process.on("exit", this.onForceClose);
         this.rl.on("SIGINT", this.onForceClose);
       }
+      /**
+       * Handle the ^C exit
+       * @return {null}
+       */
       onForceClose() {
         this.close();
         process.kill(process.pid, "SIGINT");
         console.log("");
       }
+      /**
+       * Close the interface and cleanup listeners
+       */
       close() {
         this.rl.removeListener("SIGINT", this.onForceClose);
         process.removeListener("exit", this.onForceClose);
@@ -4634,7 +4654,13 @@ var require_ansi_escapes = __commonJS({
     ansiEscapes.scrollUp = ESC + "S";
     ansiEscapes.scrollDown = ESC + "T";
     ansiEscapes.clearScreen = "\x1Bc";
-    ansiEscapes.clearTerminal = process.platform === "win32" ? `${ansiEscapes.eraseScreen}${ESC}0f` : `${ansiEscapes.eraseScreen}${ESC}3J${ESC}H`;
+    ansiEscapes.clearTerminal = process.platform === "win32" ? `${ansiEscapes.eraseScreen}${ESC}0f` : (
+      // 1. Erases the screen (Only done in case `2` is not supported)
+      // 2. Erases the whole screen including scrollback buffer
+      // 3. Moves cursor to the top-left position
+      // More info: https://www.real-world-systems.com/docs/ANSIcode.html
+      `${ansiEscapes.eraseScreen}${ESC}3J${ESC}H`
+    );
     ansiEscapes.beep = BEL;
     ansiEscapes.link = (text, url) => {
       return [
@@ -4724,6 +4750,10 @@ var require_bottom_bar = __commonJS({
         this.bottomBar = opt.bottomBar || "";
         this.render();
       }
+      /**
+       * Render the prompt to screen
+       * @return {BottomBar} self
+       */
       render() {
         this.write(this.bottomBar);
         return this;
@@ -4732,6 +4762,11 @@ var require_bottom_bar = __commonJS({
         rlUtils.clearLine(this.rl, this.bottomBar.split("\n").length);
         return this;
       }
+      /**
+       * Update the bottom bar content and rerender
+       * @param  {String} bottomBar Bottom bar content
+       * @return {BottomBar}           self
+       */
       updateBottomBar(bottomBar) {
         rlUtils.clearLine(this.rl, 1);
         this.rl.output.unmute();
@@ -4741,6 +4776,11 @@ var require_bottom_bar = __commonJS({
         this.rl.output.mute();
         return this;
       }
+      /**
+       * Write out log data
+       * @param {String} data - The log data to be output
+       * @return {BottomBar} self
+       */
       writeLog(data) {
         this.rl.output.unmute();
         this.clean();
@@ -4749,9 +4789,18 @@ var require_bottom_bar = __commonJS({
         this.rl.output.mute();
         return this;
       }
+      /**
+       * Make sure line end on a line feed
+       * @param  {String} str Input string
+       * @return {String}     The input string with a final line feed
+       */
       enforceLF(str) {
         return str.match(/[\r\n]$/) ? str : str + "\n";
       }
+      /**
+       * Helper for writing message in Prompt
+       * @param {String} message - The message to be output
+       */
       write(message) {
         const msgLines = message.split(/\n/);
         this.height = msgLines.length;
@@ -15993,6 +16042,7 @@ var require_prompt = __commonJS({
         this.process = obs.pipe(
           concatMap(this.processQuestion.bind(this)),
           publish()
+          // Creates a hot Observable. It prevents duplicating prompts.
         );
         this.process.connect();
         return this.process.pipe(
@@ -16002,6 +16052,9 @@ var require_prompt = __commonJS({
           }, this.answers)
         ).toPromise(Promise).then(this.onCompletion.bind(this), this.onError.bind(this));
       }
+      /**
+       * Once all prompt are over
+       */
       onCompletion() {
         this.close();
         return this.answers;
@@ -16142,6 +16195,9 @@ var require_signals = __commonJS({
         "SIGSYS",
         "SIGQUIT",
         "SIGIOT"
+        // should detect profiler and enable/disable accordingly.
+        // see #21
+        // 'SIGPROF'
       );
     }
     if (process.platform === "linux") {
@@ -16277,7 +16333,8 @@ var require_signal_exit = __commonJS({
         if (!processOk(global.process)) {
           return;
         }
-        process2.exitCode = code || 0;
+        process2.exitCode = code || /* istanbul ignore next */
+        0;
         emit("exit", process2.exitCode, null);
         emit("afterexit", process2.exitCode, null);
         originalProcessReallyExit.call(process2, process2.exitCode);
@@ -16708,7 +16765,11 @@ var require_arrayLikeKeys = __commonJS({
     function arrayLikeKeys(value, inherited) {
       var isArr = isArray(value), isArg = !isArr && isArguments(value), isBuff = !isArr && !isArg && isBuffer(value), isType = !isArr && !isArg && !isBuff && isTypedArray(value), skipIndexes = isArr || isArg || isBuff || isType, result = skipIndexes ? baseTimes(value.length, String) : [], length = result.length;
       for (var key in value) {
-        if ((inherited || hasOwnProperty.call(value, key)) && !(skipIndexes && (key == "length" || isBuff && (key == "offset" || key == "parent") || isType && (key == "buffer" || key == "byteLength" || key == "byteOffset") || isIndex(key, length)))) {
+        if ((inherited || hasOwnProperty.call(value, key)) && !(skipIndexes && // Safari 9 has enumerable `arguments.length` in strict mode.
+        (key == "length" || // Node.js 0.10 has enumerable non-index properties on buffers.
+        isBuff && (key == "offset" || key == "parent") || // PhantomJS 2 has enumerable non-index properties on typed arrays.
+        isType && (key == "buffer" || key == "byteLength" || key == "byteOffset") || // Skip index properties.
+        isIndex(key, length)))) {
           result.push(key);
         }
       }
@@ -18434,6 +18495,7 @@ var require_choices = __commonJS({
     var Separator = require_separator();
     var Choice = require_choice();
     module2.exports = class Choices {
+      /** @param {Array} choices  All `choice` to keep in the collection */
       constructor(choices, answers) {
         this.choices = choices.map((val) => {
           if (val.type === "separator") {
@@ -18462,20 +18524,41 @@ var require_choices = __commonJS({
           }
         });
       }
+      /**
+       * Get a valid choice from the collection
+       * @param  {Number} selector  The selected choice index
+       * @return {Choice|Undefined} Return the matched choice or undefined
+       */
       getChoice(selector) {
         assert(typeof selector === "number");
         return this.realChoices[selector];
       }
+      /**
+       * Get a raw element from the collection
+       * @param  {Number} selector  The selected index value
+       * @return {Choice|Undefined} Return the matched choice or undefined
+       */
       get(selector) {
         assert(typeof selector === "number");
         return this.choices[selector];
       }
+      /**
+       * Match the valid choices against a where clause
+       * @param  {Object} whereClause Lodash `where` clause
+       * @return {Array}              Matching choices or empty array
+       */
       where(whereClause) {
         return _.filter(this.realChoices, whereClause);
       }
+      /**
+       * Pluck a particular key from the choices
+       * @param  {String} propertyName Property name to select
+       * @return {Array}               Selected properties
+       */
       pluck(propertyName) {
         return _.map(this.realChoices, propertyName);
       }
+      // Expose usual Array methods
       indexOf(...args) {
         return this.choices.indexOf(...args);
       }
@@ -18575,7 +18658,22 @@ var require_is_fullwidth_code_point = __commonJS({
       if (Number.isNaN(codePoint)) {
         return false;
       }
-      if (codePoint >= 4352 && (codePoint <= 4447 || codePoint === 9001 || codePoint === 9002 || 11904 <= codePoint && codePoint <= 12871 && codePoint !== 12351 || 12880 <= codePoint && codePoint <= 19903 || 19968 <= codePoint && codePoint <= 42182 || 43360 <= codePoint && codePoint <= 43388 || 44032 <= codePoint && codePoint <= 55203 || 63744 <= codePoint && codePoint <= 64255 || 65040 <= codePoint && codePoint <= 65049 || 65072 <= codePoint && codePoint <= 65131 || 65281 <= codePoint && codePoint <= 65376 || 65504 <= codePoint && codePoint <= 65510 || 110592 <= codePoint && codePoint <= 110593 || 127488 <= codePoint && codePoint <= 127569 || 131072 <= codePoint && codePoint <= 262141)) {
+      if (codePoint >= 4352 && (codePoint <= 4447 || // Hangul Jamo
+      codePoint === 9001 || // LEFT-POINTING ANGLE BRACKET
+      codePoint === 9002 || // RIGHT-POINTING ANGLE BRACKET
+      // CJK Radicals Supplement .. Enclosed CJK Letters and Months
+      11904 <= codePoint && codePoint <= 12871 && codePoint !== 12351 || // Enclosed CJK Letters and Months .. CJK Unified Ideographs Extension A
+      12880 <= codePoint && codePoint <= 19903 || // CJK Unified Ideographs .. Yi Radicals
+      19968 <= codePoint && codePoint <= 42182 || // Hangul Jamo Extended-A
+      43360 <= codePoint && codePoint <= 43388 || // Hangul Syllables
+      44032 <= codePoint && codePoint <= 55203 || // CJK Compatibility Ideographs
+      63744 <= codePoint && codePoint <= 64255 || // Vertical Forms
+      65040 <= codePoint && codePoint <= 65049 || // CJK Compatibility Forms .. Small Form Variants
+      65072 <= codePoint && codePoint <= 65131 || // Halfwidth and Fullwidth Forms
+      65281 <= codePoint && codePoint <= 65376 || 65504 <= codePoint && codePoint <= 65510 || // Kana Supplement
+      110592 <= codePoint && codePoint <= 110593 || // Enclosed Ideographic Supplement
+      127488 <= codePoint && codePoint <= 127569 || // CJK Unified Ideographs Extension B .. Tertiary Ideographic Plane
+      131072 <= codePoint && codePoint <= 262141)) {
         return true;
       }
       return false;
@@ -20237,7 +20335,8 @@ var require_is_unicode_supported = __commonJS({
       if (process.platform !== "win32") {
         return true;
       }
-      return Boolean(process.env.CI) || Boolean(process.env.WT_SESSION) || process.env.TERM_PROGRAM === "vscode" || process.env.TERM === "xterm-256color" || process.env.TERM === "alacritty";
+      return Boolean(process.env.CI) || Boolean(process.env.WT_SESSION) || // Windows Terminal
+      process.env.TERM_PROGRAM === "vscode" || process.env.TERM === "xterm-256color" || process.env.TERM === "alacritty";
     };
   }
 });
@@ -20593,7 +20692,14 @@ var require_wcwidth = __commonJS({
         return opts.control;
       if (bisearch(ucs))
         return 0;
-      return 1 + (ucs >= 4352 && (ucs <= 4447 || ucs == 9001 || ucs == 9002 || ucs >= 11904 && ucs <= 42191 && ucs != 12351 || ucs >= 44032 && ucs <= 55203 || ucs >= 63744 && ucs <= 64255 || ucs >= 65040 && ucs <= 65049 || ucs >= 65072 && ucs <= 65135 || ucs >= 65280 && ucs <= 65376 || ucs >= 65504 && ucs <= 65510 || ucs >= 131072 && ucs <= 196605 || ucs >= 196608 && ucs <= 262141));
+      return 1 + (ucs >= 4352 && (ucs <= 4447 || // Hangul Jamo init. consonants
+      ucs == 9001 || ucs == 9002 || ucs >= 11904 && ucs <= 42191 && ucs != 12351 || // CJK ... Yi
+      ucs >= 44032 && ucs <= 55203 || // Hangul Syllables
+      ucs >= 63744 && ucs <= 64255 || // CJK Compatibility Ideographs
+      ucs >= 65040 && ucs <= 65049 || // Vertical forms
+      ucs >= 65072 && ucs <= 65135 || // CJK Compatibility Forms
+      ucs >= 65280 && ucs <= 65376 || // Fullwidth Forms
+      ucs >= 65504 && ucs <= 65510 || ucs >= 131072 && ucs <= 196605 || ucs >= 196608 && ucs <= 262141));
     }
     function bisearch(ucs) {
       var min = 0;
@@ -20784,6 +20890,7 @@ var require_buffer_list = __commonJS({
           }
           return ret;
         }
+        // Consumes a specified amount of bytes or characters from the buffered data.
       }, {
         key: "consume",
         value: function consume(n, hasStrings) {
@@ -20803,6 +20910,7 @@ var require_buffer_list = __commonJS({
         value: function first() {
           return this.head.data;
         }
+        // Consumes a specified amount of characters from the buffered data.
       }, {
         key: "_getString",
         value: function _getString(n) {
@@ -20836,6 +20944,7 @@ var require_buffer_list = __commonJS({
           this.length -= c;
           return ret;
         }
+        // Consumes a specified amount of bytes from the buffered data.
       }, {
         key: "_getBuffer",
         value: function _getBuffer(n) {
@@ -20867,11 +20976,14 @@ var require_buffer_list = __commonJS({
           this.length -= c;
           return ret;
         }
+        // Make sure the linked list only shows the minimal necessary information.
       }, {
         key: custom,
         value: function value(_, options) {
           return inspect(this, _objectSpread({}, options, {
+            // Only inspect one level.
             depth: 0,
+            // It should not recurse.
             customInspect: false
           }));
         }
@@ -21357,6 +21469,9 @@ var require_stream_writable = __commonJS({
       return this;
     };
     Object.defineProperty(Writable.prototype, "writableBuffer", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._writableState && this._writableState.getBuffer();
@@ -21369,6 +21484,9 @@ var require_stream_writable = __commonJS({
       return chunk;
     }
     Object.defineProperty(Writable.prototype, "writableHighWaterMark", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._writableState.highWaterMark;
@@ -21547,6 +21665,9 @@ var require_stream_writable = __commonJS({
       return this;
     };
     Object.defineProperty(Writable.prototype, "writableLength", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._writableState.length;
@@ -21619,6 +21740,9 @@ var require_stream_writable = __commonJS({
       state.corkedRequestsFree.next = corkReq;
     }
     Object.defineProperty(Writable.prototype, "destroyed", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         if (this._writableState === void 0) {
@@ -21685,18 +21809,27 @@ var require_stream_duplex = __commonJS({
       }
     }
     Object.defineProperty(Duplex.prototype, "writableHighWaterMark", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._writableState.highWaterMark;
       }
     });
     Object.defineProperty(Duplex.prototype, "writableBuffer", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._writableState && this._writableState.getBuffer();
       }
     });
     Object.defineProperty(Duplex.prototype, "writableLength", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._writableState.length;
@@ -21711,6 +21844,9 @@ var require_stream_duplex = __commonJS({
       self2.end();
     }
     Object.defineProperty(Duplex.prototype, "destroyed", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         if (this._readableState === void 0 || this._writableState === void 0) {
@@ -22541,6 +22677,9 @@ var require_stream_readable = __commonJS({
       Stream.call(this);
     }
     Object.defineProperty(Readable.prototype, "destroyed", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         if (this._readableState === void 0) {
@@ -23128,18 +23267,27 @@ var require_stream_readable = __commonJS({
       };
     }
     Object.defineProperty(Readable.prototype, "readableHighWaterMark", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._readableState.highWaterMark;
       }
     });
     Object.defineProperty(Readable.prototype, "readableBuffer", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._readableState && this._readableState.buffer;
       }
     });
     Object.defineProperty(Readable.prototype, "readableFlowing", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._readableState.flowing;
@@ -23152,6 +23300,9 @@ var require_stream_readable = __commonJS({
     });
     Readable._fromList = fromList;
     Object.defineProperty(Readable.prototype, "readableLength", {
+      // making it explicit this property is not enumerable
+      // because otherwise some prototype manipulation in
+      // userland will fail
       enumerable: false,
       get: function get() {
         return this._readableState.length;
@@ -24266,11 +24417,17 @@ var require_screen_manager = __commonJS({
         });
         return width;
       }
+      /**
+       * @param {string[]} lines
+       */
       breakLines(lines, width = this.normalizedCliWidth()) {
         return lines.map(
           (line) => wrapAnsi(line, width, { trim: false, hard: true }).split("\n")
         );
       }
+      /**
+       * @param {string} content
+       */
       forceLineReturn(content, width = this.normalizedCliWidth()) {
         return this.breakLines(content.split("\n"), width).flat().join("\n");
       }
@@ -24319,6 +24476,10 @@ var require_base = __commonJS({
         this.rl = rl;
         this.screen = new ScreenManager(this.rl);
       }
+      /**
+       * Start the Inquiry session and manage output value filtering
+       * @return {Promise}
+       */
       run() {
         return new Promise((resolve, reject) => {
           this._run(
@@ -24327,15 +24488,29 @@ var require_base = __commonJS({
           );
         });
       }
+      // Default noop (this one should be overwritten in prompts)
       _run(cb) {
         cb();
       }
+      /**
+       * Throw an error telling a required parameter is missing
+       * @param  {String} name Name of the missing param
+       * @return {Throw Error}
+       */
       throwParamError(name) {
         throw new Error("You must provide a `" + name + "` parameter");
       }
+      /**
+       * Called when the UI closes. Override to do any specific cleanup necessary
+       */
       close() {
         this.screen.releaseCursor();
       }
+      /**
+       * Run the provided validation method each time a submit event occur.
+       * @param  {Rx.Observable} submit - submit event flow
+       * @return {Object}        Object containing two observables: `success` and `error`
+       */
       handleSubmitEvents(submit) {
         const self2 = this;
         const validate = runAsync(this.opt.validate);
@@ -24374,9 +24549,19 @@ var require_base = __commonJS({
         const content = bottomContent ? this.getQuestion() + value : this.getQuestion().slice(this.opt.prefix.length + 1) + value;
         this.screen.renderWithSpinner(content, bottomContent);
       }
+      /**
+       * Allow override, e.g. for password prompts
+       * See: https://github.com/SBoudrias/Inquirer.js/issues/1022
+       *
+       * @return {String} value to display while spinning
+       */
       getSpinningValue(value) {
         return value;
       }
+      /**
+       * Generate the prompt question string
+       * @return {String} prompt question string
+       */
       getQuestion() {
         let message = (this.opt.prefix ? this.opt.prefix + " " : "") + chalk4.bold(this.opt.message) + this.opt.suffix + chalk4.reset(" ");
         if (this.opt.default != null && this.status !== "touched" && this.status !== "answered") {
@@ -24447,6 +24632,10 @@ var require_paginator = __commonJS({
     "use strict";
     var chalk4 = require_source();
     var Paginator = class {
+      /**
+       * @param {import("./screen-manager")} [screen]
+       * @param {{isInfinite?: boolean}} [options]
+       */
       constructor(screen, options = {}) {
         const { isInfinite = true } = options;
         this.lastIndex = 0;
@@ -24550,6 +24739,11 @@ var require_list = __commonJS({
         const shouldLoop = this.opt.loop === void 0 ? true : this.opt.loop;
         this.paginator = new Paginator(this.screen, { isInfinite: shouldLoop });
       }
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb      Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         const self2 = this;
@@ -24568,6 +24762,10 @@ var require_list = __commonJS({
         this.render();
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {ListPrompt} self
+       */
       render() {
         let message = this.getQuestion();
         if (this.firstRender) {
@@ -24599,6 +24797,9 @@ var require_list = __commonJS({
         this.firstRender = false;
         this.screen.render(message);
       }
+      /**
+       * When user press `enter` key
+       */
       onSubmit(value) {
         this.status = "answered";
         this.render();
@@ -24609,6 +24810,9 @@ var require_list = __commonJS({
       getCurrentValue() {
         return this.opt.choices.getChoice(this.selected).value;
       }
+      /**
+       * When user press a key
+       */
       onUpKey() {
         this.selected = incrementListIndex(this.selected, "up", this.opt);
         this.render();
@@ -24662,6 +24866,11 @@ var require_input = __commonJS({
     var Base = require_base();
     var observe = require_events();
     var InputPrompt = class extends Base {
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb      Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         const events = observe(this.rl);
@@ -24673,6 +24882,10 @@ var require_input = __commonJS({
         this.render();
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {InputPrompt} self
+       */
       render(error) {
         let bottomContent = "";
         let appendContent = "";
@@ -24694,6 +24907,9 @@ var require_input = __commonJS({
         }
         this.screen.render(message, bottomContent);
       }
+      /**
+       * When user press `enter` key
+       */
       filterInput(input) {
         if (!input) {
           return this.opt.default == null ? "" : this.opt.default;
@@ -24712,6 +24928,9 @@ var require_input = __commonJS({
         this.rl.cursor += value.length;
         this.render(isValid);
       }
+      /**
+       * When user press a key
+       */
       onKeypress() {
         this.status = "touched";
         this.render();
@@ -24768,6 +24987,11 @@ var require_confirm = __commonJS({
         }
         this.opt.default = rawDefault ? "Y/n" : "y/N";
       }
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb   Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         const events = observe(this.rl);
@@ -24776,6 +25000,10 @@ var require_confirm = __commonJS({
         this.render();
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {ConfirmPrompt} self
+       */
       render(answer) {
         let message = this.getQuestion();
         if (typeof answer === "boolean") {
@@ -24786,6 +25014,9 @@ var require_confirm = __commonJS({
         this.screen.render(message);
         return this;
       }
+      /**
+       * When user press `enter` key
+       */
       onEnd(input) {
         this.status = "answered";
         const output = this.opt.filter(input);
@@ -24793,6 +25024,9 @@ var require_confirm = __commonJS({
         this.screen.done();
         this.done(output);
       }
+      /**
+       * When user press a key
+       */
       onKeypress() {
         this.render();
       }
@@ -24842,6 +25076,11 @@ var require_rawlist = __commonJS({
         const shouldLoop = this.opt.loop === void 0 ? true : this.opt.loop;
         this.paginator = new Paginator(void 0, { isInfinite: shouldLoop });
       }
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb      Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         const events = observe(this.rl);
@@ -24855,6 +25094,10 @@ var require_rawlist = __commonJS({
         this.render();
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {RawListPrompt} self
+       */
       render(error) {
         let message = this.getQuestion();
         let bottomContent = "";
@@ -24871,6 +25114,9 @@ var require_rawlist = __commonJS({
         }
         this.screen.render(message, bottomContent);
       }
+      /**
+       * When user press `enter` key
+       */
       getCurrentValue(index) {
         if (index == null) {
           index = this.rawDefault;
@@ -24893,6 +25139,9 @@ var require_rawlist = __commonJS({
       onError() {
         this.render("Please enter a valid index");
       }
+      /**
+       * When user press a key
+       */
       onKeypress() {
         let index;
         if (this.lastKey === "arrow") {
@@ -24908,12 +25157,22 @@ var require_rawlist = __commonJS({
         }
         this.render();
       }
+      /**
+       * When user press up key
+       */
       onUpKey() {
         this.onArrowKey("up");
       }
+      /**
+       * When user press down key
+       */
       onDownKey() {
         this.onArrowKey("down");
       }
+      /**
+       * When user press up or down key
+       * @param {String} type Arrow type: up or down
+       */
       onArrowKey(type) {
         this.selected = incrementListIndex(this.selected, type, this.opt) || 0;
         this.hiddenLine = String(this.selected + 1);
@@ -24975,6 +25234,11 @@ var require_expand2 = __commonJS({
         this.opt.default = this.generateChoicesString(this.opt.choices, this.opt.default);
         this.paginator = new Paginator(this.screen);
       }
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb      Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         const events = observe(this.rl);
@@ -24987,6 +25251,10 @@ var require_expand2 = __commonJS({
         this.render();
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {ExpandPrompt} self
+       */
       render(error, hint) {
         let message = this.getQuestion();
         let bottomContent = "";
@@ -25016,6 +25284,10 @@ var require_expand2 = __commonJS({
         }
         return selected.value;
       }
+      /**
+       * Generate the prompt choices string
+       * @return {String}  Choices string
+       */
       getChoices() {
         let output = "";
         this.opt.choices.forEach((choice) => {
@@ -25041,6 +25313,9 @@ var require_expand2 = __commonJS({
         }
         this.render(state.isValid);
       }
+      /**
+       * When user press `enter` key
+       */
       onSubmit(state) {
         this.status = "answered";
         const choice = this.opt.choices.where({ value: state.value })[0];
@@ -25049,6 +25324,9 @@ var require_expand2 = __commonJS({
         this.screen.done();
         this.done(state.value);
       }
+      /**
+       * When user press a key
+       */
       onKeypress() {
         this.selectedKey = this.rl.line.toLowerCase();
         const selected = this.opt.choices.where({ key: this.selectedKey })[0];
@@ -25058,6 +25336,10 @@ var require_expand2 = __commonJS({
           this.render(null, selected ? selected.name : null);
         }
       }
+      /**
+       * Validate the choices
+       * @param {Array} choices
+       */
       validateChoices(choices) {
         let formatError;
         const errors = [];
@@ -25088,6 +25370,12 @@ var require_expand2 = __commonJS({
           );
         }
       }
+      /**
+       * Generate a string out of the choices keys
+       * @param  {Array}  choices
+       * @param  {Number|String} default - the choice index or name to capitalize
+       * @return {String} The rendered choices key string
+       */
       generateChoicesString(choices, defaultChoice) {
         let defIndex = choices.realLength - 1;
         if (typeof defaultChoice === "number" && this.opt.choices.getChoice(defaultChoice)) {
@@ -25152,6 +25440,11 @@ var require_checkbox = __commonJS({
         const shouldLoop = this.opt.loop === void 0 ? true : this.opt.loop;
         this.paginator = new Paginator(this.screen, { isInfinite: shouldLoop });
       }
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb      Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         const events = observe(this.rl);
@@ -25171,6 +25464,10 @@ var require_checkbox = __commonJS({
         this.firstRender = false;
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {CheckboxPrompt} self
+       */
       render(error) {
         let message = this.getQuestion();
         let bottomContent = "";
@@ -25205,6 +25502,9 @@ var require_checkbox = __commonJS({
         }
         this.screen.render(message, bottomContent);
       }
+      /**
+       * When user press `enter` key
+       */
       onEnd(state) {
         this.status = "answered";
         this.dontShowHints = true;
@@ -25317,6 +25617,11 @@ var require_password = __commonJS({
       return new Array(input.length + 1).join(maskChar);
     }
     var PasswordPrompt = class extends Base {
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb      Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         const events = observe(this.rl);
@@ -25328,6 +25633,10 @@ var require_password = __commonJS({
         this.render();
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {PasswordPrompt} self
+       */
       render(error) {
         let message = this.getQuestion();
         let bottomContent = "";
@@ -25347,9 +25656,15 @@ var require_password = __commonJS({
         }
         return this.opt.mask ? mask(value, this.opt.mask) : chalk4.italic.dim("[input is hidden] ");
       }
+      /**
+       * Mask value during async filter/validation.
+       */
       getSpinningValue(value) {
         return this.getMaskedValue(value);
       }
+      /**
+       * When user press `enter` key
+       */
       filterInput(input) {
         if (!input) {
           return this.opt.default == null ? "" : this.opt.default;
@@ -30638,17 +30953,29 @@ var require_iso2022 = __commonJS({
       };
       this.escapeSequences = [
         [27, 36, 40, 67],
+        // KS X 1001:1992
         [27, 36, 40, 68],
+        // JIS X 212-1990
         [27, 36, 64],
+        // JIS C 6226-1978
         [27, 36, 65],
+        // GB 2312-80
         [27, 36, 66],
+        // JIS X 208-1983
         [27, 38, 64],
+        // JIS X 208 1990, 1997
         [27, 40, 66],
+        // ASCII
         [27, 40, 72],
+        // JIS-Roman
         [27, 40, 73],
+        // Half-width katakana
         [27, 40, 74],
+        // JIS-Roman
         [27, 46, 65],
+        // ISO 8859-1
         [27, 46, 70]
+        // ISO 8859-7
       ];
     };
     util.inherits(module2.exports.ISO_2022_JP, ISO_2022);
@@ -30667,16 +30994,27 @@ var require_iso2022 = __commonJS({
       };
       this.escapeSequences = [
         [27, 36, 41, 65],
+        // GB 2312-80
         [27, 36, 41, 71],
+        // CNS 11643-1992 Plane 1
         [27, 36, 42, 72],
+        // CNS 11643-1992 Plane 2
         [27, 36, 41, 69],
+        // ISO-IR-165
         [27, 36, 43, 73],
+        // CNS 11643-1992 Plane 3
         [27, 36, 43, 74],
+        // CNS 11643-1992 Plane 4
         [27, 36, 43, 75],
+        // CNS 11643-1992 Plane 5
         [27, 36, 43, 76],
+        // CNS 11643-1992 Plane 6
         [27, 36, 43, 77],
+        // CNS 11643-1992 Plane 7
         [27, 78],
+        // SS2
         [27, 79]
+        // SS3
       ];
     };
     util.inherits(module2.exports.ISO_2022_CN, ISO_2022);
@@ -30934,6 +31272,7 @@ var require_internal = __commonJS({
     "use strict";
     var Buffer2 = require_safer().Buffer;
     module2.exports = {
+      // Encodings
       utf8: { type: "_internal", bomAware: true },
       cesu8: { type: "_internal", bomAware: true },
       unicode11utf8: "utf8",
@@ -30942,6 +31281,7 @@ var require_internal = __commonJS({
       binary: { type: "_internal" },
       base64: { type: "_internal" },
       hex: { type: "_internal" },
+      // Codec.
       _internal: InternalCodec
     };
     function InternalCodec(codecOptions, iconv) {
@@ -31450,6 +31790,7 @@ var require_sbcs_data = __commonJS({
   "../../node_modules/iconv-lite/encodings/sbcs-data.js"(exports, module2) {
     "use strict";
     module2.exports = {
+      // Not supported by iconv, not sure why.
       "10029": "maccenteuro",
       "maccenteuro": {
         "type": "_sbcs",
@@ -31465,6 +31806,7 @@ var require_sbcs_data = __commonJS({
         "type": "_sbcs",
         "chars": "\u0410\u0411\u0412\u0413\u0414\u0415\u0416\u0417\u0418\u0419\u041A\u041B\u041C\u041D\u041E\u041F\u0420\u0421\u0422\u0423\u0424\u0425\u0426\u0427\u0428\u0429\u042A\u042B\u042C\u042D\u042E\u042F\u0430\u0431\u0432\u0433\u0434\u0435\u0436\u0437\u0438\u0439\u043A\u043B\u043C\u043D\u043E\u043F\u0440\u0441\u0442\u0443\u0444\u0445\u0446\u0447\u0448\u0449\u044A\u044B\u044C\u044D\u044E\u044F\u2514\u2534\u252C\u251C\u2500\u253C\u2563\u2551\u255A\u2554\u2569\u2566\u2560\u2550\u256C\u2510\u2591\u2592\u2593\u2502\u2524\u2116\xA7\u2557\u255D\u2518\u250C\u2588\u2584\u258C\u2590\u2580\u03B1\xDF\u0393\u03C0\u03A3\u03C3\xB5\u03C4\u03A6\u0398\u03A9\u03B4\u221E\u03C6\u03B5\u2229\u2261\xB1\u2265\u2264\u2320\u2321\xF7\u2248\xB0\u2219\xB7\u221A\u207F\xB2\u25A0\xA0"
       },
+      // Aliases of generated encodings.
       "ascii8bit": "ascii",
       "usascii": "ascii",
       "ansix34": "ascii",
@@ -33684,6 +34026,36 @@ var require_dbcs_data = __commonJS({
   "../../node_modules/iconv-lite/encodings/dbcs-data.js"(exports, module2) {
     "use strict";
     module2.exports = {
+      // == Japanese/ShiftJIS ====================================================
+      // All japanese encodings are based on JIS X set of standards:
+      // JIS X 0201 - Single-byte encoding of ASCII + ¥ + Kana chars at 0xA1-0xDF.
+      // JIS X 0208 - Main set of 6879 characters, placed in 94x94 plane, to be encoded by 2 bytes. 
+      //              Has several variations in 1978, 1983, 1990 and 1997.
+      // JIS X 0212 - Supplementary plane of 6067 chars in 94x94 plane. 1990. Effectively dead.
+      // JIS X 0213 - Extension and modern replacement of 0208 and 0212. Total chars: 11233.
+      //              2 planes, first is superset of 0208, second - revised 0212.
+      //              Introduced in 2000, revised 2004. Some characters are in Unicode Plane 2 (0x2xxxx)
+      // Byte encodings are:
+      //  * Shift_JIS: Compatible with 0201, uses not defined chars in top half as lead bytes for double-byte
+      //               encoding of 0208. Lead byte ranges: 0x81-0x9F, 0xE0-0xEF; Trail byte ranges: 0x40-0x7E, 0x80-0x9E, 0x9F-0xFC.
+      //               Windows CP932 is a superset of Shift_JIS. Some companies added more chars, notably KDDI.
+      //  * EUC-JP:    Up to 3 bytes per character. Used mostly on *nixes.
+      //               0x00-0x7F       - lower part of 0201
+      //               0x8E, 0xA1-0xDF - upper part of 0201
+      //               (0xA1-0xFE)x2   - 0208 plane (94x94).
+      //               0x8F, (0xA1-0xFE)x2 - 0212 plane (94x94).
+      //  * JIS X 208: 7-bit, direct encoding of 0208. Byte ranges: 0x21-0x7E (94 values). Uncommon.
+      //               Used as-is in ISO2022 family.
+      //  * ISO2022-JP: Stateful encoding, with escape sequences to switch between ASCII, 
+      //                0201-1976 Roman, 0208-1978, 0208-1983.
+      //  * ISO2022-JP-1: Adds esc seq for 0212-1990.
+      //  * ISO2022-JP-2: Adds esc seq for GB2313-1980, KSX1001-1992, ISO8859-1, ISO8859-7.
+      //  * ISO2022-JP-3: Adds esc seq for 0201-1976 Kana set, 0213-2000 Planes 1, 2.
+      //  * ISO2022-JP-2004: Adds 0213-2004 Plane 1.
+      //
+      // After JIS X 0213 appeared, Shift_JIS-2004, EUC-JISX0213 and ISO2022-JP-2004 followed, with just changing the planes.
+      //
+      // Overall, it seems that it's a mess :( http://www8.plala.or.jp/tkubota1/unicode-symbols-map2.html
       "shiftjis": {
         type: "_dbcs",
         table: function() {
@@ -33709,12 +34081,20 @@ var require_dbcs_data = __commonJS({
         },
         encodeAdd: { "\xA5": 92, "\u203E": 126 }
       },
+      // TODO: KDDI extension to Shift_JIS
+      // TODO: IBM CCSID 942 = CP932, but F0-F9 custom chars and other char changes.
+      // TODO: IBM CCSID 943 = Shift_JIS = CP932 with original Shift_JIS lower 128 chars.
+      // == Chinese/GBK ==========================================================
+      // http://en.wikipedia.org/wiki/GBK
+      // We mostly implement W3C recommendation: https://www.w3.org/TR/encoding/#gbk-encoder
+      // Oldest GB2312 (1981, ~7600 chars) is a subset of CP936
       "gb2312": "cp936",
       "gb231280": "cp936",
       "gb23121980": "cp936",
       "csgb2312": "cp936",
       "csiso58gb231280": "cp936",
       "euccn": "cp936",
+      // Microsoft's CP936 is a subset and approximation of GBK.
       "windows936": "cp936",
       "ms936": "cp936",
       "936": "cp936",
@@ -33724,6 +34104,7 @@ var require_dbcs_data = __commonJS({
           return require_cp936();
         }
       },
+      // GBK (~22000 chars) is an extension of CP936 that added user-mapped chars and some other.
       "gbk": {
         type: "_dbcs",
         table: function() {
@@ -33732,6 +34113,11 @@ var require_dbcs_data = __commonJS({
       },
       "xgbk": "gbk",
       "isoir58": "gbk",
+      // GB18030 is an algorithmic extension of GBK.
+      // Main source: https://www.w3.org/TR/encoding/#gbk-encoder
+      // http://icu-project.org/docs/papers/gb18030.html
+      // http://source.icu-project.org/repos/icu/data/trunk/charset/data/xml/gb-18030-2000.xml
+      // http://www.khngai.com/chinese/charmap/tblgbk.php?page=0
       "gb18030": {
         type: "_dbcs",
         table: function() {
@@ -33744,6 +34130,8 @@ var require_dbcs_data = __commonJS({
         encodeAdd: { "\u20AC": 41699 }
       },
       "chinese": "gb18030",
+      // == Korean ===============================================================
+      // EUC-KR, KS_C_5601 and KS X 1001 are exactly the same.
       "windows949": "cp949",
       "ms949": "cp949",
       "949": "cp949",
@@ -33761,6 +34149,28 @@ var require_dbcs_data = __commonJS({
       "ksc56011987": "cp949",
       "ksc56011989": "cp949",
       "ksc5601": "cp949",
+      // == Big5/Taiwan/Hong Kong ================================================
+      // There are lots of tables for Big5 and cp950. Please see the following links for history:
+      // http://moztw.org/docs/big5/  http://www.haible.de/bruno/charsets/conversion-tables/Big5.html
+      // Variations, in roughly number of defined chars:
+      //  * Windows CP 950: Microsoft variant of Big5. Canonical: http://www.unicode.org/Public/MAPPINGS/VENDORS/MICSFT/WINDOWS/CP950.TXT
+      //  * Windows CP 951: Microsoft variant of Big5-HKSCS-2001. Seems to be never public. http://me.abelcheung.org/articles/research/what-is-cp951/
+      //  * Big5-2003 (Taiwan standard) almost superset of cp950.
+      //  * Unicode-at-on (UAO) / Mozilla 1.8. Falling out of use on the Web. Not supported by other browsers.
+      //  * Big5-HKSCS (-2001, -2004, -2008). Hong Kong standard. 
+      //    many unicode code points moved from PUA to Supplementary plane (U+2XXXX) over the years.
+      //    Plus, it has 4 combining sequences.
+      //    Seems that Mozilla refused to support it for 10 yrs. https://bugzilla.mozilla.org/show_bug.cgi?id=162431 https://bugzilla.mozilla.org/show_bug.cgi?id=310299
+      //    because big5-hkscs is the only encoding to include astral characters in non-algorithmic way.
+      //    Implementations are not consistent within browsers; sometimes labeled as just big5.
+      //    MS Internet Explorer switches from big5 to big5-hkscs when a patch applied.
+      //    Great discussion & recap of what's going on https://bugzilla.mozilla.org/show_bug.cgi?id=912470#c31
+      //    In the encoder, it might make sense to support encoding old PUA mappings to Big5 bytes seq-s.
+      //    Official spec: http://www.ogcio.gov.hk/en/business/tech_promotion/ccli/terms/doc/2003cmp_2008.txt
+      //                   http://www.ogcio.gov.hk/tc/business/tech_promotion/ccli/terms/doc/hkscs-2008-big5-iso.txt
+      // 
+      // Current understanding of how to deal with Big5(-HKSCS) is in the Encoding Standard, http://encoding.spec.whatwg.org/#big5-encoder
+      // Unicode mapping (http://www.unicode.org/Public/MAPPINGS/OBSOLETE/EASTASIA/OTHER/BIG5.TXT) is said to be wrong.
       "windows950": "cp950",
       "ms950": "cp950",
       "950": "cp950",
@@ -33770,6 +34180,7 @@ var require_dbcs_data = __commonJS({
           return require_cp950();
         }
       },
+      // Big5 has many variations and is an extension of cp950. We use Encoding Standard's as a consensus.
       "big5": "big5hkscs",
       "big5hkscs": {
         type: "_dbcs",
@@ -34511,22 +34922,25 @@ var require_CreateFileError = __commonJS({
       };
     }();
     Object.defineProperty(exports, "__esModule", { value: true });
-    var CreateFileError = function(_super) {
-      __extends(CreateFileError2, _super);
-      function CreateFileError2(originalError) {
-        var _newTarget = this.constructor;
-        var _this = _super.call(this, "Failed to create temporary file for editor") || this;
-        _this.originalError = originalError;
-        var proto = _newTarget.prototype;
-        if (Object.setPrototypeOf) {
-          Object.setPrototypeOf(_this, proto);
-        } else {
-          _this.__proto__ = _newTarget.prototype;
+    var CreateFileError = (
+      /** @class */
+      function(_super) {
+        __extends(CreateFileError2, _super);
+        function CreateFileError2(originalError) {
+          var _newTarget = this.constructor;
+          var _this = _super.call(this, "Failed to create temporary file for editor") || this;
+          _this.originalError = originalError;
+          var proto = _newTarget.prototype;
+          if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(_this, proto);
+          } else {
+            _this.__proto__ = _newTarget.prototype;
+          }
+          return _this;
         }
-        return _this;
-      }
-      return CreateFileError2;
-    }(Error);
+        return CreateFileError2;
+      }(Error)
+    );
     exports.CreateFileError = CreateFileError;
   }
 });
@@ -34555,22 +34969,25 @@ var require_LaunchEditorError = __commonJS({
       };
     }();
     Object.defineProperty(exports, "__esModule", { value: true });
-    var LaunchEditorError = function(_super) {
-      __extends(LaunchEditorError2, _super);
-      function LaunchEditorError2(originalError) {
-        var _newTarget = this.constructor;
-        var _this = _super.call(this, "Failed launch editor") || this;
-        _this.originalError = originalError;
-        var proto = _newTarget.prototype;
-        if (Object.setPrototypeOf) {
-          Object.setPrototypeOf(_this, proto);
-        } else {
-          _this.__proto__ = _newTarget.prototype;
+    var LaunchEditorError = (
+      /** @class */
+      function(_super) {
+        __extends(LaunchEditorError2, _super);
+        function LaunchEditorError2(originalError) {
+          var _newTarget = this.constructor;
+          var _this = _super.call(this, "Failed launch editor") || this;
+          _this.originalError = originalError;
+          var proto = _newTarget.prototype;
+          if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(_this, proto);
+          } else {
+            _this.__proto__ = _newTarget.prototype;
+          }
+          return _this;
         }
-        return _this;
-      }
-      return LaunchEditorError2;
-    }(Error);
+        return LaunchEditorError2;
+      }(Error)
+    );
     exports.LaunchEditorError = LaunchEditorError;
   }
 });
@@ -34599,22 +35016,25 @@ var require_ReadFileError = __commonJS({
       };
     }();
     Object.defineProperty(exports, "__esModule", { value: true });
-    var ReadFileError = function(_super) {
-      __extends(ReadFileError2, _super);
-      function ReadFileError2(originalError) {
-        var _newTarget = this.constructor;
-        var _this = _super.call(this, "Failed to read temporary file") || this;
-        _this.originalError = originalError;
-        var proto = _newTarget.prototype;
-        if (Object.setPrototypeOf) {
-          Object.setPrototypeOf(_this, proto);
-        } else {
-          _this.__proto__ = _newTarget.prototype;
+    var ReadFileError = (
+      /** @class */
+      function(_super) {
+        __extends(ReadFileError2, _super);
+        function ReadFileError2(originalError) {
+          var _newTarget = this.constructor;
+          var _this = _super.call(this, "Failed to read temporary file") || this;
+          _this.originalError = originalError;
+          var proto = _newTarget.prototype;
+          if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(_this, proto);
+          } else {
+            _this.__proto__ = _newTarget.prototype;
+          }
+          return _this;
         }
-        return _this;
-      }
-      return ReadFileError2;
-    }(Error);
+        return ReadFileError2;
+      }(Error)
+    );
     exports.ReadFileError = ReadFileError;
   }
 });
@@ -34643,22 +35063,25 @@ var require_RemoveFileError = __commonJS({
       };
     }();
     Object.defineProperty(exports, "__esModule", { value: true });
-    var RemoveFileError = function(_super) {
-      __extends(RemoveFileError2, _super);
-      function RemoveFileError2(originalError) {
-        var _newTarget = this.constructor;
-        var _this = _super.call(this, "Failed to cleanup temporary file") || this;
-        _this.originalError = originalError;
-        var proto = _newTarget.prototype;
-        if (Object.setPrototypeOf) {
-          Object.setPrototypeOf(_this, proto);
-        } else {
-          _this.__proto__ = _newTarget.prototype;
+    var RemoveFileError = (
+      /** @class */
+      function(_super) {
+        __extends(RemoveFileError2, _super);
+        function RemoveFileError2(originalError) {
+          var _newTarget = this.constructor;
+          var _this = _super.call(this, "Failed to cleanup temporary file") || this;
+          _this.originalError = originalError;
+          var proto = _newTarget.prototype;
+          if (Object.setPrototypeOf) {
+            Object.setPrototypeOf(_this, proto);
+          } else {
+            _this.__proto__ = _newTarget.prototype;
+          }
+          return _this;
         }
-        return _this;
-      }
-      return RemoveFileError2;
-    }(Error);
+        return RemoveFileError2;
+      }(Error)
+    );
     exports.RemoveFileError = RemoveFileError;
   }
 });
@@ -34710,141 +35133,144 @@ var require_main = __commonJS({
       });
     }
     exports.editAsync = editAsync;
-    var ExternalEditor = function() {
-      function ExternalEditor2(text, fileOptions) {
-        if (text === void 0) {
-          text = "";
-        }
-        this.text = "";
-        this.fileOptions = {};
-        this.text = text;
-        if (fileOptions) {
-          this.fileOptions = fileOptions;
-        }
-        this.determineEditor();
-        this.createTemporaryFile();
-      }
-      ExternalEditor2.splitStringBySpace = function(str) {
-        var pieces = [];
-        var currentString = "";
-        for (var strIndex = 0; strIndex < str.length; strIndex++) {
-          var currentLetter = str[strIndex];
-          if (strIndex > 0 && currentLetter === " " && str[strIndex - 1] !== "\\" && currentString.length > 0) {
+    var ExternalEditor = (
+      /** @class */
+      function() {
+        function ExternalEditor2(text, fileOptions) {
+          if (text === void 0) {
+            text = "";
+          }
+          this.text = "";
+          this.fileOptions = {};
+          this.text = text;
+          if (fileOptions) {
+            this.fileOptions = fileOptions;
+          }
+          this.determineEditor();
+          this.createTemporaryFile();
+        }
+        ExternalEditor2.splitStringBySpace = function(str) {
+          var pieces = [];
+          var currentString = "";
+          for (var strIndex = 0; strIndex < str.length; strIndex++) {
+            var currentLetter = str[strIndex];
+            if (strIndex > 0 && currentLetter === " " && str[strIndex - 1] !== "\\" && currentString.length > 0) {
+              pieces.push(currentString);
+              currentString = "";
+            } else {
+              currentString += currentLetter;
+            }
+          }
+          if (currentString.length > 0) {
             pieces.push(currentString);
-            currentString = "";
-          } else {
-            currentString += currentLetter;
           }
-        }
-        if (currentString.length > 0) {
-          pieces.push(currentString);
-        }
-        return pieces;
-      };
-      Object.defineProperty(ExternalEditor2.prototype, "temp_file", {
-        get: function() {
-          console.log("DEPRECATED: temp_file. Use tempFile moving forward.");
-          return this.tempFile;
-        },
-        enumerable: true,
-        configurable: true
-      });
-      Object.defineProperty(ExternalEditor2.prototype, "last_exit_status", {
-        get: function() {
-          console.log("DEPRECATED: last_exit_status. Use lastExitStatus moving forward.");
-          return this.lastExitStatus;
-        },
-        enumerable: true,
-        configurable: true
-      });
-      ExternalEditor2.prototype.run = function() {
-        this.launchEditor();
-        this.readTemporaryFile();
-        return this.text;
-      };
-      ExternalEditor2.prototype.runAsync = function(callback) {
-        var _this = this;
-        try {
-          this.launchEditorAsync(function() {
-            try {
-              _this.readTemporaryFile();
-              setImmediate(callback, null, _this.text);
-            } catch (readError) {
-              setImmediate(callback, readError, null);
-            }
-          });
-        } catch (launchError) {
-          setImmediate(callback, launchError, null);
-        }
-      };
-      ExternalEditor2.prototype.cleanup = function() {
-        this.removeTemporaryFile();
-      };
-      ExternalEditor2.prototype.determineEditor = function() {
-        var editor = process.env.VISUAL ? process.env.VISUAL : process.env.EDITOR ? process.env.EDITOR : /^win/.test(process.platform) ? "notepad" : "vim";
-        var editorOpts = ExternalEditor2.splitStringBySpace(editor).map(function(piece) {
-          return piece.replace("\\ ", " ");
+          return pieces;
+        };
+        Object.defineProperty(ExternalEditor2.prototype, "temp_file", {
+          get: function() {
+            console.log("DEPRECATED: temp_file. Use tempFile moving forward.");
+            return this.tempFile;
+          },
+          enumerable: true,
+          configurable: true
         });
-        var bin = editorOpts.shift();
-        this.editor = { args: editorOpts, bin };
-      };
-      ExternalEditor2.prototype.createTemporaryFile = function() {
-        try {
-          this.tempFile = tmp_1.tmpNameSync(this.fileOptions);
-          var opt = { encoding: "utf8" };
-          if (this.fileOptions.hasOwnProperty("mode")) {
-            opt.mode = this.fileOptions.mode;
+        Object.defineProperty(ExternalEditor2.prototype, "last_exit_status", {
+          get: function() {
+            console.log("DEPRECATED: last_exit_status. Use lastExitStatus moving forward.");
+            return this.lastExitStatus;
+          },
+          enumerable: true,
+          configurable: true
+        });
+        ExternalEditor2.prototype.run = function() {
+          this.launchEditor();
+          this.readTemporaryFile();
+          return this.text;
+        };
+        ExternalEditor2.prototype.runAsync = function(callback) {
+          var _this = this;
+          try {
+            this.launchEditorAsync(function() {
+              try {
+                _this.readTemporaryFile();
+                setImmediate(callback, null, _this.text);
+              } catch (readError) {
+                setImmediate(callback, readError, null);
+              }
+            });
+          } catch (launchError) {
+            setImmediate(callback, launchError, null);
           }
-          fs_1.writeFileSync(this.tempFile, this.text, opt);
-        } catch (createFileError) {
-          throw new CreateFileError_1.CreateFileError(createFileError);
-        }
-      };
-      ExternalEditor2.prototype.readTemporaryFile = function() {
-        try {
-          var tempFileBuffer = fs_1.readFileSync(this.tempFile);
-          if (tempFileBuffer.length === 0) {
-            this.text = "";
-          } else {
-            var encoding = chardet_1.detect(tempFileBuffer).toString();
-            if (!iconv_lite_1.encodingExists(encoding)) {
-              encoding = "utf8";
+        };
+        ExternalEditor2.prototype.cleanup = function() {
+          this.removeTemporaryFile();
+        };
+        ExternalEditor2.prototype.determineEditor = function() {
+          var editor = process.env.VISUAL ? process.env.VISUAL : process.env.EDITOR ? process.env.EDITOR : /^win/.test(process.platform) ? "notepad" : "vim";
+          var editorOpts = ExternalEditor2.splitStringBySpace(editor).map(function(piece) {
+            return piece.replace("\\ ", " ");
+          });
+          var bin = editorOpts.shift();
+          this.editor = { args: editorOpts, bin };
+        };
+        ExternalEditor2.prototype.createTemporaryFile = function() {
+          try {
+            this.tempFile = tmp_1.tmpNameSync(this.fileOptions);
+            var opt = { encoding: "utf8" };
+            if (this.fileOptions.hasOwnProperty("mode")) {
+              opt.mode = this.fileOptions.mode;
             }
-            this.text = iconv_lite_1.decode(tempFileBuffer, encoding);
+            fs_1.writeFileSync(this.tempFile, this.text, opt);
+          } catch (createFileError) {
+            throw new CreateFileError_1.CreateFileError(createFileError);
           }
-        } catch (readFileError) {
-          throw new ReadFileError_1.ReadFileError(readFileError);
-        }
-      };
-      ExternalEditor2.prototype.removeTemporaryFile = function() {
-        try {
-          fs_1.unlinkSync(this.tempFile);
-        } catch (removeFileError) {
-          throw new RemoveFileError_1.RemoveFileError(removeFileError);
-        }
-      };
-      ExternalEditor2.prototype.launchEditor = function() {
-        try {
-          var editorProcess = child_process_1.spawnSync(this.editor.bin, this.editor.args.concat([this.tempFile]), { stdio: "inherit" });
-          this.lastExitStatus = editorProcess.status;
-        } catch (launchError) {
-          throw new LaunchEditorError_1.LaunchEditorError(launchError);
-        }
-      };
-      ExternalEditor2.prototype.launchEditorAsync = function(callback) {
-        var _this = this;
-        try {
-          var editorProcess = child_process_1.spawn(this.editor.bin, this.editor.args.concat([this.tempFile]), { stdio: "inherit" });
-          editorProcess.on("exit", function(code) {
-            _this.lastExitStatus = code;
-            setImmediate(callback);
-          });
-        } catch (launchError) {
-          throw new LaunchEditorError_1.LaunchEditorError(launchError);
-        }
-      };
-      return ExternalEditor2;
-    }();
+        };
+        ExternalEditor2.prototype.readTemporaryFile = function() {
+          try {
+            var tempFileBuffer = fs_1.readFileSync(this.tempFile);
+            if (tempFileBuffer.length === 0) {
+              this.text = "";
+            } else {
+              var encoding = chardet_1.detect(tempFileBuffer).toString();
+              if (!iconv_lite_1.encodingExists(encoding)) {
+                encoding = "utf8";
+              }
+              this.text = iconv_lite_1.decode(tempFileBuffer, encoding);
+            }
+          } catch (readFileError) {
+            throw new ReadFileError_1.ReadFileError(readFileError);
+          }
+        };
+        ExternalEditor2.prototype.removeTemporaryFile = function() {
+          try {
+            fs_1.unlinkSync(this.tempFile);
+          } catch (removeFileError) {
+            throw new RemoveFileError_1.RemoveFileError(removeFileError);
+          }
+        };
+        ExternalEditor2.prototype.launchEditor = function() {
+          try {
+            var editorProcess = child_process_1.spawnSync(this.editor.bin, this.editor.args.concat([this.tempFile]), { stdio: "inherit" });
+            this.lastExitStatus = editorProcess.status;
+          } catch (launchError) {
+            throw new LaunchEditorError_1.LaunchEditorError(launchError);
+          }
+        };
+        ExternalEditor2.prototype.launchEditorAsync = function(callback) {
+          var _this = this;
+          try {
+            var editorProcess = child_process_1.spawn(this.editor.bin, this.editor.args.concat([this.tempFile]), { stdio: "inherit" });
+            editorProcess.on("exit", function(code) {
+              _this.lastExitStatus = code;
+              setImmediate(callback);
+            });
+          } catch (launchError) {
+            throw new LaunchEditorError_1.LaunchEditorError(launchError);
+          }
+        };
+        return ExternalEditor2;
+      }()
+    );
     exports.ExternalEditor = ExternalEditor;
   }
 });
@@ -34859,6 +35285,11 @@ var require_editor = __commonJS({
     var observe = require_events();
     var { Subject } = require_cjs();
     var EditorPrompt = class extends Base {
+      /**
+       * Start the Inquiry session
+       * @param  {Function} cb      Callback when prompt is done
+       * @return {this}
+       */
       _run(cb) {
         this.done = cb;
         this.editorResult = new Subject();
@@ -34872,6 +35303,10 @@ var require_editor = __commonJS({
         this.render();
         return this;
       }
+      /**
+       * Render the prompt to screen
+       * @return {EditorPrompt} self
+       */
       render(error) {
         let bottomContent = "";
         let message = this.getQuestion();
@@ -34885,6 +35320,9 @@ var require_editor = __commonJS({
         }
         this.screen.render(message, bottomContent);
       }
+      /**
+       * Launch $EDITOR on user press enter
+       */
       startExternalEditor() {
         this.rl.pause();
         editAsync(this.currentText, this.endExternalEditor.bind(this));
@@ -34971,7 +35409,8 @@ var require_constants = __commonJS({
   "../../node_modules/semver/internal/constants.js"(exports, module2) {
     var SEMVER_SPEC_VERSION = "2.0.0";
     var MAX_LENGTH = 256;
-    var MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
+    var MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || /* istanbul ignore next */
+    9007199254740991;
     var MAX_SAFE_COMPONENT_LENGTH = 16;
     module2.exports = {
       SEMVER_SPEC_VERSION,
@@ -35229,6 +35668,8 @@ var require_semver = __commonJS({
           }
         } while (++i);
       }
+      // preminor will bump the version up to the next minor release, and immediately
+      // down to pre-release. premajor and prepatch work the same way.
       inc(release, identifier) {
         switch (release) {
           case "premajor":
@@ -36077,6 +36518,7 @@ var require_lru_cache2 = __commonJS({
         this[UPDATE_AGE_ON_GET] = options.updateAgeOnGet || false;
         this.reset();
       }
+      // resize the cache when the max changes.
       set max(mL) {
         if (typeof mL !== "number" || mL < 0)
           throw new TypeError("max must be a non-negative number");
@@ -36101,6 +36543,7 @@ var require_lru_cache2 = __commonJS({
       get maxAge() {
         return this[MAX_AGE];
       }
+      // resize the cache when the lengthCalculator changes.
       set lengthCalculator(lC) {
         if (typeof lC !== "function")
           lC = naiveLength;
@@ -36415,6 +36858,7 @@ var require_range2 = __commonJS({
           });
         });
       }
+      // if ANY of the sets match ALL of its comparators, then pass
       test(version) {
         if (!version) {
           return false;
@@ -38299,6 +38743,7 @@ var require_mkdirs = __commonJS({
     module2.exports = {
       mkdirs: makeDir,
       mkdirsSync: makeDirSync,
+      // alias
       mkdirp: makeDir,
       mkdirpSync: makeDirSync,
       ensureDir: makeDir,
@@ -39531,14 +39976,17 @@ var require_ensure = __commonJS({
     var { createLink, createLinkSync } = require_link();
     var { createSymlink, createSymlinkSync } = require_symlink();
     module2.exports = {
+      // file
       createFile,
       createFileSync,
       ensureFile: createFile,
       ensureFileSync: createFileSync,
+      // link
       createLink,
       createLinkSync,
       ensureLink: createLink,
       ensureLinkSync: createLinkSync,
+      // symlink
       createSymlink,
       createSymlinkSync,
       ensureSymlink: createSymlink,
@@ -39673,6 +40121,7 @@ var require_jsonfile2 = __commonJS({
     "use strict";
     var jsonFile = require_jsonfile();
     module2.exports = {
+      // jsonfile exports
       readJson: jsonFile.readFile,
       readJsonSync: jsonFile.readFileSync,
       writeJson: jsonFile.writeFile,
@@ -39924,7 +40373,9 @@ var require_lib2 = __commonJS({
   "../../node_modules/fs-extra/lib/index.js"(exports, module2) {
     "use strict";
     module2.exports = {
+      // Export promiseified graceful-fs:
       ...require_fs(),
+      // Export extra methods:
       ...require_copy2(),
       ...require_empty2(),
       ...require_ensure(),
@@ -40918,50 +41369,97 @@ var require_constants2 = __commonJS({
     "use strict";
     module2.exports = {
       MAX_LENGTH: 1024 * 64,
+      // Digits
       CHAR_0: "0",
+      /* 0 */
       CHAR_9: "9",
+      /* 9 */
+      // Alphabet chars.
       CHAR_UPPERCASE_A: "A",
+      /* A */
       CHAR_LOWERCASE_A: "a",
+      /* a */
       CHAR_UPPERCASE_Z: "Z",
+      /* Z */
       CHAR_LOWERCASE_Z: "z",
+      /* z */
       CHAR_LEFT_PARENTHESES: "(",
+      /* ( */
       CHAR_RIGHT_PARENTHESES: ")",
+      /* ) */
       CHAR_ASTERISK: "*",
+      /* * */
+      // Non-alphabetic chars.
       CHAR_AMPERSAND: "&",
+      /* & */
       CHAR_AT: "@",
+      /* @ */
       CHAR_BACKSLASH: "\\",
+      /* \ */
       CHAR_BACKTICK: "`",
+      /* ` */
       CHAR_CARRIAGE_RETURN: "\r",
+      /* \r */
       CHAR_CIRCUMFLEX_ACCENT: "^",
+      /* ^ */
       CHAR_COLON: ":",
+      /* : */
       CHAR_COMMA: ",",
+      /* , */
       CHAR_DOLLAR: "$",
+      /* . */
       CHAR_DOT: ".",
+      /* . */
       CHAR_DOUBLE_QUOTE: '"',
+      /* " */
       CHAR_EQUAL: "=",
+      /* = */
       CHAR_EXCLAMATION_MARK: "!",
+      /* ! */
       CHAR_FORM_FEED: "\f",
+      /* \f */
       CHAR_FORWARD_SLASH: "/",
+      /* / */
       CHAR_HASH: "#",
+      /* # */
       CHAR_HYPHEN_MINUS: "-",
+      /* - */
       CHAR_LEFT_ANGLE_BRACKET: "<",
+      /* < */
       CHAR_LEFT_CURLY_BRACE: "{",
+      /* { */
       CHAR_LEFT_SQUARE_BRACKET: "[",
+      /* [ */
       CHAR_LINE_FEED: "\n",
+      /* \n */
       CHAR_NO_BREAK_SPACE: "\xA0",
+      /* \u00A0 */
       CHAR_PERCENT: "%",
+      /* % */
       CHAR_PLUS: "+",
+      /* + */
       CHAR_QUESTION_MARK: "?",
+      /* ? */
       CHAR_RIGHT_ANGLE_BRACKET: ">",
+      /* > */
       CHAR_RIGHT_CURLY_BRACE: "}",
+      /* } */
       CHAR_RIGHT_SQUARE_BRACKET: "]",
+      /* ] */
       CHAR_SEMICOLON: ";",
+      /* ; */
       CHAR_SINGLE_QUOTE: "'",
+      /* ' */
       CHAR_SPACE: " ",
+      /*   */
       CHAR_TAB: "	",
+      /* \t */
       CHAR_UNDERSCORE: "_",
+      /* _ */
       CHAR_VERTICAL_LINE: "|",
+      /* | */
       CHAR_ZERO_WIDTH_NOBREAK_SPACE: "\uFEFF"
+      /* \uFEFF */
     };
   }
 });
@@ -40974,17 +41472,29 @@ var require_parse3 = __commonJS({
     var {
       MAX_LENGTH,
       CHAR_BACKSLASH,
+      /* \ */
       CHAR_BACKTICK,
+      /* ` */
       CHAR_COMMA,
+      /* , */
       CHAR_DOT,
+      /* . */
       CHAR_LEFT_PARENTHESES,
+      /* ( */
       CHAR_RIGHT_PARENTHESES,
+      /* ) */
       CHAR_LEFT_CURLY_BRACE,
+      /* { */
       CHAR_RIGHT_CURLY_BRACE,
+      /* } */
       CHAR_LEFT_SQUARE_BRACKET,
+      /* [ */
       CHAR_RIGHT_SQUARE_BRACKET,
+      /* ] */
       CHAR_DOUBLE_QUOTE,
+      /* " */
       CHAR_SINGLE_QUOTE,
+      /* ' */
       CHAR_NO_BREAK_SPACE,
       CHAR_ZERO_WIDTH_NOBREAK_SPACE
     } = require_constants2();
@@ -41333,61 +41843,112 @@ var require_constants3 = __commonJS({
     module2.exports = {
       MAX_LENGTH: 1024 * 64,
       POSIX_REGEX_SOURCE,
+      // regular expressions
       REGEX_BACKSLASH: /\\(?![*+?^${}(|)[\]])/g,
       REGEX_NON_SPECIAL_CHARS: /^[^@![\].,$*+?^{}()|\\/]+/,
       REGEX_SPECIAL_CHARS: /[-*+?.^${}(|)[\]]/,
       REGEX_SPECIAL_CHARS_BACKREF: /(\\?)((\W)(\3*))/g,
       REGEX_SPECIAL_CHARS_GLOBAL: /([-*+?.^${}(|)[\]])/g,
       REGEX_REMOVE_BACKSLASH: /(?:\[.*?[^\\]\]|\\(?=.))/g,
+      // Replace globs with equivalent patterns to reduce parsing time.
       REPLACEMENTS: {
         "***": "*",
         "**/**": "**",
         "**/**/**": "**"
       },
+      // Digits
       CHAR_0: 48,
+      /* 0 */
       CHAR_9: 57,
+      /* 9 */
+      // Alphabet chars.
       CHAR_UPPERCASE_A: 65,
+      /* A */
       CHAR_LOWERCASE_A: 97,
+      /* a */
       CHAR_UPPERCASE_Z: 90,
+      /* Z */
       CHAR_LOWERCASE_Z: 122,
+      /* z */
       CHAR_LEFT_PARENTHESES: 40,
+      /* ( */
       CHAR_RIGHT_PARENTHESES: 41,
+      /* ) */
       CHAR_ASTERISK: 42,
+      /* * */
+      // Non-alphabetic chars.
       CHAR_AMPERSAND: 38,
+      /* & */
       CHAR_AT: 64,
+      /* @ */
       CHAR_BACKWARD_SLASH: 92,
+      /* \ */
       CHAR_CARRIAGE_RETURN: 13,
+      /* \r */
       CHAR_CIRCUMFLEX_ACCENT: 94,
+      /* ^ */
       CHAR_COLON: 58,
+      /* : */
       CHAR_COMMA: 44,
+      /* , */
       CHAR_DOT: 46,
+      /* . */
       CHAR_DOUBLE_QUOTE: 34,
+      /* " */
       CHAR_EQUAL: 61,
+      /* = */
       CHAR_EXCLAMATION_MARK: 33,
+      /* ! */
       CHAR_FORM_FEED: 12,
+      /* \f */
       CHAR_FORWARD_SLASH: 47,
+      /* / */
       CHAR_GRAVE_ACCENT: 96,
+      /* ` */
       CHAR_HASH: 35,
+      /* # */
       CHAR_HYPHEN_MINUS: 45,
+      /* - */
       CHAR_LEFT_ANGLE_BRACKET: 60,
+      /* < */
       CHAR_LEFT_CURLY_BRACE: 123,
+      /* { */
       CHAR_LEFT_SQUARE_BRACKET: 91,
+      /* [ */
       CHAR_LINE_FEED: 10,
+      /* \n */
       CHAR_NO_BREAK_SPACE: 160,
+      /* \u00A0 */
       CHAR_PERCENT: 37,
+      /* % */
       CHAR_PLUS: 43,
+      /* + */
       CHAR_QUESTION_MARK: 63,
+      /* ? */
       CHAR_RIGHT_ANGLE_BRACKET: 62,
+      /* > */
       CHAR_RIGHT_CURLY_BRACE: 125,
+      /* } */
       CHAR_RIGHT_SQUARE_BRACKET: 93,
+      /* ] */
       CHAR_SEMICOLON: 59,
+      /* ; */
       CHAR_SINGLE_QUOTE: 39,
+      /* ' */
       CHAR_SPACE: 32,
+      /*   */
       CHAR_TAB: 9,
+      /* \t */
       CHAR_UNDERSCORE: 95,
+      /* _ */
       CHAR_VERTICAL_LINE: 124,
+      /* | */
       CHAR_ZERO_WIDTH_NOBREAK_SPACE: 65279,
+      /* \uFEFF */
       SEP: path3.sep,
+      /**
+       * Create EXTGLOB_CHARS
+       */
       extglobChars(chars) {
         return {
           "!": { type: "negate", open: "(?:(?!(?:", close: `))${chars.STAR})` },
@@ -41397,6 +41958,9 @@ var require_constants3 = __commonJS({
           "@": { type: "at", open: "(?:", close: ")" }
         };
       },
+      /**
+       * Create GLOB_CHARS
+       */
       globChars(win32) {
         return win32 === true ? WINDOWS_CHARS : POSIX_CHARS;
       }
@@ -41474,20 +42038,35 @@ var require_scan2 = __commonJS({
     var utils = require_utils5();
     var {
       CHAR_ASTERISK,
+      /* * */
       CHAR_AT,
+      /* @ */
       CHAR_BACKWARD_SLASH,
+      /* \ */
       CHAR_COMMA,
+      /* , */
       CHAR_DOT,
+      /* . */
       CHAR_EXCLAMATION_MARK,
+      /* ! */
       CHAR_FORWARD_SLASH,
+      /* / */
       CHAR_LEFT_CURLY_BRACE,
+      /* { */
       CHAR_LEFT_PARENTHESES,
+      /* ( */
       CHAR_LEFT_SQUARE_BRACKET,
+      /* [ */
       CHAR_PLUS,
+      /* + */
       CHAR_QUESTION_MARK,
+      /* ? */
       CHAR_RIGHT_CURLY_BRACE,
+      /* } */
       CHAR_RIGHT_PARENTHESES,
+      /* ) */
       CHAR_RIGHT_SQUARE_BRACKET
+      /* ] */
     } = require_constants3();
     var isPathSeparator = (code) => {
       return code === CHAR_FORWARD_SLASH || code === CHAR_BACKWARD_SLASH;
@@ -43218,8 +43797,18 @@ var require_tasks = __commonJS({
       const negativePatterns = getNegativePatternsAsPositive(patterns, settings.ignore);
       const staticPatterns = positivePatterns.filter((pattern) => utils.pattern.isStaticPattern(pattern, settings));
       const dynamicPatterns = positivePatterns.filter((pattern) => utils.pattern.isDynamicPattern(pattern, settings));
-      const staticTasks = convertPatternsToTasks(staticPatterns, negativePatterns, false);
-      const dynamicTasks = convertPatternsToTasks(dynamicPatterns, negativePatterns, true);
+      const staticTasks = convertPatternsToTasks(
+        staticPatterns,
+        negativePatterns,
+        /* dynamic */
+        false
+      );
+      const dynamicTasks = convertPatternsToTasks(
+        dynamicPatterns,
+        negativePatterns,
+        /* dynamic */
+        true
+      );
       return staticTasks.concat(dynamicTasks);
     }
     exports.generate = generate;
@@ -44637,6 +45226,10 @@ var require_entry = __commonJS({
         const fullpath = utils.path.makeAbsolute(this._settings.cwd, entryPath);
         return utils.pattern.matchAny(fullpath, patternsRe);
       }
+      /**
+       * First, just trying to apply patterns to the path.
+       * Second, trying to apply patterns to the path with final slash.
+       */
       _isMatchToPatterns(entryPath, patternsRe) {
         const filepath = utils.path.removeLeadingDotSegment(entryPath);
         return utils.pattern.matchAny(filepath, patternsRe) || utils.pattern.matchAny(filepath + "/", patternsRe);
@@ -45707,6 +46300,7 @@ var require_ansi_styles2 = __commonJS({
       const styles = {
         modifier: {
           reset: [0, 0],
+          // 21 isn't widely supported and 22 does the same thing
           bold: [1, 22],
           dim: [2, 22],
           italic: [3, 23],
@@ -45725,6 +46319,7 @@ var require_ansi_styles2 = __commonJS({
           magenta: [35, 39],
           cyan: [36, 39],
           white: [37, 39],
+          // Bright color
           blackBright: [90, 39],
           redBright: [91, 39],
           greenBright: [92, 39],
@@ -45743,6 +46338,7 @@ var require_ansi_styles2 = __commonJS({
           bgMagenta: [45, 49],
           bgCyan: [46, 49],
           bgWhite: [47, 49],
+          // Bright color
           bgBlackBright: [100, 49],
           bgRedBright: [101, 49],
           bgGreenBright: [102, 49],
@@ -46372,7 +46968,8 @@ var require_Immutable = __commonJS({
         return printAsLeaf(name);
       }
       if (val[IS_KEYED_SENTINEL]) {
-        return `${name + SPACE}{${val._iter || val._object ? (0, _collections.printIteratorEntries)(
+        return `${name + SPACE}{${// from Immutable collection of entries or from ECMAScript object
+        val._iter || val._object ? (0, _collections.printIteratorEntries)(
           val.entries(),
           config,
           indentation,
@@ -46381,7 +46978,10 @@ var require_Immutable = __commonJS({
           printer
         ) : LAZY}}`;
       }
-      return `${name + SPACE}[${val._iter || val._array || val._collection || val._iterable ? (0, _collections.printIteratorValues)(
+      return `${name + SPACE}[${val._iter || // from Immutable collection of values
+      val._array || // from ECMAScript array
+      val._collection || // from ECMAScript collection in immutable v4
+      val._iterable ? (0, _collections.printIteratorValues)(
         val.values(),
         config,
         indentation,
@@ -48009,19 +48609,23 @@ var require_build3 = __commonJS({
           iMaxF = extendPathsF(d, aEnd, bEnd, bF, isCommon, aIndexesF, iMaxF);
           if (d < dMin) {
             iMaxR = extendPathsR(d, aStart, bStart, bR, isCommon, aIndexesR, iMaxR);
-          } else if (extendOverlappablePathsR(
-            d,
-            aStart,
-            aEnd,
-            bStart,
-            bEnd,
-            isCommon,
-            aIndexesF,
-            iMaxF,
-            aIndexesR,
-            iMaxR,
-            division
-          )) {
+          } else if (
+            // If a reverse path overlaps a forward path in the same diagonal,
+            // return a division of the index intervals at the middle change.
+            extendOverlappablePathsR(
+              d,
+              aStart,
+              aEnd,
+              bStart,
+              bEnd,
+              isCommon,
+              aIndexesF,
+              iMaxF,
+              aIndexesR,
+              iMaxR,
+              division
+            )
+          ) {
             return;
           }
         }
@@ -48042,19 +48646,23 @@ var require_build3 = __commonJS({
           );
           if (d < dMin) {
             iMaxF = extendPathsF(d, aEnd, bEnd, bF, isCommon, aIndexesF, iMaxF);
-          } else if (extendOverlappablePathsF(
-            d,
-            aStart,
-            aEnd,
-            bStart,
-            bEnd,
-            isCommon,
-            aIndexesF,
-            iMaxF,
-            aIndexesR,
-            iMaxR,
-            division
-          )) {
+          } else if (
+            // If a forward path overlaps a reverse path in the same diagonal,
+            // return a division of the index intervals at the middle change.
+            extendOverlappablePathsF(
+              d,
+              aStart,
+              aEnd,
+              bStart,
+              bEnd,
+              isCommon,
+              aIndexesF,
+              iMaxF,
+              aIndexesR,
+              iMaxR,
+              division
+            )
+          ) {
             return;
           }
         }
@@ -48718,7 +49326,9 @@ var require_getAlignedDiffs = __commonJS({
     var ChangeBuffer = class {
       op;
       line;
+      // incomplete line
       lines;
+      // complete lines
       changeColor;
       constructor(op, changeColor) {
         this.op = op;
@@ -48735,15 +49345,18 @@ var require_getAlignedDiffs = __commonJS({
             this.op,
             concatenateRelevantDiffs(this.op, this.line, this.changeColor)
           ) : this.line[0][0] === this.op ? this.line[0] : new _cleanupSemantic.Diff(this.op, this.line[0][1])
+          // was common diff
         );
         this.line.length = 0;
       }
       isLineEmpty() {
         return this.line.length === 0;
       }
+      // Minor input to buffer.
       pushDiff(diff2) {
         this.line.push(diff2);
       }
+      // Main input to buffer.
       align(diff2) {
         const string = diff2[1];
         if (string.includes("\n")) {
@@ -48761,6 +49374,7 @@ var require_getAlignedDiffs = __commonJS({
           this.pushDiff(diff2);
         }
       }
+      // Output from buffer.
       moveLinesTo(lines) {
         if (!this.isLineEmpty()) {
           this.pushLine();
@@ -48794,6 +49408,7 @@ var require_getAlignedDiffs = __commonJS({
         this.deleteBuffer.moveLinesTo(this.lines);
         this.insertBuffer.moveLinesTo(this.lines);
       }
+      // Input to buffer.
       align(diff2) {
         const op = diff2[0];
         const string = diff2[1];
@@ -48820,6 +49435,7 @@ var require_getAlignedDiffs = __commonJS({
           this.pushDiffChangeLines(diff2);
         }
       }
+      // Output from buffer.
       getLines() {
         this.flushChangeLines();
         return this.lines;
@@ -48888,6 +49504,7 @@ var require_printDiffs = __commonJS({
           isMultiline ? `${b}
 ` : b,
           true
+          // cleanupSemantic
         );
         if (hasCommonDiff(diffs, isMultiline)) {
           const optionsNormalized = (0, _normalizeDiffOptions.normalizeDiffOptions)(
@@ -50409,6 +51026,8 @@ var require_build7 = __commonJS({
         });
         return lines;
       }
+      // if the full 'source' can render in
+      // the target line, do so.
       renderInline(source, previousLine) {
         const match = source.match(/^ */);
         const leadingWhitespace = match ? match[0].length : 0;
@@ -50626,7 +51245,14 @@ var require_require_directory = __commonJS({
       }
     };
     function checkFileInclusion(path3, filename, options) {
-      return new RegExp("\\.(" + options.extensions.join("|") + ")$", "i").test(filename) && !(options.include && options.include instanceof RegExp && !options.include.test(path3)) && !(options.include && typeof options.include === "function" && !options.include(path3, filename)) && !(options.exclude && options.exclude instanceof RegExp && options.exclude.test(path3)) && !(options.exclude && typeof options.exclude === "function" && options.exclude(path3, filename));
+      return (
+        // verify file has valid extension
+        new RegExp("\\.(" + options.extensions.join("|") + ")$", "i").test(filename) && // if options.include is a RegExp, evaluate it and make sure the path passes
+        !(options.include && options.include instanceof RegExp && !options.include.test(path3)) && // if options.include is a function, evaluate it and make sure the path passes
+        !(options.include && typeof options.include === "function" && !options.include(path3, filename)) && // if options.exclude is a RegExp, evaluate it and make sure the path doesn't pass
+        !(options.exclude && options.exclude instanceof RegExp && options.exclude.test(path3)) && // if options.exclude is a function, evaluate it and make sure the path doesn't pass
+        !(options.exclude && typeof options.exclude === "function" && options.exclude(path3, filename))
+      );
     }
     function requireDirectory(m, path3, options) {
       var retval = {};
@@ -52471,6 +53097,10 @@ function getColor(level) {
 }
 var defaultLevel = process.env.NODE_ENV === "test" ? "warn" : "info";
 var Logger = {
+  /**
+   * @param {string} level
+   * @returns {LoggerInstance}
+   */
   create(level = defaultLevel) {
     let max = levels[level];
     const logger2 = {
@@ -52574,6 +53204,10 @@ function hash(str) {
 
 // src/workspace.js
 var Workspace = class {
+  /**
+   * @param {string} directory
+   * @returns {Promise<Workspace>}
+   */
   static async load(directory) {
     const tree = await loadWorkspace(directory);
     const visited = /* @__PURE__ */ new Map();
@@ -52720,6 +53354,10 @@ function getAvailableWorkspaces(directory) {
   });
 }
 var _PackageJson = class {
+  /**
+   * @param {object} packageJson
+   * @returns {PackageJson}
+   */
   static create(packageJson) {
     return new _PackageJson(packageJson);
   }
@@ -53053,6 +53691,12 @@ async function run2(options) {
 // src/upgrades.js
 var TRANSFORM_DIR = import_path2.default.join(__dirname, "transforms");
 var Change = {
+  /**
+   * @param {object} options
+   * @param {string} options.name
+   * @param {string} options.version
+   * @returns {object}
+   */
   install({ name, version }) {
     return {
       type: "install",
@@ -53065,6 +53709,11 @@ var Change = {
   uninstall: {
     type: "uninstall"
   },
+  /**
+   * @param {object} options
+   * @param {string} options.version
+   * @returns {object}
+   */
   update({ version }) {
     return {
       type: "update",
@@ -53227,7 +53876,7 @@ var upgrades = [
 var package_default = {
   name: "@carbon/upgrade",
   description: "A tool for upgrading Carbon versions",
-  version: "11.5.0",
+  version: "11.6.0",
   license: "Apache-2.0",
   bin: {
     "carbon-upgrade": "./bin/carbon-upgrade.js"
@@ -53264,7 +53913,7 @@ var package_default = {
   devDependencies: {
     chalk: "^4.1.1",
     "change-case": "^4.1.2",
-    esbuild: "^0.16.0",
+    esbuild: "^0.17.0",
     execa: "^5.1.1",
     "fast-glob": "^3.2.11",
     "fs-extra": "^10.0.0",
@@ -53390,3 +54039,84 @@ function run3(command, ignoreSafetyChecks = false) {
 0 && (module.exports = {
   main
 });
+/*! Bundled license information:
+
+object-assign/index.js:
+  (*
+  object-assign
+  (c) Sindre Sorhus
+  @license MIT
+  *)
+
+safe-buffer/index.js:
+  (*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> *)
+
+tmp/lib/tmp.js:
+  (*!
+   * Tmp
+   *
+   * Copyright (c) 2011-2017 KARASZI Istvan <github@spam.raszi.hu>
+   *
+   * MIT Licensed
+   *)
+
+is-extglob/index.js:
+  (*!
+   * is-extglob <https://github.com/jonschlinkert/is-extglob>
+   *
+   * Copyright (c) 2014-2016, Jon Schlinkert.
+   * Licensed under the MIT License.
+   *)
+
+is-glob/index.js:
+  (*!
+   * is-glob <https://github.com/jonschlinkert/is-glob>
+   *
+   * Copyright (c) 2014-2017, Jon Schlinkert.
+   * Released under the MIT License.
+   *)
+
+is-number/index.js:
+  (*!
+   * is-number <https://github.com/jonschlinkert/is-number>
+   *
+   * Copyright (c) 2014-present, Jon Schlinkert.
+   * Released under the MIT License.
+   *)
+
+to-regex-range/index.js:
+  (*!
+   * to-regex-range <https://github.com/micromatch/to-regex-range>
+   *
+   * Copyright (c) 2015-present, Jon Schlinkert.
+   * Released under the MIT License.
+   *)
+
+fill-range/index.js:
+  (*!
+   * fill-range <https://github.com/jonschlinkert/fill-range>
+   *
+   * Copyright (c) 2014-present, Jon Schlinkert.
+   * Licensed under the MIT License.
+   *)
+
+react-is/cjs/react-is.production.min.js:
+  (** @license React v17.0.2
+   * react-is.production.min.js
+   *
+   * Copyright (c) Facebook, Inc. and its affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   *)
+
+react-is/cjs/react-is.development.js:
+  (** @license React v17.0.2
+   * react-is.development.js
+   *
+   * Copyright (c) Facebook, Inc. and its affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   *)
+*/