@oscarpalmer/atoms 0.190.0 → 0.191.0

package/dist/index.mjs

@@ -4014,38 +4014,6 @@ const NAME_OBSERVABLE = "observable";
 const NAME_SUBSCRIPTION = "subscription";
 const TYPE_ERROR = "error";
 const TYPE_NEXT = "next";
-//#endregion
-//#region src/color/misc/index.ts
-function formatHslColor(state, alpha) {
-	const { hue, lightness, saturation } = state.hsl;
-	return `hsl(${hue}deg ${saturation}% ${lightness}%${alpha ? ` / ${state.alpha.value}%` : ""})`;
-}
-function formatHwbColor(state, alpha) {
-	const { blackness, hue, whiteness } = state.hwb;
-	return `hwb(${hue}deg ${whiteness}% ${blackness}%${alpha ? ` / ${state.alpha.value}%` : ""})`;
-}
-function formatRgbColor(state, alpha) {
-	const { blue, green, red } = state.rgb;
-	return `rgb(${red} ${green} ${blue}${alpha ? ` / ${state.alpha.value}%` : ""})`;
-}
-//#endregion
-//#region src/internal/math/misc.ts
-/**
-* Round a number
-*
-* @param value Number to round
-* @param decimals Number of decimal places to round to _(defaults to `0`)_
-* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
-*/
-function round(value, decimals) {
-	return roundNumber(Math.round, value, decimals);
-}
-function roundNumber(callback, value, decimals) {
-	if (typeof value !== "number") return NaN;
-	if (typeof decimals !== "number" || decimals < 1) return callback(value);
-	const mod = 10 ** decimals;
-	return callback((value + Number.EPSILON) * mod) / mod;
-}
 const ALPHA_FULL_HEX_LONG = `ff`;
 const DEFAULT_ALPHA = {
 	hex: ALPHA_FULL_HEX_LONG,
@@ -4066,6 +4034,7 @@ const DEFAULT_RGB = {
 	green: 0,
 	red: 0
 };
+const EXPRESSION_ALPHA_HEX = /^([a-f0-9]{1,2})$/i;
 const EXPRESSION_HEX_LONG = /^#?([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})?$/i;
 const EXPRESSION_HEX_SHORT = /^#?([a-f0-9]{3,4})$/i;
 const EXPRESSION_PREFIX = /^#/;
@@ -4089,24 +4058,44 @@ const KEYS_RGB = [
 	"blue"
 ];
 const KEYS_RGBA = [...KEYS_RGB, "alpha"];
+const PROPERTY_COLOR = "$color";
 const SRGB_LUMINANCE_EXPONENT = 2.4;
 const SRGB_LUMINANCE_MODIFIER = 1.055;
 const SRGB_LUMINANCE_MULTIPLIER = 12.92;
 const SRGB_LUMINANCE_OFFSET = .055;
 //#endregion
+//#region src/internal/math/misc.ts
+/**
+* Round a number
+*
+* @param value Number to round
+* @param decimals Number of decimal places to round to _(defaults to `0`)_
+* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
+*/
+function round(value, decimals) {
+	return roundNumber(Math.round, value, decimals);
+}
+function roundNumber(callback, value, decimals) {
+	if (typeof value !== "number") return NaN;
+	if (typeof decimals !== "number" || decimals < 1) return callback(value);
+	const mod = 10 ** decimals;
+	return callback((value + Number.EPSILON) * mod) / mod;
+}
+//#endregion
 //#region src/color/misc/alpha.ts
-function getAlpha(value) {
+function getAlpha(value, hex) {
 	if (typeof value === "number") return getAlphaFromValue(value);
-	if (typeof value === "string" && value !== ALPHA_FULL_HEX_LONG) return {
+	if (typeof value !== "string" || value.toLowerCase() === ALPHA_FULL_HEX_LONG) return { ...DEFAULT_ALPHA };
+	if (hex && EXPRESSION_ALPHA_HEX.test(value)) return {
 		hex: value,
 		value: Number.parseInt(value, 16) / 255
 	};
-	return { ...DEFAULT_ALPHA };
+	return getAlphaFromValue(Number.parseFloat(value));
 }
 function getAlphaHexadecimal(value) {
 	if (value === 0) return "00";
 	if (value === 100) return ALPHA_FULL_HEX_LONG;
-	return round(value * 255).toString(16);
+	return round(value / 100 * 255).toString(16);
 }
 function getAlphaFromValue(value) {
 	const alpha = getAlphaValue(value);
@@ -4116,8 +4105,8 @@ function getAlphaFromValue(value) {
 	};
 }
 function getAlphaValue(original) {
-	if (Number.isNaN(original) || original >= 100) return 100;
-	return original <= 0 ? 0 : original;
+	if (Number.isNaN(original)) return 100;
+	return clamp(original, 0, 100);
 }
 //#endregion
 //#region src/color/misc/get.ts
@@ -4125,7 +4114,7 @@ function getClampedValue(value, minimum, maximum, rounding) {
 	return typeof value === "number" && !Number.isNaN(value) ? clamp(rounding ?? false ? round(value) : value, minimum, maximum) : minimum;
 }
 function getForegroundColor(value, hex) {
-	const { blue, green, red } = getColorState(value).rgb;
+	const { blue, green, red } = getColorFromState(getColorState(value), "rgb");
 	const values = [
 		blue / 255,
 		green / 255,
@@ -4163,7 +4152,7 @@ function getHexaColor(value) {
 * @returns Hex color string
 */
 function getHexColor(value) {
-	return getColorState(value).hex;
+	return getColorFromState(getColorState(value), "hex");
 }
 function getHexValue(value) {
 	return getClampedValue(value, 0, 255, true);
@@ -4181,10 +4170,10 @@ function getDegrees(value) {
 * @returns _HSLA_ color
 */
 function getHslaColor(value) {
-	const { alpha, hsl } = getColorState(value);
+	const state = getColorState(value);
 	return {
-		...hsl,
-		alpha: alpha.value
+		...getColorFromState(state, "hsl"),
+		alpha: state.alpha.value
 	};
 }
 /**
@@ -4197,7 +4186,7 @@ function getHslaColor(value) {
 * @returns _HWB_ color
 */
 function getHwbColor(value) {
-	return getColorState(value).hwb;
+	return getColorFromState(getColorState(value), "hwb");
 }
 /**
 * Get the _HWBA_ color from any kind of value
@@ -4209,10 +4198,10 @@ function getHwbColor(value) {
 * @returns _HWBA_ color
 */
 function getHwbaColor(value) {
-	const { alpha, hwb } = getColorState(value);
+	const state = getColorState(value);
 	return {
-		...hwb,
-		alpha: alpha.value
+		...getColorFromState(state, "hwb"),
+		alpha: state.alpha.value
 	};
 }
 /**
@@ -4225,7 +4214,7 @@ function getHwbaColor(value) {
 * @returns _HSL_ color
 */
 function getHslColor(value) {
-	return getColorState(value).hsl;
+	return getColorFromState(getColorState(value), "hsl");
 }
 function getPercentage(value) {
 	return getClampedValue(value, 0, 100);
@@ -4240,10 +4229,10 @@ function getPercentage(value) {
 * @returns _RGBA_ color
 */
 function getRgbaColor(value) {
-	const { alpha, rgb } = getColorState(value);
+	const state = getColorState(value);
 	return {
-		...rgb,
-		alpha: alpha.value
+		...getColorFromState(state, "rgb"),
+		alpha: state.alpha.value
 	};
 }
 /**
@@ -4256,7 +4245,7 @@ function getRgbaColor(value) {
 * @returns _RGB_ color
 */
 function getRgbColor(value) {
-	return getColorState(value).rgb;
+	return getColorFromState(getColorState(value), "rgb");
 }
 //#endregion
 //#region src/color/misc/is.ts
@@ -4276,7 +4265,7 @@ function isBytey(value) {
 * @returns `true` if the value is a _Color_, otherwise `false`
 */
 function isColor(value) {
-	return typeof value === "object" && value !== null && "$color" in value && value.$color === true;
+	return typeof value === "object" && value !== null && "$color" in value && value["$color"] === true;
 }
 function isColorValue(obj, properties) {
 	if (typeof obj !== "object" || obj === null) return false;
@@ -4335,12 +4324,6 @@ function isHslaColor(value) {
 function isHslColor(value) {
 	return isColorValue(value, KEYS_HSLA) || isColorValue(value, KEYS_HSL);
 }
-/**
-* Is the value like an _HSL_ color?
-*
-* @param value Value to check
-* @returns `true` if the value is like an _HSL_ color, otherwise `false`
-*/
 function isHslLike(value) {
 	return hasKeys(value, KEYS_HSL);
 }
@@ -4354,15 +4337,6 @@ function isHwbaColor(value) {
 	return isColorValue(value, KEYS_HWBA);
 }
 /**
-* Is the value like an _HWBA_ color?
-*
-* @param value Value to check
-* @returns `true` if the value is like an _HWBA_ color, otherwise `false`
-*/
-function isHwbaLike(value) {
-	return hasKeys(value, KEYS_HWBA);
-}
-/**
 * Is the value an _HWB_ color?
 *
 * @param value Value to check
@@ -4371,12 +4345,6 @@ function isHwbaLike(value) {
 function isHwbColor(value) {
 	return isColorValue(value, KEYS_HWB) || isColorValue(value, KEYS_HWBA);
 }
-/**
-* Is the value like an _HWB_ color?
-*
-* @param value Value to check
-* @returns `true` if the value is like an _HWB_ color, otherwise `false`
-*/
 function isHwbLike(value) {
 	return hasKeys(value, KEYS_HWB);
 }
@@ -4398,12 +4366,6 @@ function isRgbaColor(value) {
 function isRgbColor(value) {
 	return isColorValue(value, KEYS_RGBA) || isColorValue(value, KEYS_RGB);
 }
-/**
-* Is the value like an _RGB_ color?
-*
-* @param value Value to check
-* @returns `true` if the value is like an _RGB_ color, otherwise `false`
-*/
 function isRgbLike(value) {
 	return hasKeys(value, KEYS_RGB);
 }
@@ -4433,7 +4395,7 @@ function convertRgbToHex(rgb, alpha) {
 		return hexString.length === 1 ? `0${hexString}` : hexString;
 	}))}`;
 	let a = "";
-	if (typeof alpha === "boolean" && alpha) a = getAlpha(rgb.alpha).hex;
+	if (typeof alpha === "boolean" && alpha) a = getAlpha(rgb.alpha, false).hex;
 	return `${hex}${a}`;
 }
 function convertRgbToHsla(value) {
@@ -4469,6 +4431,18 @@ function convertRgbToHwba(value) {
 		alpha: getAlphaValue(value?.alpha ?? 100)
 	};
 }
+function getColorFromRgb(state, type) {
+	switch (type) {
+		case "hex":
+			state.hex = rgbToHex(state.rgb);
+			break;
+		case "hsl":
+			state.hsl = rgbToHsl(state.rgb);
+			break;
+		case "hwb": state.hwb = rgbToHwb(state.rgb);
+	}
+	return state[type];
+}
 function getRgbHue(values) {
 	const { blue, delta, green, max, red } = values;
 	switch (max) {
@@ -4588,6 +4562,18 @@ function convertHexToRgba(value) {
 		red: getHexValue(values[0])
 	};
 }
+function getColorFromHex(state, type) {
+	switch (type) {
+		case "hsl":
+			state.hsl ??= hexToHsl(state.hex);
+			break;
+		case "hwb":
+			state.hwb ??= hexToHwb(state.hex);
+			break;
+		case "rgb": state.rgb ??= hexToRgb(state.hex);
+	}
+	return state[type];
+}
 /**
 * Get the normalized hex color from a value
 *
@@ -4714,6 +4700,18 @@ function convertHslToRgba(input) {
 		red: getHexValue(getHexyValue(hue, lightness, saturation, 0))
 	};
 }
+function getColorFromHsl(state, type) {
+	switch (type) {
+		case "hex":
+			state.hex = hslToHex(state.hsl);
+			break;
+		case "hwb":
+			state.hwb = hslToHwb(state.hsl);
+			break;
+		case "rgb": state.rgb = hslToRgb(state.hsl);
+	}
+	return state[type];
+}
 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;
@@ -4814,6 +4812,18 @@ function convertHwbToHsl(input) {
 		alpha: getAlphaValue(input?.alpha ?? 100)
 	};
 }
+function getColorFromHwb(state, type) {
+	switch (type) {
+		case "hex":
+			state.hex = hwbToHex(state.hwb);
+			break;
+		case "hsl":
+			state.hsl = hwbToHsl(state.hwb);
+			break;
+		case "rgb": state.rgb = hwbToRgb(state.hwb);
+	}
+	return state[type];
+}
 function getHwbSaturation(blackness, whiteness, lightness) {
 	const hue = 1 - blackness - whiteness;
 	if (hue <= 0) return 0;
@@ -4889,115 +4899,118 @@ function hwbToRgba(hwb) {
 }
 //#endregion
 //#region src/color/misc/state.ts
+function getColorFromState(state, type) {
+	const { origin } = state;
+	if (type === origin) return state[origin];
+	return state[type] ?? getters[origin](state, type);
+}
 function getColorState(value) {
 	if (typeof value === "string") return getColorStateForHex(value);
-	if (isColor(value)) return {
-		hex: value.hex,
-		hsl: value.hsl,
-		hwb: value.hwb,
-		rgb: value.rgb,
-		alpha: getAlpha(value.alpha)
-	};
-	const state = {};
+	if (isColor(value)) {
+		const { origin } = value;
+		return {
+			origin,
+			[origin]: value[origin],
+			alpha: getAlpha(value.alpha, false)
+		};
+	}
 	if (typeof value === "object" && value !== null) {
-		state.alpha = getAlpha(value.alpha);
-		if (KEYS_HSL.every((key) => key in value)) return getColorStateForHsl(state, value);
-		if (KEYS_HWB.every((key) => key in value)) return getColorStateForHwb(state, value);
-		if (KEYS_RGB.every((key) => key in value)) return getColorStateForRgb(state, value);
+		const state = {
+			alpha: getAlpha(value.alpha, false),
+			origin: void 0
+		};
+		if (KEYS_HSL.every((key) => key in value)) {
+			state.hsl = getHslValue(value);
+			state.origin = "hsl";
+		} else if (KEYS_HWB.every((key) => key in value)) {
+			state.hwb = getHwbValue(value);
+			state.origin = "hwb";
+		} else if (KEYS_RGB.every((key) => key in value)) {
+			state.rgb = getRgbValue(value);
+			state.origin = "rgb";
+		}
+		if (state.origin != null) return state;
 	}
-	return getDefaultColorState(state);
+	return getDefaultColorState();
 }
 function getColorStateForHex(value) {
 	const normalized = getNormalizedHex(value, true);
-	const hex = normalized.slice(0, 6);
-	const hsl = hexToHsl(hex);
 	return {
-		hex,
-		hsl,
-		alpha: getAlpha(normalized.slice(6)),
-		hwb: hslToHwb(hsl),
-		rgb: hslToRgb(hsl)
+		hex: normalized.slice(0, 6),
+		alpha: getAlpha(normalized.slice(6), true),
+		origin: "hex"
 	};
 }
-function getColorStateForHsl(state, value) {
-	state.hsl = getHslValue(value);
-	state.rgb = hslToRgb(state.hsl);
-	state.hex = hslToHex(state.hsl);
-	state.hwb = hslToHwb(state.hsl);
-	return state;
-}
-function getColorStateForHwb(state, value) {
-	state.hwb = getHwbValue(value);
-	state.hsl = hwbToHsl(state.hwb);
-	state.rgb = hwbToRgb(state.hwb);
-	state.hex = hwbToHex(state.hwb);
-	return state;
-}
-function getColorStateForRgb(state, value) {
-	state.rgb = getRgbValue(value);
-	state.hex = rgbToHex(state.rgb);
-	state.hsl = rgbToHsl(state.rgb);
-	state.hwb = rgbToHwb(state.rgb);
-	return state;
-}
-function getDefaultColorState(state) {
-	state.alpha = getAlpha(100);
-	state.hex = HEX_BLACK;
-	state.hsl = { ...DEFAULT_HSL };
-	state.hwb = { ...DEFAULT_HWB };
-	state.rgb = { ...DEFAULT_RGB };
-	return state;
+function getDefaultColorState() {
+	return {
+		alpha: getAlpha(100, false),
+		hex: HEX_BLACK,
+		hsl: { ...DEFAULT_HSL },
+		hwb: { ...DEFAULT_HWB },
+		rgb: { ...DEFAULT_RGB },
+		origin: "hex"
+	};
+}
+function setColorValue(state, type, value, alpha) {
+	state.hex = void 0;
+	state.hsl = void 0;
+	state.hwb = void 0;
+	state.rgb = void 0;
+	state.origin = type;
+	state[type] = value;
+	if (alpha != null) state.alpha = getAlpha(alpha, type === "hex");
 }
 function setHexColor(state, value, alpha) {
 	if (!isHexColor(value) || !alpha && value === state.hex) return;
 	const normalized = getNormalizedHex(value, true);
-	const hex = normalized.slice(0, 6);
-	const hsl = hexToHsl(hex);
-	state.hex = hex;
-	state.hsl = hsl;
-	state.rgb = hslToRgb(hsl);
-	state.hwb = hslToHwb(hsl);
-	if (alpha) state.alpha = getAlpha(normalized.slice(6));
+	setColorValue(state, "hex", normalized.slice(0, 6), alpha ? normalized.slice(6) : void 0);
 }
 function setHSLColor(state, value, alpha) {
 	if (!isHslLike(value)) return;
-	const hsl = {
+	setColorValue(state, "hsl", {
 		hue: getDegrees(value.hue),
 		saturation: getPercentage(value.saturation),
 		lightness: getPercentage(value.lightness)
-	};
-	state.hsl = hsl;
-	state.hex = hslToHex(hsl);
-	state.hwb = hslToHwb(hsl);
-	state.rgb = hslToRgb(hsl);
-	if (alpha) state.alpha = getAlpha(value.alpha);
+	}, alpha ? value.alpha : void 0);
 }
 function setHWBColor(state, value, alpha) {
 	if (!isHwbLike(value)) return;
-	const hwb = {
+	setColorValue(state, "hwb", {
 		hue: getDegrees(value.hue),
 		whiteness: getPercentage(value.whiteness),
 		blackness: getPercentage(value.blackness)
-	};
-	state.hwb = hwb;
-	state.hex = hwbToHex(hwb);
-	state.hsl = hwbToHsl(hwb);
-	state.rgb = hwbToRgb(hwb);
-	if (alpha) state.alpha = getAlpha(value.alpha);
+	}, alpha ? value.alpha : void 0);
 }
 function setRGBColor(state, value, alpha) {
 	if (!isRgbLike(value)) return;
-	const rgb = {
-		blue: getHexValue(value.blue),
+	setColorValue(state, "rgb", {
+		red: getHexValue(value.red),
 		green: getHexValue(value.green),
-		red: getHexValue(value.red)
-	};
-	const hsl = rgbToHsl(rgb);
-	state.hsl = hsl;
-	state.rgb = rgb;
-	state.hex = hslToHex(hsl);
-	state.hwb = hslToHwb(hsl);
-	if (alpha) state.alpha = getAlpha(value.alpha);
+		blue: getHexValue(value.blue)
+	}, alpha ? value.alpha : void 0);
+}
+const getters = {
+	hex: getColorFromHex,
+	hsl: getColorFromHsl,
+	hwb: getColorFromHwb,
+	rgb: getColorFromRgb
+};
+//#endregion
+//#region src/color/misc/format.ts
+function formatHslColor(state, alpha) {
+	const { hue, lightness, saturation } = getColorFromState(state, "hsl");
+	return `hsl(${hue}deg ${saturation}% ${lightness}%${getSuffix(state, alpha)})`;
+}
+function formatHwbColor(state, alpha) {
+	const { blackness, hue, whiteness } = getColorFromState(state, "hwb");
+	return `hwb(${hue}deg ${whiteness}% ${blackness}%${getSuffix(state, alpha)})`;
+}
+function formatRgbColor(state, alpha) {
+	const { blue, green, red } = getColorFromState(state, "rgb");
+	return `rgb(${red} ${green} ${blue}${getSuffix(state, alpha)})`;
+}
+function getSuffix(state, alpha) {
+	return alpha === true ? ` / ${state.alpha.value}%` : "";
 }
 //#endregion
 //#region src/color/instance.ts
@@ -5005,22 +5018,20 @@ function color(value) {
 	const state = getColorState(value);
 	const instance = {
 		toHexString: (alpha) => `#${alpha === true ? instance.hexa : instance.hex}`,
-		toHslString: (alpha) => formatHslColor(state, alpha === true),
-		toHwbString: (alpha) => formatHwbColor(state, alpha === true),
-		toRgbString: (alpha) => formatRgbColor(state, alpha === true),
+		toHslString: (alpha) => formatHslColor(state, alpha),
+		toHwbString: (alpha) => formatHwbColor(state, alpha),
+		toRgbString: (alpha) => formatRgbColor(state, alpha),
 		toString: () => instance.toHexString()
 	};
 	Object.defineProperties(instance, {
-		$color: {
+		[PROPERTY_COLOR]: {
 			enumerable: false,
-			get: () => true
+			value: true
 		},
 		alpha: {
 			enumerable: true,
 			get: () => state.alpha.value,
-			set: (value) => {
-				if (typeof value === "number" && !Number.isNaN(value)) state.alpha = getAlpha(value);
-			}
+			set: (value) => setAlphaValue(state, value)
 		},
 		hex: getProperty("hex", state, false),
 		hexa: getProperty("hex", state, true),
@@ -5028,31 +5039,34 @@ function color(value) {
 		hsla: getProperty("hsl", state, true),
 		hwb: getProperty("hwb", state, false),
 		hwba: getProperty("hwb", state, true),
+		origin: {
+			enumerable: true,
+			get: () => state.origin
+		},
 		rgb: getProperty("rgb", state, false),
 		rgba: getProperty("rgb", state, true)
 	});
 	return Object.freeze(instance);
 }
-function getHex(state, alpha) {
-	return alpha ? `${state.hex}${state.alpha.hex}` : state.hex;
-}
 function getProperty(space, state, alpha) {
-	const setter = setters[space];
+	const setValue = setters[space];
 	return {
 		enumerable: true,
-		get: () => {
-			const value = state[space];
-			if (typeof value === "string") return getHex(state, alpha);
-			return alpha ? {
-				...value,
-				alpha: state.alpha.value
-			} : { ...value };
-		},
-		set: (value) => {
-			setter(state, value, alpha);
-		}
+		get: () => getValue$1(space, state, alpha),
+		set: (value) => setValue(state, value, alpha)
 	};
 }
+function getValue$1(space, state, alpha) {
+	const value = getColorFromState(state, space);
+	if (typeof value === "string") return alpha ? `${value}${state.alpha.hex}` : value;
+	return alpha ? {
+		...value,
+		alpha: state.alpha.value
+	} : { ...value };
+}
+function setAlphaValue(state, value) {
+	if (typeof value === "number" && !Number.isNaN(value)) state.alpha = getAlpha(value, false);
+}
 const setters = {
 	hex: setHexColor,
 	hsl: setHSLColor,
@@ -6114,4 +6128,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, Logger, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isBeacon, isColor, isConstructor, isEmpty, isError, isEvents, isFrozen, isFulfilled, isHerald, isHexColor, isHslColor, isHslLike, isHslaColor, isHwbColor, isHwbLike, isHwbaColor, isHwbaLike, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isPlainObject, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isSorted, isSubscription, isTimedLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, Logger, PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isBeacon, isColor, isConstructor, isEmpty, isError, isEvents, isFrozen, isFulfilled, isHerald, isHexColor, isHslColor, isHslaColor, isHwbColor, isHwbaColor, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isPlainObject, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbaColor, isSorted, isSubscription, isTimedLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.190.0",
+	"version": "0.191.0",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"helper",
@@ -257,10 +257,10 @@
 		"watch": "npx vite build --watch"
 	},
 	"devDependencies": {
-		"@oxlint/plugins": "^1.78",
+		"@oxlint/plugins": "^1.79",
 		"@types/node": "^26.2",
-		"@vitest/coverage-istanbul": "4.1.10",
-		"eslint": "^10.8",
+		"@vitest/coverage-istanbul": "^4.1",
+		"eslint": "^10.9",
 		"jsdom": "^30",
 		"tsdown": "^0.22",
 		"typescript": "^6",

package/src/color/constants.ts

@@ -33,6 +33,8 @@ export const DEFAULT_RGB: RGBColor = {
 	red: 0,
 };
 
+export const EXPRESSION_ALPHA_HEX = /^([a-f0-9]{1,2})$/i;
+
 export const EXPRESSION_HEX_LONG = /^#?([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})?$/i;
 
 export const EXPRESSION_HEX_SHORT = /^#?([a-f0-9]{3,4})$/i;
@@ -65,6 +67,16 @@ export const MAX_HEX = 255;
 
 export const MAX_PERCENT = 100;
 
+export const PROPERTY_COLOR = '$color';
+
+export const TYPE_HEX = 'hex';
+
+export const TYPE_HSL = 'hsl';
+
+export const TYPE_HWB = 'hwb';
+
+export const TYPE_RGB = 'rgb';
+
 // https://www.w3.org/TR/WCAG20/#relativeluminancedef
 
 export const SRGB_LUMINANCE_BLUE = 0.0722;