@ztimson/utils 0.23.4 → 0.23.6

package/dist/arg-parser.d.ts

@@ -17,7 +17,6 @@ export declare class ArgParser {
     readonly desc: string;
     readonly argList: (ArgParser | Arg)[];
     readonly examples: string[];
-    static readonly helpArg: Arg;
     commands: ArgParser[];
     args: Arg[];
     flags: Arg[];

package/dist/color.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Determine if either black or white provides more contrast to the provided color
+ * @param {string} background Color to compare against
+ * @return {"white" | "black"} Color with the most contrast
+ */
+export declare function blackOrWhite(background: string): 'white' | 'black';

package/dist/index.cjs

@@ -5,7 +5,7 @@
 var __defNormalProp = (obj, key, value2) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value: value2 }) : obj[key] = value2;
 var __publicField = (obj, key, value2) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value2);
 
-  const _ArgParser = class _ArgParser {
+  class ArgParser {
     /**
      * Create a unix-like argument parser to extract flags from the argument list. Can also create help messages.
      *
@@ -23,12 +23,15 @@ var __publicField = (obj, key, value2) => __defNormalProp(obj, typeof key !== "s
       this.desc = desc;
       this.argList = argList;
       this.examples = examples;
-      this.commands = argList.filter((arg) => arg instanceof _ArgParser);
+      this.commands = argList.filter((arg) => arg instanceof ArgParser);
       this.args = argList.filter((arg) => {
         var _a;
-        return !(arg instanceof _ArgParser) && !((_a = arg.flags) == null ? void 0 : _a.length);
+        return !(arg instanceof ArgParser) && !((_a = arg.flags) == null ? void 0 : _a.length);
       });
-      this.flags = [...argList.filter((arg) => !(arg instanceof _ArgParser) && arg.flags && arg.flags.length), ...this.flags];
+      this.flags = [
+        ...argList.filter((arg) => !(arg instanceof ArgParser) && arg.flags && arg.flags.length),
+        { name: "help", desc: "Display command's help message", flags: ["-h", "--help"], default: false }
+      ];
       this.defaults = argList.reduce((acc, arg) => ({ ...acc, [arg.name]: arg["extras"] ? [] : arg.default ?? null }), {});
       this.examples = [
         ...examples,
@@ -105,21 +108,19 @@ var __publicField = (obj, key, value2) => __defNormalProp(obj, typeof key !== "s
       let msg = `
 
 ${opts.message || this.desc}`;
-      msg += "\n\nUsage:	" + this.examples.map((ex) => `run ${this.name} ${ex}`).join("\n		");
-      if (this.args.length) msg += "\n\n		" + this.args.map((arg) => `${arg.name.toUpperCase()}${spacer(arg.name)}${arg.desc}`).join("\n		");
-      msg += "\n\nOptions:\n		" + this.flags.map((flag) => {
+      msg += "\n\nUsage:	" + this.examples.map((ex) => `${this.name} ${ex}`).join("\n	");
+      if (this.args.length) msg += "\n\n	" + this.args.map((arg) => `${arg.name.toUpperCase()}${spacer(arg.name)}${arg.desc}`).join("\n	");
+      msg += "\n\nOptions:\n	" + this.flags.map((flag) => {
         var _a;
         const flags = ((_a = flag.flags) == null ? void 0 : _a.join(", ")) || "";
         return `${flags}${spacer(flags)}${flag.desc}`;
-      }).join("\n		");
-      if (this.commands.length) msg += "\n\nCommands:\n		" + this.commands.map((command) => `${command.name}${spacer(command.name)}${command.desc}`).join("\n		");
+      }).join("\n	");
+      if (this.commands.length) msg += "\n\nCommands:\n	" + this.commands.map((command) => `${command.name}${spacer(command.name)}${command.desc}`).join("\n	");
       return `${msg}
 
 `;
     }
-  };
-  __publicField(_ArgParser, "helpArg", { name: "help", desc: "Display command's help message", flags: ["-h", "--help"], default: false });
-  let ArgParser = _ArgParser;
+  }
   function clean(obj, undefinedOnly = false) {
     if (obj == null) throw new Error("Cannot clean a NULL value");
     if (Array.isArray(obj)) {
@@ -531,6 +532,13 @@ ${opts.message || this.desc}`;
       return this;
     }
   }
+  function blackOrWhite(background) {
+    const exploded = background.match(background.length >= 6 ? /\w\w/g : /\w/g);
+    if (!exploded) return "black";
+    const [r2, g, b2] = exploded.map((hex) => parseInt(hex, 16));
+    const luminance = (0.299 * r2 + 0.587 * g + 0.114 * b2) / 255;
+    return luminance > 0.5 ? "black" : "white";
+  }
   const LETTER_LIST = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
   const NUMBER_LIST = "0123456789";
   const SYMBOL_LIST = "~`!@#$%^&*()_-+={[}]|\\:;\"'<,>.?/";
@@ -1694,6 +1702,7 @@ ${opts.message || this.desc}`;
   exports.addUnique = addUnique;
   exports.adjustedInterval = adjustedInterval;
   exports.arrayDiff = arrayDiff;
+  exports.blackOrWhite = blackOrWhite;
   exports.caseInsensitiveSort = caseInsensitiveSort;
   exports.clean = clean;
   exports.dec2Frac = dec2Frac;