@oscarpalmer/atoms 0.188.0 → 0.189.0

package/dist/color/misc/get.d.mts

@@ -1,11 +1,20 @@
-import { HSLAColor, HSLColor, RGBAColor, RGBColor } from "../models.mjs";
+import { HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
 import { Color } from "../instance.mjs";
-
 //#region src/color/misc/get.d.ts
+/**
+ * Get a foreground color _(usually text)_ based on a background color's luminance as an unprefixed hex color string
+ *
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+ * - If the value cannot be parsed, a white foreground color will be returned
+ *
+ * @param value Original value
+ * @returns Foreground color
+ */
+declare function getForegroundColor(value: unknown, hex: true): string;
 /**
  * Get a foreground color _(usually text)_ based on a background color's luminance
  *
- * - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
  * - If the value cannot be parsed, a white foreground color will be returned
  *
  * @param value Original value
@@ -15,8 +24,8 @@ declare function getForegroundColor(value: unknown): Color;
 /**
  * Get the hex color _(with alpha channel, i.e., opacity)_ from any kind of value
  *
- * - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
- * - If the value cannot be parsed, a black hex color with an alpha channel of `0` will be returned
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+ * - If the value cannot be parsed, a black hex color will be returned
  *
  * @param value Original value
  * @returns Hex color string
@@ -25,7 +34,7 @@ declare function getHexaColor(value: unknown): string;
 /**
  * Get the hex color from any kind of value
  *
- * - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
  * - If the value cannot be parsed, a black hex color will be returned
  *
  * @param value Original value
@@ -37,17 +46,37 @@ declare function getDegrees(value: unknown): number;
 /**
  * Get the _HSLA_ color from any kind of value
  *
- * - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
- * - If the value cannot be parsed, a black _HSLA_ color with an alpha channel _(opacity)_ of `0` will be returned
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+ * - If the value cannot be parsed, a black _HSLA_ color will be returned
  *
  * @param value Original value
  * @returns _HSLA_ color
  */
 declare function getHslaColor(value: unknown): HSLAColor;
+/**
+ * Get the _HWB_ color from any kind of value
+ *
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+ * - If the value cannot be parsed, a black _HWB_ color will be returned
+ *
+ * @param value Original value
+ * @returns _HWB_ color
+ */
+declare function getHwbColor(value: unknown): HWBColor;
+/**
+ * Get the _HWBA_ color from any kind of value
+ *
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+ * - If the value cannot be parsed, a black _HWBA_ color will be returned
+ *
+ * @param value Original value
+ * @returns _HWBA_ color
+ */
+declare function getHwbaColor(value: unknown): HWBAColor;
 /**
  * Get the _HSL_ color from any kind of value
  *
- * - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
  * - If the value cannot be parsed, a black _HSL_ color will be returned
  *
  * @param value Original value
@@ -58,8 +87,8 @@ declare function getPercentage(value: unknown): number;
 /**
  * Get the _RGBA_ color from any kind of value
  *
- * - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
- * - If the value cannot be parsed, a black _RGBA_ color with an alpha channel _(opacity)_ of `0` will be returned
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+ * - If the value cannot be parsed, a black _RGBA_ color will be returned
  *
  * @param value Original value
  * @returns _RGBA_ color
@@ -68,7 +97,7 @@ declare function getRgbaColor(value: unknown): RGBAColor;
 /**
  * Get the _RGB_ color from any kind of value
  *
- * - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+ * - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
  * - If the value cannot be parsed, a black _RGB_ color will be returned
  *
  * @param value Original value
@@ -76,4 +105,4 @@ declare function getRgbaColor(value: unknown): RGBAColor;
  */
 declare function getRgbColor(value: unknown): RGBColor;
 //#endregion
-export { getDegrees, getForegroundColor, getHexColor, getHexValue, getHexaColor, getHslColor, getHslaColor, getPercentage, getRgbColor, getRgbaColor };
+export { getDegrees, getForegroundColor, getHexColor, getHexValue, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getPercentage, getRgbColor, getRgbaColor };

package/dist/color/misc/get.mjs

@@ -1,21 +1,13 @@
 import { clamp } from "../../internal/number.mjs";
+import { round } from "../../internal/math/misc.mjs";
 import { HEX_BLACK, HEX_WHITE, SRGB_LUMINANCE_EXPONENT, SRGB_LUMINANCE_MODIFIER, SRGB_LUMINANCE_MULTIPLIER, SRGB_LUMINANCE_OFFSET } from "../constants.mjs";
 import { getColorState } from "./state.mjs";
 import { Color } from "../instance.mjs";
 //#region src/color/misc/get.ts
-function getClampedValue(value, minimum, maximum) {
-	return typeof value === "number" ? clamp(value, minimum, maximum) : minimum;
+function getClampedValue(value, minimum, maximum, rounding) {
+	return typeof value === "number" && !Number.isNaN(value) ? clamp(rounding ?? false ? round(value) : value, minimum, maximum) : minimum;
 }
-/**
-* Get a foreground color _(usually text)_ based on a background color's luminance
-*
-* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
-* - If the value cannot be parsed, a white foreground color will be returned
-*
-* @param value Original value
-* @returns Foreground color
-*/
-function getForegroundColor(value) {
+function getForegroundColor(value, hex) {
 	const { blue, green, red } = getColorState(value).rgb;
 	const values = [
 		blue / 255,
@@ -28,13 +20,14 @@ function getForegroundColor(value) {
 		if (color <= .03928) values[index] /= SRGB_LUMINANCE_MULTIPLIER;
 		else values[index] = ((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);
+	const color = .2126 * values[2] + .7152 * values[1] + .0722 * values[0] > .625 ? HEX_BLACK : HEX_WHITE;
+	return hex === true ? color : new Color(color);
 }
 /**
 * Get the hex color _(with alpha channel, i.e., opacity)_ from any kind of value
 *
-* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
-* - If the value cannot be parsed, a black hex color with an alpha channel of `0` will be returned
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black hex color will be returned
 *
 * @param value Original value
 * @returns Hex color string
@@ -46,7 +39,7 @@ function getHexaColor(value) {
 /**
 * Get the hex color from any kind of value
 *
-* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
 * - If the value cannot be parsed, a black hex color will be returned
 *
 * @param value Original value
@@ -56,7 +49,7 @@ function getHexColor(value) {
 	return getColorState(value).hex;
 }
 function getHexValue(value) {
-	return getClampedValue(value, 0, 255);
+	return getClampedValue(value, 0, 255, true);
 }
 function getDegrees(value) {
 	return getClampedValue(value, 0, 360);
@@ -64,8 +57,8 @@ function getDegrees(value) {
 /**
 * Get the _HSLA_ color from any kind of value
 *
-* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
-* - If the value cannot be parsed, a black _HSLA_ color with an alpha channel _(opacity)_ of `0` will be returned
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _HSLA_ color will be returned
 *
 * @param value Original value
 * @returns _HSLA_ color
@@ -78,9 +71,37 @@ function getHslaColor(value) {
 	};
 }
 /**
+* Get the _HWB_ color from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _HWB_ color will be returned
+*
+* @param value Original value
+* @returns _HWB_ color
+*/
+function getHwbColor(value) {
+	return getColorState(value).hwb;
+}
+/**
+* Get the _HWBA_ color from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _HWBA_ color will be returned
+*
+* @param value Original value
+* @returns _HWBA_ color
+*/
+function getHwbaColor(value) {
+	const { alpha, hwb } = getColorState(value);
+	return {
+		...hwb,
+		alpha: alpha.value
+	};
+}
+/**
 * Get the _HSL_ color from any kind of value
 *
-* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
 * - If the value cannot be parsed, a black _HSL_ color will be returned
 *
 * @param value Original value
@@ -95,8 +116,8 @@ function getPercentage(value) {
 /**
 * Get the _RGBA_ color from any kind of value
 *
-* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
-* - If the value cannot be parsed, a black _RGBA_ color with an alpha channel _(opacity)_ of `0` will be returned
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _RGBA_ color will be returned
 *
 * @param value Original value
 * @returns _RGBA_ color
@@ -111,7 +132,7 @@ function getRgbaColor(value) {
 /**
 * Get the _RGB_ color from any kind of value
 *
-* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - Values that can be parsed are: hex(a) color strings, as well as _HSL(A)_, _HWB(A)_, and _RGB(A)_ color objects
 * - If the value cannot be parsed, a black _RGB_ color will be returned
 *
 * @param value Original value
@@ -121,4 +142,4 @@ function getRgbColor(value) {
 	return getColorState(value).rgb;
 }
 //#endregion
-export { getDegrees, getForegroundColor, getHexColor, getHexValue, getHexaColor, getHslColor, getHslaColor, getPercentage, getRgbColor, getRgbaColor };
+export { getDegrees, getForegroundColor, getHexColor, getHexValue, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getPercentage, getRgbColor, getRgbaColor };

package/dist/color/misc/index.d.mts

@@ -1,7 +1,7 @@
-import { ColorSpace } from "../models.mjs";
 import { Color } from "../instance.mjs";
-
 //#region src/color/misc/index.d.ts
-declare function formatColor(space: ColorSpace, color: Color, alpha: boolean): string;
+declare function formatHslColor(color: Color, alpha: boolean): string;
+declare function formatHwbColor(color: Color, alpha: boolean): string;
+declare function formatRgbColor(color: Color, alpha: boolean): string;
 //#endregion
-export { formatColor };
+export { formatHslColor, formatHwbColor, formatRgbColor };

package/dist/color/misc/index.mjs

@@ -1,15 +1,15 @@
-import { join } from "../../internal/string.mjs";
-import { KEYS_HSL, KEYS_RGB } from "../constants.mjs";
 //#region src/color/misc/index.ts
-function formatColor(space, color, alpha) {
-	const suffix = alpha ? ` / ${color.alpha}` : "";
-	const value = color[space];
-	return `${space}(${join(keys[space].map((key) => value[key]), SPACE)}${suffix})`;
+function formatHslColor(color, alpha) {
+	const { hue, lightness, saturation } = color.hsl;
+	return `hsl(${hue}deg ${saturation}% ${lightness}%${alpha ? ` / ${color.alpha}%` : ""})`;
+}
+function formatHwbColor(color, alpha) {
+	const { blackness, hue, whiteness } = color.hwb;
+	return `hwb(${hue}deg ${whiteness}% ${blackness}%${alpha ? ` / ${color.alpha}%` : ""})`;
+}
+function formatRgbColor(color, alpha) {
+	const { blue, green, red } = color.rgb;
+	return `rgb(${red} ${green} ${blue}${alpha ? ` / ${color.alpha}%` : ""})`;
 }
-const SPACE = " ";
-const keys = {
-	hsl: KEYS_HSL,
-	rgb: KEYS_RGB
-};
 //#endregion
-export { formatColor };
+export { formatHslColor, formatHwbColor, formatRgbColor };

package/dist/color/misc/is.d.mts

@@ -1,6 +1,5 @@
-import { HSLAColor, HSLColor, RGBAColor, RGBColor } from "../models.mjs";
+import { HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
 import { Color } from "../instance.mjs";
-
 //#region src/color/misc/is.d.ts
 /**
  * Is the value a _Color_?
@@ -33,6 +32,13 @@ declare function isHexColor(value: unknown, alpha?: boolean): value is string;
  * @returns `true` if the value is an _HSLA_ color, otherwise `false`
  */
 declare function isHslaColor(value: unknown): value is HSLAColor;
+/**
+ * Is the value like an _HSLA_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is like an _HSLA_ color, otherwise `false`
+ */
+declare function isHslaLike(value: unknown): value is Record<keyof HSLAColor, unknown>;
 /**
  * Is the value an _HSL_ color?
  *
@@ -40,7 +46,41 @@ declare function isHslaColor(value: unknown): value is HSLAColor;
  * @returns `true` if the value is an _HSL_ color, otherwise `false`
  */
 declare function isHslColor(value: unknown): value is HSLColor;
+/**
+ * Is the value like an _HSL_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is like an _HSL_ color, otherwise `false`
+ */
 declare function isHslLike(value: unknown): value is Record<keyof HSLColor, unknown>;
+/**
+ * Is the value an _HWBA_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is an _HWBA_ color, otherwise `false`
+ */
+declare function isHwbaColor(value: unknown): value is HWBAColor;
+/**
+ * Is the value like an _HWBA_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is like an _HWBA_ color, otherwise `false`
+ */
+declare function isHwbaLike(value: unknown): value is Record<keyof HWBAColor, unknown>;
+/**
+ * Is the value an _HWB_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is an _HWB_ color, otherwise `false`
+ */
+declare function isHwbColor(value: unknown): value is HWBColor;
+/**
+ * Is the value like an _HWB_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is like an _HWB_ color, otherwise `false`
+ */
+declare function isHwbLike(value: unknown): value is Record<keyof HWBColor, unknown>;
 /**
  * Is the value an _RGBA_ color?
  *
@@ -48,6 +88,13 @@ declare function isHslLike(value: unknown): value is Record<keyof HSLColor, unkn
  * @returns `true` if the value is an _RGBA_ color, otherwise `false`
  */
 declare function isRgbaColor(value: unknown): value is RGBAColor;
+/**
+ * Is the value like an _RGBA_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is like an _RGBA_ color, otherwise `false`
+ */
+declare function isRgbaLike(value: unknown): value is Record<keyof RGBAColor, unknown>;
 /**
  * Is the value an _RGB_ color?
  *
@@ -55,6 +102,12 @@ declare function isRgbaColor(value: unknown): value is RGBAColor;
  * @returns `true` if the value is an _RGB_ color, otherwise `false`
  */
 declare function isRgbColor(value: unknown): value is RGBColor;
+/**
+ * Is the value like an _RGB_ color?
+ *
+ * @param value Value to check
+ * @returns `true` if the value is like an _RGB_ color, otherwise `false`
+ */
 declare function isRgbLike(value: unknown): value is Record<keyof RGBColor, unknown>;
 //#endregion
-export { isColor, isHexColor, isHslColor, isHslLike, isHslaColor, isRgbColor, isRgbLike, isRgbaColor };
+export { isColor, isHexColor, isHslColor, isHslLike, isHslaColor, isHslaLike, isHwbColor, isHwbLike, isHwbaColor, isHwbaLike, isRgbColor, isRgbLike, isRgbaColor, isRgbaLike };

package/dist/color/misc/is.mjs

@@ -1,11 +1,11 @@
 import { between } from "../../internal/number.mjs";
-import { EXPRESSION_HEX_LONG, EXPRESSION_HEX_SHORT, KEYS_HSL, KEYS_HSLA, KEYS_RGB, KEYS_RGBA } from "../constants.mjs";
+import { EXPRESSION_HEX_LONG, EXPRESSION_HEX_SHORT, KEYS_HSL, KEYS_HSLA, KEYS_HWB, KEYS_HWBA, KEYS_RGB, KEYS_RGBA } from "../constants.mjs";
 //#region src/color/misc/is.ts
 function hasKeys(value, keys) {
 	return typeof value === "object" && value !== null && keys.every((key) => key in value);
 }
 function isAlpha(value) {
-	return typeof value === "number" && between(value, 0, 1);
+	return typeof value === "number" && between(value, 0, 100);
 }
 function isBytey(value) {
 	return typeof value === "number" && between(value, 0, 255);
@@ -65,6 +65,15 @@ function isHslaColor(value) {
 	return isColorValue(value, KEYS_HSLA);
 }
 /**
+* Is the value like an _HSLA_ color?
+*
+* @param value Value to check
+* @returns `true` if the value is like an _HSLA_ color, otherwise `false`
+*/
+function isHslaLike(value) {
+	return hasKeys(value, KEYS_HSLA);
+}
+/**
 * Is the value an _HSL_ color?
 *
 * @param value Value to check
@@ -73,10 +82,52 @@ 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);
 }
 /**
+* Is the value an _HWBA_ color?
+*
+* @param value Value to check
+* @returns `true` if the value is an _HWBA_ color, otherwise `false`
+*/
+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
+* @returns `true` if the value is an _HWB_ color, otherwise `false`
+*/
+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);
+}
+/**
 * Is the value an _RGBA_ color?
 *
 * @param value Value to check
@@ -86,6 +137,15 @@ function isRgbaColor(value) {
 	return isColorValue(value, KEYS_RGBA);
 }
 /**
+* Is the value like an _RGBA_ color?
+*
+* @param value Value to check
+* @returns `true` if the value is like an _RGBA_ color, otherwise `false`
+*/
+function isRgbaLike(value) {
+	return hasKeys(value, KEYS_RGBA);
+}
+/**
 * Is the value an _RGB_ color?
 *
 * @param value Value to check
@@ -94,6 +154,12 @@ 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);
 }
@@ -102,12 +168,14 @@ function isPercentage(value) {
 }
 const validators = {
 	alpha: isAlpha,
+	blackness: isPercentage,
 	blue: isBytey,
 	green: isBytey,
 	hue: isDegree,
 	lightness: isPercentage,
 	saturation: isPercentage,
-	red: isBytey
+	red: isBytey,
+	whiteness: isPercentage
 };
 //#endregion
-export { isColor, isHexColor, isHslColor, isHslLike, isHslaColor, isRgbColor, isRgbLike, isRgbaColor };
+export { isColor, isHexColor, isHslColor, isHslLike, isHslaColor, isHslaLike, isHwbColor, isHwbLike, isHwbaColor, isHwbaLike, isRgbColor, isRgbLike, isRgbaColor, isRgbaLike };

package/dist/color/misc/state.d.mts

@@ -1,9 +1,9 @@
 import { ColorState } from "../models.mjs";
-
 //#region src/color/misc/state.d.ts
 declare function getColorState(value: unknown): ColorState;
 declare function setHexColor(state: ColorState, value: string, alpha: boolean): void;
 declare function setHSLColor(state: ColorState, value: unknown, alpha: boolean): void;
+declare function setHWBColor(state: ColorState, value: unknown, alpha: boolean): void;
 declare function setRGBColor(state: ColorState, value: unknown, alpha: boolean): void;
 //#endregion
-export { getColorState, setHSLColor, setHexColor, setRGBColor };
+export { getColorState, setHSLColor, setHWBColor, setHexColor, setRGBColor };

package/dist/color/misc/state.mjs

@@ -1,72 +1,106 @@
-import { DEFAULT_HSL, DEFAULT_RGB, HEX_BLACK, KEYS_HSL, KEYS_RGB } from "../constants.mjs";
+import { DEFAULT_HSL, DEFAULT_HWB, DEFAULT_RGB, HEX_BLACK, KEYS_HSL, KEYS_HWB, KEYS_RGB } from "../constants.mjs";
 import { getAlpha } from "./alpha.mjs";
-import { isColor, isHexColor, isHslLike, isRgbLike } from "./is.mjs";
 import { getDegrees, getHexValue, getPercentage } from "./get.mjs";
-import { getRgbValue, rgbToHex, rgbToHsl } from "../space/rgb.mjs";
-import { getNormalizedHex, hexToRgb } from "../space/hex.mjs";
-import { getHslValue, hslToRgb } from "../space/hsl.mjs";
+import { isColor, isHexColor, isHslLike, isHwbLike, isRgbLike } from "./is.mjs";
+import { getRgbValue, rgbToHex, rgbToHsl, rgbToHwb } from "../space/rgb.mjs";
+import { getNormalizedHex, hexToHsl } from "../space/hex.mjs";
+import { getHslValue, hslToHex, hslToHwb, hslToRgb } from "../space/hsl.mjs";
+import { getHwbValue, hwbToHex, hwbToHsl, hwbToRgb } from "../space/hwb.mjs";
 //#region src/color/misc/state.ts
 function getColorState(value) {
-	if (typeof value === "string") {
-		const normalized = getNormalizedHex(value, true);
-		const hex = normalized.slice(0, 6);
-		const rgb = hexToRgb(hex);
-		return {
-			hex,
-			rgb,
-			alpha: getAlpha(normalized.slice(6)),
-			hsl: rgbToHsl(rgb)
-		};
-	}
+	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 (typeof value === "object" && value !== null) {
 		state.alpha = getAlpha(value.alpha);
-		if (KEYS_HSL.every((key) => key in value)) {
-			state.hsl = getHslValue(value);
-			state.rgb = hslToRgb(state.hsl);
-			state.hex = rgbToHex(state.rgb);
-			return state;
-		}
-		if (KEYS_RGB.every((key) => key in value)) {
-			state.rgb = getRgbValue(value);
-			state.hex = rgbToHex(state.rgb);
-			state.hsl = rgbToHsl(state.rgb);
-			return state;
-		}
+		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);
 	}
-	state.alpha ??= getAlpha(1);
-	state.hex ??= HEX_BLACK;
-	state.hsl ??= { ...DEFAULT_HSL };
-	state.rgb ??= { ...DEFAULT_RGB };
+	return getDefaultColorState(state);
+}
+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)
+	};
+}
+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 setHexColor(state, value, alpha) {
 	if (!isHexColor(value) || !alpha && value === state.hex) return;
 	const normalized = getNormalizedHex(value, true);
 	const hex = normalized.slice(0, 6);
-	const rgb = hexToRgb(hex);
+	const hsl = hexToHsl(hex);
 	state.hex = hex;
-	state.hsl = rgbToHsl(rgb);
-	state.rgb = rgb;
+	state.hsl = hsl;
+	state.rgb = hslToRgb(hsl);
+	state.hwb = hslToHwb(hsl);
 	if (alpha) state.alpha = getAlpha(normalized.slice(6));
 }
 function setHSLColor(state, value, alpha) {
 	if (!isHslLike(value)) return;
 	const hsl = {
 		hue: getDegrees(value.hue),
-		lightness: getPercentage(value.lightness),
-		saturation: getPercentage(value.saturation)
+		saturation: getPercentage(value.saturation),
+		lightness: getPercentage(value.lightness)
 	};
-	const rgb = hslToRgb(hsl);
-	state.hex = rgbToHex(rgb);
 	state.hsl = hsl;
-	state.rgb = rgb;
+	state.hex = hslToHex(hsl);
+	state.hwb = hslToHwb(hsl);
+	state.rgb = hslToRgb(hsl);
+	if (alpha) state.alpha = getAlpha(value.alpha);
+}
+function setHWBColor(state, value, alpha) {
+	if (!isHwbLike(value)) return;
+	const 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);
 }
 function setRGBColor(state, value, alpha) {
@@ -76,10 +110,12 @@ function setRGBColor(state, value, alpha) {
 		green: getHexValue(value.green),
 		red: getHexValue(value.red)
 	};
-	state.hex = rgbToHex(rgb);
-	state.hsl = rgbToHsl(rgb);
+	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);
 }
 //#endregion
-export { getColorState, setHSLColor, setHexColor, setRGBColor };
+export { getColorState, setHSLColor, setHWBColor, setHexColor, setRGBColor };