@ztimson/utils 0.23.5 → 0.23.6

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

@@ -532,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 = "~`!@#$%^&*()_-+={[}]|\\:;\"'<,>.?/";
@@ -1695,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;