@oscarpalmer/atoms 0.113.0 → 0.114.0

package/dist/atoms.full.js

@@ -810,17 +810,14 @@ const HEX_BLACK = '000000';
 const HEX_WHITE = 'ffffff';
 const LENGTH_LONG = 6;
 const LENGTH_SHORT = 3;
-const KEYS_HSL = new Set([
-    'hue',
-    'lightness',
-    'saturation',
-]);
-const KEYS_HSLA = new Set([...KEYS_HSL, 'alpha']);
-const KEYS_RGB = new Set(['blue', 'green', 'red']);
-const KEYS_RGBA = new Set([...KEYS_RGB, 'alpha']);
+const KEYS_HSL = ['hue', 'saturation', 'lightness'];
+const KEYS_HSLA = [...KEYS_HSL, 'alpha'];
+const KEYS_RGB = ['red', 'green', 'blue'];
+const KEYS_RGBA = [...KEYS_RGB, 'alpha'];
 const MAX_DEGREE = 360;
 const MAX_HEX = 255;
 const MAX_PERCENT = 100;
+//
 // https://www.w3.org/TR/WCAG20/#relativeluminancedef
 const SRGB_LUMINANCE_BLUE = 0.0722;
 const SRGB_LUMINANCE_EXPONENT = 2.4;
@@ -832,6 +829,17 @@ const SRGB_LUMINANCE_OFFSET = 0.055;
 const SRGB_LUMINANCE_RED = 0.2126;
 const SRGB_LUMINANCE_THRESHOLD = 0.625;
 
+function formatColor(space, color, alpha) {
+    const suffix = alpha ? ` / ${color.alpha}` : '';
+    const value = color[space];
+    return `${space}(${join(formattingKeys[space].map(key => value[key]), ' ')}${suffix})`;
+}
+//
+const formattingKeys = {
+    hsl: KEYS_HSL,
+    rgb: KEYS_RGB,
+};
+
 function getAlpha(value) {
     if (typeof value === 'number') {
         return getAlphaFromValue(value);
@@ -1029,12 +1037,12 @@ function isObject(obj, properties) {
     }
     const keys = Object.keys(obj);
     const { length } = keys;
-    if (length !== properties.size) {
+    if (length !== properties.length) {
         return false;
     }
     for (let index = 0; index < length; index += 1) {
         const key = keys[index];
-        if (!(properties.has(key) &&
+        if (!(properties.includes(key) &&
             validators[key](obj[key]))) {
             return false;
         }
@@ -1109,26 +1117,6 @@ function convertRgbToHsla(rgb) {
         saturation: +(saturation * MAX_PERCENT).toFixed(2),
     };
 }
-/**
- * Get the RGBA color from any kind of value
- * @param value Original value
- * @returns RGBA color
- */
-function getRgbaColor(value) {
-    const { alpha, rgb } = getState(value);
-    return {
-        ...rgb,
-        alpha: alpha.value,
-    };
-}
-/**
- * Get the RGB color from any kind of value
- * @param value Original value
- * @returns RGB color
- */
-function getRgbColor(value) {
-    return getState(value).rgb;
-}
 /**
  * Convert an RGB(A) color to a hex color _(with optional alpha channel)_
  * @param rgb RGB(A) color
@@ -1179,14 +1167,6 @@ function convertHexToRgba(value) {
         red: values[0],
     };
 }
-/**
- * Get the hex color from any kind of value
- * @param value Original value
- * @returns Hex color
- */
-function getHexColor(value) {
-    return getState(value).hex;
-}
 /**
  * Get the normalized hex color from a value
  * @param value Value to normalize
@@ -1261,26 +1241,6 @@ function getHexyValue(hue, lightness, saturation, value) {
     const mod = saturation * Math.min(lightness, 1 - lightness);
     return ((lightness - mod * Math.max(-1, Math.min(part - 3, 9 - part, 1))) * MAX_HEX);
 }
-/**
- * Get the HSLA color from any kind of value
- * @param value Original value
- * @returns HSLA color
- */
-function getHslaColor(value) {
-    const { alpha, hsl } = getState(value);
-    return {
-        ...hsl,
-        alpha: alpha.value,
-    };
-}
-/**
- * Get the HSL color from any kind of value
- * @param value Original value
- * @returns HSL color
- */
-function getHslColor(value) {
-    return getState(value).hsl;
-}
 function hslToHex(hsl, alpha) {
     return convertRgbToHex(convertHslToRgba(hsl), alpha ?? false);
 }
@@ -1400,9 +1360,15 @@ function setRGBColor(state, value, alpha) {
 
 class Color {
     #state;
+    /**
+     * Get the alpha channel
+     */
     get alpha() {
         return this.#state.alpha.value;
     }
+    /**
+     * Set the alpha channel
+     */
     set alpha(value) {
         if (typeof value === 'number' && !Number.isNaN(value)) {
             this.#state.alpha = getAlpha(value);
@@ -1492,6 +1458,18 @@ class Color {
             value: true,
         });
     }
+    toHexString(alpha) {
+        return `#${alpha === true ? this.hexa : this.hex}`;
+    }
+    toHslString(alpha) {
+        return formatColor('hsl', this, alpha === true);
+    }
+    toRgbString(alpha) {
+        return formatColor('rgb', this, alpha === true);
+    }
+    toString() {
+        return this.toHexString();
+    }
 }
 
 /**
@@ -1519,9 +1497,66 @@ function getForegroundColor(value) {
     // Rudimentary and ureliable?; implement APCA for more reliable results?
     return new Color(luminance > SRGB_LUMINANCE_THRESHOLD ? HEX_BLACK : HEX_WHITE);
 }
+/**
+ * Get the hex color _(with alpha channel)_ from any kind of value
+ * @param value Original value
+ * @returns Hex color
+ */
+function getHexaColor(value) {
+    const { alpha, hex } = getState(value);
+    return `${hex}${alpha.hex}`;
+}
+/**
+ * Get the hex color from any kind of value
+ * @param value Original value
+ * @returns Hex color
+ */
+function getHexColor(value) {
+    return getState(value).hex;
+}
+/**
+ * Get the HSLA color from any kind of value
+ * @param value Original value
+ * @returns HSLA color
+ */
+function getHslaColor(value) {
+    const { alpha, hsl } = getState(value);
+    return {
+        ...hsl,
+        alpha: alpha.value,
+    };
+}
+/**
+ * Get the HSL color from any kind of value
+ * @param value Original value
+ * @returns HSL color
+ */
+function getHslColor(value) {
+    return getState(value).hsl;
+}
+/**
+ * Get the RGBA color from any kind of value
+ * @param value Original value
+ * @returns RGBA color
+ */
+function getRgbaColor(value) {
+    const { alpha, rgb } = getState(value);
+    return {
+        ...rgb,
+        alpha: alpha.value,
+    };
+}
+/**
+ * Get the RGB color from any kind of value
+ * @param value Original value
+ * @returns RGB color
+ */
+function getRgbColor(value) {
+    return getState(value).rgb;
+}
 
 /**
- * Get a color from any kind of value
+ * Get a Color from any kind of value
  * @param value Original value
  * @returns Color instance
  */
@@ -3259,4 +3294,4 @@ function unsmush(value) {
     return unsmushed;
 }
 
-export { SizedMap, SizedSet, average, between, camelCase, capitalize, chunk, clamp, clone, compact, compare, count, createUuid, debounce, diff, emitter, equal, exists, filter, find, flatten$1 as flatten, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, indexOf, insert, isArrayOrPlainObject, isColor, isEmpty, isHexColor, isHslColor, isHslaColor, isKey, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject$1 as isObject, isPlainObject, isPrimitive, isRgbColor, isRgbaColor, isTypedArray, join, kebabCase, logger, max, memoize, merge, min, noop, parse, partial, pascalCase, push, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, sum, template, throttle, titleCase, toMap, toQuery, toRecord, toSet, truncate, unique, unsmush, words };
+export { SizedMap, SizedSet, average, between, camelCase, capitalize, chunk, clamp, clone, compact, compare, count, createUuid, debounce, diff, emitter, equal, exists, filter, find, flatten$1 as flatten, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, indexOf, insert, isArrayOrPlainObject, isColor, isEmpty, isHexColor, isHslColor, isHslaColor, isKey, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject$1 as isObject, isPlainObject, isPrimitive, isRgbColor, isRgbaColor, isTypedArray, join, kebabCase, logger, max, memoize, merge, min, noop, parse, partial, pascalCase, push, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, sum, template, throttle, titleCase, toMap, toQuery, toRecord, toSet, truncate, unique, unsmush, words };

package/dist/color/constants.js

@@ -24,21 +24,23 @@ const HEX_BLACK = "000000";
 const HEX_WHITE = "ffffff";
 const LENGTH_LONG = 6;
 const LENGTH_SHORT = 3;
-const KEYS_HSL = new Set([
+const KEYS_HSL = [
 	"hue",
-	"lightness",
-	"saturation"
-]);
-const KEYS_HSLA = new Set([...KEYS_HSL, "alpha"]);
-const KEYS_RGB = new Set([
-	"blue",
+	"saturation",
+	"lightness"
+];
+const KEYS_HSLA = [...KEYS_HSL, "alpha"];
+const KEYS_RGB = [
+	"red",
 	"green",
-	"red"
-]);
-const KEYS_RGBA = new Set([...KEYS_RGB, "alpha"]);
+	"blue"
+];
+const KEYS_RGBA = [...KEYS_RGB, "alpha"];
 const MAX_DEGREE = 360;
 const MAX_HEX = 255;
 const MAX_PERCENT = 100;
+const SPACE_HSL = "hsl";
+const SPACE_RGB = "rgb";
 const SRGB_LUMINANCE_BLUE = .0722;
 const SRGB_LUMINANCE_EXPONENT = 2.4;
 const SRGB_LUMINANCE_GREEN = .7152;
@@ -48,4 +50,4 @@ const SRGB_LUMINANCE_MULTIPLIER = 12.92;
 const SRGB_LUMINANCE_OFFSET = .055;
 const SRGB_LUMINANCE_RED = .2126;
 const SRGB_LUMINANCE_THRESHOLD = .625;
-export { ALPHA_FULL_HEX_LONG, ALPHA_FULL_HEX_SHORT, ALPHA_FULL_VALUE, ALPHA_NONE_HEX, ALPHA_NONE_VALUE, DEFAULT_ALPHA, DEFAULT_HSL, DEFAULT_RGB, EXPRESSION_HEX_LONG, EXPRESSION_HEX_SHORT, EXPRESSION_PREFIX, HEX_BLACK, HEX_WHITE, KEYS_HSL, KEYS_HSLA, KEYS_RGB, KEYS_RGBA, LENGTH_LONG, LENGTH_SHORT, MAX_DEGREE, MAX_HEX, MAX_PERCENT, SRGB_LUMINANCE_BLUE, SRGB_LUMINANCE_EXPONENT, SRGB_LUMINANCE_GREEN, SRGB_LUMINANCE_MINIMUM, SRGB_LUMINANCE_MODIFIER, SRGB_LUMINANCE_MULTIPLIER, SRGB_LUMINANCE_OFFSET, SRGB_LUMINANCE_RED, SRGB_LUMINANCE_THRESHOLD };
+export { ALPHA_FULL_HEX_LONG, ALPHA_FULL_HEX_SHORT, ALPHA_FULL_VALUE, ALPHA_NONE_HEX, ALPHA_NONE_VALUE, DEFAULT_ALPHA, DEFAULT_HSL, DEFAULT_RGB, EXPRESSION_HEX_LONG, EXPRESSION_HEX_SHORT, EXPRESSION_PREFIX, HEX_BLACK, HEX_WHITE, KEYS_HSL, KEYS_HSLA, KEYS_RGB, KEYS_RGBA, LENGTH_LONG, LENGTH_SHORT, MAX_DEGREE, MAX_HEX, MAX_PERCENT, SPACE_HSL, SPACE_RGB, SRGB_LUMINANCE_BLUE, SRGB_LUMINANCE_EXPONENT, SRGB_LUMINANCE_GREEN, SRGB_LUMINANCE_MINIMUM, SRGB_LUMINANCE_MODIFIER, SRGB_LUMINANCE_MULTIPLIER, SRGB_LUMINANCE_OFFSET, SRGB_LUMINANCE_RED, SRGB_LUMINANCE_THRESHOLD };

package/dist/color/index.js

@@ -1,10 +1,10 @@
 import { isColor, isHexColor, isHslColor, isHslaColor, isRgbColor, isRgbaColor } from "./misc/is.js";
-import { getRgbColor, getRgbaColor, rgbToHex, rgbToHsl, rgbToHsla } from "./space/rgb.js";
-import { getHexColor, getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba } from "./space/hex.js";
-import { getHslColor, getHslaColor, hslToHex, hslToRgb, hslToRgba } from "./space/hsl.js";
+import { rgbToHex, rgbToHsl, rgbToHsla } from "./space/rgb.js";
+import { getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba } from "./space/hex.js";
+import { hslToHex, hslToRgb, hslToRgba } from "./space/hsl.js";
 import { Color } from "./instance.js";
-import { getForegroundColor } from "./misc/foreground.js";
+import { getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getRgbColor, getRgbaColor } from "./misc/get.js";
 function getColor(value) {
 	return isColor(value) ? value : new Color(value);
 }
-export { getColor, getForegroundColor, getHexColor, getHslColor, getHslaColor, getNormalizedHex, getRgbColor, getRgbaColor, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, isColor, isHexColor, isHslColor, isHslaColor, isRgbColor, isRgbaColor, rgbToHex, rgbToHsl, rgbToHsla };
+export { getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getRgbColor, getRgbaColor, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, isColor, isHexColor, isHslColor, isHslaColor, isRgbColor, isRgbaColor, rgbToHex, rgbToHsl, rgbToHsla };

package/dist/color/instance.js

@@ -1,3 +1,4 @@
+import { formatColor } from "./misc/index.js";
 import { getAlpha } from "./misc/alpha.js";
 import { getState, setHSLColor, setHexColor, setRGBColor } from "./misc/state.js";
 var Color = class {
@@ -54,5 +55,17 @@ var Color = class {
 		this.#state = getState(value);
 		Object.defineProperty(this, "$color", { value: true });
 	}
+	toHexString(alpha) {
+		return `#${alpha === true ? this.hexa : this.hex}`;
+	}
+	toHslString(alpha) {
+		return formatColor("hsl", this, alpha === true);
+	}
+	toRgbString(alpha) {
+		return formatColor("rgb", this, alpha === true);
+	}
+	toString() {
+		return this.toHexString();
+	}
 };
 export { Color };

package/dist/color/misc/alpha.js

@@ -24,4 +24,4 @@ function getAlphaValue(original) {
 	if (original < 0) return 0;
 	return original <= 1 ? original : original / 100;
 }
-export { getAlpha, getAlphaValue };
+export { getAlpha, getAlphaHexadecimal, getAlphaValue };

package/dist/color/misc/{foreground.js → get.js}

@@ -12,4 +12,31 @@ function getForegroundColor(value) {
 	else color = ((color + SRGB_LUMINANCE_OFFSET) / SRGB_LUMINANCE_MODIFIER) ** SRGB_LUMINANCE_EXPONENT;
 	return new Color(.2126 * values[2] + .7152 * values[1] + .0722 * values[0] > .625 ? HEX_BLACK : HEX_WHITE);
 }
-export { getForegroundColor };
+function getHexaColor(value) {
+	const { alpha, hex } = getState(value);
+	return `${hex}${alpha.hex}`;
+}
+function getHexColor(value) {
+	return getState(value).hex;
+}
+function getHslaColor(value) {
+	const { alpha, hsl } = getState(value);
+	return {
+		...hsl,
+		alpha: alpha.value
+	};
+}
+function getHslColor(value) {
+	return getState(value).hsl;
+}
+function getRgbaColor(value) {
+	const { alpha, rgb } = getState(value);
+	return {
+		...rgb,
+		alpha: alpha.value
+	};
+}
+function getRgbColor(value) {
+	return getState(value).rgb;
+}
+export { getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getRgbColor, getRgbaColor };

package/dist/color/misc/index.js

@@ -0,0 +1,12 @@
+import { join } from "../../internal/string.js";
+import { KEYS_HSL, KEYS_RGB } from "../constants.js";
+function formatColor(space, color, alpha) {
+	const suffix = alpha ? ` / ${color.alpha}` : "";
+	const value = color[space];
+	return `${space}(${join(formattingKeys[space].map((key) => value[key]), " ")}${suffix})`;
+}
+var formattingKeys = {
+	hsl: KEYS_HSL,
+	rgb: KEYS_RGB
+};
+export { formatColor };

package/dist/color/misc/is.js

@@ -34,10 +34,10 @@ function isObject(obj, properties) {
 	if (typeof obj !== "object" || obj === null) return false;
 	const keys = Object.keys(obj);
 	const { length } = keys;
-	if (length !== properties.size) return false;
+	if (length !== properties.length) return false;
 	for (let index = 0; index < length; index += 1) {
 		const key = keys[index];
-		if (!(properties.has(key) && validators[key](obj[key]))) return false;
+		if (!(properties.includes(key) && validators[key](obj[key]))) return false;
 	}
 	return true;
 }

package/dist/color/space/hex.js

@@ -2,7 +2,6 @@ import { join } from "../../internal/string.js";
 import { ALPHA_FULL_HEX_LONG, ALPHA_FULL_HEX_SHORT, EXPRESSION_HEX_LONG, EXPRESSION_PREFIX, HEX_BLACK, LENGTH_LONG, LENGTH_SHORT, MAX_HEX } from "../constants.js";
 import { isHexColor } from "../misc/is.js";
 import { convertRgbToHsla } from "./rgb.js";
-import { getState } from "../misc/state.js";
 function convertHexToRgba(value) {
 	const normalized = getNormalizedHex(value, true);
 	const pairs = EXPRESSION_HEX_LONG.exec(normalized);
@@ -16,9 +15,6 @@ function convertHexToRgba(value) {
 		red: values[0]
 	};
 }
-function getHexColor(value) {
-	return getState(value).hex;
-}
 function getNormalizedHex(value, alpha) {
 	const includeAlpha = alpha ?? false;
 	if (!isHexColor(value)) return `${HEX_BLACK}${includeAlpha ? ALPHA_FULL_HEX_LONG : ""}`;
@@ -48,4 +44,4 @@ function hexToRgb(value) {
 function hexToRgba(value) {
 	return convertHexToRgba(value);
 }
-export { getHexColor, getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba };
+export { getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba };

package/dist/color/space/hsl.js

@@ -4,7 +4,6 @@ import { ALPHA_FULL_VALUE, DEFAULT_HSL, MAX_DEGREE, MAX_HEX, MAX_PERCENT } from
 import { getAlphaValue } from "../misc/alpha.js";
 import { isHslColor } from "../misc/is.js";
 import { convertRgbToHex } from "./rgb.js";
-import { getState } from "../misc/state.js";
 function convertHslToRgba(hsl) {
 	const actual = isHslColor(hsl) ? hsl : { ...DEFAULT_HSL };
 	let hue = actual.hue % 360;
@@ -22,16 +21,6 @@ function getHexyValue(hue, lightness, saturation, value) {
 	const part = (value + hue / 30) % 12;
 	return (lightness - saturation * Math.min(lightness, 1 - lightness) * Math.max(-1, Math.min(part - 3, 9 - part, 1))) * 255;
 }
-function getHslaColor(value) {
-	const { alpha, hsl } = getState(value);
-	return {
-		...hsl,
-		alpha: alpha.value
-	};
-}
-function getHslColor(value) {
-	return getState(value).hsl;
-}
 function hslToHex(hsl, alpha) {
 	return convertRgbToHex(convertHslToRgba(hsl), alpha ?? false);
 }
@@ -46,4 +35,4 @@ function hslToRgb(hsl) {
 function hslToRgba(hsl) {
 	return convertHslToRgba(hsl);
 }
-export { getHslColor, getHslaColor, hslToHex, hslToRgb, hslToRgba };
+export { hslToHex, hslToRgb, hslToRgba };

package/dist/color/space/rgb.js

@@ -2,7 +2,6 @@ import { join } from "../../internal/string.js";
 import { ALPHA_FULL_VALUE, DEFAULT_RGB, MAX_DEGREE, MAX_HEX, MAX_PERCENT } from "../constants.js";
 import { getAlpha, getAlphaValue } from "../misc/alpha.js";
 import { isRgbColor } from "../misc/is.js";
-import { getState } from "../misc/state.js";
 function convertRgbToHex(rgb, alpha) {
 	const hex = `${join([
 		rgb.red,
@@ -57,16 +56,6 @@ function convertRgbToHsla(rgb) {
 		saturation: +(saturation * 100).toFixed(2)
 	};
 }
-function getRgbaColor(value) {
-	const { alpha, rgb } = getState(value);
-	return {
-		...rgb,
-		alpha: alpha.value
-	};
-}
-function getRgbColor(value) {
-	return getState(value).rgb;
-}
 function rgbToHex(rgb, alpha) {
 	return convertRgbToHex(isRgbColor(rgb) ? rgb : { ...DEFAULT_RGB }, alpha ?? false);
 }
@@ -81,4 +70,4 @@ function rgbToHsl(rgb) {
 function rgbToHsla(rgb) {
 	return convertRgbToHsla(rgb);
 }
-export { convertRgbToHex, convertRgbToHsla, getRgbColor, getRgbaColor, rgbToHex, rgbToHsl, rgbToHsla };
+export { convertRgbToHex, convertRgbToHsla, rgbToHex, rgbToHsl, rgbToHsla };

package/dist/index.js

@@ -33,10 +33,10 @@ import { toSet } from "./array/to-set.js";
 import { unique } from "./array/unique.js";
 import "./array/index.js";
 import { isColor, isHexColor, isHslColor, isHslaColor, isRgbColor, isRgbaColor } from "./color/misc/is.js";
-import { getRgbColor, getRgbaColor, rgbToHex, rgbToHsl, rgbToHsla } from "./color/space/rgb.js";
-import { getHexColor, getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba } from "./color/space/hex.js";
-import { getHslColor, getHslaColor, hslToHex, hslToRgb, hslToRgba } from "./color/space/hsl.js";
-import { getForegroundColor } from "./color/misc/foreground.js";
+import { rgbToHex, rgbToHsl, rgbToHsla } from "./color/space/rgb.js";
+import { getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba } from "./color/space/hex.js";
+import { hslToHex, hslToRgb, hslToRgba } from "./color/space/hsl.js";
+import { getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getRgbColor, getRgbaColor } from "./color/misc/get.js";
 import { getColor } from "./color/index.js";
 import { emitter } from "./emitter.js";
 import { debounce, memoize, throttle } from "./function.js";
@@ -52,4 +52,4 @@ import { partial } from "./value/partial.js";
 import { smush } from "./value/smush.js";
 import { unsmush } from "./value/unsmush.js";
 import "./value/index.js";
-export { SizedMap, SizedSet, average, between, camelCase, capitalize, chunk, clamp, clone, compact, compare, count, createUuid, debounce, diff, emitter, equal, exists, filter, find, flatten, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, indexOf, insert, isArrayOrPlainObject, isColor, isEmpty, isHexColor, isHslColor, isHslaColor, isKey, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isRgbColor, isRgbaColor, isTypedArray, join, kebabCase, logger, max, memoize, merge, min, noop, parse, partial, pascalCase, push, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, sum, template, throttle, titleCase, toMap, toQuery, toRecord, toSet, truncate, unique, unsmush, words };
+export { SizedMap, SizedSet, average, between, camelCase, capitalize, chunk, clamp, clone, compact, compare, count, createUuid, debounce, diff, emitter, equal, exists, filter, find, flatten, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, indexOf, insert, isArrayOrPlainObject, isColor, isEmpty, isHexColor, isHslColor, isHslaColor, isKey, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isRgbColor, isRgbaColor, isTypedArray, join, kebabCase, logger, max, memoize, merge, min, noop, parse, partial, pascalCase, push, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, sum, template, throttle, titleCase, toMap, toQuery, toRecord, toSet, truncate, unique, unsmush, words };

package/package.json

@@ -101,5 +101,5 @@
 	},
 	"type": "module",
 	"types": "./types/index.d.ts",
-	"version": "0.113.0"
+	"version": "0.114.0"
 }

package/src/color/constants.ts

@@ -1,4 +1,10 @@
-import type {Alpha, ColorProperty, HSLColor, RGBColor} from './models';
+import type {
+	Alpha,
+	ColorProperty,
+	ColorSpace,
+	HSLColor,
+	RGBColor,
+} from './models';
 
 export const ALPHA_FULL_HEX_SHORT = 'f';
 
@@ -42,17 +48,13 @@ export const LENGTH_LONG = 6;
 
 export const LENGTH_SHORT = 3;
 
-export const KEYS_HSL: Set<ColorProperty> = new Set([
-	'hue',
-	'lightness',
-	'saturation',
-]);
+export const KEYS_HSL: ColorProperty[] = ['hue', 'saturation', 'lightness'];
 
-export const KEYS_HSLA: Set<ColorProperty> = new Set([...KEYS_HSL, 'alpha']);
+export const KEYS_HSLA: ColorProperty[] = [...KEYS_HSL, 'alpha'];
 
-export const KEYS_RGB: Set<ColorProperty> = new Set(['blue', 'green', 'red']);
+export const KEYS_RGB: ColorProperty[] = ['red', 'green', 'blue'];
 
-export const KEYS_RGBA: Set<ColorProperty> = new Set([...KEYS_RGB, 'alpha']);
+export const KEYS_RGBA: ColorProperty[] = [...KEYS_RGB, 'alpha'];
 
 export const MAX_DEGREE = 360;
 
@@ -60,6 +62,12 @@ export const MAX_HEX = 255;
 
 export const MAX_PERCENT = 100;
 
+export const SPACE_HSL: ColorSpace = 'hsl';
+
+export const SPACE_RGB: ColorSpace = 'rgb';
+
+//
+
 // https://www.w3.org/TR/WCAG20/#relativeluminancedef
 
 export const SRGB_LUMINANCE_BLUE = 0.0722;

package/src/color/index.ts

@@ -2,11 +2,19 @@ import {Color} from './instance';
 import {isColor} from './misc/is';
 import type {HSLAColor, HSLColor, RGBAColor, RGBColor} from './models';
 
-export * from './misc/foreground';
+export {
+	getForegroundColor,
+	getHexaColor,
+	getHexColor,
+	getHslaColor,
+	getHslColor,
+	getRgbaColor,
+	getRgbColor,
+} from './misc/get';
+
 export * from './misc/is';
 
 export {
-	getHexColor,
 	getNormalizedHex,
 	hexToHsl,
 	hexToHsla,
@@ -15,16 +23,12 @@ export {
 } from './space/hex';
 
 export {
-	getHslaColor,
-	getHslColor,
 	hslToHex,
 	hslToRgb,
 	hslToRgba,
 } from './space/hsl';
 
 export {
-	getRgbaColor,
-	getRgbColor,
 	rgbToHex,
 	rgbToHsl,
 	rgbToHsla,
@@ -33,7 +37,7 @@ export {
 export type {Color, HSLAColor, HSLColor, RGBAColor, RGBColor};
 
 /**
- * Get a color from any kind of value
+ * Get a Color from any kind of value
  * @param value Original value
  * @returns Color instance
  */

package/src/color/instance.ts

@@ -1,3 +1,5 @@
+import {SPACE_HSL, SPACE_RGB} from './constants';
+import {formatColor} from './misc';
 import {getAlpha} from './misc/alpha';
 import {getState, setHexColor, setHSLColor, setRGBColor} from './misc/state';
 import type {
@@ -13,10 +15,16 @@ export class Color {
 
 	readonly #state: ColorState;
 
+	/**
+	 * Get the alpha channel
+	 */
 	get alpha(): number {
 		return this.#state.alpha.value;
 	}
 
+	/**
+	 * Set the alpha channel
+	 */
 	set alpha(value: number) {
 		if (typeof value === 'number' && !Number.isNaN(value)) {
 			this.#state.alpha = getAlpha(value);
@@ -120,4 +128,20 @@ export class Color {
 			value: true,
 		});
 	}
+
+	toHexString(alpha?: boolean): string {
+		return `#${alpha === true ? this.hexa : this.hex}`;
+	}
+
+	toHslString(alpha?: boolean): string {
+		return formatColor('hsl', this, alpha === true);
+	}
+
+	toRgbString(alpha?: boolean): string {
+		return formatColor('rgb', this, alpha === true);
+	}
+
+	toString(): string {
+		return this.toHexString();
+	}
 }

package/src/color/misc/alpha.ts

@@ -24,7 +24,7 @@ export function getAlpha(value: unknown): Alpha {
 	return {...DEFAULT_ALPHA};
 }
 
-function getAlphaHexadecimal(value: number): string {
+export function getAlphaHexadecimal(value: number): string {
 	if (value === ALPHA_NONE_VALUE) {
 		return ALPHA_NONE_HEX;
 	}

package/src/color/misc/get.ts

@@ -0,0 +1,115 @@
+import {
+	HEX_BLACK,
+	HEX_WHITE,
+	MAX_HEX,
+	SRGB_LUMINANCE_BLUE,
+	SRGB_LUMINANCE_EXPONENT,
+	SRGB_LUMINANCE_GREEN,
+	SRGB_LUMINANCE_MINIMUM,
+	SRGB_LUMINANCE_MODIFIER,
+	SRGB_LUMINANCE_MULTIPLIER,
+	SRGB_LUMINANCE_OFFSET,
+	SRGB_LUMINANCE_RED,
+	SRGB_LUMINANCE_THRESHOLD,
+} from '../constants';
+import {Color} from '../instance';
+import type {HSLAColor, HSLColor, RGBAColor, RGBColor} from '../models';
+import {getState} from './state';
+
+/**
+ * Get a foreground color _(usually text)_ based on a background color's luminance
+ * @param value Original value
+ * @returns Foreground color
+ */
+export function getForegroundColor(value: unknown): Color {
+	const state = getState(value);
+	const {blue, green, red} = state.rgb;
+
+	const values = [blue / MAX_HEX, green / MAX_HEX, red / MAX_HEX];
+
+	for (let color of values) {
+		if (color <= SRGB_LUMINANCE_MINIMUM) {
+			color /= SRGB_LUMINANCE_MULTIPLIER;
+		} else {
+			color =
+				((color + SRGB_LUMINANCE_OFFSET) / SRGB_LUMINANCE_MODIFIER) **
+				SRGB_LUMINANCE_EXPONENT;
+		}
+	}
+
+	const luminance =
+		SRGB_LUMINANCE_RED * values[2] +
+		SRGB_LUMINANCE_GREEN * values[1] +
+		SRGB_LUMINANCE_BLUE * values[0];
+
+	// Rudimentary and ureliable?; implement APCA for more reliable results?
+	return new Color(
+		luminance > SRGB_LUMINANCE_THRESHOLD ? HEX_BLACK : HEX_WHITE,
+	);
+}
+
+/**
+ * Get the hex color _(with alpha channel)_ from any kind of value
+ * @param value Original value
+ * @returns Hex color
+ */
+export function getHexaColor(value: unknown): string {
+	const {alpha, hex} = getState(value);
+
+	return `${hex}${alpha.hex}`;
+}
+
+/**
+ * Get the hex color from any kind of value
+ * @param value Original value
+ * @returns Hex color
+ */
+export function getHexColor(value: unknown): string {
+	return getState(value).hex;
+}
+
+/**
+ * Get the HSLA color from any kind of value
+ * @param value Original value
+ * @returns HSLA color
+ */
+export function getHslaColor(value: unknown): HSLAColor {
+	const {alpha, hsl} = getState(value);
+
+	return {
+		...hsl,
+		alpha: alpha.value,
+	};
+}
+
+/**
+ * Get the HSL color from any kind of value
+ * @param value Original value
+ * @returns HSL color
+ */
+export function getHslColor(value: unknown): HSLColor {
+	return getState(value).hsl;
+}
+
+/**
+ * Get the RGBA color from any kind of value
+ * @param value Original value
+ * @returns RGBA color
+ */
+export function getRgbaColor(value: unknown): RGBAColor {
+	const {alpha, rgb} = getState(value);
+
+	return {
+		...rgb,
+		alpha: alpha.value,
+	};
+}
+
+/**
+ * Get the RGB color from any kind of value
+ * @param value Original value
+ * @returns RGB color
+ */
+export function getRgbColor(value: unknown): RGBColor {
+	return getState(value).rgb;
+}

package/src/color/misc/index.ts

@@ -0,0 +1,25 @@
+import {join} from '../../internal/string';
+import {KEYS_HSL, KEYS_RGB} from '../constants';
+import type {Color} from '../instance';
+import type {ColorProperty, ColorSpace} from '../models';
+
+export function formatColor(
+	space: ColorSpace,
+	color: Color,
+	alpha: boolean,
+): string {
+	const suffix = alpha ? ` / ${color.alpha}` : '';
+	const value = color[space];
+
+	return `${space}(${join(
+		formattingKeys[space].map(key => value[key as never]),
+		' ',
+	)}${suffix})`;
+}
+
+//
+
+const formattingKeys: Record<ColorSpace, ColorProperty[]> = {
+	hsl: KEYS_HSL,
+	rgb: KEYS_RGB,
+};

package/src/color/misc/is.ts

@@ -111,7 +111,7 @@ export function isRgbColor(value: unknown): value is RGBColor {
 	return isObject(value, KEYS_RGBA) || isObject(value, KEYS_RGB);
 }
 
-function isObject(obj: unknown, properties: Set<ColorProperty>): boolean {
+function isObject(obj: unknown, properties: ColorProperty[]): boolean {
 	if (typeof obj !== 'object' || obj === null) {
 		return false;
 	}
@@ -119,7 +119,7 @@ function isObject(obj: unknown, properties: Set<ColorProperty>): boolean {
 	const keys = Object.keys(obj);
 	const {length} = keys;
 
-	if (length !== properties.size) {
+	if (length !== properties.length) {
 		return false;
 	}
 
@@ -128,7 +128,7 @@ function isObject(obj: unknown, properties: Set<ColorProperty>): boolean {
 
 		if (
 			!(
-				properties.has(key as never) &&
+				properties.includes(key as never) &&
 				validators[key as ColorProperty]((obj as PlainObject)[key])
 			)
 		) {

package/src/color/models.ts

@@ -32,6 +32,8 @@ export type ColorProperty =
 	| 'red'
 	| 'saturation';
 
+export type ColorSpace = 'hsl' | 'rgb';
+
 export type ColorState = {
 	alpha: Alpha;
 	hex: string;

package/src/color/space/hex.ts

@@ -10,7 +10,6 @@ import {
 	MAX_HEX,
 } from '../constants';
 import {isHexColor} from '../misc/is';
-import {getState} from '../misc/state';
 import type {HSLAColor, HSLColor, RGBAColor, RGBColor} from '../models';
 import {convertRgbToHsla} from './rgb';
 
@@ -33,15 +32,6 @@ function convertHexToRgba(value: string): RGBAColor {
 	};
 }
 
-/**
- * Get the hex color from any kind of value
- * @param value Original value
- * @returns Hex color
- */
-export function getHexColor(value: unknown): string {
-	return getState(value).hex;
-}
-
 /**
  * Get the normalized hex color from a value
  * @param value Value to normalize

package/src/color/space/hsl.ts

@@ -8,7 +8,6 @@ import {
 } from '../constants';
 import {getAlphaValue} from '../misc/alpha';
 import {isHslColor} from '../misc/is';
-import {getState} from '../misc/state';
 import type {HSLAColor, HSLColor, RGBAColor, RGBColor} from '../models';
 import {convertRgbToHex} from './rgb';
 
@@ -58,29 +57,6 @@ function getHexyValue(
 	);
 }
 
-/**
- * Get the HSLA color from any kind of value
- * @param value Original value
- * @returns HSLA color
- */
-export function getHslaColor(value: unknown): HSLAColor {
-	const {alpha, hsl} = getState(value);
-
-	return {
-		...hsl,
-		alpha: alpha.value,
-	};
-}
-
-/**
- * Get the HSL color from any kind of value
- * @param value Original value
- * @returns HSL color
- */
-export function getHslColor(value: unknown): HSLColor {
-	return getState(value).hsl;
-}
-
 export function hslToHex(hsl: HSLAColor | HSLColor, alpha?: boolean): string {
 	return convertRgbToHex(convertHslToRgba(hsl), alpha ?? false);
 }

package/src/color/space/rgb.ts

@@ -8,7 +8,6 @@ import {
 } from '../constants';
 import {getAlpha, getAlphaValue} from '../misc/alpha';
 import {isRgbColor} from '../misc/is';
-import {getState} from '../misc/state';
 import type {HSLAColor, HSLColor, RGBAColor, RGBColor} from '../models';
 
 export function convertRgbToHex(
@@ -92,29 +91,6 @@ export function convertRgbToHsla(rgb: RGBAColor | RGBColor): HSLAColor {
 	};
 }
 
-/**
- * Get the RGBA color from any kind of value
- * @param value Original value
- * @returns RGBA color
- */
-export function getRgbaColor(value: unknown): RGBAColor {
-	const {alpha, rgb} = getState(value);
-
-	return {
-		...rgb,
-		alpha: alpha.value,
-	};
-}
-
-/**
- * Get the RGB color from any kind of value
- * @param value Original value
- * @returns RGB color
- */
-export function getRgbColor(value: unknown): RGBColor {
-	return getState(value).rgb;
-}
-
 /**
  * Convert an RGB(A) color to a hex color _(with optional alpha channel)_
  * @param rgb RGB(A) color

package/types/color/constants.d.ts

@@ -1,4 +1,4 @@
-import type { Alpha, ColorProperty, HSLColor, RGBColor } from './models';
+import type { Alpha, ColorProperty, ColorSpace, HSLColor, RGBColor } from './models';
 export declare const ALPHA_FULL_HEX_SHORT = "f";
 export declare const ALPHA_FULL_HEX_LONG = "ff";
 export declare const ALPHA_FULL_VALUE = 1;
@@ -14,13 +14,15 @@ export declare const HEX_BLACK = "000000";
 export declare const HEX_WHITE = "ffffff";
 export declare const LENGTH_LONG = 6;
 export declare const LENGTH_SHORT = 3;
-export declare const KEYS_HSL: Set<ColorProperty>;
-export declare const KEYS_HSLA: Set<ColorProperty>;
-export declare const KEYS_RGB: Set<ColorProperty>;
-export declare const KEYS_RGBA: Set<ColorProperty>;
+export declare const KEYS_HSL: ColorProperty[];
+export declare const KEYS_HSLA: ColorProperty[];
+export declare const KEYS_RGB: ColorProperty[];
+export declare const KEYS_RGBA: ColorProperty[];
 export declare const MAX_DEGREE = 360;
 export declare const MAX_HEX = 255;
 export declare const MAX_PERCENT = 100;
+export declare const SPACE_HSL: ColorSpace;
+export declare const SPACE_RGB: ColorSpace;
 export declare const SRGB_LUMINANCE_BLUE = 0.0722;
 export declare const SRGB_LUMINANCE_EXPONENT = 2.4;
 export declare const SRGB_LUMINANCE_GREEN = 0.7152;

package/types/color/index.d.ts

@@ -1,13 +1,13 @@
 import { Color } from './instance';
 import type { HSLAColor, HSLColor, RGBAColor, RGBColor } from './models';
-export * from './misc/foreground';
+export { getForegroundColor, getHexaColor, getHexColor, getHslaColor, getHslColor, getRgbaColor, getRgbColor, } from './misc/get';
 export * from './misc/is';
-export { getHexColor, getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba, } from './space/hex';
-export { getHslaColor, getHslColor, hslToHex, hslToRgb, hslToRgba, } from './space/hsl';
-export { getRgbaColor, getRgbColor, rgbToHex, rgbToHsl, rgbToHsla, } from './space/rgb';
+export { getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba, } from './space/hex';
+export { hslToHex, hslToRgb, hslToRgba, } from './space/hsl';
+export { rgbToHex, rgbToHsl, rgbToHsla, } from './space/rgb';
 export type { Color, HSLAColor, HSLColor, RGBAColor, RGBColor };
 /**
- * Get a color from any kind of value
+ * Get a Color from any kind of value
  * @param value Original value
  * @returns Color instance
  */

package/types/color/instance.d.ts

@@ -2,7 +2,13 @@ import type { HSLAColor, HSLColor, RGBAColor, RGBColor } from './models';
 export declare class Color {
     #private;
     private readonly $color;
+    /**
+     * Get the alpha channel
+     */
     get alpha(): number;
+    /**
+     * Set the alpha channel
+     */
     set alpha(value: number);
     /**
      * Get the color as a hex color
@@ -53,4 +59,8 @@ export declare class Color {
      */
     set rgba(value: RGBAColor);
     constructor(value: unknown);
+    toHexString(alpha?: boolean): string;
+    toHslString(alpha?: boolean): string;
+    toRgbString(alpha?: boolean): string;
+    toString(): string;
 }

package/types/color/misc/alpha.d.ts

@@ -1,3 +1,4 @@
 import type { Alpha } from '../models';
 export declare function getAlpha(value: unknown): Alpha;
+export declare function getAlphaHexadecimal(value: number): string;
 export declare function getAlphaValue(original: number): number;

package/types/color/misc/get.d.ts

@@ -0,0 +1,44 @@
+import { Color } from '../instance';
+import type { HSLAColor, HSLColor, RGBAColor, RGBColor } from '../models';
+/**
+ * Get a foreground color _(usually text)_ based on a background color's luminance
+ * @param value Original value
+ * @returns Foreground color
+ */
+export declare function getForegroundColor(value: unknown): Color;
+/**
+ * Get the hex color _(with alpha channel)_ from any kind of value
+ * @param value Original value
+ * @returns Hex color
+ */
+export declare function getHexaColor(value: unknown): string;
+/**
+ * Get the hex color from any kind of value
+ * @param value Original value
+ * @returns Hex color
+ */
+export declare function getHexColor(value: unknown): string;
+/**
+ * Get the HSLA color from any kind of value
+ * @param value Original value
+ * @returns HSLA color
+ */
+export declare function getHslaColor(value: unknown): HSLAColor;
+/**
+ * Get the HSL color from any kind of value
+ * @param value Original value
+ * @returns HSL color
+ */
+export declare function getHslColor(value: unknown): HSLColor;
+/**
+ * Get the RGBA color from any kind of value
+ * @param value Original value
+ * @returns RGBA color
+ */
+export declare function getRgbaColor(value: unknown): RGBAColor;
+/**
+ * Get the RGB color from any kind of value
+ * @param value Original value
+ * @returns RGB color
+ */
+export declare function getRgbColor(value: unknown): RGBColor;

package/types/color/misc/index.d.ts

@@ -0,0 +1,3 @@
+import type { Color } from '../instance';
+import type { ColorSpace } from '../models';
+export declare function formatColor(space: ColorSpace, color: Color, alpha: boolean): string;

package/types/color/models.d.ts

@@ -18,6 +18,7 @@ export type RGBColor = {
     red: number;
 };
 export type ColorProperty = 'alpha' | 'blue' | 'green' | 'hue' | 'lightness' | 'red' | 'saturation';
+export type ColorSpace = 'hsl' | 'rgb';
 export type ColorState = {
     alpha: Alpha;
     hex: string;

package/types/color/space/hex.d.ts

@@ -1,10 +1,4 @@
 import type { HSLAColor, HSLColor, RGBAColor, RGBColor } from '../models';
-/**
- * Get the hex color from any kind of value
- * @param value Original value
- * @returns Hex color
- */
-export declare function getHexColor(value: unknown): string;
 /**
  * Get the normalized hex color from a value
  * @param value Value to normalize

package/types/color/space/hsl.d.ts

@@ -1,16 +1,4 @@
 import type { HSLAColor, HSLColor, RGBAColor, RGBColor } from '../models';
-/**
- * Get the HSLA color from any kind of value
- * @param value Original value
- * @returns HSLA color
- */
-export declare function getHslaColor(value: unknown): HSLAColor;
-/**
- * Get the HSL color from any kind of value
- * @param value Original value
- * @returns HSL color
- */
-export declare function getHslColor(value: unknown): HSLColor;
 export declare function hslToHex(hsl: HSLAColor | HSLColor, alpha?: boolean): string;
 /**
  * Convert an HSL(A) color to an RGB color

package/types/color/space/rgb.d.ts

@@ -1,18 +1,6 @@
 import type { HSLAColor, HSLColor, RGBAColor, RGBColor } from '../models';
 export declare function convertRgbToHex(rgb: RGBAColor | RGBColor, alpha: boolean): string;
 export declare function convertRgbToHsla(rgb: RGBAColor | RGBColor): HSLAColor;
-/**
- * Get the RGBA color from any kind of value
- * @param value Original value
- * @returns RGBA color
- */
-export declare function getRgbaColor(value: unknown): RGBAColor;
-/**
- * Get the RGB color from any kind of value
- * @param value Original value
- * @returns RGB color
- */
-export declare function getRgbColor(value: unknown): RGBColor;
 /**
  * Convert an RGB(A) color to a hex color _(with optional alpha channel)_
  * @param rgb RGB(A) color

package/src/color/misc/foreground.ts

@@ -1,48 +0,0 @@
-import {
-	HEX_BLACK,
-	HEX_WHITE,
-	MAX_HEX,
-	SRGB_LUMINANCE_BLUE,
-	SRGB_LUMINANCE_EXPONENT,
-	SRGB_LUMINANCE_GREEN,
-	SRGB_LUMINANCE_MINIMUM,
-	SRGB_LUMINANCE_MODIFIER,
-	SRGB_LUMINANCE_MULTIPLIER,
-	SRGB_LUMINANCE_OFFSET,
-	SRGB_LUMINANCE_RED,
-	SRGB_LUMINANCE_THRESHOLD,
-} from '../constants';
-import {Color} from '../instance';
-import {getState} from './state';
-
-/**
- * Get a foreground color _(usually text)_ based on a background color's luminance
- * @param value Original value
- * @returns Foreground color
- */
-export function getForegroundColor(value: unknown): Color {
-	const state = getState(value);
-	const {blue, green, red} = state.rgb;
-
-	const values = [blue / MAX_HEX, green / MAX_HEX, red / MAX_HEX];
-
-	for (let color of values) {
-		if (color <= SRGB_LUMINANCE_MINIMUM) {
-			color /= SRGB_LUMINANCE_MULTIPLIER;
-		} else {
-			color =
-				((color + SRGB_LUMINANCE_OFFSET) / SRGB_LUMINANCE_MODIFIER) **
-				SRGB_LUMINANCE_EXPONENT;
-		}
-	}
-
-	const luminance =
-		SRGB_LUMINANCE_RED * values[2] +
-		SRGB_LUMINANCE_GREEN * values[1] +
-		SRGB_LUMINANCE_BLUE * values[0];
-
-	// Rudimentary and ureliable?; implement APCA for more reliable results?
-	return new Color(
-		luminance > SRGB_LUMINANCE_THRESHOLD ? HEX_BLACK : HEX_WHITE,
-	);
-}

package/types/color/misc/foreground.d.ts

@@ -1,7 +0,0 @@
-import { Color } from '../instance';
-/**
- * Get a foreground color _(usually text)_ based on a background color's luminance
- * @param value Original value
- * @returns Foreground color
- */
-export declare function getForegroundColor(value: unknown): Color;