@knapsack/color-utils 4.70.0--canary.4821.ef34743.0 → 4.70.0--canary.4821.bd63208.0

package/dist/index.js

@@ -1,199 +1,26 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  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
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+'use strict';
 
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  analyzeColor: () => analyzeColor,
-  assertColor: () => assertColor,
-  convertColor: () => convertColor,
-  convertTransparentColorToHex: () => convertTransparentColorToHex,
-  getColorHslInfo: () => getColorHslInfo,
-  getColorLuminosity: () => getColorLuminosity,
-  getColorRgbInfo: () => getColorRgbInfo,
-  hasOpacity: () => hasOpacity,
-  isColor: () => isColor,
-  isColorContrastEnough: () => isColorContrastEnough,
-  isDarkColor: () => isDarkColor,
-  isLightColor: () => isLightColor
-});
-module.exports = __toCommonJS(src_exports);
-var import_color = __toESM(require("color"));
-var import_memoize = __toESM(require("lodash/memoize.js"));
-function roundNumber(value) {
-  return value < 1 ? Number(value.toFixed(2)) : Math.round(value);
-}
-__name(roundNumber, "roundNumber");
-function roundObjectValuesNumber(obj) {
-  return Object.entries(obj).reduce((cur, [key, value]) => {
-    const k = key;
-    cur[k] = roundNumber(value);
-    return cur;
-  }, {});
-}
-__name(roundObjectValuesNumber, "roundObjectValuesNumber");
-function colorAlphaToHex(value) {
-  let val = Math.max(0, value);
-  val = Math.min(val, 255);
-  val = Math.ceil(val);
-  return "0123456789ABCDEF".charAt((val - val % 16) / 16) + "0123456789ABCDEF".charAt(val % 16);
-}
-__name(colorAlphaToHex, "colorAlphaToHex");
-function getColorFormat(color) {
-  if (color.startsWith("#")) return "hex";
-  if (color.startsWith("rgb")) return "rgb";
-  if (color.startsWith("hsl")) return "hsl";
-  return null;
-}
-__name(getColorFormat, "getColorFormat");
-function analyzeColorBase(color) {
-  try {
-    const c = (0, import_color.default)(color);
-    const rgb = c.rgb();
-    const rgbInfo = roundObjectValuesNumber(
-      rgb.object()
-    );
-    const isTransparent = typeof rgbInfo.alpha === "number" && rgbInfo.alpha !== 1;
-    const rgbString = isTransparent ? `rgba(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b}, ${rgbInfo.alpha})` : `rgb(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b})`;
-    const hsl = c.hsl();
-    const hslInfo = roundObjectValuesNumber(
-      hsl.object()
-    );
-    const hslString = isTransparent ? `hsla(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%, ${hslInfo.alpha})` : `hsl(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%)`;
-    let hex = c.hex();
-    if (isTransparent) {
-      hex = `${hex}${colorAlphaToHex(rgbInfo.alpha * 256)}`;
-    }
-    return {
-      original: color,
-      format: getColorFormat(color),
-      rgbInfo,
-      rgbString,
-      hslInfo,
-      hslString,
-      hex,
-      isTransparent,
-      luminosity: c.luminosity(),
-      isDark: c.isDark(),
-      isLight: c.isLight(),
-      color: c
-    };
-  } catch (e) {
-    throw new Error(`Could not analyze the color "${color}" - ${e.message}`);
-  }
-}
-__name(analyzeColorBase, "analyzeColorBase");
-var analyzeColor = (0, import_memoize.default)(analyzeColorBase);
-function isColor(color) {
-  try {
-    analyzeColor(color);
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-__name(isColor, "isColor");
-function assertColor(color) {
-  analyzeColor(color);
-}
-__name(assertColor, "assertColor");
-function getColorRgbInfo(color) {
-  return analyzeColor(color).rgbInfo;
-}
-__name(getColorRgbInfo, "getColorRgbInfo");
-function getColorHslInfo(color) {
-  return analyzeColor(color).hslInfo;
-}
-__name(getColorHslInfo, "getColorHslInfo");
-function hasOpacity(color) {
-  return !analyzeColor(color).isTransparent;
-}
-__name(hasOpacity, "hasOpacity");
-function getColorLuminosity(color) {
-  return analyzeColor(color).luminosity;
-}
-__name(getColorLuminosity, "getColorLuminosity");
-function isDarkColor(color) {
-  return analyzeColor(color).isDark;
-}
-__name(isDarkColor, "isDarkColor");
-function isLightColor(color) {
-  return analyzeColor(color).isLight;
-}
-__name(isLightColor, "isLightColor");
-function convertColor({
-  color,
-  format
-}) {
-  assertColor(color);
-  switch (format) {
-    case "rgb": {
-      const rgb = getColorRgbInfo(color);
-      return (0, import_color.default)(rgb).string();
-    }
-    case "hsl": {
-      const hsl = getColorHslInfo(color);
-      return (0, import_color.default)(hsl).string();
-    }
-    case "hex":
-    default:
-      return (0, import_color.default)(color).hex();
-  }
-}
-__name(convertColor, "convertColor");
-function convertTransparentColorToHex(color) {
-  return analyzeColor(color).hex;
-}
-__name(convertTransparentColorToHex, "convertTransparentColorToHex");
-function isColorContrastEnough({
-  foregroundColor,
-  bgColor
-}) {
-  const f = analyzeColor(foregroundColor);
-  const b = analyzeColor(bgColor);
-  const contrast = f.color.contrast(b.color);
-  return contrast >= 4.5;
-}
-__name(isColorContrastEnough, "isColorContrastEnough");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  analyzeColor,
-  assertColor,
-  convertColor,
-  convertTransparentColorToHex,
-  getColorHslInfo,
-  getColorLuminosity,
-  getColorRgbInfo,
-  hasOpacity,
-  isColor,
-  isColorContrastEnough,
-  isDarkColor,
-  isLightColor
-});
+var l = require('color');
+var m = require('lodash/memoize.js');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var l__default = /*#__PURE__*/_interopDefault(l);
+var m__default = /*#__PURE__*/_interopDefault(m);
+
+var f=Object.defineProperty;var n=(r,t)=>f(r,"name",{value:t,configurable:!0});function p(r){return r<1?Number(r.toFixed(2)):Math.round(r)}n(p,"roundNumber");function c(r){return Object.entries(r).reduce((t,[s,o])=>{let a=s;return t[a]=p(o),t},{})}n(c,"roundObjectValuesNumber");function C(r){let t=Math.max(0,r);return t=Math.min(t,255),t=Math.ceil(t),"0123456789ABCDEF".charAt((t-t%16)/16)+"0123456789ABCDEF".charAt(t%16)}n(C,"colorAlphaToHex");function x(r){return r.startsWith("#")?"hex":r.startsWith("rgb")?"rgb":r.startsWith("hsl")?"hsl":null}n(x,"getColorFormat");function $(r){try{let t=l__default.default(r),s=t.rgb(),o=c(s.object()),a=typeof o.alpha=="number"&&o.alpha!==1,g=a?`rgba(${o.r}, ${o.g}, ${o.b}, ${o.alpha})`:`rgb(${o.r}, ${o.g}, ${o.b})`,b=t.hsl(),i=c(b.object()),h=a?`hsla(${i.h}, ${i.s}%, ${i.l}%, ${i.alpha})`:`hsl(${i.h}, ${i.s}%, ${i.l}%)`,u=t.hex();return a&&(u=`${u}${C(o.alpha*256)}`),{original:r,format:x(r),rgbInfo:o,rgbString:g,hslInfo:i,hslString:h,hex:u,isTransparent:a,luminosity:t.luminosity(),isDark:t.isDark(),isLight:t.isLight(),color:t}}catch(t){throw new Error(`Could not analyze the color "${r}" - ${t.message}`)}}n($,"analyzeColorBase");var e=m__default.default($);function F(r){try{return e(r),!0}catch{return !1}}n(F,"isColor");function y(r){e(r);}n(y,"assertColor");function d(r){return e(r).rgbInfo}n(d,"getColorRgbInfo");function I(r){return e(r).hslInfo}n(I,"getColorHslInfo");function R(r){return !e(r).isTransparent}n(R,"hasOpacity");function D(r){return e(r).luminosity}n(D,"getColorLuminosity");function H(r){return e(r).isDark}n(H,"isDarkColor");function w(r){return e(r).isLight}n(w,"isLightColor");function A({color:r,format:t}){switch(y(r),t){case"rgb":{let s=d(r);return l__default.default(s).string()}case"hsl":{let s=I(r);return l__default.default(s).string()}case"hex":default:return l__default.default(r).hex()}}n(A,"convertColor");function L(r){return e(r).hex}n(L,"convertTransparentColorToHex");function M({foregroundColor:r,bgColor:t}){let s=e(r),o=e(t);return s.color.contrast(o.color)>=4.5}n(M,"isColorContrastEnough");
+
+exports.analyzeColor = e;
+exports.assertColor = y;
+exports.convertColor = A;
+exports.convertTransparentColorToHex = L;
+exports.getColorHslInfo = I;
+exports.getColorLuminosity = D;
+exports.getColorRgbInfo = d;
+exports.hasOpacity = R;
+exports.isColor = F;
+exports.isColorContrastEnough = M;
+exports.isDarkColor = H;
+exports.isLightColor = w;
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import Color from 'color';\nimport loMemo from 'lodash/memoize.js';\n// need to leave this imported even though it doesn't look like it's being used for proper typing of `lodash/memoize`\n\nexport type ColorRgbInfo = {\n  /** From 0 - 255 */\n  r: number;\n  /** From 0 - 255 */\n  g: number;\n  /** From 0 - 255 */\n  b: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorHslInfo = {\n  /** From 0 - 255 */\n  h: number;\n  /** From 0 - 255 */\n  s: number;\n  /** From 0 - 255 */\n  l: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorFormat = 'hex' | 'hsl' | 'rgb';\n\n/**\n * If a number is less than 1, round it to a hundredth (i.e. 0.87), else round to nearest integer.\n */\nfunction roundNumber(value: number): number {\n  return value < 1 ? Number(value.toFixed(2)) : Math.round(value);\n}\n\nfunction roundObjectValuesNumber<Obj extends Record<string, number>>(\n  obj: Obj,\n): Record<keyof Obj, number> {\n  return Object.entries(obj).reduce((cur, [key, value]) => {\n    const k = key as keyof Obj;\n    cur[k] = roundNumber(value);\n    return cur;\n  }, {} as Record<keyof Obj, number>);\n}\n\n/**\n * Convert a transparency to the 7th & 8th character for an 8 digit hex color\n * @link https://gist.github.com/lopspower/03fb1cc0ac9f32ef38f4\n */\nfunction colorAlphaToHex(value: number): string {\n  let val = Math.max(0, value);\n  val = Math.min(val, 255);\n  val = Math.ceil(val);\n  return (\n    '0123456789ABCDEF'.charAt((val - (val % 16)) / 16) +\n    '0123456789ABCDEF'.charAt(val % 16)\n  );\n}\n\nfunction getColorFormat(color: string): ColorFormat | null {\n  if (color.startsWith('#')) return 'hex';\n  if (color.startsWith('rgb')) return 'rgb';\n  if (color.startsWith('hsl')) return 'hsl';\n  return null;\n}\n\nfunction analyzeColorBase(color: string) {\n  try {\n    const c = Color(color);\n    const rgb = c.rgb();\n    const rgbInfo = roundObjectValuesNumber(\n      rgb.object() as unknown as ColorRgbInfo,\n    );\n    const isTransparent =\n      typeof rgbInfo.alpha === 'number' && rgbInfo.alpha !== 1;\n    const rgbString = isTransparent\n      ? `rgba(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b}, ${rgbInfo.alpha})`\n      : `rgb(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b})`;\n    const hsl = c.hsl();\n    const hslInfo = roundObjectValuesNumber(\n      hsl.object() as unknown as ColorHslInfo,\n    );\n    const hslString = isTransparent\n      ? `hsla(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%, ${hslInfo.alpha})`\n      : `hsl(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%)`;\n    let hex = c.hex();\n    if (isTransparent) {\n      // 6 => 8 character transparent hex\n      hex = `${hex}${colorAlphaToHex(rgbInfo.alpha * 256)}`;\n    }\n    return {\n      original: color,\n      format: getColorFormat(color),\n      rgbInfo,\n      rgbString,\n      hslInfo,\n      hslString,\n      hex,\n      isTransparent,\n      luminosity: c.luminosity(),\n      isDark: c.isDark(),\n      isLight: c.isLight(),\n      color: c,\n    };\n  } catch (e) {\n    throw new Error(`Could not analyze the color \"${color}\" - ${e.message}`);\n  }\n}\n\nexport const analyzeColor = loMemo(analyzeColorBase);\n\n/**\n * Is a valid css color\n */\nexport function isColor(color: string): boolean {\n  try {\n    analyzeColor(color);\n    return true;\n  } catch (e) {\n    return false;\n  }\n}\n\nexport function assertColor(color: string): asserts color is string {\n  analyzeColor(color);\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorRgbInfo(color: string): ColorRgbInfo {\n  return analyzeColor(color).rgbInfo;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorHslInfo(color: string): ColorHslInfo {\n  return analyzeColor(color).hslInfo;\n}\n\n/**\n * Has Opacity\n * Returns true if a color has opacity\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function hasOpacity(color: string): boolean {\n  return !analyzeColor(color).isTransparent;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorLuminosity(color: string): number {\n  return analyzeColor(color).luminosity;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"dark\" (ie. you should use a lighter color on top) and false if the color is light.\n */\nexport function isDarkColor(color: string): boolean {\n  return analyzeColor(color).isDark;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"light\" (ie. you should use a darker color on top) and false if the color is dark.\n */\nexport function isLightColor(color: string): boolean {\n  return analyzeColor(color).isLight;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertColor({\n  color,\n  format,\n}: {\n  color: string;\n  format: ColorFormat;\n}): string {\n  assertColor(color);\n  switch (format) {\n    case 'rgb': {\n      const rgb = getColorRgbInfo(color);\n      return Color(rgb).string();\n    }\n    case 'hsl': {\n      const hsl = getColorHslInfo(color);\n      return Color(hsl).string();\n    }\n    case 'hex':\n    default:\n      return Color(color).hex();\n  }\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertTransparentColorToHex(color: string): string {\n  return analyzeColor(color).hex;\n}\n\nconst toPercent = (n: number): string => `${n * 100}%`;\n\n/**\n * Contrast checking.\n *\n * IMPORTANT: CANNOT USE ALPHA CHANNELS IN CONTRAST CALCULATIONS.\n * This can only compare 2 SOLID colors.\n */\nexport function isColorContrastEnough({\n  foregroundColor,\n  bgColor,\n}: {\n  foregroundColor: string;\n  bgColor: string;\n}): boolean {\n  const f = analyzeColor(foregroundColor);\n  const b = analyzeColor(bgColor);\n\n  // https://www.w3.org/TR/WCAG20/#contrast-ratiodef\n  // (L1 + 0.05) / (L2 + 0.05), where\n  // L1 is the relative luminance of the lighter of the colors, and\n  // L2 is the relative luminance of the darker of the colors.\n  const contrast = f.color.contrast(b.color);\n\n  // https://webaim.org/resources/contrastchecker/\n  return contrast >= 4.5;\n}\n"],"mappings":"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","names":["Color","loMemo"]}
+{"version":3,"sources":["../src/index.ts"],"names":["roundNumber","value","__name","roundObjectValuesNumber","obj","cur","key","k","colorAlphaToHex","val","getColorFormat","color","analyzeColorBase","c","Color","rgb","rgbInfo","isTransparent","rgbString","hsl","hslInfo","hslString","hex","e","analyzeColor","loMemo","isColor","assertColor","getColorRgbInfo","getColorHslInfo","hasOpacity","getColorLuminosity","isDarkColor","isLightColor","convertColor","format","convertTransparentColorToHex","isColorContrastEnough","foregroundColor","bgColor","f","b"],"mappings":"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","file":"index.js","sourcesContent":["import Color from 'color';\nimport loMemo from 'lodash/memoize.js';\n// need to leave this imported even though it doesn't look like it's being used for proper typing of `lodash/memoize`\n\nexport type ColorRgbInfo = {\n  /** From 0 - 255 */\n  r: number;\n  /** From 0 - 255 */\n  g: number;\n  /** From 0 - 255 */\n  b: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorHslInfo = {\n  /** From 0 - 255 */\n  h: number;\n  /** From 0 - 255 */\n  s: number;\n  /** From 0 - 255 */\n  l: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorFormat = 'hex' | 'hsl' | 'rgb';\n\n/**\n * If a number is less than 1, round it to a hundredth (i.e. 0.87), else round to nearest integer.\n */\nfunction roundNumber(value: number): number {\n  return value < 1 ? Number(value.toFixed(2)) : Math.round(value);\n}\n\nfunction roundObjectValuesNumber<Obj extends Record<string, number>>(\n  obj: Obj,\n): Record<keyof Obj, number> {\n  return Object.entries(obj).reduce((cur, [key, value]) => {\n    const k = key as keyof Obj;\n    cur[k] = roundNumber(value);\n    return cur;\n  }, {} as Record<keyof Obj, number>);\n}\n\n/**\n * Convert a transparency to the 7th & 8th character for an 8 digit hex color\n * @link https://gist.github.com/lopspower/03fb1cc0ac9f32ef38f4\n */\nfunction colorAlphaToHex(value: number): string {\n  let val = Math.max(0, value);\n  val = Math.min(val, 255);\n  val = Math.ceil(val);\n  return (\n    '0123456789ABCDEF'.charAt((val - (val % 16)) / 16) +\n    '0123456789ABCDEF'.charAt(val % 16)\n  );\n}\n\nfunction getColorFormat(color: string): ColorFormat | null {\n  if (color.startsWith('#')) return 'hex';\n  if (color.startsWith('rgb')) return 'rgb';\n  if (color.startsWith('hsl')) return 'hsl';\n  return null;\n}\n\nfunction analyzeColorBase(color: string) {\n  try {\n    const c = Color(color);\n    const rgb = c.rgb();\n    const rgbInfo = roundObjectValuesNumber(\n      rgb.object() as unknown as ColorRgbInfo,\n    );\n    const isTransparent =\n      typeof rgbInfo.alpha === 'number' && rgbInfo.alpha !== 1;\n    const rgbString = isTransparent\n      ? `rgba(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b}, ${rgbInfo.alpha})`\n      : `rgb(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b})`;\n    const hsl = c.hsl();\n    const hslInfo = roundObjectValuesNumber(\n      hsl.object() as unknown as ColorHslInfo,\n    );\n    const hslString = isTransparent\n      ? `hsla(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%, ${hslInfo.alpha})`\n      : `hsl(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%)`;\n    let hex = c.hex();\n    if (isTransparent) {\n      // 6 => 8 character transparent hex\n      hex = `${hex}${colorAlphaToHex(rgbInfo.alpha * 256)}`;\n    }\n    return {\n      original: color,\n      format: getColorFormat(color),\n      rgbInfo,\n      rgbString,\n      hslInfo,\n      hslString,\n      hex,\n      isTransparent,\n      luminosity: c.luminosity(),\n      isDark: c.isDark(),\n      isLight: c.isLight(),\n      color: c,\n    };\n  } catch (e) {\n    throw new Error(`Could not analyze the color \"${color}\" - ${e.message}`);\n  }\n}\n\nexport const analyzeColor = loMemo(analyzeColorBase);\n\n/**\n * Is a valid css color\n */\nexport function isColor(color: string): boolean {\n  try {\n    analyzeColor(color);\n    return true;\n  } catch (e) {\n    return false;\n  }\n}\n\nexport function assertColor(color: string): asserts color is string {\n  analyzeColor(color);\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorRgbInfo(color: string): ColorRgbInfo {\n  return analyzeColor(color).rgbInfo;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorHslInfo(color: string): ColorHslInfo {\n  return analyzeColor(color).hslInfo;\n}\n\n/**\n * Has Opacity\n * Returns true if a color has opacity\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function hasOpacity(color: string): boolean {\n  return !analyzeColor(color).isTransparent;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorLuminosity(color: string): number {\n  return analyzeColor(color).luminosity;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"dark\" (ie. you should use a lighter color on top) and false if the color is light.\n */\nexport function isDarkColor(color: string): boolean {\n  return analyzeColor(color).isDark;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"light\" (ie. you should use a darker color on top) and false if the color is dark.\n */\nexport function isLightColor(color: string): boolean {\n  return analyzeColor(color).isLight;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertColor({\n  color,\n  format,\n}: {\n  color: string;\n  format: ColorFormat;\n}): string {\n  assertColor(color);\n  switch (format) {\n    case 'rgb': {\n      const rgb = getColorRgbInfo(color);\n      return Color(rgb).string();\n    }\n    case 'hsl': {\n      const hsl = getColorHslInfo(color);\n      return Color(hsl).string();\n    }\n    case 'hex':\n    default:\n      return Color(color).hex();\n  }\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertTransparentColorToHex(color: string): string {\n  return analyzeColor(color).hex;\n}\n\nconst toPercent = (n: number): string => `${n * 100}%`;\n\n/**\n * Contrast checking.\n *\n * IMPORTANT: CANNOT USE ALPHA CHANNELS IN CONTRAST CALCULATIONS.\n * This can only compare 2 SOLID colors.\n */\nexport function isColorContrastEnough({\n  foregroundColor,\n  bgColor,\n}: {\n  foregroundColor: string;\n  bgColor: string;\n}): boolean {\n  const f = analyzeColor(foregroundColor);\n  const b = analyzeColor(bgColor);\n\n  // https://www.w3.org/TR/WCAG20/#contrast-ratiodef\n  // (L1 + 0.05) / (L2 + 0.05), where\n  // L1 is the relative luminance of the lighter of the colors, and\n  // L2 is the relative luminance of the darker of the colors.\n  const contrast = f.color.contrast(b.color);\n\n  // https://webaim.org/resources/contrastchecker/\n  return contrast >= 4.5;\n}\n"]}

package/dist/index.mjs

@@ -1,156 +1,8 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import l from 'color';
+import m from 'lodash/memoize.js';
 
-// src/index.ts
-import Color from "color";
-import loMemo from "lodash/memoize.js";
-function roundNumber(value) {
-  return value < 1 ? Number(value.toFixed(2)) : Math.round(value);
-}
-__name(roundNumber, "roundNumber");
-function roundObjectValuesNumber(obj) {
-  return Object.entries(obj).reduce((cur, [key, value]) => {
-    const k = key;
-    cur[k] = roundNumber(value);
-    return cur;
-  }, {});
-}
-__name(roundObjectValuesNumber, "roundObjectValuesNumber");
-function colorAlphaToHex(value) {
-  let val = Math.max(0, value);
-  val = Math.min(val, 255);
-  val = Math.ceil(val);
-  return "0123456789ABCDEF".charAt((val - val % 16) / 16) + "0123456789ABCDEF".charAt(val % 16);
-}
-__name(colorAlphaToHex, "colorAlphaToHex");
-function getColorFormat(color) {
-  if (color.startsWith("#")) return "hex";
-  if (color.startsWith("rgb")) return "rgb";
-  if (color.startsWith("hsl")) return "hsl";
-  return null;
-}
-__name(getColorFormat, "getColorFormat");
-function analyzeColorBase(color) {
-  try {
-    const c = Color(color);
-    const rgb = c.rgb();
-    const rgbInfo = roundObjectValuesNumber(
-      rgb.object()
-    );
-    const isTransparent = typeof rgbInfo.alpha === "number" && rgbInfo.alpha !== 1;
-    const rgbString = isTransparent ? `rgba(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b}, ${rgbInfo.alpha})` : `rgb(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b})`;
-    const hsl = c.hsl();
-    const hslInfo = roundObjectValuesNumber(
-      hsl.object()
-    );
-    const hslString = isTransparent ? `hsla(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%, ${hslInfo.alpha})` : `hsl(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%)`;
-    let hex = c.hex();
-    if (isTransparent) {
-      hex = `${hex}${colorAlphaToHex(rgbInfo.alpha * 256)}`;
-    }
-    return {
-      original: color,
-      format: getColorFormat(color),
-      rgbInfo,
-      rgbString,
-      hslInfo,
-      hslString,
-      hex,
-      isTransparent,
-      luminosity: c.luminosity(),
-      isDark: c.isDark(),
-      isLight: c.isLight(),
-      color: c
-    };
-  } catch (e) {
-    throw new Error(`Could not analyze the color "${color}" - ${e.message}`);
-  }
-}
-__name(analyzeColorBase, "analyzeColorBase");
-var analyzeColor = loMemo(analyzeColorBase);
-function isColor(color) {
-  try {
-    analyzeColor(color);
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-__name(isColor, "isColor");
-function assertColor(color) {
-  analyzeColor(color);
-}
-__name(assertColor, "assertColor");
-function getColorRgbInfo(color) {
-  return analyzeColor(color).rgbInfo;
-}
-__name(getColorRgbInfo, "getColorRgbInfo");
-function getColorHslInfo(color) {
-  return analyzeColor(color).hslInfo;
-}
-__name(getColorHslInfo, "getColorHslInfo");
-function hasOpacity(color) {
-  return !analyzeColor(color).isTransparent;
-}
-__name(hasOpacity, "hasOpacity");
-function getColorLuminosity(color) {
-  return analyzeColor(color).luminosity;
-}
-__name(getColorLuminosity, "getColorLuminosity");
-function isDarkColor(color) {
-  return analyzeColor(color).isDark;
-}
-__name(isDarkColor, "isDarkColor");
-function isLightColor(color) {
-  return analyzeColor(color).isLight;
-}
-__name(isLightColor, "isLightColor");
-function convertColor({
-  color,
-  format
-}) {
-  assertColor(color);
-  switch (format) {
-    case "rgb": {
-      const rgb = getColorRgbInfo(color);
-      return Color(rgb).string();
-    }
-    case "hsl": {
-      const hsl = getColorHslInfo(color);
-      return Color(hsl).string();
-    }
-    case "hex":
-    default:
-      return Color(color).hex();
-  }
-}
-__name(convertColor, "convertColor");
-function convertTransparentColorToHex(color) {
-  return analyzeColor(color).hex;
-}
-__name(convertTransparentColorToHex, "convertTransparentColorToHex");
-function isColorContrastEnough({
-  foregroundColor,
-  bgColor
-}) {
-  const f = analyzeColor(foregroundColor);
-  const b = analyzeColor(bgColor);
-  const contrast = f.color.contrast(b.color);
-  return contrast >= 4.5;
-}
-__name(isColorContrastEnough, "isColorContrastEnough");
-export {
-  analyzeColor,
-  assertColor,
-  convertColor,
-  convertTransparentColorToHex,
-  getColorHslInfo,
-  getColorLuminosity,
-  getColorRgbInfo,
-  hasOpacity,
-  isColor,
-  isColorContrastEnough,
-  isDarkColor,
-  isLightColor
-};
+var f=Object.defineProperty;var n=(r,t)=>f(r,"name",{value:t,configurable:!0});function p(r){return r<1?Number(r.toFixed(2)):Math.round(r)}n(p,"roundNumber");function c(r){return Object.entries(r).reduce((t,[s,o])=>{let a=s;return t[a]=p(o),t},{})}n(c,"roundObjectValuesNumber");function C(r){let t=Math.max(0,r);return t=Math.min(t,255),t=Math.ceil(t),"0123456789ABCDEF".charAt((t-t%16)/16)+"0123456789ABCDEF".charAt(t%16)}n(C,"colorAlphaToHex");function x(r){return r.startsWith("#")?"hex":r.startsWith("rgb")?"rgb":r.startsWith("hsl")?"hsl":null}n(x,"getColorFormat");function $(r){try{let t=l(r),s=t.rgb(),o=c(s.object()),a=typeof o.alpha=="number"&&o.alpha!==1,g=a?`rgba(${o.r}, ${o.g}, ${o.b}, ${o.alpha})`:`rgb(${o.r}, ${o.g}, ${o.b})`,b=t.hsl(),i=c(b.object()),h=a?`hsla(${i.h}, ${i.s}%, ${i.l}%, ${i.alpha})`:`hsl(${i.h}, ${i.s}%, ${i.l}%)`,u=t.hex();return a&&(u=`${u}${C(o.alpha*256)}`),{original:r,format:x(r),rgbInfo:o,rgbString:g,hslInfo:i,hslString:h,hex:u,isTransparent:a,luminosity:t.luminosity(),isDark:t.isDark(),isLight:t.isLight(),color:t}}catch(t){throw new Error(`Could not analyze the color "${r}" - ${t.message}`)}}n($,"analyzeColorBase");var e=m($);function F(r){try{return e(r),!0}catch{return !1}}n(F,"isColor");function y(r){e(r);}n(y,"assertColor");function d(r){return e(r).rgbInfo}n(d,"getColorRgbInfo");function I(r){return e(r).hslInfo}n(I,"getColorHslInfo");function R(r){return !e(r).isTransparent}n(R,"hasOpacity");function D(r){return e(r).luminosity}n(D,"getColorLuminosity");function H(r){return e(r).isDark}n(H,"isDarkColor");function w(r){return e(r).isLight}n(w,"isLightColor");function A({color:r,format:t}){switch(y(r),t){case"rgb":{let s=d(r);return l(s).string()}case"hsl":{let s=I(r);return l(s).string()}case"hex":default:return l(r).hex()}}n(A,"convertColor");function L(r){return e(r).hex}n(L,"convertTransparentColorToHex");function M({foregroundColor:r,bgColor:t}){let s=e(r),o=e(t);return s.color.contrast(o.color)>=4.5}n(M,"isColorContrastEnough");
+
+export { e as analyzeColor, y as assertColor, A as convertColor, L as convertTransparentColorToHex, I as getColorHslInfo, D as getColorLuminosity, d as getColorRgbInfo, R as hasOpacity, F as isColor, M as isColorContrastEnough, H as isDarkColor, w as isLightColor };
+//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import Color from 'color';\nimport loMemo from 'lodash/memoize.js';\n// need to leave this imported even though it doesn't look like it's being used for proper typing of `lodash/memoize`\n\nexport type ColorRgbInfo = {\n  /** From 0 - 255 */\n  r: number;\n  /** From 0 - 255 */\n  g: number;\n  /** From 0 - 255 */\n  b: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorHslInfo = {\n  /** From 0 - 255 */\n  h: number;\n  /** From 0 - 255 */\n  s: number;\n  /** From 0 - 255 */\n  l: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorFormat = 'hex' | 'hsl' | 'rgb';\n\n/**\n * If a number is less than 1, round it to a hundredth (i.e. 0.87), else round to nearest integer.\n */\nfunction roundNumber(value: number): number {\n  return value < 1 ? Number(value.toFixed(2)) : Math.round(value);\n}\n\nfunction roundObjectValuesNumber<Obj extends Record<string, number>>(\n  obj: Obj,\n): Record<keyof Obj, number> {\n  return Object.entries(obj).reduce((cur, [key, value]) => {\n    const k = key as keyof Obj;\n    cur[k] = roundNumber(value);\n    return cur;\n  }, {} as Record<keyof Obj, number>);\n}\n\n/**\n * Convert a transparency to the 7th & 8th character for an 8 digit hex color\n * @link https://gist.github.com/lopspower/03fb1cc0ac9f32ef38f4\n */\nfunction colorAlphaToHex(value: number): string {\n  let val = Math.max(0, value);\n  val = Math.min(val, 255);\n  val = Math.ceil(val);\n  return (\n    '0123456789ABCDEF'.charAt((val - (val % 16)) / 16) +\n    '0123456789ABCDEF'.charAt(val % 16)\n  );\n}\n\nfunction getColorFormat(color: string): ColorFormat | null {\n  if (color.startsWith('#')) return 'hex';\n  if (color.startsWith('rgb')) return 'rgb';\n  if (color.startsWith('hsl')) return 'hsl';\n  return null;\n}\n\nfunction analyzeColorBase(color: string) {\n  try {\n    const c = Color(color);\n    const rgb = c.rgb();\n    const rgbInfo = roundObjectValuesNumber(\n      rgb.object() as unknown as ColorRgbInfo,\n    );\n    const isTransparent =\n      typeof rgbInfo.alpha === 'number' && rgbInfo.alpha !== 1;\n    const rgbString = isTransparent\n      ? `rgba(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b}, ${rgbInfo.alpha})`\n      : `rgb(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b})`;\n    const hsl = c.hsl();\n    const hslInfo = roundObjectValuesNumber(\n      hsl.object() as unknown as ColorHslInfo,\n    );\n    const hslString = isTransparent\n      ? `hsla(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%, ${hslInfo.alpha})`\n      : `hsl(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%)`;\n    let hex = c.hex();\n    if (isTransparent) {\n      // 6 => 8 character transparent hex\n      hex = `${hex}${colorAlphaToHex(rgbInfo.alpha * 256)}`;\n    }\n    return {\n      original: color,\n      format: getColorFormat(color),\n      rgbInfo,\n      rgbString,\n      hslInfo,\n      hslString,\n      hex,\n      isTransparent,\n      luminosity: c.luminosity(),\n      isDark: c.isDark(),\n      isLight: c.isLight(),\n      color: c,\n    };\n  } catch (e) {\n    throw new Error(`Could not analyze the color \"${color}\" - ${e.message}`);\n  }\n}\n\nexport const analyzeColor = loMemo(analyzeColorBase);\n\n/**\n * Is a valid css color\n */\nexport function isColor(color: string): boolean {\n  try {\n    analyzeColor(color);\n    return true;\n  } catch (e) {\n    return false;\n  }\n}\n\nexport function assertColor(color: string): asserts color is string {\n  analyzeColor(color);\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorRgbInfo(color: string): ColorRgbInfo {\n  return analyzeColor(color).rgbInfo;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorHslInfo(color: string): ColorHslInfo {\n  return analyzeColor(color).hslInfo;\n}\n\n/**\n * Has Opacity\n * Returns true if a color has opacity\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function hasOpacity(color: string): boolean {\n  return !analyzeColor(color).isTransparent;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorLuminosity(color: string): number {\n  return analyzeColor(color).luminosity;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"dark\" (ie. you should use a lighter color on top) and false if the color is light.\n */\nexport function isDarkColor(color: string): boolean {\n  return analyzeColor(color).isDark;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"light\" (ie. you should use a darker color on top) and false if the color is dark.\n */\nexport function isLightColor(color: string): boolean {\n  return analyzeColor(color).isLight;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertColor({\n  color,\n  format,\n}: {\n  color: string;\n  format: ColorFormat;\n}): string {\n  assertColor(color);\n  switch (format) {\n    case 'rgb': {\n      const rgb = getColorRgbInfo(color);\n      return Color(rgb).string();\n    }\n    case 'hsl': {\n      const hsl = getColorHslInfo(color);\n      return Color(hsl).string();\n    }\n    case 'hex':\n    default:\n      return Color(color).hex();\n  }\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertTransparentColorToHex(color: string): string {\n  return analyzeColor(color).hex;\n}\n\nconst toPercent = (n: number): string => `${n * 100}%`;\n\n/**\n * Contrast checking.\n *\n * IMPORTANT: CANNOT USE ALPHA CHANNELS IN CONTRAST CALCULATIONS.\n * This can only compare 2 SOLID colors.\n */\nexport function isColorContrastEnough({\n  foregroundColor,\n  bgColor,\n}: {\n  foregroundColor: string;\n  bgColor: string;\n}): boolean {\n  const f = analyzeColor(foregroundColor);\n  const b = analyzeColor(bgColor);\n\n  // https://www.w3.org/TR/WCAG20/#contrast-ratiodef\n  // (L1 + 0.05) / (L2 + 0.05), where\n  // L1 is the relative luminance of the lighter of the colors, and\n  // L2 is the relative luminance of the darker of the colors.\n  const contrast = f.color.contrast(b.color);\n\n  // https://webaim.org/resources/contrastchecker/\n  return contrast >= 4.5;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"names":["roundNumber","value","__name","roundObjectValuesNumber","obj","cur","key","k","colorAlphaToHex","val","getColorFormat","color","analyzeColorBase","c","Color","rgb","rgbInfo","isTransparent","rgbString","hsl","hslInfo","hslString","hex","e","analyzeColor","loMemo","isColor","assertColor","getColorRgbInfo","getColorHslInfo","hasOpacity","getColorLuminosity","isDarkColor","isLightColor","convertColor","format","convertTransparentColorToHex","isColorContrastEnough","foregroundColor","bgColor","f","b"],"mappings":"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","file":"index.mjs","sourcesContent":["import Color from 'color';\nimport loMemo from 'lodash/memoize.js';\n// need to leave this imported even though it doesn't look like it's being used for proper typing of `lodash/memoize`\n\nexport type ColorRgbInfo = {\n  /** From 0 - 255 */\n  r: number;\n  /** From 0 - 255 */\n  g: number;\n  /** From 0 - 255 */\n  b: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorHslInfo = {\n  /** From 0 - 255 */\n  h: number;\n  /** From 0 - 255 */\n  s: number;\n  /** From 0 - 255 */\n  l: number;\n  /** From 0 - 1 */\n  alpha?: number;\n};\n\nexport type ColorFormat = 'hex' | 'hsl' | 'rgb';\n\n/**\n * If a number is less than 1, round it to a hundredth (i.e. 0.87), else round to nearest integer.\n */\nfunction roundNumber(value: number): number {\n  return value < 1 ? Number(value.toFixed(2)) : Math.round(value);\n}\n\nfunction roundObjectValuesNumber<Obj extends Record<string, number>>(\n  obj: Obj,\n): Record<keyof Obj, number> {\n  return Object.entries(obj).reduce((cur, [key, value]) => {\n    const k = key as keyof Obj;\n    cur[k] = roundNumber(value);\n    return cur;\n  }, {} as Record<keyof Obj, number>);\n}\n\n/**\n * Convert a transparency to the 7th & 8th character for an 8 digit hex color\n * @link https://gist.github.com/lopspower/03fb1cc0ac9f32ef38f4\n */\nfunction colorAlphaToHex(value: number): string {\n  let val = Math.max(0, value);\n  val = Math.min(val, 255);\n  val = Math.ceil(val);\n  return (\n    '0123456789ABCDEF'.charAt((val - (val % 16)) / 16) +\n    '0123456789ABCDEF'.charAt(val % 16)\n  );\n}\n\nfunction getColorFormat(color: string): ColorFormat | null {\n  if (color.startsWith('#')) return 'hex';\n  if (color.startsWith('rgb')) return 'rgb';\n  if (color.startsWith('hsl')) return 'hsl';\n  return null;\n}\n\nfunction analyzeColorBase(color: string) {\n  try {\n    const c = Color(color);\n    const rgb = c.rgb();\n    const rgbInfo = roundObjectValuesNumber(\n      rgb.object() as unknown as ColorRgbInfo,\n    );\n    const isTransparent =\n      typeof rgbInfo.alpha === 'number' && rgbInfo.alpha !== 1;\n    const rgbString = isTransparent\n      ? `rgba(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b}, ${rgbInfo.alpha})`\n      : `rgb(${rgbInfo.r}, ${rgbInfo.g}, ${rgbInfo.b})`;\n    const hsl = c.hsl();\n    const hslInfo = roundObjectValuesNumber(\n      hsl.object() as unknown as ColorHslInfo,\n    );\n    const hslString = isTransparent\n      ? `hsla(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%, ${hslInfo.alpha})`\n      : `hsl(${hslInfo.h}, ${hslInfo.s}%, ${hslInfo.l}%)`;\n    let hex = c.hex();\n    if (isTransparent) {\n      // 6 => 8 character transparent hex\n      hex = `${hex}${colorAlphaToHex(rgbInfo.alpha * 256)}`;\n    }\n    return {\n      original: color,\n      format: getColorFormat(color),\n      rgbInfo,\n      rgbString,\n      hslInfo,\n      hslString,\n      hex,\n      isTransparent,\n      luminosity: c.luminosity(),\n      isDark: c.isDark(),\n      isLight: c.isLight(),\n      color: c,\n    };\n  } catch (e) {\n    throw new Error(`Could not analyze the color \"${color}\" - ${e.message}`);\n  }\n}\n\nexport const analyzeColor = loMemo(analyzeColorBase);\n\n/**\n * Is a valid css color\n */\nexport function isColor(color: string): boolean {\n  try {\n    analyzeColor(color);\n    return true;\n  } catch (e) {\n    return false;\n  }\n}\n\nexport function assertColor(color: string): asserts color is string {\n  analyzeColor(color);\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorRgbInfo(color: string): ColorRgbInfo {\n  return analyzeColor(color).rgbInfo;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorHslInfo(color: string): ColorHslInfo {\n  return analyzeColor(color).hslInfo;\n}\n\n/**\n * Has Opacity\n * Returns true if a color has opacity\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function hasOpacity(color: string): boolean {\n  return !analyzeColor(color).isTransparent;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function getColorLuminosity(color: string): number {\n  return analyzeColor(color).luminosity;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"dark\" (ie. you should use a lighter color on top) and false if the color is light.\n */\nexport function isDarkColor(color: string): boolean {\n  return analyzeColor(color).isDark;\n}\n\n/**\n * Color Contrast\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n * @param color - color value to check. supports any number of formats (hex, rgb, hsl, etc)\n * @returns {boolean} - true if the color is \"light\" (ie. you should use a darker color on top) and false if the color is dark.\n */\nexport function isLightColor(color: string): boolean {\n  return analyzeColor(color).isLight;\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertColor({\n  color,\n  format,\n}: {\n  color: string;\n  format: ColorFormat;\n}): string {\n  assertColor(color);\n  switch (format) {\n    case 'rgb': {\n      const rgb = getColorRgbInfo(color);\n      return Color(rgb).string();\n    }\n    case 'hsl': {\n      const hsl = getColorHslInfo(color);\n      return Color(hsl).string();\n    }\n    case 'hex':\n    default:\n      return Color(color).hex();\n  }\n}\n\n/**\n * @deprecated - use `analyzeColor`\n * @see analyzeColor\n */\nexport function convertTransparentColorToHex(color: string): string {\n  return analyzeColor(color).hex;\n}\n\nconst toPercent = (n: number): string => `${n * 100}%`;\n\n/**\n * Contrast checking.\n *\n * IMPORTANT: CANNOT USE ALPHA CHANNELS IN CONTRAST CALCULATIONS.\n * This can only compare 2 SOLID colors.\n */\nexport function isColorContrastEnough({\n  foregroundColor,\n  bgColor,\n}: {\n  foregroundColor: string;\n  bgColor: string;\n}): boolean {\n  const f = analyzeColor(foregroundColor);\n  const b = analyzeColor(bgColor);\n\n  // https://www.w3.org/TR/WCAG20/#contrast-ratiodef\n  // (L1 + 0.05) / (L2 + 0.05), where\n  // L1 is the relative luminance of the lighter of the colors, and\n  // L2 is the relative luminance of the darker of the colors.\n  const contrast = f.color.contrast(b.color);\n\n  // https://webaim.org/resources/contrastchecker/\n  return contrast >= 4.5;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@knapsack/color-utils",
   "description": "",
-  "version": "4.70.0--canary.4821.ef34743.0",
+  "version": "4.70.0--canary.4821.bd63208.0",
   "source": "src/index.ts",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -29,9 +29,9 @@
     "lodash": "^4.17.21"
   },
   "devDependencies": {
-    "@knapsack/eslint-config-starter": "4.70.0--canary.4821.ef34743.0",
-    "@knapsack/test-ava": "4.70.0--canary.4821.ef34743.0",
-    "@knapsack/typescript-config-starter": "4.70.0--canary.4821.ef34743.0",
+    "@knapsack/eslint-config-starter": "4.70.0--canary.4821.bd63208.0",
+    "@knapsack/test-ava": "4.70.0--canary.4821.bd63208.0",
+    "@knapsack/typescript-config-starter": "4.70.0--canary.4821.bd63208.0",
     "@types/color": "^3.0.6",
     "ava": "^6.1.3",
     "eslint": "^8.57.0",
@@ -46,5 +46,5 @@
     "directory": "libs/color-utils",
     "type": "git"
   },
-  "gitHead": "ef34743371e8e5d6c05f0f3dac6cd756c9ebb078"
+  "gitHead": "bd6320889f9e7ea11ea57943e22d8da2493ff786"
 }