@ztimson/utils 0.23.4 → 0.23.6

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './arg-parser';
 export * from './array';
 export * from './aset';
 export * from './cache';
+export * from './color';
 export * from './csv';
 export * from './files';
 export * from './emitter';

package/dist/index.mjs

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 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.
    *
@@ -19,12 +19,15 @@ const _ArgParser = class _ArgParser {
     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,
@@ -101,21 +104,19 @@ const _ArgParser = class _ArgParser {
     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)) {
@@ -527,6 +528,13 @@ class Cache {
     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 = "~`!@#$%^&*()_-+={[}]|\\:;\"'<,>.?/";
@@ -1691,6 +1699,7 @@ export {
   addUnique,
   adjustedInterval,
   arrayDiff,
+  blackOrWhite,
   caseInsensitiveSort,
   clean,
   dec2Frac,