create-tamagui 1.1.7 → 1.1.9

package/dist/index.js

@@ -22,6 +22,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
 ));
@@ -166,8 +170,10 @@ var require_which = __commonJS({
     var getPathInfo = (cmd, opt) => {
       const colon = opt.colon || COLON;
       const pathEnv = cmd.match(/\//) || isWindows && cmd.match(/\\/) ? [""] : [
+        // windows always checks the cwd first
         ...isWindows ? [process.cwd()] : [],
-        ...(opt.path || process.env.PATH || "").split(colon)
+        ...(opt.path || process.env.PATH || /* istanbul ignore next: very unusual */
+        "").split(colon)
       ];
       const pathExtExe = isWindows ? opt.pathExt || process.env.PATHEXT || ".EXE;.CMD;.BAT;.COM" : "";
       const pathExt = isWindows ? pathExtExe.split(colon) : [""];
@@ -2373,6 +2379,8 @@ var require_route = __commonJS({
       var models = Object.keys(conversions);
       for (var 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
         };
@@ -2513,6 +2521,7 @@ var require_ansi_styles = __commonJS({
       const styles3 = {
         modifier: {
           reset: [0, 0],
+          // 21 isn't widely supported and 22 does the same thing
           bold: [1, 22],
           dim: [2, 22],
           italic: [3, 23],
@@ -2531,6 +2540,7 @@ var require_ansi_styles = __commonJS({
           cyan: [36, 39],
           white: [37, 39],
           gray: [90, 39],
+          // Bright color
           redBright: [91, 39],
           greenBright: [92, 39],
           yellowBright: [93, 39],
@@ -2548,6 +2558,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],
@@ -5388,6 +5399,9 @@ var require_signals = __commonJS({
         "SIGSYS",
         "SIGQUIT",
         "SIGIOT"
+        // should detect profiler and enable/disable accordingly.
+        // see #21
+        // 'SIGPROF'
       );
     }
     if (process.platform === "linux") {
@@ -5523,7 +5537,8 @@ var require_signal_exit = __commonJS({
         if (!processOk(global.process)) {
           return;
         }
-        process4.exitCode = code || 0;
+        process4.exitCode = code || /* istanbul ignore next */
+        0;
         emit("exit", process4.exitCode, null);
         emit("afterexit", process4.exitCode, null);
         originalProcessReallyExit.call(process4, process4.exitCode);
@@ -6819,50 +6834,97 @@ var require_constants = __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 */
     };
   }
 });
@@ -6875,17 +6937,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_constants();
@@ -7234,61 +7308,112 @@ var require_constants2 = __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})` },
@@ -7298,6 +7423,9 @@ var require_constants2 = __commonJS({
           "@": { type: "at", open: "(?:", close: ")" }
         };
       },
+      /**
+       * Create GLOB_CHARS
+       */
       globChars(win32) {
         return win32 === true ? WINDOWS_CHARS : POSIX_CHARS;
       }
@@ -7375,20 +7503,35 @@ var require_scan = __commonJS({
     var utils = require_utils2();
     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_constants2();
     var isPathSeparator = (code) => {
       return code === CHAR_FORWARD_SLASH || code === CHAR_BACKWARD_SLASH;
@@ -8958,6 +9101,8 @@ var require_git_host_info = __commonJS({
     "use strict";
     var gitHosts = module2.exports = {
       github: {
+        // First two are insecure and generally shouldn't be used any more, but
+        // they are still supported.
         "protocols": ["git", "http", "git+ssh", "git+https", "ssh", "https"],
         "domain": "github.com",
         "treepath": "tree",
@@ -9591,6 +9736,7 @@ var require_lru_cache = __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");
@@ -9615,6 +9761,7 @@ var require_lru_cache = __commonJS({
       get maxAge() {
         return this[MAX_AGE];
       }
+      // resize the cache when the lengthCalculator changes.
       set lengthCalculator(lC) {
         if (typeof lC !== "function")
           lC = naiveLength;
@@ -10076,7 +10223,8 @@ var require_semver = __commonJS({
     }
     exports.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;
     var re = exports.re = [];
     var src = exports.src = [];
@@ -14374,6 +14522,7 @@ var require_NodePackageManagers = __commonJS({
           rimraf_1.default.sync(nodeModulesPath);
         }
       }
+      // Private
       async _runAsync(args) {
         if (!this.options.ignoreStdio) {
           this.log(`> npm ${args.join(" ")}`);
@@ -14487,6 +14636,7 @@ var require_NodePackageManagers = __commonJS({
           rimraf_1.default.sync(nodeModulesPath);
         }
       }
+      // Private
       async _runAsync(args) {
         if (!this.options.ignoreStdio) {
           this.log(`> yarn ${args.join(" ")}`);
@@ -15361,6 +15511,8 @@ var require_route2 = __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
         };
@@ -15536,6 +15688,7 @@ var require_ansi_styles2 = __commonJS({
       const styles3 = {
         modifier: {
           reset: [0, 0],
+          // 21 isn't widely supported and 22 does the same thing
           bold: [1, 22],
           dim: [2, 22],
           italic: [3, 23],
@@ -15553,6 +15706,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],
@@ -15571,6 +15725,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],
@@ -16105,6 +16260,8 @@ var require_CocoaPodsPackageManager = __commonJS({
         this.silent = !!silent;
         this.options = {
           cwd,
+          // We use pipe by default instead of inherit so that we can capture stderr/stdout and process it for errors.
+          // Later we'll also pipe the stdout/stderr to the terminal when silent is false.
           stdio: "pipe"
         };
       }
@@ -16198,6 +16355,7 @@ var require_CocoaPodsPackageManager = __commonJS({
       get name() {
         return "CocoaPods";
       }
+      /** Runs `pod install` and attempts to automatically run known troubleshooting steps automatically. */
       async installAsync({ spinner } = {}) {
         await this._installAsync({ spinner });
       }
@@ -16225,6 +16383,7 @@ var require_CocoaPodsPackageManager = __commonJS({
           return await this._installAsync({
             spinner,
             shouldRepoUpdate: true,
+            // Include a boolean to ensure pod install --repo-update isn't invoked in the unlikely case where the pods fail to update.
             shouldUpdate: false,
             updatedPackages
           });
@@ -16285,6 +16444,7 @@ var require_CocoaPodsPackageManager = __commonJS({
       async cleanAsync() {
         throw new Error("Unimplemented");
       }
+      // Private
       async podRepoUpdateAsync() {
         var _a;
         try {
@@ -16294,15 +16454,22 @@ var require_CocoaPodsPackageManager = __commonJS({
           throw new CocoaPodsError("The command `pod install --repo-update` failed", "COMMAND_FAILED", error);
         }
       }
+      // Exposed for testing
       async _runAsync(args) {
         if (!this.silent) {
           console.log(`> pod ${args.join(" ")}`);
         }
         const promise = spawn_async_1.default("pod", [
           ...args,
+          // Enables colors while collecting output.
           "--ansi"
         ], {
+          // Add the cwd and other options to the spawn options.
           ...this.options,
+          // We use pipe by default instead of inherit so that we can capture stderr/stdout and process it for errors.
+          // This is particularly required for the `pod install --repo-update` error.
+          // Later we'll also pipe the stdout/stderr to the terminal when silent is false,
+          // currently this means we lose out on the ansi colors unless passing the `--ansi` flag to every command.
           stdio: "pipe"
         });
         if (!this.silent) {
@@ -17243,6 +17410,7 @@ var require_mkdirs = __commonJS({
     module2.exports = {
       mkdirs: makeDir,
       mkdirsSync: makeDirSync,
+      // alias
       mkdirp: makeDir,
       mkdirpSync: makeDirSync,
       ensureDir: makeDir,
@@ -18475,14 +18643,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,
@@ -18587,6 +18758,7 @@ var require_jsonfile2 = __commonJS({
     "use strict";
     var jsonFile = require_jsonfile();
     module2.exports = {
+      // jsonfile exports
       readJson: jsonFile.readFile,
       readJsonSync: jsonFile.readFileSync,
       writeJson: jsonFile.writeFile,
@@ -18838,7 +19010,9 @@ var require_lib5 = __commonJS({
   "../../node_modules/fs-extra/lib/index.js"(exports, module2) {
     "use strict";
     module2.exports = {
+      // Export promiseified graceful-fs:
       ...require_fs2(),
+      // Export extra methods:
       ...require_copy2(),
       ...require_empty(),
       ...require_ensure(),
@@ -18938,39 +19112,111 @@ var require_dist = __commonJS({
     };
     is.generator = (value) => is.iterable(value) && is.function_(value.next) && is.function_(value.throw);
     is.asyncGenerator = (value) => is.asyncIterable(value) && is.function_(value.next) && is.function_(value.throw);
-    is.nativePromise = (value) => isObjectOfType("Promise")(value);
+    is.nativePromise = (value) => isObjectOfType(
+      "Promise"
+      /* Promise */
+    )(value);
     var hasPromiseAPI = (value) => {
       var _a, _b;
       return is.function_((_a = value) === null || _a === void 0 ? void 0 : _a.then) && is.function_((_b = value) === null || _b === void 0 ? void 0 : _b.catch);
     };
     is.promise = (value) => is.nativePromise(value) || hasPromiseAPI(value);
-    is.generatorFunction = isObjectOfType("GeneratorFunction");
+    is.generatorFunction = isObjectOfType(
+      "GeneratorFunction"
+      /* GeneratorFunction */
+    );
     is.asyncGeneratorFunction = (value) => getObjectType(value) === "AsyncGeneratorFunction";
     is.asyncFunction = (value) => getObjectType(value) === "AsyncFunction";
     is.boundFunction = (value) => is.function_(value) && !value.hasOwnProperty("prototype");
-    is.regExp = isObjectOfType("RegExp");
-    is.date = isObjectOfType("Date");
-    is.error = isObjectOfType("Error");
-    is.map = (value) => isObjectOfType("Map")(value);
-    is.set = (value) => isObjectOfType("Set")(value);
-    is.weakMap = (value) => isObjectOfType("WeakMap")(value);
-    is.weakSet = (value) => isObjectOfType("WeakSet")(value);
-    is.int8Array = isObjectOfType("Int8Array");
-    is.uint8Array = isObjectOfType("Uint8Array");
-    is.uint8ClampedArray = isObjectOfType("Uint8ClampedArray");
-    is.int16Array = isObjectOfType("Int16Array");
-    is.uint16Array = isObjectOfType("Uint16Array");
-    is.int32Array = isObjectOfType("Int32Array");
-    is.uint32Array = isObjectOfType("Uint32Array");
-    is.float32Array = isObjectOfType("Float32Array");
-    is.float64Array = isObjectOfType("Float64Array");
-    is.bigInt64Array = isObjectOfType("BigInt64Array");
-    is.bigUint64Array = isObjectOfType("BigUint64Array");
-    is.arrayBuffer = isObjectOfType("ArrayBuffer");
-    is.sharedArrayBuffer = isObjectOfType("SharedArrayBuffer");
-    is.dataView = isObjectOfType("DataView");
+    is.regExp = isObjectOfType(
+      "RegExp"
+      /* RegExp */
+    );
+    is.date = isObjectOfType(
+      "Date"
+      /* Date */
+    );
+    is.error = isObjectOfType(
+      "Error"
+      /* Error */
+    );
+    is.map = (value) => isObjectOfType(
+      "Map"
+      /* Map */
+    )(value);
+    is.set = (value) => isObjectOfType(
+      "Set"
+      /* Set */
+    )(value);
+    is.weakMap = (value) => isObjectOfType(
+      "WeakMap"
+      /* WeakMap */
+    )(value);
+    is.weakSet = (value) => isObjectOfType(
+      "WeakSet"
+      /* WeakSet */
+    )(value);
+    is.int8Array = isObjectOfType(
+      "Int8Array"
+      /* Int8Array */
+    );
+    is.uint8Array = isObjectOfType(
+      "Uint8Array"
+      /* Uint8Array */
+    );
+    is.uint8ClampedArray = isObjectOfType(
+      "Uint8ClampedArray"
+      /* Uint8ClampedArray */
+    );
+    is.int16Array = isObjectOfType(
+      "Int16Array"
+      /* Int16Array */
+    );
+    is.uint16Array = isObjectOfType(
+      "Uint16Array"
+      /* Uint16Array */
+    );
+    is.int32Array = isObjectOfType(
+      "Int32Array"
+      /* Int32Array */
+    );
+    is.uint32Array = isObjectOfType(
+      "Uint32Array"
+      /* Uint32Array */
+    );
+    is.float32Array = isObjectOfType(
+      "Float32Array"
+      /* Float32Array */
+    );
+    is.float64Array = isObjectOfType(
+      "Float64Array"
+      /* Float64Array */
+    );
+    is.bigInt64Array = isObjectOfType(
+      "BigInt64Array"
+      /* BigInt64Array */
+    );
+    is.bigUint64Array = isObjectOfType(
+      "BigUint64Array"
+      /* BigUint64Array */
+    );
+    is.arrayBuffer = isObjectOfType(
+      "ArrayBuffer"
+      /* ArrayBuffer */
+    );
+    is.sharedArrayBuffer = isObjectOfType(
+      "SharedArrayBuffer"
+      /* SharedArrayBuffer */
+    );
+    is.dataView = isObjectOfType(
+      "DataView"
+      /* DataView */
+    );
     is.directInstanceOf = (instance, class_) => Object.getPrototypeOf(instance) === class_.prototype;
-    is.urlInstance = (value) => isObjectOfType("URL")(value);
+    is.urlInstance = (value) => isObjectOfType(
+      "URL"
+      /* URL */
+    )(value);
     is.urlString = (value) => {
       if (!is.string(value)) {
         return false;
@@ -19015,6 +19261,7 @@ var require_dist = __commonJS({
       "Float64Array",
       "BigInt64Array",
       "BigUint64Array"
+      /* BigUint64Array */
     ]);
     is.typedArray = (value) => {
       const objectType = getObjectType(value);
@@ -19093,10 +19340,12 @@ var require_dist = __commonJS({
       }
     };
     exports.assert = {
+      // Unknowns.
       undefined: (value) => assertType(is.undefined(value), "undefined", value),
       string: (value) => assertType(is.string(value), "string", value),
       number: (value) => assertType(is.number(value), "number", value),
       bigint: (value) => assertType(is.bigint(value), "bigint", value),
+      // eslint-disable-next-line @typescript-eslint/ban-types
       function_: (value) => assertType(is.function_(value), "Function", value),
       null_: (value) => assertType(is.null_(value), "null", value),
       class_: (value) => assertType(is.class_(value), "Class", value),
@@ -19115,7 +19364,9 @@ var require_dist = __commonJS({
       promise: (value) => assertType(is.promise(value), "Promise", value),
       generatorFunction: (value) => assertType(is.generatorFunction(value), "GeneratorFunction", value),
       asyncGeneratorFunction: (value) => assertType(is.asyncGeneratorFunction(value), "AsyncGeneratorFunction", value),
+      // eslint-disable-next-line @typescript-eslint/ban-types
       asyncFunction: (value) => assertType(is.asyncFunction(value), "AsyncFunction", value),
+      // eslint-disable-next-line @typescript-eslint/ban-types
       boundFunction: (value) => assertType(is.boundFunction(value), "Function", value),
       regExp: (value) => assertType(is.regExp(value), "RegExp", value),
       date: (value) => assertType(is.date(value), "Date", value),
@@ -19164,10 +19415,13 @@ var require_dist = __commonJS({
       nonEmptySet: (value) => assertType(is.nonEmptySet(value), "non-empty set", value),
       emptyMap: (value) => assertType(is.emptyMap(value), "empty map", value),
       nonEmptyMap: (value) => assertType(is.nonEmptyMap(value), "non-empty map", value),
+      // Numbers.
       evenInteger: (value) => assertType(is.evenInteger(value), "even integer", value),
       oddInteger: (value) => assertType(is.oddInteger(value), "odd integer", value),
+      // Two arguments.
       directInstanceOf: (instance, class_) => assertType(is.directInstanceOf(instance, class_), "T", instance),
       inRange: (value, range) => assertType(is.inRange(value, range), "in range", value),
+      // Variadic functions.
       any: (predicate, ...values) => assertType(is.any(predicate, ...values), "predicate returns truthy for any value", values),
       all: (predicate, ...values) => assertType(is.all(predicate, ...values), "predicate returns truthy for all values", values)
     };
@@ -19586,6 +19840,8 @@ var require_errors = __commonJS({
           this.code = error.code;
         }
         Object.defineProperty(this, "options", {
+          // This fails because of TS 3.7.2 useDefineForClassFields
+          // Ref: https://github.com/microsoft/TypeScript/issues/34972
           enumerable: false,
           value: options
         });
@@ -19871,6 +20127,7 @@ var require_http_cache_semantics = __commonJS({
     ]);
     var hopByHopHeaders = {
       date: true,
+      // included, because we add Age update Date
       connection: true,
       "keep-alive": true,
       "proxy-authenticate": true,
@@ -19881,6 +20138,7 @@ var require_http_cache_semantics = __commonJS({
       upgrade: true
     };
     var excludedFromRevalidationUpdate = {
+      // Since the old body is reused, it doesn't make sense to change properties of the body
       "content-length": true,
       "content-encoding": true,
       "transfer-encoding": true,
@@ -19967,7 +20225,19 @@ var require_http_cache_semantics = __commonJS({
         return Date.now();
       }
       storable() {
-        return !!(!this._reqcc["no-store"] && ("GET" === this._method || "HEAD" === this._method || "POST" === this._method && this._hasExplicitExpiration()) && understoodStatuses.has(this._status) && !this._rescc["no-store"] && (!this._isShared || !this._rescc.private) && (!this._isShared || this._noAuthorization || this._allowsStoringAuthenticated()) && (this._resHeaders.expires || this._rescc["max-age"] || this._isShared && this._rescc["s-maxage"] || this._rescc.public || statusCodeCacheableByDefault.has(this._status)));
+        return !!(!this._reqcc["no-store"] && // A cache MUST NOT store a response to any request, unless:
+        // The request method is understood by the cache and defined as being cacheable, and
+        ("GET" === this._method || "HEAD" === this._method || "POST" === this._method && this._hasExplicitExpiration()) && // the response status code is understood by the cache, and
+        understoodStatuses.has(this._status) && // the "no-store" cache directive does not appear in request or response header fields, and
+        !this._rescc["no-store"] && // the "private" response directive does not appear in the response, if the cache is shared, and
+        (!this._isShared || !this._rescc.private) && // the Authorization header field does not appear in the request, if the cache is shared,
+        (!this._isShared || this._noAuthorization || this._allowsStoringAuthenticated()) && // the response either:
+        // contains an Expires header field, or
+        (this._resHeaders.expires || // contains a max-age response directive, or
+        // contains a s-maxage response directive and the cache is shared, or
+        // contains a public response directive.
+        this._rescc["max-age"] || this._isShared && this._rescc["s-maxage"] || this._rescc.public || // has a status code that is defined as cacheable by default
+        statusCodeCacheableByDefault.has(this._status)));
       }
       _hasExplicitExpiration() {
         return this._isShared && this._rescc["s-maxage"] || this._rescc["max-age"] || this._resHeaders.expires;
@@ -19998,7 +20268,9 @@ var require_http_cache_semantics = __commonJS({
         return this._requestMatches(req, false);
       }
       _requestMatches(req, allowHeadMethod) {
-        return (!this._url || this._url === req.url) && this._host === req.headers.host && (!req.method || this._method === req.method || allowHeadMethod && "HEAD" === req.method) && this._varyMatches(req);
+        return (!this._url || this._url === req.url) && this._host === req.headers.host && // the request method associated with the stored response allows it to be used for the presented request, and
+        (!req.method || this._method === req.method || allowHeadMethod && "HEAD" === req.method) && // selecting header fields nominated by the stored response (if any) match those presented, and
+        this._varyMatches(req);
       }
       _allowsStoringAuthenticated() {
         return this._rescc["must-revalidate"] || this._rescc.public || this._rescc["s-maxage"];
@@ -20052,6 +20324,10 @@ var require_http_cache_semantics = __commonJS({
         headers.date = new Date(this.now()).toUTCString();
         return headers;
       }
+      /**
+       * Value of the Date response header or current time if Date was invalid
+       * @return timestamp
+       */
       date() {
         const serverDate = Date.parse(this._resHeaders.date);
         if (isFinite(serverDate)) {
@@ -20059,6 +20335,12 @@ var require_http_cache_semantics = __commonJS({
         }
         return this._responseTime;
       }
+      /**
+       * Value of the Age header, in seconds, updated for the current time.
+       * May be fractional.
+       *
+       * @return Number
+       */
       age() {
         let age = this._ageValue();
         const residentTime = (this.now() - this._responseTime) / 1e3;
@@ -20067,6 +20349,13 @@ var require_http_cache_semantics = __commonJS({
       _ageValue() {
         return toNumberOrZero(this._resHeaders.age);
       }
+      /**
+       * Value of applicable max-age (or heuristic equivalent) in seconds. This counts since response's `Date`.
+       *
+       * For an up-to-date value, see `timeToLive()`.
+       *
+       * @return Number
+       */
       maxAge() {
         if (!this.storable() || this._rescc["no-cache"]) {
           return 0;
@@ -20163,6 +20452,13 @@ var require_http_cache_semantics = __commonJS({
           reqcc: this._reqcc
         };
       }
+      /**
+       * Headers for sending to the origin server to revalidate stale response.
+       * Allows server to return 304 to allow reuse of the previous response.
+       *
+       * Hop by hop headers are always stripped.
+       * Revalidation headers may be added or removed, depending on request.
+       */
       revalidationHeaders(incomingReq) {
         this._assertRequestHasHeaders(incomingReq);
         const headers = this._copyWithoutHopByHopHeaders(incomingReq.headers);
@@ -20193,6 +20489,15 @@ var require_http_cache_semantics = __commonJS({
         }
         return headers;
       }
+      /**
+       * Creates new CachePolicy with information combined from the previews response,
+       * and the new revalidation response.
+       *
+       * Returns {policy, modified} where modified is a boolean indicating
+       * whether the response body has been modified, and old cached body can't be used.
+       *
+       * @return {Object} {policy: CachePolicy, modified: Boolean}
+       */
       revalidatedPolicy(request, response) {
         this._assertRequestHasHeaders(request);
         if (this._useStaleIfError() && isErrorResponse(response)) {
@@ -20222,6 +20527,9 @@ var require_http_cache_semantics = __commonJS({
         if (!matches) {
           return {
             policy: new this.constructor(request, response),
+            // Client receiving 304 without body, even if it's invalid/mismatched has no option
+            // but to reuse a cached body. We don't have a good way to tell clients to do
+            // error recovery in such case.
             modified: response.status != 304,
             matches: false
           };
@@ -21334,6 +21642,7 @@ var require_normalize_arguments = __commonJS({
       }
       if (options.cache) {
         options.cacheableRequest = new CacheableRequest(
+          // @ts-ignore Cannot properly type a function with multiple definitions yet
           (requestOptions, handler) => requestOptions[types_1.requestSymbol](requestOptions, handler),
           options.cache
         );
@@ -22182,6 +22491,7 @@ var require_p_timeout = __commonJS({
         reject(timeoutError);
       }, milliseconds);
       pFinally(
+        // eslint-disable-next-line promise/prefer-await-to-then
         promise.then(resolve, reject),
         () => {
           clearTimeout(timer);
@@ -23311,6 +23621,7 @@ var require_kleur = __commonJS({
     var { FORCE_COLOR, NODE_DISABLE_COLORS, TERM } = process.env;
     var $2 = {
       enabled: !NODE_DISABLE_COLORS && TERM !== "dumb" && FORCE_COLOR !== "0",
+      // modifiers
       reset: init(0, 0),
       bold: init(1, 22),
       dim: init(2, 22),
@@ -23319,6 +23630,7 @@ var require_kleur = __commonJS({
       inverse: init(7, 27),
       hidden: init(8, 28),
       strikethrough: init(9, 29),
+      // colors
       black: init(30, 39),
       red: init(31, 39),
       green: init(32, 39),
@@ -23329,6 +23641,7 @@ var require_kleur = __commonJS({
       white: init(37, 39),
       gray: init(90, 39),
       grey: init(90, 39),
+      // background colors
       bgBlack: init(40, 49),
       bgRed: init(41, 49),
       bgGreen: init(42, 49),
@@ -24157,7 +24470,7 @@ var require_datepart = __commonJS({
         locales
       }) {
         this.token = token;
-        this.date = date || new Date();
+        this.date = date || /* @__PURE__ */ new Date();
         this.parts = parts || [this];
         this.locales = locales || {};
       }
@@ -24482,19 +24795,39 @@ var require_date = __commonJS({
         token
       }) => token.replace(/\\(.)/g, "$1"),
       2: (opts) => new Day(opts),
+      // Day // TODO
       3: (opts) => new Month(opts),
+      // Month
       4: (opts) => new Year(opts),
+      // Year
       5: (opts) => new Meridiem(opts),
+      // AM/PM // TODO (special)
       6: (opts) => new Hours(opts),
+      // Hours
       7: (opts) => new Minutes(opts),
+      // Minutes
       8: (opts) => new Seconds(opts),
+      // Seconds
       9: (opts) => new Milliseconds(opts)
+      // Fractional seconds
     };
     var dfltLocales = {
       months: "January,February,March,April,May,June,July,August,September,October,November,December".split(","),
       monthsShort: "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec".split(","),
       weekdays: "Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday".split(","),
       weekdaysShort: "Sun,Mon,Tue,Wed,Thu,Fri,Sat".split(",")
+      /**
+       * DatePrompt Base Element
+       * @param {Object} opts Options
+       * @param {String} opts.message Message
+       * @param {Number} [opts.initial] Index of default value
+       * @param {String} [opts.mask] The format mask
+       * @param {object} [opts.locales] The date locales
+       * @param {String} [opts.error] The error message shown on invalid value
+       * @param {Function} [opts.validate] Function to validate the submitted value
+       * @param {Stream} [opts.stdin] The Readable stream to listen to
+       * @param {Stream} [opts.stdout] The Writable stream to write readline data to
+       */
     };
     var DatePrompt = class extends Prompt {
       constructor(opts = {}) {
@@ -24503,7 +24836,7 @@ var require_date = __commonJS({
         this.cursor = 0;
         this.typed = "";
         this.locales = Object.assign(dfltLocales, opts.locales);
-        this._date = opts.initial || new Date();
+        this._date = opts.initial || /* @__PURE__ */ new Date();
         this.errorMsg = opts.error || "Please Enter A Valid Value";
         this.validator = opts.validate || (() => true);
         this.mask = opts.mask || "YYYY-MM-DD HH:mm:ss";
@@ -25019,6 +25352,7 @@ Instructions:
           title = cursor2 === i ? color.cyan().underline(v.title) : v.title;
         return (v.selected ? color.green(figures.radioOn) : figures.radioOff) + "  " + title;
       }
+      // shared with autocompleteMultiselect
       paginateOptions(options) {
         const c = this.cursor;
         let styledOptions = options.map((v, i) => this.renderOption(c, v, i));
@@ -25042,6 +25376,7 @@ Instructions:
         }
         return "\n" + scopedOptions.join("\n") + "\n" + hint;
       }
+      // shared with autocomleteMultiselect
       renderOptions(options) {
         if (!this.done) {
           return this.paginateOptions(options);
@@ -26448,7 +26783,7 @@ var require_datepart2 = __commonJS({
     var DatePart = class {
       constructor({ token, date, parts, locales }) {
         this.token = token;
-        this.date = date || new Date();
+        this.date = date || /* @__PURE__ */ new Date();
         this.parts = parts || [this];
         this.locales = locales || {};
       }
@@ -26727,13 +27062,21 @@ var require_date2 = __commonJS({
     var regexGroups = {
       1: ({ token }) => token.replace(/\\(.)/g, "$1"),
       2: (opts) => new Day(opts),
+      // Day // TODO
       3: (opts) => new Month(opts),
+      // Month
       4: (opts) => new Year(opts),
+      // Year
       5: (opts) => new Meridiem(opts),
+      // AM/PM // TODO (special)
       6: (opts) => new Hours(opts),
+      // Hours
       7: (opts) => new Minutes(opts),
+      // Minutes
       8: (opts) => new Seconds(opts),
+      // Seconds
       9: (opts) => new Milliseconds(opts)
+      // Fractional seconds
     };
     var dfltLocales = {
       months: "January,February,March,April,May,June,July,August,September,October,November,December".split(","),
@@ -26748,7 +27091,7 @@ var require_date2 = __commonJS({
         this.cursor = 0;
         this.typed = "";
         this.locales = Object.assign(dfltLocales, opts.locales);
-        this._date = opts.initial || new Date();
+        this._date = opts.initial || /* @__PURE__ */ new Date();
         this.errorMsg = opts.error || "Please Enter A Valid Value";
         this.validator = opts.validate || (() => true);
         this.mask = opts.mask || "YYYY-MM-DD HH:mm:ss";
@@ -27214,6 +27557,7 @@ Instructions:
           title = cursor2 === i ? color.cyan().underline(v.title) : v.title;
         return (v.selected ? color.green(figures.radioOn) : figures.radioOff) + "  " + title;
       }
+      // shared with autocompleteMultiselect
       paginateOptions(options) {
         const c = this.cursor;
         let styledOptions = options.map((v, i) => this.renderOption(c, v, i));
@@ -27237,6 +27581,7 @@ Instructions:
         }
         return "\n" + scopedOptions.join("\n") + "\n" + hint;
       }
+      // shared with autocomleteMultiselect
       renderOptions(options) {
         if (!this.done) {
           return this.paginateOptions(options);
@@ -28419,7 +28764,10 @@ var require_minipass = __commonJS({
     var doIter = global._MP_NO_ITERATOR_SYMBOLS_ !== "1";
     var ASYNCITERATOR = doIter && Symbol.asyncIterator || Symbol("asyncIterator not implemented");
     var ITERATOR = doIter && Symbol.iterator || Symbol("iterator not implemented");
-    var B = Buffer.alloc ? Buffer : require_safe_buffer().Buffer;
+    var B = Buffer.alloc ? Buffer : (
+      /* istanbul ignore next */
+      require_safe_buffer().Buffer
+    );
     var isEndish = (ev) => ev === "end" || ev === "finish" || ev === "prefinish";
     var isArrayBuffer = (b) => b instanceof ArrayBuffer || typeof b === "object" && b.constructor && b.constructor.name === "ArrayBuffer" && b.byteLength >= 0;
     var isArrayBufferView = (b) => !B.isBuffer(b) && ArrayBuffer.isView(b);
@@ -28504,7 +28852,8 @@ var require_minipass = __commonJS({
             cb();
           return ret;
         }
-        if (typeof chunk === "string" && !this[OBJECTMODE] && !(encoding === this[ENCODING] && !this[DECODER].lastNeed)) {
+        if (typeof chunk === "string" && !this[OBJECTMODE] && // unless it is a string already ready for us to use
+        !(encoding === this[ENCODING] && !this[DECODER].lastNeed)) {
           chunk = B.from(chunk, encoding);
         }
         if (B.isBuffer(chunk) && this[ENCODING])
@@ -28569,6 +28918,7 @@ var require_minipass = __commonJS({
           this[MAYBE_EMIT_END]();
         return this;
       }
+      // don't let the internal resume be overwritten
       [RESUME]() {
         if (this[DESTROYED])
           return;
@@ -28716,6 +29066,7 @@ var require_minipass = __commonJS({
             this.removeAllListeners(ev);
         }
       }
+      // const all = await stream.collect()
       collect() {
         const buf = [];
         buf.dataLength = 0;
@@ -28725,9 +29076,11 @@ var require_minipass = __commonJS({
         });
         return this.promise().then(() => buf);
       }
+      // const data = await stream.concat()
       concat() {
         return this[OBJECTMODE] ? Promise.reject(new Error("cannot concat in objectMode")) : this.collect().then((buf) => this[OBJECTMODE] ? Promise.reject(new Error("cannot concat in objectMode")) : this[ENCODING] ? buf.join("") : B.concat(buf, buf.dataLength));
       }
+      // stream.promise().then(() => done, er => emitted error)
       promise() {
         return new Promise((resolve, reject) => {
           this.on(DESTROYED, () => reject(new Error("stream destroyed")));
@@ -28735,6 +29088,7 @@ var require_minipass = __commonJS({
           this.on("error", (er) => reject(er));
         });
       }
+      // for await (let chunk of stream)
       [ASYNCITERATOR]() {
         const next = () => {
           const res = this.read();
@@ -28772,6 +29126,7 @@ var require_minipass = __commonJS({
         };
         return { next };
       }
+      // for (let chunk of stream)
       [ITERATOR]() {
         const next = () => {
           const value = this.read();
@@ -28800,7 +29155,8 @@ var require_minipass = __commonJS({
         return this;
       }
       static isStream(s) {
-        return !!s && (s instanceof Minipass || s instanceof EE && (typeof s.pipe === "function" || typeof s.write === "function" && typeof s.end === "function"));
+        return !!s && (s instanceof Minipass || s instanceof EE && (typeof s.pipe === "function" || // readable
+        typeof s.write === "function" && typeof s.end === "function"));
       }
     };
   }
@@ -28809,7 +29165,8 @@ var require_minipass = __commonJS({
 // ../../node_modules/tar/node_modules/minizlib/constants.js
 var require_constants3 = __commonJS({
   "../../node_modules/tar/node_modules/minizlib/constants.js"(exports, module2) {
-    var realZlibConstants = require("zlib").constants || { ZLIB_VERNUM: 4736 };
+    var realZlibConstants = require("zlib").constants || /* istanbul ignore next */
+    { ZLIB_VERNUM: 4736 };
     module2.exports = Object.freeze(Object.assign(/* @__PURE__ */ Object.create(null), {
       Z_NO_FLUSH: 0,
       Z_PARTIAL_FLUSH: 1,
@@ -29173,25 +29530,41 @@ var require_types2 = __commonJS({
     "use strict";
     exports.name = /* @__PURE__ */ new Map([
       ["0", "File"],
+      // same as File
       ["", "OldFile"],
       ["1", "Link"],
       ["2", "SymbolicLink"],
+      // Devices and FIFOs aren't fully supported
+      // they are parsed, but skipped when unpacking
       ["3", "CharacterDevice"],
       ["4", "BlockDevice"],
       ["5", "Directory"],
       ["6", "FIFO"],
+      // same as File
       ["7", "ContiguousFile"],
+      // pax headers
       ["g", "GlobalExtendedHeader"],
       ["x", "ExtendedHeader"],
+      // vendor-specific stuff
+      // skip
       ["A", "SolarisACL"],
+      // like 5, but with data, which should be skipped
       ["D", "GNUDumpDir"],
+      // metadata only, skip
       ["I", "Inode"],
+      // data = link path of next file
       ["K", "NextFileHasLongLinkpath"],
+      // data = path of next file
       ["L", "NextFileHasLongPath"],
+      // skip
       ["M", "ContinuationFile"],
+      // like L
       ["N", "OldGnuLongPath"],
+      // skip
       ["S", "SparseFile"],
+      // skip
       ["V", "TapeVolumeHeader"],
+      // like x
       ["X", "OldExtendedHeader"]
     ]);
     exports.code = new Map(Array.from(exports.name).map((kv) => [kv[1], kv[0]]));
@@ -29614,6 +29987,9 @@ var require_pax = __commonJS({
           buf[i] = 0;
         }
         new Header({
+          // XXX split the path
+          // then the path should be PaxHeader + basename, but less than 99,
+          // prepend with the dirname
           path: ("PaxHeader/" + path3.basename(this.path)).slice(0, 99),
           mode: this.mode || 420,
           uid: this.uid || null,
@@ -29838,6 +30214,8 @@ var require_write_entry = __commonJS({
         this.header = new Header({
           path: this.path,
           linkpath: this.linkpath,
+          // only the permissions and setuid/setgid/sticky bitflags
+          // not the higher-order bits that specify file type
           mode: this[MODE](this.stat.mode),
           uid: this.portable ? null : this.stat.uid,
           gid: this.portable ? null : this.stat.gid,
@@ -30044,6 +30422,8 @@ var require_write_entry = __commonJS({
         this.header = new Header({
           path: this.path,
           linkpath: this.linkpath,
+          // only the permissions and setuid/setgid/sticky bitflags
+          // not the higher-order bits that specify file type
           mode: this.mode,
           uid: this.portable ? null : this.uid,
           gid: this.portable ? null : this.gid,
@@ -30358,6 +30738,7 @@ var require_pack = __commonJS({
         if (this[CURRENT] && this[CURRENT].entry)
           this[CURRENT].entry.resume();
       }
+      // like .pipe() but using super, because our write() is special
       [PIPE](job) {
         job.piped = true;
         if (job.readdir)
@@ -30390,6 +30771,7 @@ var require_pack = __commonJS({
         super(opt);
         this[WRITEENTRYCLASS] = WriteEntrySync;
       }
+      // pause/resume are no-ops in sync streams.
       pause() {
       }
       resume() {
@@ -30401,6 +30783,7 @@ var require_pack = __commonJS({
       [READDIR](job, stat) {
         this[ONREADDIR](job, fs4.readdirSync(job.absolute));
       }
+      // gotta get it all in this tick
       [PIPE](job) {
         const source = job.entry;
         const zip = this.zip;
@@ -31543,7 +31926,8 @@ var require_mkdirp = __commonJS({
       }
       if (!made)
         made = null;
-      var cb = f || function() {
+      var cb = f || /* istanbul ignore next */
+      function() {
       };
       p = path3.resolve(p);
       xfs.mkdir(p, mode, function(er) {
@@ -32130,7 +32514,7 @@ var require_unpack = __commonJS({
           const fd = stream.fd;
           if (entry.mtime && !this.noMtime) {
             actions++;
-            const atime = entry.atime || new Date();
+            const atime = entry.atime || /* @__PURE__ */ new Date();
             const mtime = entry.mtime;
             fs4.futimes(fd, atime, mtime, (er) => er ? fs4.utimes(abs, atime, mtime, (er2) => done(er2 && er)) : done());
           }
@@ -32163,7 +32547,7 @@ var require_unpack = __commonJS({
           };
           if (entry.mtime && !this.noMtime) {
             actions++;
-            fs4.utimes(entry.absolute, entry.atime || new Date(), entry.mtime, done);
+            fs4.utimes(entry.absolute, entry.atime || /* @__PURE__ */ new Date(), entry.mtime, done);
           }
           if (this[DOCHOWN](entry)) {
             actions++;
@@ -32193,9 +32577,13 @@ var require_unpack = __commonJS({
         this[UNPEND]();
         entry.resume();
       }
+      // Check if we can reuse an existing filesystem entry safely and
+      // overwrite it, rather than unlinking and recreating
+      // Windows doesn't report a useful nlink, so we just never reuse entries
       [ISREUSABLE](entry, st) {
         return entry.type === "File" && !this.unlink && st.isFile() && st.nlink <= 1 && process.platform !== "win32";
       }
+      // check if a thing is there, and if so, try to clobber it
       [CHECKFS](entry) {
         this[PEND]();
         this[MKDIR](path3.dirname(entry.absolute), this.dmode, (er) => {
@@ -32310,7 +32698,7 @@ var require_unpack = __commonJS({
         tx.on("end", (_) => {
           let er = null;
           if (entry.mtime && !this.noMtime) {
-            const atime = entry.atime || new Date();
+            const atime = entry.atime || /* @__PURE__ */ new Date();
             const mtime = entry.mtime;
             try {
               fs4.futimesSync(fd, atime, mtime);
@@ -32345,7 +32733,7 @@ var require_unpack = __commonJS({
           return this[ONERROR](er, entry);
         if (entry.mtime && !this.noMtime) {
           try {
-            fs4.utimesSync(entry.absolute, entry.atime || new Date(), entry.mtime);
+            fs4.utimesSync(entry.absolute, entry.atime || /* @__PURE__ */ new Date(), entry.mtime);
           } catch (er2) {
           }
         }
@@ -32504,8 +32892,10 @@ var require_which2 = __commonJS({
     var getPathInfo = (cmd, opt) => {
       const colon = opt.colon || COLON;
       const pathEnv = cmd.match(/\//) || isWindows && cmd.match(/\\/) ? [""] : [
+        // windows always checks the cwd first
         ...isWindows ? [process.cwd()] : [],
-        ...(opt.path || process.env.PATH || "").split(colon)
+        ...(opt.path || process.env.PATH || /* istanbul ignore next: very unusual */
+        "").split(colon)
       ];
       const pathExtExe = isWindows ? opt.pathExt || process.env.PATHEXT || ".EXE;.CMD;.BAT;.COM" : "";
       const pathExt = isWindows ? pathExtExe.split(colon) : [""];
@@ -32929,7 +33319,8 @@ var require_event_stream = __commonJS({
     es.pause = pause;
     es.split = split;
     es.pipeline = es.connect = es.pipe = pipeline2;
-    es.concat = es.merge = function() {
+    es.concat = //actually this should be called concat
+    es.merge = function() {
       var toMerge = [].slice.call(arguments);
       if (toMerge.length === 1 && toMerge[0] instanceof Array) {
         toMerge = toMerge[0];
@@ -33164,6 +33555,7 @@ var require_ps_tree = __commonJS({
         processLister = spawn2("ps", ["-A", "-o", "ppid,pid,stat,comm"]);
       }
       es.connect(
+        // spawn('ps', ['-A', '-o', 'ppid,pid,stat,comm']).stdout,
         processLister.stdout,
         es.split(),
         es.map(function(line, cb) {
@@ -33832,8 +34224,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;
@@ -35966,64 +36368,135 @@ var require_ignore = __commonJS({
       return slashes.slice(0, length - length % 2);
     };
     var REPLACERS = [
+      // > Trailing spaces are ignored unless they are quoted with backslash ("\")
       [
+        // (a\ ) -> (a )
+        // (a  ) -> (a)
+        // (a \ ) -> (a  )
         /\\?\s+$/,
         (match) => match.indexOf("\\") === 0 ? SPACE : EMPTY
       ],
+      // replace (\ ) with ' '
       [
         /\\\s/g,
         () => SPACE
       ],
+      // Escape metacharacters
+      // which is written down by users but means special for regular expressions.
+      // > There are 12 characters with special meanings:
+      // > - the backslash \,
+      // > - the caret ^,
+      // > - the dollar sign $,
+      // > - the period or dot .,
+      // > - the vertical bar or pipe symbol |,
+      // > - the question mark ?,
+      // > - the asterisk or star *,
+      // > - the plus sign +,
+      // > - the opening parenthesis (,
+      // > - the closing parenthesis ),
+      // > - and the opening square bracket [,
+      // > - the opening curly brace {,
+      // > These special characters are often called "metacharacters".
       [
         /[\\$.|*+(){^]/g,
         (match) => `\\${match}`
       ],
       [
+        // > a question mark (?) matches a single character
         /(?!\\)\?/g,
         () => "[^/]"
       ],
+      // leading slash
       [
+        // > A leading slash matches the beginning of the pathname.
+        // > For example, "/*.c" matches "cat-file.c" but not "mozilla-sha1/sha1.c".
+        // A leading slash matches the beginning of the pathname
         /^\//,
         () => "^"
       ],
+      // replace special metacharacter slash after the leading slash
       [
         /\//g,
         () => "\\/"
       ],
       [
+        // > A leading "**" followed by a slash means match in all directories.
+        // > For example, "**/foo" matches file or directory "foo" anywhere,
+        // > the same as pattern "foo".
+        // > "**/foo/bar" matches file or directory "bar" anywhere that is directly
+        // >   under directory "foo".
+        // Notice that the '*'s have been replaced as '\\*'
         /^\^*\\\*\\\*\\\//,
+        // '**/foo' <-> 'foo'
         () => "^(?:.*\\/)?"
       ],
+      // starting
       [
+        // there will be no leading '/'
+        //   (which has been replaced by section "leading slash")
+        // If starts with '**', adding a '^' to the regular expression also works
         /^(?=[^^])/,
         function startingReplacer() {
           return !/\/(?!$)/.test(this) ? "(?:^|\\/)" : "^";
         }
       ],
+      // two globstars
       [
+        // Use lookahead assertions so that we could match more than one `'/**'`
         /\\\/\\\*\\\*(?=\\\/|$)/g,
+        // Zero, one or several directories
+        // should not use '*', or it will be replaced by the next replacer
+        // Check if it is not the last `'/**'`
         (_, index, str) => index + 6 < str.length ? "(?:\\/[^\\/]+)*" : "\\/.+"
       ],
+      // intermediate wildcards
       [
+        // Never replace escaped '*'
+        // ignore rule '\*' will match the path '*'
+        // 'abc.*/' -> go
+        // 'abc.*'  -> skip this rule
         /(^|[^\\]+)\\\*(?=.+)/g,
+        // '*.js' matches '.js'
+        // '*.js' doesn't match 'abc'
         (_, p1) => `${p1}[^\\/]*`
       ],
       [
+        // unescape, revert step 3 except for back slash
+        // For example, if a user escape a '\\*',
+        // after step 3, the result will be '\\\\\\*'
         /\\\\\\(?=[$.|*+(){^])/g,
         () => ESCAPE
       ],
       [
+        // '\\\\' -> '\\'
         /\\\\/g,
         () => ESCAPE
       ],
       [
+        // > The range notation, e.g. [a-zA-Z],
+        // > can be used to match one of the characters in a range.
+        // `\` is escaped by step 3
         /(\\)?\[([^\]/]*?)(\\*)($|\])/g,
         (match, leadEscape, range, endEscape, close) => leadEscape === ESCAPE ? `\\[${range}${cleanRangeBackSlash(endEscape)}${close}` : close === "]" ? endEscape.length % 2 === 0 ? `[${sanitizeRange(range)}${endEscape}]` : "[]" : "[]"
       ],
+      // ending
       [
+        // 'js' will not match 'js.'
+        // 'ab' will not match 'abc'
         /(?:[^*])$/,
+        // WTF!
+        // https://git-scm.com/docs/gitignore
+        // changes in [2.22.1](https://git-scm.com/docs/gitignore/2.22.1)
+        // which re-fixes #24, #38
+        // > If there is a separator at the end of the pattern then the pattern
+        // > will only match directories, otherwise the pattern can match both
+        // > files and directories.
+        // 'js*' will not match 'a.js'
+        // 'js/' will not match 'a.js'
+        // 'js' will match 'a.js' and 'a.js/'
         (match) => /\/$/.test(match) ? `${match}$` : `${match}(?=$|\\/$)`
       ],
+      // trailing wildcard
       [
         /(\^|\\\/)?\\\*$/,
         (_, p1) => {
@@ -36124,6 +36597,7 @@ var require_ignore = __commonJS({
           this._rules.push(rule);
         }
       }
+      // @param {Array<string> | string | Ignore} pattern
       add(pattern) {
         this._added = false;
         makeArray(
@@ -36134,9 +36608,23 @@ var require_ignore = __commonJS({
         }
         return this;
       }
+      // legacy
       addPattern(pattern) {
         return this.add(pattern);
       }
+      //          |           ignored : unignored
+      // negative |   0:0   |   0:1   |   1:0   |   1:1
+      // -------- | ------- | ------- | ------- | --------
+      //     0    |  TEST   |  TEST   |  SKIP   |    X
+      //     1    |  TESTIF |  SKIP   |  TEST   |    X
+      // - SKIP: always skip
+      // - TEST: always test
+      // - TESTIF: only test if checkUnignored
+      // - X: that never happen
+      // @param {boolean} whether should check if the path is unignored,
+      //   setting `checkUnignored` to `false` could reduce additional
+      //   path matching.
+      // @returns {TestResult} true if a file is ignored
       _testOne(path3, checkUnignored) {
         let ignored = false;
         let unignored = false;
@@ -36156,6 +36644,7 @@ var require_ignore = __commonJS({
           unignored
         };
       }
+      // @returns {TestResult}
       _test(originalPath, cache, checkUnignored, slices) {
         const path3 = originalPath && checkPath.convert(originalPath);
         checkPath(
@@ -36193,6 +36682,7 @@ var require_ignore = __commonJS({
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
+      // @returns {TestResult}
       test(path3) {
         return this._test(path3, this._testCache, true);
       }
@@ -36202,7 +36692,10 @@ var require_ignore = __commonJS({
     factory.isPathValid = isPathValid;
     factory.default = factory;
     module2.exports = factory;
-    if (typeof process !== "undefined" && (process.env && process.env.IGNORE_TEST_WIN32 || process.platform === "win32")) {
+    if (
+      // Detect `process` so that it can run in browsers.
+      typeof process !== "undefined" && (process.env && process.env.IGNORE_TEST_WIN32 || process.platform === "win32")
+    ) {
       const makePosix = (str) => /^\\\\\?\\/.test(str) || /["<>|\u0000-\u001F]+/u.test(str) ? str : str.replace(/\\/g, "/");
       checkPath.convert = makePosix;
       const REGIX_IS_WINDOWS_PATH_ABSOLUTE = /^[a-z]:\//i;
@@ -36460,6 +36953,7 @@ var require_Node = __commonJS({
       constructor(type) {
         Object.defineProperty(this, NODE_TYPE, { value: type });
       }
+      /** Create a copy of this node.  */
       clone() {
         const copy2 = Object.create(Object.getPrototypeOf(this), Object.getOwnPropertyDescriptors(this));
         if (this.range)
@@ -36673,6 +37167,10 @@ var require_directives = __commonJS({
         copy2.docStart = this.docStart;
         return copy2;
       }
+      /**
+       * During parsing, get a Directives instance for the current document and
+       * update the stream state according to the current version's spec.
+       */
       atDocument() {
         const res = new Directives(this.yaml, this.tags);
         switch (this.yaml.version) {
@@ -36690,6 +37188,10 @@ var require_directives = __commonJS({
         }
         return res;
       }
+      /**
+       * @param onError - May be called even if the action was successful
+       * @returns `true` on success
+       */
       add(line, onError) {
         if (this.atNextDocument) {
           this.yaml = { explicit: Directives.defaultYaml.explicit, version: "1.1" };
@@ -36730,6 +37232,12 @@ var require_directives = __commonJS({
             return false;
         }
       }
+      /**
+       * Resolves a tag, matching handles to those defined in %TAG directives.
+       *
+       * @returns Resolved tag, which may also be the non-specific tag `'!'` or a
+       *   `'!local'` tag, or `null` if unresolvable.
+       */
       tagName(source, onError) {
         if (source === "!")
           return "!";
@@ -36758,6 +37266,10 @@ var require_directives = __commonJS({
         onError(`Could not resolve tag: ${source}`);
         return null;
       }
+      /**
+       * Given a fully resolved tag, returns its printable string form,
+       * taking into account current tag prefixes and defaults.
+       */
       tagString(tag) {
         for (const [handle, prefix] of Object.entries(this.tags)) {
           if (tag.startsWith(prefix))
@@ -36837,6 +37349,11 @@ var require_anchors = __commonJS({
           prevAnchors.add(anchor);
           return anchor;
         },
+        /**
+         * With circular references, the source node is only resolved after all
+         * of its child nodes are. This is why anchors are set only after all of
+         * the nodes have been created.
+         */
         setAnchors: () => {
           for (const source of aliasObjects) {
             const ref = sourceObjects.get(source);
@@ -36876,6 +37393,10 @@ var require_Alias = __commonJS({
           }
         });
       }
+      /**
+       * Resolve the value of this alias within `doc`, finding the last
+       * instance of the `source` anchor before this node.
+       */
       resolve(doc) {
         let found = void 0;
         visit.visit(doc, {
@@ -37127,6 +37648,11 @@ var require_Collection = __commonJS({
           writable: true
         });
       }
+      /**
+       * Create a copy of this collection.
+       *
+       * @param schema - If defined, overwrites the original's schema
+       */
       clone(schema) {
         const copy2 = Object.create(Object.getPrototypeOf(this), Object.getOwnPropertyDescriptors(this));
         if (schema)
@@ -37136,6 +37662,11 @@ var require_Collection = __commonJS({
           copy2.range = this.range.slice();
         return copy2;
       }
+      /**
+       * Adds a value to the collection. For `!!map` and `!!omap` the value must
+       * be a Pair instance or a `{ key, value }` object, which may not have a key
+       * that already exists in the map.
+       */
       addIn(path3, value) {
         if (isEmptyPath(path3))
           this.add(value);
@@ -37150,6 +37681,10 @@ var require_Collection = __commonJS({
             throw new Error(`Expected YAML collection at ${key}. Remaining path: ${rest}`);
         }
       }
+      /**
+       * Removes a value from the collection.
+       * @returns `true` if the item was found and removed.
+       */
       deleteIn(path3) {
         const [key, ...rest] = path3;
         if (rest.length === 0)
@@ -37160,6 +37695,11 @@ var require_Collection = __commonJS({
         else
           throw new Error(`Expected YAML collection at ${key}. Remaining path: ${rest}`);
       }
+      /**
+       * Returns item at `key`, or `undefined` if not found. By default unwraps
+       * scalar values from their surrounding node; to disable set `keepScalar` to
+       * `true` (collections are always returned intact).
+       */
       getIn(path3, keepScalar) {
         const [key, ...rest] = path3;
         const node = this.get(key, true);
@@ -37176,6 +37716,9 @@ var require_Collection = __commonJS({
           return n == null || allowScalar && Node.isScalar(n) && n.value == null && !n.commentBefore && !n.comment && !n.tag;
         });
       }
+      /**
+       * Checks if the collection includes a value with the key `key`.
+       */
       hasIn(path3) {
         const [key, ...rest] = path3;
         if (rest.length === 0)
@@ -37183,6 +37726,10 @@ var require_Collection = __commonJS({
         const node = this.get(key, true);
         return Node.isCollection(node) ? node.hasIn(rest) : false;
       }
+      /**
+       * Sets a value in this collection. For `!!set`, `value` needs to be a
+       * boolean to add/remove the item from the set.
+       */
       setIn(path3, value) {
         const [key, ...rest] = path3;
         if (rest.length === 0) {
@@ -38187,6 +38734,12 @@ var require_YAMLMap = __commonJS({
       static get tagName() {
         return "tag:yaml.org,2002:map";
       }
+      /**
+       * Adds a value to the collection.
+       *
+       * @param overwrite - If not set `true`, using a key that is already in the
+       *   collection will throw. Otherwise, overwrites the previous value.
+       */
       add(pair, overwrite) {
         var _a;
         let _pair;
@@ -38233,6 +38786,11 @@ var require_YAMLMap = __commonJS({
       set(key, value) {
         this.add(new Pair.Pair(key, value), true);
       }
+      /**
+       * @param ctx - Conversion context, originally set in Document#toJS()
+       * @param {Class} Type - If set, forces the returned collection type
+       * @returns Instance of Type, Map, or Object
+       */
       toJSON(_, ctx, Type) {
         const map = Type ? new Type() : (ctx == null ? void 0 : ctx.mapAsMap) ? /* @__PURE__ */ new Map() : {};
         if (ctx == null ? void 0 : ctx.onCreate)
@@ -38330,6 +38888,14 @@ var require_YAMLSeq = __commonJS({
       add(value) {
         this.items.push(value);
       }
+      /**
+       * Removes a value from the collection.
+       *
+       * `key` must contain a representation of an integer for this to succeed.
+       * It may be wrapped in a `Scalar`.
+       *
+       * @returns `true` if the item was found and removed.
+       */
       delete(key) {
         const idx = asItemIndex(key);
         if (typeof idx !== "number")
@@ -38344,10 +38910,23 @@ var require_YAMLSeq = __commonJS({
         const it = this.items[idx];
         return !keepScalar && Node.isScalar(it) ? it.value : it;
       }
+      /**
+       * Checks if the collection includes a value with the key `key`.
+       *
+       * `key` must contain a representation of an integer for this to succeed.
+       * It may be wrapped in a `Scalar`.
+       */
       has(key) {
         const idx = asItemIndex(key);
         return typeof idx === "number" && idx < this.items.length;
       }
+      /**
+       * Sets a value in this collection. For `!!set`, `value` needs to be a
+       * boolean to add/remove the item from the set.
+       *
+       * If `key` does not contain a representation of an integer, this will throw.
+       * It may be wrapped in a `Scalar`.
+       */
       set(key, value) {
         const idx = asItemIndex(key);
         if (typeof idx !== "number")
@@ -38711,6 +39290,14 @@ var require_binary = __commonJS({
       identify: (value) => value instanceof Uint8Array,
       default: false,
       tag: "tag:yaml.org,2002:binary",
+      /**
+       * Returns a Buffer in node and an Uint8Array in browsers
+       *
+       * To use the resulting buffer as an image, you'll want to do something like:
+       *
+       *   const blob = new Blob([buffer], { type: 'image/jpeg' })
+       *   document.querySelector('#photo').src = URL.createObjectURL(blob)
+       */
       resolve(src, onError) {
         if (typeof Buffer === "function") {
           return Buffer.from(src, "base64");
@@ -38852,6 +39439,10 @@ var require_omap = __commonJS({
         this.set = YAMLMap.YAMLMap.prototype.set.bind(this);
         this.tag = YAMLOMap.tag;
       }
+      /**
+       * If `ctx` is given, the return type is actually `Map<unknown, unknown>`,
+       * but TypeScript won't allow widening the signature of a child method.
+       */
       toJSON(_, ctx) {
         if (!ctx)
           return super.toJSON(_);
@@ -39090,6 +39681,10 @@ var require_set = __commonJS({
         if (!prev)
           this.items.push(pair);
       }
+      /**
+       * If `keepPair` is `true`, returns the Pair matching `key`.
+       * Otherwise, returns the value of that Pair's key.
+       */
       get(key, keepPair) {
         const pair = YAMLMap.findPair(this.items, key);
         return !keepPair && Node.isPair(pair) ? Node.isScalar(pair.key) ? pair.key.value : pair.key : pair;
@@ -39210,6 +39805,9 @@ var require_timestamp = __commonJS({
       identify: (value) => value instanceof Date,
       default: true,
       tag: "tag:yaml.org,2002:timestamp",
+      // If the time zone is omitted, the timestamp is assumed to be specified in UTC. The time part
+      // may be omitted altogether, resulting in a date format. In such a case, the time part is
+      // assumed to be 00:00:00Z (start of day, UTC).
       test: RegExp("^([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})(?:(?:t|T|[ \\t]+)([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2}(\\.[0-9]+)?)(?:[ \\t]*(Z|[-+][012]?[0-9](?::[0-9]{2})?))?)?$"),
       resolve(str) {
         const match = str.match(timestamp.test);
@@ -39578,6 +40176,11 @@ var require_Document = __commonJS({
           this.contents = this.createNode(value, _replacer, options);
         }
       }
+      /**
+       * Create a deep copy of this Document and its contents.
+       *
+       * Custom Node values that inherit from `Object` still refer to their original instances.
+       */
       clone() {
         const copy2 = Object.create(Document.prototype, {
           [Node.NODE_TYPE]: { value: Node.DOC }
@@ -39595,18 +40198,30 @@ var require_Document = __commonJS({
           copy2.range = this.range.slice();
         return copy2;
       }
+      /** Adds a value to the document. */
       add(value) {
         if (assertCollection(this.contents))
           this.contents.add(value);
       }
+      /** Adds a value to the document. */
       addIn(path3, value) {
         if (assertCollection(this.contents))
           this.contents.addIn(path3, value);
       }
+      /**
+       * Create a new `Alias` node, ensuring that the target `node` has the required anchor.
+       *
+       * If `node` already has an anchor, `name` is ignored.
+       * Otherwise, the `node.anchor` value will be set to `name`,
+       * or if an anchor with that name is already present in the document,
+       * `name` will be used as a prefix for a new unique anchor.
+       * If `name` is undefined, the generated anchor will use 'a' as a prefix.
+       */
       createAlias(node, name) {
         if (!node.anchor) {
           const prev = anchors.anchorNames(this);
-          node.anchor = !name || prev.has(name) ? anchors.findNewAnchor(name || "a", prev) : name;
+          node.anchor = // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+          !name || prev.has(name) ? anchors.findNewAnchor(name || "a", prev) : name;
         }
         return new Alias.Alias(node.anchor);
       }
@@ -39628,6 +40243,7 @@ var require_Document = __commonJS({
         const { aliasDuplicateObjects, anchorPrefix, flow, keepUndefined, onTagObj, tag } = options ?? {};
         const { onAnchor, setAnchors, sourceObjects } = anchors.createNodeAnchors(
           this,
+          // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
           anchorPrefix || "a"
         );
         const ctx = {
@@ -39645,14 +40261,26 @@ var require_Document = __commonJS({
         setAnchors();
         return node;
       }
+      /**
+       * Convert a key and a value into a `Pair` using the current schema,
+       * recursively wrapping all values as `Scalar` or `Collection` nodes.
+       */
       createPair(key, value, options = {}) {
         const k = this.createNode(key, null, options);
         const v = this.createNode(value, null, options);
         return new Pair.Pair(k, v);
       }
+      /**
+       * Removes a value from the document.
+       * @returns `true` if the item was found and removed.
+       */
       delete(key) {
         return assertCollection(this.contents) ? this.contents.delete(key) : false;
       }
+      /**
+       * Removes a value from the document.
+       * @returns `true` if the item was found and removed.
+       */
       deleteIn(path3) {
         if (Collection.isEmptyPath(path3)) {
           if (this.contents == null)
@@ -39662,22 +40290,42 @@ var require_Document = __commonJS({
         }
         return assertCollection(this.contents) ? this.contents.deleteIn(path3) : false;
       }
+      /**
+       * Returns item at `key`, or `undefined` if not found. By default unwraps
+       * scalar values from their surrounding node; to disable set `keepScalar` to
+       * `true` (collections are always returned intact).
+       */
       get(key, keepScalar) {
         return Node.isCollection(this.contents) ? this.contents.get(key, keepScalar) : void 0;
       }
+      /**
+       * Returns item at `path`, or `undefined` if not found. By default unwraps
+       * scalar values from their surrounding node; to disable set `keepScalar` to
+       * `true` (collections are always returned intact).
+       */
       getIn(path3, keepScalar) {
         if (Collection.isEmptyPath(path3))
           return !keepScalar && Node.isScalar(this.contents) ? this.contents.value : this.contents;
         return Node.isCollection(this.contents) ? this.contents.getIn(path3, keepScalar) : void 0;
       }
+      /**
+       * Checks if the document includes a value with the key `key`.
+       */
       has(key) {
         return Node.isCollection(this.contents) ? this.contents.has(key) : false;
       }
+      /**
+       * Checks if the document includes a value at `path`.
+       */
       hasIn(path3) {
         if (Collection.isEmptyPath(path3))
           return this.contents !== void 0;
         return Node.isCollection(this.contents) ? this.contents.hasIn(path3) : false;
       }
+      /**
+       * Sets a value in this document. For `!!set`, `value` needs to be a
+       * boolean to add/remove the item from the set.
+       */
       set(key, value) {
         if (this.contents == null) {
           this.contents = Collection.collectionFromPath(this.schema, [key], value);
@@ -39685,6 +40333,10 @@ var require_Document = __commonJS({
           this.contents.set(key, value);
         }
       }
+      /**
+       * Sets a value in this document. For `!!set`, `value` needs to be a
+       * boolean to add/remove the item from the set.
+       */
       setIn(path3, value) {
         if (Collection.isEmptyPath(path3))
           this.contents = value;
@@ -39694,6 +40346,13 @@ var require_Document = __commonJS({
           this.contents.setIn(path3, value);
         }
       }
+      /**
+       * Change the YAML version and schema used by the document.
+       * A `null` version disables support for directives, explicit tags, anchors, and aliases.
+       * It also requires the `schema` option to be given as a `Schema` instance value.
+       *
+       * Overrides all previously set schema options.
+       */
       setSchema(version, options = {}) {
         if (typeof version === "number")
           version = String(version);
@@ -39731,6 +40390,7 @@ var require_Document = __commonJS({
         else
           throw new Error(`With a null YAML version, the { schema: Schema } option is required`);
       }
+      // json & jsonArg are only used from toJSON()
       toJS({ json, jsonArg, mapAsMap, maxAliasCount, onAnchor, reviver } = {}) {
         const ctx = {
           anchors: /* @__PURE__ */ new Map(),
@@ -39747,9 +40407,16 @@ var require_Document = __commonJS({
             onAnchor(res2, count);
         return typeof reviver === "function" ? applyReviver.applyReviver(reviver, { "": res }, "", res) : res;
       }
+      /**
+       * A JSON representation of the document `contents`.
+       *
+       * @param jsonArg Used by `JSON.stringify` to indicate the array index or
+       *   property name.
+       */
       toJSON(jsonArg, onAnchor) {
         return this.toJS({ json: true, jsonArg, mapAsMap: false, onAnchor });
       }
+      /** A YAML representation of the document. */
       toString(options = {}) {
         if (this.errors.length > 0)
           throw new Error("Document with errors cannot be stringified");
@@ -40280,6 +40947,7 @@ var require_resolve_flow_collection = __commonJS({
           if (!isMap && ctx.options.strict && utilContainsNewline.containsNewline(key))
             onError(
               key,
+              // checked by containsNewline()
               "MULTILINE_IMPLICIT_KEY",
               "Implicit keys of flow sequence pairs need to be on a single line"
             );
@@ -41195,6 +41863,11 @@ ${cb}` : comment;
         this.errors = [];
         this.warnings = [];
       }
+      /**
+       * Current stream status information.
+       *
+       * Mostly useful at the end of input for an empty stream.
+       */
       streamInfo() {
         return {
           comment: parsePrelude(this.prelude).comment,
@@ -41203,11 +41876,18 @@ ${cb}` : comment;
           warnings: this.warnings
         };
       }
+      /**
+       * Compose tokens into documents.
+       *
+       * @param forceDoc - If the stream contains no document, still emit a final document including any comments and directives that would be applied to a subsequent document.
+       * @param endOffset - Should be set if `forceDoc` is also set, to set the document range end and to indicate errors correctly.
+       */
       *compose(tokens, forceDoc = false, endOffset = -1) {
         for (const token of tokens)
           yield* this.next(token);
         yield* this.end(forceDoc, endOffset);
       }
+      /** Advance the composer by one CST token. */
       *next(token) {
         if (process.env.LOG_STREAM)
           console.dir(token, { depth: null });
@@ -41269,6 +41949,12 @@ ${end.comment}` : end.comment;
             this.errors.push(new errors.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
         }
       }
+      /**
+       * Call at end of input to yield any remaining document.
+       *
+       * @param forceDoc - If the stream contains no document, still emit a final document including any comments and directives that would be applied to a subsequent document.
+       * @param endOffset - Should be set if `forceDoc` is also set, to set the document range end and to indicate errors correctly.
+       */
       *end(forceDoc = false, endOffset = -1) {
         if (this.doc) {
           this.decorate(this.doc, true);
@@ -41735,6 +42421,12 @@ var require_lexer = __commonJS({
         this.next = null;
         this.pos = 0;
       }
+      /**
+       * Generate YAML tokens from the `source` string. If `incomplete`,
+       * a part of the last line may be left as a buffer for the next call.
+       *
+       * @returns A generator of lexical tokens
+       */
       *lex(source, incomplete = false) {
         if (source) {
           this.buffer = this.buffer ? this.buffer + source : source;
@@ -42378,6 +43070,10 @@ var require_parser = __commonJS({
       }
     }
     var Parser = class {
+      /**
+       * @param onNewLine - If defined, called separately with the start position of
+       *   each new line (in `parse()`, including the start of input).
+       */
       constructor(onNewLine) {
         this.atNewLine = true;
         this.atScalar = false;
@@ -42390,6 +43086,14 @@ var require_parser = __commonJS({
         this.lexer = new lexer.Lexer();
         this.onNewLine = onNewLine;
       }
+      /**
+       * Parse `source` as a YAML stream.
+       * If `incomplete`, a part of the last line may be left as a buffer for the next call.
+       *
+       * Errors are not thrown, but yielded as `{ type: 'error', message }` tokens.
+       *
+       * @returns A generator of tokens representing each directive, document, and other structure.
+       */
       *parse(source, incomplete = false) {
         if (this.onNewLine && this.offset === 0)
           this.onNewLine(0);
@@ -42398,6 +43102,9 @@ var require_parser = __commonJS({
         if (!incomplete)
           yield* this.end();
       }
+      /**
+       * Advance the parser by the `source` of one lexical token.
+       */
       *next(source) {
         this.source = source;
         if (process.env.LOG_TOKENS)
@@ -42446,6 +43153,7 @@ var require_parser = __commonJS({
           this.offset += source.length;
         }
       }
+      /** Call at end of input to push out any remaining constructions */
       *end() {
         while (this.stack.length > 0)
           yield* this.pop();
@@ -43306,6 +44014,7 @@ var wrapAnsi16m = (offset = 0) => (red, green, blue) => `\x1B[${38 + offset};2;$
 var 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],
@@ -43324,9 +44033,12 @@ var styles = {
     magenta: [35, 39],
     cyan: [36, 39],
     white: [37, 39],
+    // Bright color
     blackBright: [90, 39],
     gray: [90, 39],
+    // Alias of `blackBright`
     grey: [90, 39],
+    // Alias of `blackBright`
     redBright: [91, 39],
     greenBright: [92, 39],
     yellowBright: [93, 39],
@@ -43344,9 +44056,12 @@ var styles = {
     bgMagenta: [45, 49],
     bgCyan: [46, 49],
     bgWhite: [47, 49],
+    // Bright color
     bgBlackBright: [100, 49],
     bgGray: [100, 49],
+    // Alias of `bgBlackBright`
     bgGrey: [100, 49],
+    // Alias of `bgBlackBright`
     bgRedBright: [101, 49],
     bgGreenBright: [102, 49],
     bgYellowBright: [103, 49],
@@ -43416,9 +44131,11 @@ function assembleStyles() {
         }
         const integer = Number.parseInt(colorString, 16);
         return [
+          /* eslint-disable no-bitwise */
           integer >> 16 & 255,
           integer >> 8 & 255,
           integer & 255
+          /* eslint-enable no-bitwise */
         ];
       },
       enumerable: false
@@ -44720,7 +45437,7 @@ var globby2 = Object.assign(function globby3(patterns, options) {
 // package.json
 var package_default = {
   name: "create-tamagui",
-  version: "1.1.6",
+  version: "1.1.8",
   bin: "./run.js",
   main: "dist",
   files: [
@@ -44754,7 +45471,7 @@ var package_default = {
   },
   devDependencies: {
     "@playwright/test": "^1.29.0",
-    "@tamagui/build": "^1.1.6",
+    "@tamagui/build": "^1.1.8",
     "@types/async-retry": "1.4.2",
     "@types/cross-spawn": "^6.0.2",
     "@types/node": "^16.11.9",
@@ -44907,7 +45624,10 @@ ${import_chalk4.default.bold(import_chalk4.default.red(`Please pick a different
         } catch {
         }
       }
-      const branch = IS_TEST ? (await $`git rev-parse --abbrev-ref HEAD`).stdout.trim() : `master`;
+      const branch = IS_TEST ? (
+        // use current branch
+        (await $`git rev-parse --abbrev-ref HEAD`).stdout.trim()
+      ) : `master`;
       if (IS_TEST) {
         await (0, import_fs_extra.remove)(targetGitDir);
         if (!await (0, import_fs_extra.pathExists)((0, import_path.join)(repoRoot, ".git"))) {
@@ -45033,48 +45753,68 @@ async function installDependenciesAsync(projectRoot, packageManager2) {
   downloadAndExtractExample,
   installDependenciesAsync
 });
-/*!
- * fill-range <https://github.com/jonschlinkert/fill-range>
- *
- * Copyright (c) 2014-present, Jon Schlinkert.
- * Licensed under the MIT License.
- */
-/*!
- * is-extglob <https://github.com/jonschlinkert/is-extglob>
- *
- * Copyright (c) 2014-2016, Jon Schlinkert.
- * Licensed under the MIT License.
- */
-/*!
- * is-glob <https://github.com/jonschlinkert/is-glob>
- *
- * Copyright (c) 2014-2017, Jon Schlinkert.
- * Released under the MIT License.
- */
-/*!
- * is-number <https://github.com/jonschlinkert/is-number>
- *
- * Copyright (c) 2014-present, Jon Schlinkert.
- * Released under the MIT License.
- */
-/*!
- * to-regex-range <https://github.com/micromatch/to-regex-range>
- *
- * Copyright (c) 2015-present, Jon Schlinkert.
- * Released under the MIT License.
- */
-/*! queue-microtask. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */
-/*! run-parallel. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */
-/*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> */
-/**
- * @preserve
- * JS Implementation of incremental MurmurHash3 (r150) (as of May 10, 2013)
- *
- * @author <a href="mailto:jensyt@gmail.com">Jens Taylor</a>
- * @see http://github.com/homebrewing/brauhaus-diff
- * @author <a href="mailto:gary.court@gmail.com">Gary Court</a>
- * @see http://github.com/garycourt/murmurhash-js
- * @author <a href="mailto:aappleby@gmail.com">Austin Appleby</a>
- * @see http://sites.google.com/site/murmurhash/
- */
+/*! Bundled license information:
+
+imurmurhash/imurmurhash.js:
+  (**
+   * @preserve
+   * JS Implementation of incremental MurmurHash3 (r150) (as of May 10, 2013)
+   *
+   * @author <a href="mailto:jensyt@gmail.com">Jens Taylor</a>
+   * @see http://github.com/homebrewing/brauhaus-diff
+   * @author <a href="mailto:gary.court@gmail.com">Gary Court</a>
+   * @see http://github.com/garycourt/murmurhash-js
+   * @author <a href="mailto:aappleby@gmail.com">Austin Appleby</a>
+   * @see http://sites.google.com/site/murmurhash/
+   *)
+
+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.
+   *)
+
+safe-buffer/index.js:
+  (*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> *)
+
+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.
+   *)
+
+queue-microtask/index.js:
+  (*! queue-microtask. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> *)
+
+run-parallel/index.js:
+  (*! run-parallel. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> *)
+*/
 //# sourceMappingURL=index.js.map