zarro 1.183.7 → 1.185.0

package/gulp-tasks/modules/parse-flag.js

@@ -0,0 +1,47 @@
+"use strict";
+(function () {
+    const positives = new Set([
+        "yes",
+        "y",
+        "1",
+        "true",
+        "on"
+    ]);
+    const negatives = new Set([
+        "no",
+        "n",
+        "0",
+        "false",
+        "off"
+    ]);
+    function parseFlag(value, fallback) {
+        const lower = (value || "").toLowerCase();
+        if (positives.has(lower)) {
+            return true;
+        }
+        if (negatives.has(lower)) {
+            return false;
+        }
+        if (fallback !== undefined) {
+            return fallback;
+        }
+        const possiblePositives = [];
+        for (const item of positives) {
+            possiblePositives.push(item);
+        }
+        const possibleNegatives = [];
+        for (const item of negatives) {
+            possibleNegatives.push(item);
+        }
+        throw new Error(`${value} is not a valid flag value.
+Try one of:
+  - accepted truthy values:
+    ${possiblePositives.join(", ")}
+  - accepted falsey values:
+    ${possibleNegatives.join(", ")}
+`);
+    }
+    module.exports = {
+        parseFlag
+    };
+})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zarro",
-  "version": "1.183.7",
+  "version": "1.185.0",
   "description": "Some glue to make gulp easier, perhaps even zero- or close-to-zero-conf",
   "bin": {
     "zarro": "index.js"

package/types.d.ts

@@ -546,6 +546,10 @@ declare global {
     open(url: string): Promise<void>;
   }
 
+  interface ParseFlag {
+    parseFlag: (value: string, fallback?: boolean) => boolean;
+  }
+
   type ResolveNugetApiKey = (forSource?: string) => Promise<Optional<string>>;
 
   interface Env