@oscarpalmer/atoms 0.188.1 → 0.189.0

package/dist/color/models.d.mts

@@ -30,6 +30,21 @@ type HSLColor = {
    */
   saturation: number;
 };
+type HWBColor = {
+  /**
+   * Blackness of the color _(in percentage; 0-100)_
+   */
+  blackness: number;
+  /**
+   * Hue of the color _(in degrees; 0-360)_
+   */
+  hue: number;
+  /**
+   * Whiteness of the color _(in percentage; 0-100)_
+   */
+  whiteness: number;
+};
+type HWBAColor = HWBColor & ColorWithAlpha;
 /**
  * An _RGB_ color with an alpha channel _(opacity)_
  */
@@ -51,13 +66,14 @@ type RGBColor = {
    */
   red: number;
 };
-type ColorProperty = 'alpha' | 'blue' | 'green' | 'hue' | 'lightness' | 'red' | 'saturation';
+type ColorProperty = 'alpha' | keyof HSLColor | keyof HWBColor | keyof RGBColor;
 type ColorSpace = 'hsl' | 'rgb';
 type ColorState = {
   alpha: Alpha;
   hex: string;
   hsl: HSLColor;
+  hwb: HWBColor;
   rgb: RGBColor;
 };
 //#endregion
-export { Alpha, ColorProperty, ColorSpace, ColorState, HSLAColor, HSLColor, RGBAColor, RGBColor };
+export { Alpha, ColorProperty, ColorSpace, ColorState, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor };

package/dist/color/space/hex.d.mts

@@ -1,5 +1,4 @@
-import { HSLAColor, HSLColor, RGBAColor, RGBColor } from "../models.mjs";
-
+import { HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
 //#region src/color/space/hex.d.ts
 /**
  * Get the normalized hex color from a value
@@ -11,12 +10,46 @@ import { HSLAColor, HSLColor, RGBAColor, RGBColor } from "../models.mjs";
  * @returns Normalized hex color
  */
 declare function getNormalizedHex(value: unknown, alpha?: boolean): string;
+/**
+ * Convert a hex color string to a _HSL_ color
+ *
+ * _If the value is unable to be converted, a black _HSL_ color will be returned_
+ *
+ * @param value Hex color string
+ * @returns _HSL_ color
+ */
 declare function hexToHsl(value: string): HSLColor;
+/**
+ * Convert a hex color string to a _HSLA_ color
+ *
+ * _If the value is unable to be converted, a black _HSLA_ color will be returned_
+ *
+ * @param value Hex color string
+ * @returns _HSLA_ color
+ */
 declare function hexToHsla(value: string): HSLAColor;
+/**
+ * Convert a hex color string to a _HWB_ color
+ *
+ * _If the value is unable to be converted, a black _HWB_ color will be returned_
+ *
+ * @param value Hex color string
+ * @returns _HWB_ color
+ */
+declare function hexToHwb(value: string): HWBColor;
+/**
+ * Convert a hex color string to a _HWBA_ color
+ *
+ * _If the value is unable to be converted, a black _HWBA_ color will be returned_
+ *
+ * @param value Hex color string
+ * @returns _HWBA_ color
+ */
+declare function hexToHwba(value: string): HWBAColor;
 /**
  * Convert a hex color to an _RGB_ color
  *
- * _If the value is unable to be converted, a black RGB color will be returned_
+ * _If the value is unable to be converted, a black _RGB_ color will be returned_
  *
  * @param value Original value
  * @returns _RGB_ color
@@ -25,11 +58,11 @@ declare function hexToRgb(value: string): RGBColor;
 /**
  * Convert a hex color to an _RGBA_ color
  *
- * _If the value is unable to be converted, a black RGBA color with an alpha channel (opacity) of `0` will be returned_
+ * _If the value is unable to be converted, a black _RGBA_ color will be returned_
  *
  * @param value Original value
  * @returns _RGBA_ color
  */
 declare function hexToRgba(value: string): RGBAColor;
 //#endregion
-export { getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba };
+export { getNormalizedHex, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba };

package/dist/color/space/hex.mjs

@@ -1,7 +1,8 @@
 import { join } from "../../internal/string.mjs";
 import { ALPHA_FULL_HEX_LONG, EXPRESSION_HEX_LONG, EXPRESSION_PREFIX, HEX_BLACK } from "../constants.mjs";
+import { getHexValue, getPercentage } from "../misc/get.mjs";
 import { isHexColor } from "../misc/is.mjs";
-import { convertRgbToHsla } from "./rgb.mjs";
+import { convertRgbToHsla, convertRgbToHwba } from "./rgb.mjs";
 //#region src/color/space/hex.ts
 function convertHexToRgba(value) {
 	const normalized = getNormalizedHex(value, true);
@@ -10,10 +11,10 @@ function convertHexToRgba(value) {
 	const { length } = pairs;
 	for (let index = 1; index < length; index += 1) values.push(Number.parseInt(pairs[index], 16));
 	return {
-		alpha: values[3] / 255,
-		blue: values[2],
-		green: values[1],
-		red: values[0]
+		alpha: getPercentage(values[3] / 255 * 100),
+		blue: getHexValue(values[2]),
+		green: getHexValue(values[1]),
+		red: getHexValue(values[0])
 	};
 }
 /**
@@ -29,9 +30,21 @@ function getNormalizedHex(value, alpha) {
 	const includeAlpha = alpha ?? false;
 	if (!isHexColor(value)) return `${HEX_BLACK}${includeAlpha ? ALPHA_FULL_HEX_LONG : ""}`;
 	const normalized = value.replace(EXPRESSION_PREFIX, "");
-	if (normalized.length < 6) return join(`${normalized.slice(0, 3)}${includeAlpha ? normalized[3] ?? "f" : ""}`.split("").map((character) => character.repeat(2)));
+	if (normalized.length < 6) {
+		const hex = normalized.slice(0, 3);
+		const a = includeAlpha ? normalized[3] ?? "f" : "";
+		return join(`${hex}${a}`.split("").map((character) => character.repeat(2)));
+	}
 	return `${normalized.slice(0, 6)}${includeAlpha ? normalized.slice(6) || ALPHA_FULL_HEX_LONG : ""}`;
 }
+/**
+* Convert a hex color string to a _HSL_ color
+*
+* _If the value is unable to be converted, a black _HSL_ color will be returned_
+*
+* @param value Hex color string
+* @returns _HSL_ color
+*/
 function hexToHsl(value) {
 	const { hue, lightness, saturation } = hexToHsla(value);
 	return {
@@ -40,13 +53,48 @@ function hexToHsl(value) {
 		saturation
 	};
 }
+/**
+* Convert a hex color string to a _HSLA_ color
+*
+* _If the value is unable to be converted, a black _HSLA_ color will be returned_
+*
+* @param value Hex color string
+* @returns _HSLA_ color
+*/
 function hexToHsla(value) {
 	return convertRgbToHsla(convertHexToRgba(value));
 }
 /**
+* Convert a hex color string to a _HWB_ color
+*
+* _If the value is unable to be converted, a black _HWB_ color will be returned_
+*
+* @param value Hex color string
+* @returns _HWB_ color
+*/
+function hexToHwb(value) {
+	const { blackness, hue, whiteness } = hexToHwba(value);
+	return {
+		hue,
+		whiteness,
+		blackness
+	};
+}
+/**
+* Convert a hex color string to a _HWBA_ color
+*
+* _If the value is unable to be converted, a black _HWBA_ color will be returned_
+*
+* @param value Hex color string
+* @returns _HWBA_ color
+*/
+function hexToHwba(value) {
+	return convertRgbToHwba(convertHexToRgba(value));
+}
+/**
 * Convert a hex color to an _RGB_ color
 *
-* _If the value is unable to be converted, a black RGB color will be returned_
+* _If the value is unable to be converted, a black _RGB_ color will be returned_
 *
 * @param value Original value
 * @returns _RGB_ color
@@ -62,7 +110,7 @@ function hexToRgb(value) {
 /**
 * Convert a hex color to an _RGBA_ color
 *
-* _If the value is unable to be converted, a black RGBA color with an alpha channel (opacity) of `0` will be returned_
+* _If the value is unable to be converted, a black _RGBA_ color will be returned_
 *
 * @param value Original value
 * @returns _RGBA_ color
@@ -71,4 +119,4 @@ function hexToRgba(value) {
 	return convertHexToRgba(value);
 }
 //#endregion
-export { getNormalizedHex, hexToHsl, hexToHsla, hexToRgb, hexToRgba };
+export { getNormalizedHex, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba };

package/dist/color/space/hsl.d.mts

@@ -1,29 +1,55 @@
-import { HSLAColor, HSLColor, RGBAColor, RGBColor } from "../models.mjs";
-
+import { HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
 //#region src/color/space/hsl.d.ts
 declare function getHslValue(value: Record<keyof HSLColor, unknown>): HSLColor;
+/**
+ * Convert an _HSL(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
+ *
+ * _If the value is unable to be converted, a black hex color will be returned_
+ *
+ * @param hsl _HSL(A)_ color
+ * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+ * @returns Hex color string
+ */
 declare function hslToHex(hsl: HSLAColor | HSLColor, alpha?: boolean): string;
+/**
+ * Convert an _HSL(A)_ color to an _HWB_ color
+ *
+ * _If the value is unable to be converted, a black _HWB_ color will be returned_
+ *
+ * @param hsl HSL(A) color
+ * @returns _HWB_ color
+ */
+declare function hslToHwb(hsl: HSLAColor | HSLColor): HWBColor;
+/**
+ * Convert an _HSL(A)_ color to an _HWBA_ color
+ *
+ * _If the value is unable to be converted, a black _HWBA_ color will be returned_
+ *
+ * @param hsl HSL(A) color
+ * @returns _HWBA_ color
+ */
+declare function hslToHwba(hsl: HSLAColor | HSLColor): HWBAColor;
 /**
  * Convert an _HSL(A)_ color to an _RGB_ color
  *
- * _If the value is unable to be converted, a black RGB color will be returned_
+ * _If the value is unable to be converted, a black _RGB_ color will be returned_
  *
  * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61_
  *
  * @param hsl HSL(A) color
- * @returns RGB color
+ * @returns _RGB_ color
  */
 declare function hslToRgb(hsl: HSLAColor | HSLColor): RGBColor;
 /**
  * Convert an _HSL(A)_ color to an _RGBA_ color
  *
- * _If the value is unable to be converted, a black RGBA color with an alpha channel (opactiy) of `0` will be returned_
+ * _If the value is unable to be converted, a black _RGBA_ color will be returned_
  *
  * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61_
  *
  * @param hsl HSL(A) color
- * @returns RGBA color
+ * @returns _RGBA_ color
  */
 declare function hslToRgba(hsl: HSLAColor | HSLColor): RGBAColor;
 //#endregion
-export { getHslValue, hslToHex, hslToRgb, hslToRgba };
+export { getHslValue, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba };

package/dist/color/space/hsl.mjs

@@ -1,19 +1,34 @@
 import { DEFAULT_HSL } from "../constants.mjs";
 import { getAlphaValue } from "../misc/alpha.mjs";
-import { isHslLike } from "../misc/is.mjs";
 import { getDegrees, getHexValue, getPercentage } from "../misc/get.mjs";
+import { isHslLike } from "../misc/is.mjs";
 import { convertRgbToHex } from "./rgb.mjs";
 //#region src/color/space/hsl.ts
-function convertHslToRgba(value) {
-	const hsl = isHslLike(value) ? getHslValue(value) : { ...DEFAULT_HSL };
+function convertHslToHwba(input) {
+	let { hue, lightness, saturation } = isHslLike(input) ? getHslValue(input) : { ...DEFAULT_HSL };
+	lightness /= 100;
+	saturation /= 100;
+	const value = lightness + saturation * Math.min(lightness, 1 - lightness);
+	if (value === 0) saturation = 0;
+	else saturation = 2 * (1 - lightness / value);
+	const blackness = 1 - value;
+	return {
+		hue,
+		whiteness: (1 - saturation) * value * 100,
+		blackness: blackness * 100,
+		alpha: getAlphaValue(input?.alpha ?? 100)
+	};
+}
+function convertHslToRgba(input) {
+	const hsl = isHslLike(input) ? getHslValue(input) : { ...DEFAULT_HSL };
 	const hue = hsl.hue % 360;
 	const saturation = hsl.saturation / 100;
 	const lightness = hsl.lightness / 100;
 	return {
-		alpha: getAlphaValue(value.alpha ?? 1),
-		blue: getHexValue(Math.round(getHexyValue(hue, lightness, saturation, 4))),
-		green: getHexValue(Math.round(getHexyValue(hue, lightness, saturation, 8))),
-		red: getHexValue(Math.round(getHexyValue(hue, lightness, saturation, 0)))
+		alpha: getAlphaValue(input?.alpha ?? 100),
+		blue: getHexValue(getHexyValue(hue, lightness, saturation, 4)),
+		green: getHexValue(getHexyValue(hue, lightness, saturation, 8)),
+		red: getHexValue(getHexyValue(hue, lightness, saturation, 0))
 	};
 }
 function getHexyValue(hue, lightness, saturation, value) {
@@ -23,22 +38,58 @@ function getHexyValue(hue, lightness, saturation, value) {
 function getHslValue(value) {
 	return {
 		hue: getDegrees(value.hue),
-		lightness: getPercentage(value.lightness),
-		saturation: getPercentage(value.saturation)
+		saturation: getPercentage(value.saturation),
+		lightness: getPercentage(value.lightness)
 	};
 }
+/**
+* Convert an _HSL(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
+*
+* _If the value is unable to be converted, a black hex color will be returned_
+*
+* @param hsl _HSL(A)_ color
+* @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+* @returns Hex color string
+*/
 function hslToHex(hsl, alpha) {
 	return convertRgbToHex(convertHslToRgba(hsl), alpha ?? false);
 }
 /**
+* Convert an _HSL(A)_ color to an _HWB_ color
+*
+* _If the value is unable to be converted, a black _HWB_ color will be returned_
+*
+* @param hsl HSL(A) color
+* @returns _HWB_ color
+*/
+function hslToHwb(hsl) {
+	const { blackness, hue, whiteness } = convertHslToHwba(hsl);
+	return {
+		hue,
+		whiteness,
+		blackness
+	};
+}
+/**
+* Convert an _HSL(A)_ color to an _HWBA_ color
+*
+* _If the value is unable to be converted, a black _HWBA_ color will be returned_
+*
+* @param hsl HSL(A) color
+* @returns _HWBA_ color
+*/
+function hslToHwba(hsl) {
+	return convertHslToHwba(hsl);
+}
+/**
 * Convert an _HSL(A)_ color to an _RGB_ color
 *
-* _If the value is unable to be converted, a black RGB color will be returned_
+* _If the value is unable to be converted, a black _RGB_ color will be returned_
 *
 * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61_
 *
 * @param hsl HSL(A) color
-* @returns RGB color
+* @returns _RGB_ color
 */
 function hslToRgb(hsl) {
 	const { blue, green, red } = convertHslToRgba(hsl);
@@ -51,15 +102,15 @@ function hslToRgb(hsl) {
 /**
 * Convert an _HSL(A)_ color to an _RGBA_ color
 *
-* _If the value is unable to be converted, a black RGBA color with an alpha channel (opactiy) of `0` will be returned_
+* _If the value is unable to be converted, a black _RGBA_ color will be returned_
 *
 * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61_
 *
 * @param hsl HSL(A) color
-* @returns RGBA color
+* @returns _RGBA_ color
 */
 function hslToRgba(hsl) {
 	return convertHslToRgba(hsl);
 }
 //#endregion
-export { getHslValue, hslToHex, hslToRgb, hslToRgba };
+export { getHslValue, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba };

package/dist/color/space/hwb.d.mts

@@ -0,0 +1,52 @@
+import { HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
+//#region src/color/space/hwb.d.ts
+declare function convertHwbToHsl(input: HWBAColor | HWBColor): HSLAColor;
+declare function getHwbValue(value: Record<keyof HWBColor, unknown>): HWBColor;
+/**
+ * Convert an _HWB(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
+ *
+ * _If the value is unable to be converted, a black hex color will be returned_
+ *
+ * @param hwb _HWB(A)_ color
+ * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+ * @returns Hex color string
+ */
+declare function hwbToHex(hwb: HWBAColor | HWBColor, alpha?: boolean): string;
+/**
+ * Convert an _HWB(A)_ color to an _RGB_ color
+ *
+ * _If the value is unable to be converted, a black _RGB_ color will be returned_
+ *
+ * @param hwb _HWB(A)_ color
+ * @returns _RGB_ color
+ */
+declare function hwbToHsl(hwb: HWBAColor | HWBColor): HSLColor;
+/**
+ * Convert an _HWB(A)_ color to an _HSLA_ color
+ *
+ * _If the value is unable to be converted, a black _HSLA_ color will be returned_
+ *
+ * @param hwb _HWB(A)_ color
+ * @returns _HSLA_ color
+ */
+declare function hwbToHsla(hwb: HWBAColor | HWBColor): HSLAColor;
+/**
+ * Convert an _HWB(A)_ color to an _RGB_ color
+ *
+ * _If the value is unable to be converted, a black _RGB_ color will be returned_
+ *
+ * @param hwb _HWB(A)_ color
+ * @returns _RGB_ color
+ */
+declare function hwbToRgb(hwb: HWBAColor | HWBColor): RGBColor;
+/**
+ * Convert an _HWB(A)_ color to an _RGBA_ color
+ *
+ * _If the value is unable to be converted, a black _RGBA_ color will be returned_
+ *
+ * @param hwb _HWB(A)_ color
+ * @returns _RGBA_ color
+ */
+declare function hwbToRgba(hwb: HWBAColor | HWBColor): RGBAColor;
+//#endregion
+export { convertHwbToHsl, getHwbValue, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba };

package/dist/color/space/hwb.mjs

@@ -0,0 +1,99 @@
+import { DEFAULT_HWB } from "../constants.mjs";
+import { getAlphaValue } from "../misc/alpha.mjs";
+import { getDegrees, getPercentage } from "../misc/get.mjs";
+import { isHwbLike } from "../misc/is.mjs";
+import { rgbToHex } from "./rgb.mjs";
+import { hslToRgb, hslToRgba } from "./hsl.mjs";
+//#region src/color/space/hwb.ts
+function convertHwbToHsl(input) {
+	let { blackness, hue, whiteness } = isHwbLike(input) ? getHwbValue(input) : DEFAULT_HWB;
+	blackness /= 100;
+	whiteness /= 100;
+	if (blackness + whiteness > 1) {
+		const total = blackness + whiteness;
+		blackness /= total;
+		whiteness /= total;
+	}
+	const lightness = (1 - blackness + whiteness) / 2;
+	return {
+		hue,
+		saturation: getHwbSaturation(blackness, whiteness, lightness) * 100,
+		lightness: lightness * 100,
+		alpha: getAlphaValue(input?.alpha ?? 100)
+	};
+}
+function getHwbSaturation(blackness, whiteness, lightness) {
+	const hue = 1 - blackness - whiteness;
+	if (hue <= 0) return 0;
+	return hue / Math.min(2 * lightness, 2 - 2 * lightness);
+}
+function getHwbValue(value) {
+	return {
+		hue: getDegrees(value.hue),
+		whiteness: getPercentage(value.whiteness),
+		blackness: getPercentage(value.blackness)
+	};
+}
+/**
+* Convert an _HWB(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
+*
+* _If the value is unable to be converted, a black hex color will be returned_
+*
+* @param hwb _HWB(A)_ color
+* @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+* @returns Hex color string
+*/
+function hwbToHex(hwb, alpha) {
+	return rgbToHex(hwbToRgb(hwb), alpha);
+}
+/**
+* Convert an _HWB(A)_ color to an _RGB_ color
+*
+* _If the value is unable to be converted, a black _RGB_ color will be returned_
+*
+* @param hwb _HWB(A)_ color
+* @returns _RGB_ color
+*/
+function hwbToHsl(hwb) {
+	const { hue, lightness, saturation } = convertHwbToHsl(hwb);
+	return {
+		hue,
+		lightness,
+		saturation
+	};
+}
+/**
+* Convert an _HWB(A)_ color to an _HSLA_ color
+*
+* _If the value is unable to be converted, a black _HSLA_ color will be returned_
+*
+* @param hwb _HWB(A)_ color
+* @returns _HSLA_ color
+*/
+function hwbToHsla(hwb) {
+	return convertHwbToHsl(hwb);
+}
+/**
+* Convert an _HWB(A)_ color to an _RGB_ color
+*
+* _If the value is unable to be converted, a black _RGB_ color will be returned_
+*
+* @param hwb _HWB(A)_ color
+* @returns _RGB_ color
+*/
+function hwbToRgb(hwb) {
+	return hslToRgb(hwbToHsl(hwb));
+}
+/**
+* Convert an _HWB(A)_ color to an _RGBA_ color
+*
+* _If the value is unable to be converted, a black _RGBA_ color will be returned_
+*
+* @param hwb _HWB(A)_ color
+* @returns _RGBA_ color
+*/
+function hwbToRgba(hwb) {
+	return hslToRgba(hwbToHsla(hwb));
+}
+//#endregion
+export { convertHwbToHsl, getHwbValue, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba };

package/dist/color/space/rgb.d.mts

@@ -1,8 +1,8 @@
-import { HSLAColor, HSLColor, RGBAColor, RGBColor } from "../models.mjs";
-
+import { HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
 //#region src/color/space/rgb.d.ts
 declare function convertRgbToHex(rgb: RGBAColor | RGBColor, alpha: boolean): string;
 declare function convertRgbToHsla(value: unknown): HSLAColor;
+declare function convertRgbToHwba(value: unknown): HWBAColor;
 declare function getRgbValue(value: Record<keyof RGBColor, unknown>): RGBColor;
 /**
  * Convert an _RGB(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
@@ -17,7 +17,7 @@ declare function rgbToHex(rgb: RGBAColor | RGBColor, alpha?: boolean): string;
 /**
  * Convert an _RGB(A)_ color to an _HSL_ color
  *
- * _If the value is unable to be converted, a black HSL color will be returned_
+ * _If the value is unable to be converted, a black _HSL_ color will be returned_
  *
  * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26_
  *
@@ -28,7 +28,7 @@ declare function rgbToHsl(rgb: RGBAColor | RGBColor): HSLColor;
 /**
  * Convert an _RGB(A)_ color to an _HSLA_ color
  *
- * _If the value is unable to be converted, a black _HSLA_ color with an alpha channel (opacity) of `0` will be returned_
+ * _If the value is unable to be converted, a black _HSLA_ color will be returned_
  *
  * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26_
  *
@@ -36,5 +36,26 @@ declare function rgbToHsl(rgb: RGBAColor | RGBColor): HSLColor;
  * @returns _HSLA_ color
  */
 declare function rgbToHsla(rgb: RGBAColor | RGBColor): HSLAColor;
+/**
+ * Convert an _RGB(A)_ color to an _HWB_ color
+ *
+ * _If the value is unable to be converted, a black _HWB_ color will be returned_
+ *
+ * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26_
+ *
+ * @param rgb _RGB(A)_ color
+ * @returns _HWB_ color
+ */
+declare function rgbToHwb(rgb: RGBAColor | RGBColor): HWBColor;
+/**
+ * Convert an _RGB(A)_ color to an _HWBA_ color
+ * _If the value is unable to be converted, a black _HWBA_ color will be returned_
+ *
+ * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26_
+ *
+ * @param rgb _RGB(A)_ color
+ * @returns _HWBA_ color
+ */
+declare function rgbToHwba(rgb: RGBAColor | RGBColor): HWBAColor;
 //#endregion
-export { convertRgbToHex, convertRgbToHsla, getRgbValue, rgbToHex, rgbToHsl, rgbToHsla };
+export { convertRgbToHex, convertRgbToHsla, convertRgbToHwba, getRgbValue, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba };