@oscarpalmer/atoms 0.202.0 → 0.204.0

package/dist/color/misc/state.mjs

@@ -1,11 +1,10 @@
-import { COLOR_DEFAULTS, COLOR_KEYS, COLOR_LENGTHS, COLOR_MAX, COLOR_TYPE } from "../constants.mjs";
+import { COLOR_DEFAULTS, COLOR_KEYS, COLOR_LENGTHS, COLOR_MAX, COLOR_SYMBOL, COLOR_TYPE } from "../constants.mjs";
 import { getAlpha } from "./alpha.mjs";
-import { getDegrees, getHexValue, getPercentage } from "./get.mjs";
-import { isColor, isHexColor, isHslLike, isHwbLike, isRgbLike } from "./is.mjs";
-import { getColorFromRgb, getRgbValue } from "../space/rgb.mjs";
+import { isColor } from "./is.mjs";
+import { getColorFromRgb, getRgbValues } from "../space/rgb.mjs";
 import { getColorFromHex, getNormalizedHex } from "../space/hex.mjs";
-import { getColorFromHsl, getHslValue } from "../space/hsl.mjs";
-import { getColorFromHwb, getHwbValue } from "../space/hwb.mjs";
+import { getColorFromHsl, getHslValues } from "../space/hsl.mjs";
+import { getColorFromHwb, getHwbValues } from "../space/hwb.mjs";
 //#region src/color/misc/state.ts
 function getColorFromState(state, type) {
 	const { origin } = state;
@@ -28,13 +27,13 @@ function getColorState(value) {
 			origin: void 0
 		};
 		if (COLOR_KEYS.hsl.every((key) => key in value)) {
-			state.hsl = getHslValue(value);
+			state.hsl = getHslValues(value);
 			state.origin = COLOR_TYPE.hsl;
 		} else if (COLOR_KEYS.hwb.every((key) => key in value)) {
-			state.hwb = getHwbValue(value);
+			state.hwb = getHwbValues(value);
 			state.origin = COLOR_TYPE.hwb;
 		} else if (COLOR_KEYS.rgb.every((key) => key in value)) {
-			state.rgb = getRgbValue(value);
+			state.rgb = getRgbValues(value);
 			state.origin = COLOR_TYPE.rgb;
 		}
 		if (state.origin != null) return state;
@@ -59,45 +58,26 @@ function getDefaultColorState() {
 		origin: COLOR_TYPE.hex
 	};
 }
-function setColorValue(color, state, changes, 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 === COLOR_TYPE.hex);
-	for (const type of COLOR_TYPE.all) if (changes.observed(type)) changes.emit(type, color[type]);
-	changes.emit(COLOR_TYPE.wildcard, color);
+function getStateValue(instance, type, alpha) {
+	const { values } = instance[COLOR_SYMBOL];
+	const value = getColorFromState(values, type);
+	if (typeof value === "string") return alpha ? `${value}${values.alpha.hex}` : value;
+	return alpha ? {
+		...value,
+		alpha: values.alpha.value
+	} : { ...value };
 }
-function setHexColor(color, state, changes, value, alpha) {
-	if (!isHexColor(value) || !alpha && value === state.hex) return;
-	const normalized = getNormalizedHex(value, true);
-	setColorValue(color, state, changes, COLOR_TYPE.hex, normalized.slice(0, COLOR_LENGTHS.hexLong), alpha ? normalized.slice(COLOR_LENGTHS.hexLong) : void 0);
-}
-function setHSLColor(color, state, changes, value, alpha) {
-	if (!isHslLike(value)) return;
-	setColorValue(color, state, changes, COLOR_TYPE.hsl, {
-		hue: getDegrees(value.hue),
-		saturation: getPercentage(value.saturation),
-		lightness: getPercentage(value.lightness)
-	}, alpha ? value.alpha : void 0);
-}
-function setHWBColor(color, state, changes, value, alpha) {
-	if (!isHwbLike(value)) return;
-	setColorValue(color, state, changes, COLOR_TYPE.hwb, {
-		hue: getDegrees(value.hue),
-		whiteness: getPercentage(value.whiteness),
-		blackness: getPercentage(value.blackness)
-	}, alpha ? value.alpha : void 0);
-}
-function setRGBColor(color, state, changes, value, alpha) {
-	if (!isRgbLike(value)) return;
-	setColorValue(color, state, changes, COLOR_TYPE.rgb, {
-		red: getHexValue(value.red),
-		green: getHexValue(value.green),
-		blue: getHexValue(value.blue)
-	}, alpha ? value.alpha : void 0);
+function setStateValue(instance, type, value, alpha) {
+	const { changes, values } = instance[COLOR_SYMBOL];
+	values.hex = void 0;
+	values.hsl = void 0;
+	values.hwb = void 0;
+	values.rgb = void 0;
+	values.origin = type;
+	values[type] = value;
+	if (alpha != null) values.alpha = getAlpha(alpha, type === COLOR_TYPE.hex);
+	for (const type of COLOR_TYPE.all) if (changes.observed(type)) changes.emit(type, instance[type]);
+	changes.emit(COLOR_TYPE.wildcard, instance);
 }
 const getters = {
 	hex: getColorFromHex,
@@ -106,4 +86,4 @@ const getters = {
 	rgb: getColorFromRgb
 };
 //#endregion
-export { getColorFromState, getColorState, setHSLColor, setHWBColor, setHexColor, setRGBColor };
+export { getColorFromState, getColorState, getStateValue, setStateValue };

package/dist/color/models.d.mts

@@ -1,15 +1,15 @@
 import { Subscription } from "../internal/subscription.mjs";
-import { HeraldEvents } from "../internal/herald.mjs";
-import { COLOR_ALPHA } from "./constants.mjs";
+import { Herald, HeraldEvents } from "../internal/herald.mjs";
+import { COLOR_SYMBOL } from "./constants.mjs";
 //#region src/color/models.d.ts
-type Alpha = {
+export type Alpha = {
   hex: string;
   value: number;
 };
 /**
  * A color that is represented in multiple color formats
  */
-type Color = {
+export type Color = {
   /**
    *
    */
@@ -186,7 +186,7 @@ type Color = {
    */
   unsubscribe(): void;
 };
-type ColorChanges = {
+export type ColorChanges = {
   '*': (value: Color) => void;
   alpha: (value: number) => void;
   hex: (value: string) => void;
@@ -207,11 +207,11 @@ type ColorWithAlpha = {
 /**
  * An _HSL_ color with an alpha channel _(opacity)_
  */
-type HSLAColor = HSLColor & ColorWithAlpha;
+export type HSLAColor = HSLColor & ColorWithAlpha;
 /**
  * An _HSL_ color
  */
-type HSLColor = {
+export type HSLColor = {
   /**
    * Hue of the color _(in degrees; 0-360)_
    */
@@ -225,7 +225,7 @@ type HSLColor = {
    */
   saturation: number;
 };
-type HWBColor = {
+export type HWBColor = {
   /**
    * Blackness of the color _(in percentage; 0-100)_
    */
@@ -239,15 +239,22 @@ type HWBColor = {
    */
   whiteness: number;
 };
-type HWBAColor = HWBColor & ColorWithAlpha;
+export type HWBAColor = HWBColor & ColorWithAlpha;
+export type InternalColor = {
+  [COLOR_SYMBOL]: InternalColorState;
+} & Color;
+export type InternalColorState = {
+  changes: Herald<ColorChanges>;
+  values: ColorState;
+};
 /**
  * An _RGB_ color with an alpha channel _(opacity)_
  */
-type RGBAColor = RGBColor & ColorWithAlpha;
+export type RGBAColor = RGBColor & ColorWithAlpha;
 /**
  * An _RGB_ color
  */
-type RGBColor = {
+export type RGBColor = {
   /**
    * Blue channel of the color _(in hexadecimal; 0-255)_
    */
@@ -261,8 +268,8 @@ type RGBColor = {
    */
   red: number;
 };
-type ColorProperty = typeof COLOR_ALPHA.name | keyof HSLColor | keyof HWBColor | keyof RGBColor;
-type ColorState = {
+export type ColorProperty = 'alpha' | keyof HSLColor | keyof HWBColor | keyof RGBColor;
+export type ColorState = {
   alpha: Alpha;
   hex?: string;
   hsl?: HSLColor;
@@ -273,18 +280,17 @@ type ColorState = {
 /**
  * Base color types
  */
-type ColorType = 'hex' | 'hsl' | 'hwb' | 'rgb';
+export type ColorType = 'hex' | 'hsl' | 'hwb' | 'rgb';
 /**
  * Extended color types
  */
-type ColorTypeExtended = ColorType | 'hsla' | 'hwba' | 'rgba';
+export type ColorTypeExtended = ColorType | 'hsla' | 'hwba' | 'rgba';
 /**
  * Base color values
  */
-type ColorValue = string | HSLColor | HWBColor | RGBColor;
+export type ColorValue = string | HSLColor | HWBColor | RGBColor;
 /**
  * Extended color values
  */
-type ColorValueExtended = ColorValue | HSLAColor | HWBAColor | RGBAColor;
-//#endregion
-export { Alpha, Color, ColorChanges, ColorProperty, ColorState, ColorType, ColorTypeExtended, ColorValue, ColorValueExtended, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor };
+export type ColorValueExtended = ColorValue | HSLAColor | HWBAColor | RGBAColor;
+//#endregion

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

@@ -1,6 +1,8 @@
-import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
+import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, InternalColor, RGBAColor, RGBColor } from "../models.mjs";
 //#region src/color/space/hex.d.ts
-declare function getColorFromHex<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
+export declare function getColorFromHex<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
+export declare function getHexColor(this: InternalColor): string;
+export declare function getHexaColor(this: InternalColor): string;
 /**
  * Get the normalized hex color from a value
  *
@@ -10,7 +12,7 @@ declare function getColorFromHex<Type extends ColorType>(state: ColorState, type
  * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
  * @returns Normalized hex color
  */
-declare function getNormalizedHex(value: unknown, alpha?: boolean): string;
+export declare function getNormalizedHex(value: unknown, alpha?: boolean): string;
 /**
  * Convert a hex color string to a _HSL_ color
  *
@@ -19,7 +21,7 @@ declare function getNormalizedHex(value: unknown, alpha?: boolean): string;
  * @param value Hex color string
  * @returns _HSL_ color
  */
-declare function hexToHsl(value: string): HSLColor;
+export declare function hexToHsl(value: string): HSLColor;
 /**
  * Convert a hex color string to a _HSLA_ color
  *
@@ -28,7 +30,7 @@ declare function hexToHsl(value: string): HSLColor;
  * @param value Hex color string
  * @returns _HSLA_ color
  */
-declare function hexToHsla(value: string): HSLAColor;
+export declare function hexToHsla(value: string): HSLAColor;
 /**
  * Convert a hex color string to a _HWB_ color
  *
@@ -37,7 +39,7 @@ declare function hexToHsla(value: string): HSLAColor;
  * @param value Hex color string
  * @returns _HWB_ color
  */
-declare function hexToHwb(value: string): HWBColor;
+export declare function hexToHwb(value: string): HWBColor;
 /**
  * Convert a hex color string to a _HWBA_ color
  *
@@ -46,7 +48,7 @@ declare function hexToHwb(value: string): HWBColor;
  * @param value Hex color string
  * @returns _HWBA_ color
  */
-declare function hexToHwba(value: string): HWBAColor;
+export declare function hexToHwba(value: string): HWBAColor;
 /**
  * Convert a hex color to an _RGB_ color
  *
@@ -55,7 +57,7 @@ declare function hexToHwba(value: string): HWBAColor;
  * @param value Original value
  * @returns _RGB_ color
  */
-declare function hexToRgb(value: string): RGBColor;
+export declare function hexToRgb(value: string): RGBColor;
 /**
  * Convert a hex color to an _RGBA_ color
  *
@@ -64,6 +66,7 @@ declare function hexToRgb(value: string): RGBColor;
  * @param value Original value
  * @returns _RGBA_ color
  */
-declare function hexToRgba(value: string): RGBAColor;
-//#endregion
-export { getColorFromHex, getNormalizedHex, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba };
+export declare function hexToRgba(value: string): RGBAColor;
+export declare function setHexValue(this: InternalColor, value: string): void;
+export declare function setHexaValue(this: InternalColor, value: string): void;
+//#endregion

package/dist/color/space/hex.mjs

@@ -1,8 +1,9 @@
 import { join } from "../../internal/string/misc.mjs";
-import { COLOR_ALPHA, COLOR_DEFAULTS, COLOR_EXPRESSION, COLOR_LENGTHS, COLOR_MAX, COLOR_TYPE } from "../constants.mjs";
+import { COLOR_ALPHA, COLOR_DEFAULTS, COLOR_EXPRESSION, COLOR_LENGTHS, COLOR_MAX, COLOR_SYMBOL, COLOR_TYPE } from "../constants.mjs";
 import { getHexValue, getPercentage } from "../misc/get.mjs";
 import { isHexColor } from "../misc/is.mjs";
 import { convertRgbToHsla, convertRgbToHwba } from "./rgb.mjs";
+import { getStateValue, setStateValue } from "../misc/state.mjs";
 //#region src/color/space/hex.ts
 function convertHexToRgba(value) {
 	const normalized = getNormalizedHex(value, true);
@@ -29,6 +30,12 @@ function getColorFromHex(state, type) {
 	}
 	return state[type];
 }
+function getHexColor() {
+	return getStateValue(this, COLOR_TYPE.hex, false);
+}
+function getHexaColor() {
+	return getStateValue(this, COLOR_TYPE.hex, true);
+}
 /**
 * Get the normalized hex color from a value
 *
@@ -130,5 +137,17 @@ function hexToRgb(value) {
 function hexToRgba(value) {
 	return convertHexToRgba(value);
 }
+function setHexValue(value) {
+	setHexValueInState(this, value, false);
+}
+function setHexValueInState(instance, value, alpha) {
+	const { values } = instance[COLOR_SYMBOL];
+	if (!isHexColor(value) || !alpha && value === values.hex) return;
+	const normalized = getNormalizedHex(value, true);
+	setStateValue(instance, COLOR_TYPE.hex, normalized.slice(0, COLOR_LENGTHS.hexLong), alpha ? normalized.slice(COLOR_LENGTHS.hexLong) : void 0);
+}
+function setHexaValue(value) {
+	setHexValueInState(this, value, true);
+}
 //#endregion
-export { getColorFromHex, getNormalizedHex, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba };
+export { getColorFromHex, getHexColor, getHexaColor, getNormalizedHex, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, setHexValue, setHexaValue };

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

@@ -1,7 +1,9 @@
-import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
+import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, InternalColor, RGBAColor, RGBColor } from "../models.mjs";
 //#region src/color/space/hsl.d.ts
-declare function getColorFromHsl<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
-declare function getHslValue(value: Record<keyof HSLColor, unknown>): HSLColor;
+export declare function getColorFromHsl<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
+export declare function getHslValue(this: InternalColor): HSLColor;
+export declare function getHslaValue(this: InternalColor): HSLAColor;
+export declare function getHslValues(value: Record<keyof HSLColor, unknown>): HSLColor;
 /**
  * Convert an _HSL(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
  *
@@ -11,7 +13,7 @@ declare function getHslValue(value: Record<keyof HSLColor, unknown>): HSLColor;
  * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
  * @returns Hex color string
  */
-declare function hslToHex(hsl: HSLAColor | HSLColor, alpha?: boolean): string;
+export declare function hslToHex(hsl: HSLAColor | HSLColor, alpha?: boolean): string;
 /**
  * Convert an _HSL(A)_ color to an _HWB_ color
  *
@@ -20,7 +22,7 @@ declare function hslToHex(hsl: HSLAColor | HSLColor, alpha?: boolean): string;
  * @param hsl HSL(A) color
  * @returns _HWB_ color
  */
-declare function hslToHwb(hsl: HSLAColor | HSLColor): HWBColor;
+export declare function hslToHwb(hsl: HSLAColor | HSLColor): HWBColor;
 /**
  * Convert an _HSL(A)_ color to an _HWBA_ color
  *
@@ -29,7 +31,7 @@ declare function hslToHwb(hsl: HSLAColor | HSLColor): HWBColor;
  * @param hsl HSL(A) color
  * @returns _HWBA_ color
  */
-declare function hslToHwba(hsl: HSLAColor | HSLColor): HWBAColor;
+export declare function hslToHwba(hsl: HSLAColor | HSLColor): HWBAColor;
 /**
  * Convert an _HSL(A)_ color to an _RGB_ color
  *
@@ -40,7 +42,7 @@ declare function hslToHwba(hsl: HSLAColor | HSLColor): HWBAColor;
  * @param hsl HSL(A) color
  * @returns _RGB_ color
  */
-declare function hslToRgb(hsl: HSLAColor | HSLColor): RGBColor;
+export declare function hslToRgb(hsl: HSLAColor | HSLColor): RGBColor;
 /**
  * Convert an _HSL(A)_ color to an _RGBA_ color
  *
@@ -51,6 +53,7 @@ declare function hslToRgb(hsl: HSLAColor | HSLColor): RGBColor;
  * @param hsl HSL(A) color
  * @returns _RGBA_ color
  */
-declare function hslToRgba(hsl: HSLAColor | HSLColor): RGBAColor;
-//#endregion
-export { getColorFromHsl, getHslValue, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba };
+export declare function hslToRgba(hsl: HSLAColor | HSLColor): RGBAColor;
+export declare function setHslValue(this: InternalColor, value: unknown): void;
+export declare function setHslaValue(this: InternalColor, value: unknown): void;
+//#endregion

package/dist/color/space/hsl.mjs

@@ -3,9 +3,10 @@ import { getAlphaValue } from "../misc/alpha.mjs";
 import { getDegrees, getHexValue, getPercentage } from "../misc/get.mjs";
 import { isHslLike } from "../misc/is.mjs";
 import { convertRgbToHex } from "./rgb.mjs";
+import { getStateValue, setStateValue } from "../misc/state.mjs";
 //#region src/color/space/hsl.ts
 function convertHslToHwba(input) {
-	let { hue, lightness, saturation } = isHslLike(input) ? getHslValue(input) : { ...COLOR_DEFAULTS.hsl };
+	let { hue, lightness, saturation } = isHslLike(input) ? getHslValues(input) : { ...COLOR_DEFAULTS.hsl };
 	lightness /= COLOR_MAX.percent;
 	saturation /= COLOR_MAX.percent;
 	const value = lightness + saturation * Math.min(lightness, 1 - lightness);
@@ -20,7 +21,7 @@ function convertHslToHwba(input) {
 	};
 }
 function convertHslToRgba(input) {
-	const hsl = isHslLike(input) ? getHslValue(input) : { ...COLOR_DEFAULTS.hsl };
+	const hsl = isHslLike(input) ? getHslValues(input) : { ...COLOR_DEFAULTS.hsl };
 	const hue = hsl.hue % COLOR_MAX.degree;
 	const saturation = hsl.saturation / COLOR_MAX.percent;
 	const lightness = hsl.lightness / COLOR_MAX.percent;
@@ -47,7 +48,13 @@ 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))) * COLOR_MAX.hex;
 }
-function getHslValue(value) {
+function getHslValue() {
+	return getStateValue(this, COLOR_TYPE.hsl, false);
+}
+function getHslaValue() {
+	return getStateValue(this, COLOR_TYPE.hsl, true);
+}
+function getHslValues(value) {
 	return {
 		hue: getDegrees(value.hue),
 		saturation: getPercentage(value.saturation),
@@ -124,5 +131,19 @@ function hslToRgb(hsl) {
 function hslToRgba(hsl) {
 	return convertHslToRgba(hsl);
 }
+function setHslValue(value) {
+	setHSLValueInState(this, value, false);
+}
+function setHSLValueInState(instance, value, alpha) {
+	if (!isHslLike(value)) return;
+	setStateValue(instance, COLOR_TYPE.hsl, {
+		hue: getDegrees(value.hue),
+		saturation: getPercentage(value.saturation),
+		lightness: getPercentage(value.lightness)
+	}, alpha ? value.alpha : void 0);
+}
+function setHslaValue(value) {
+	setHSLValueInState(this, value, true);
+}
 //#endregion
-export { getColorFromHsl, getHslValue, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba };
+export { getColorFromHsl, getHslValue, getHslValues, getHslaValue, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, setHslValue, setHslaValue };

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

@@ -1,8 +1,10 @@
-import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
+import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, InternalColor, RGBAColor, RGBColor } from "../models.mjs";
 //#region src/color/space/hwb.d.ts
-declare function convertHwbToHsl(input: HWBAColor | HWBColor): HSLAColor;
-declare function getColorFromHwb<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
-declare function getHwbValue(value: Record<keyof HWBColor, unknown>): HWBColor;
+export declare function convertHwbToHsl(input: HWBAColor | HWBColor): HSLAColor;
+export declare function getColorFromHwb<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
+export declare function getHwbValue(this: InternalColor): HWBColor;
+export declare function getHwbaValue(this: InternalColor): HWBAColor;
+export declare function getHwbValues(value: Record<keyof HWBColor, unknown>): HWBColor;
 /**
  * Convert an _HWB(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
  *
@@ -12,7 +14,7 @@ declare function getHwbValue(value: Record<keyof HWBColor, unknown>): HWBColor;
  * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
  * @returns Hex color string
  */
-declare function hwbToHex(hwb: HWBAColor | HWBColor, alpha?: boolean): string;
+export declare function hwbToHex(hwb: HWBAColor | HWBColor, alpha?: boolean): string;
 /**
  * Convert an _HWB(A)_ color to an _RGB_ color
  *
@@ -21,7 +23,7 @@ declare function hwbToHex(hwb: HWBAColor | HWBColor, alpha?: boolean): string;
  * @param hwb _HWB(A)_ color
  * @returns _RGB_ color
  */
-declare function hwbToHsl(hwb: HWBAColor | HWBColor): HSLColor;
+export declare function hwbToHsl(hwb: HWBAColor | HWBColor): HSLColor;
 /**
  * Convert an _HWB(A)_ color to an _HSLA_ color
  *
@@ -30,7 +32,7 @@ declare function hwbToHsl(hwb: HWBAColor | HWBColor): HSLColor;
  * @param hwb _HWB(A)_ color
  * @returns _HSLA_ color
  */
-declare function hwbToHsla(hwb: HWBAColor | HWBColor): HSLAColor;
+export declare function hwbToHsla(hwb: HWBAColor | HWBColor): HSLAColor;
 /**
  * Convert an _HWB(A)_ color to an _RGB_ color
  *
@@ -39,7 +41,7 @@ declare function hwbToHsla(hwb: HWBAColor | HWBColor): HSLAColor;
  * @param hwb _HWB(A)_ color
  * @returns _RGB_ color
  */
-declare function hwbToRgb(hwb: HWBAColor | HWBColor): RGBColor;
+export declare function hwbToRgb(hwb: HWBAColor | HWBColor): RGBColor;
 /**
  * Convert an _HWB(A)_ color to an _RGBA_ color
  *
@@ -48,6 +50,7 @@ declare function hwbToRgb(hwb: HWBAColor | HWBColor): RGBColor;
  * @param hwb _HWB(A)_ color
  * @returns _RGBA_ color
  */
-declare function hwbToRgba(hwb: HWBAColor | HWBColor): RGBAColor;
-//#endregion
-export { convertHwbToHsl, getColorFromHwb, getHwbValue, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba };
+export declare function hwbToRgba(hwb: HWBAColor | HWBColor): RGBAColor;
+export declare function setHwbValue(this: InternalColor, value: unknown): void;
+export declare function setHwbaValue(this: InternalColor, value: unknown): void;
+//#endregion

package/dist/color/space/hwb.mjs

@@ -4,9 +4,10 @@ import { getDegrees, getPercentage } from "../misc/get.mjs";
 import { isHwbLike } from "../misc/is.mjs";
 import { rgbToHex } from "./rgb.mjs";
 import { hslToRgb, hslToRgba } from "./hsl.mjs";
+import { getStateValue, setStateValue } from "../misc/state.mjs";
 //#region src/color/space/hwb.ts
 function convertHwbToHsl(input) {
-	let { blackness, hue, whiteness } = isHwbLike(input) ? getHwbValue(input) : COLOR_DEFAULTS.hwb;
+	let { blackness, hue, whiteness } = isHwbLike(input) ? getHwbValues(input) : COLOR_DEFAULTS.hwb;
 	blackness /= COLOR_MAX.percent;
 	whiteness /= COLOR_MAX.percent;
 	if (blackness + whiteness > 1) {
@@ -39,7 +40,13 @@ function getHwbSaturation(blackness, whiteness, lightness) {
 	if (hue <= 0) return 0;
 	return hue / Math.min(2 * lightness, 2 - 2 * lightness);
 }
-function getHwbValue(value) {
+function getHwbValue() {
+	return getStateValue(this, COLOR_TYPE.hwb, false);
+}
+function getHwbaValue() {
+	return getStateValue(this, COLOR_TYPE.hwb, true);
+}
+function getHwbValues(value) {
 	return {
 		hue: getDegrees(value.hue),
 		whiteness: getPercentage(value.whiteness),
@@ -107,5 +114,19 @@ function hwbToRgb(hwb) {
 function hwbToRgba(hwb) {
 	return hslToRgba(hwbToHsla(hwb));
 }
+function setHwbValue(value) {
+	setHwbColorValueInState(this, value, false);
+}
+function setHwbColorValueInState(instance, value, alpha) {
+	if (!isHwbLike(value)) return;
+	setStateValue(instance, COLOR_TYPE.hwb, {
+		hue: getDegrees(value.hue),
+		whiteness: getPercentage(value.whiteness),
+		blackness: getPercentage(value.blackness)
+	}, alpha ? value.alpha : void 0);
+}
+function setHwbaValue(value) {
+	setHwbColorValueInState(this, value, true);
+}
 //#endregion
-export { convertHwbToHsl, getColorFromHwb, getHwbValue, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba };
+export { convertHwbToHsl, getColorFromHwb, getHwbValue, getHwbValues, getHwbaValue, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, setHwbValue, setHwbaValue };

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

@@ -1,10 +1,12 @@
-import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, RGBAColor, RGBColor } from "../models.mjs";
+import { ColorState, ColorType, HSLAColor, HSLColor, HWBAColor, HWBColor, InternalColor, 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 getColorFromRgb<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
-declare function getRgbValue(value: Record<keyof RGBColor, unknown>): RGBColor;
+export declare function convertRgbToHex(rgb: RGBAColor | RGBColor, alpha: boolean): string;
+export declare function convertRgbToHsla(value: unknown): HSLAColor;
+export declare function convertRgbToHwba(value: unknown): HWBAColor;
+export declare function getColorFromRgb<Type extends ColorType>(state: ColorState, type: Type): NonNullable<ColorState[Type]>;
+export declare function getRgbColor(this: InternalColor): RGBColor;
+export declare function getRgbaColor(this: InternalColor): RGBAColor;
+export declare function getRgbValues(value: Record<keyof RGBColor, unknown>): RGBColor;
 /**
  * Convert an _RGB(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
  *
@@ -14,7 +16,7 @@ declare function getRgbValue(value: Record<keyof RGBColor, unknown>): RGBColor;
  * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
  * @returns Hex color string
  */
-declare function rgbToHex(rgb: RGBAColor | RGBColor, alpha?: boolean): string;
+export declare function rgbToHex(rgb: RGBAColor | RGBColor, alpha?: boolean): string;
 /**
  * Convert an _RGB(A)_ color to an _HSL_ color
  *
@@ -25,7 +27,7 @@ declare function rgbToHex(rgb: RGBAColor | RGBColor, alpha?: boolean): string;
  * @param rgb _RGB(A)_ color
  * @returns _HSL_ color
  */
-declare function rgbToHsl(rgb: RGBAColor | RGBColor): HSLColor;
+export declare function rgbToHsl(rgb: RGBAColor | RGBColor): HSLColor;
 /**
  * Convert an _RGB(A)_ color to an _HSLA_ color
  *
@@ -36,7 +38,7 @@ declare function rgbToHsl(rgb: RGBAColor | RGBColor): HSLColor;
  * @param rgb _RGB(A)_ color
  * @returns _HSLA_ color
  */
-declare function rgbToHsla(rgb: RGBAColor | RGBColor): HSLAColor;
+export declare function rgbToHsla(rgb: RGBAColor | RGBColor): HSLAColor;
 /**
  * Convert an _RGB(A)_ color to an _HWB_ color
  *
@@ -47,7 +49,7 @@ declare function rgbToHsla(rgb: RGBAColor | RGBColor): HSLAColor;
  * @param rgb _RGB(A)_ color
  * @returns _HWB_ color
  */
-declare function rgbToHwb(rgb: RGBAColor | RGBColor): HWBColor;
+export 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_
@@ -57,6 +59,7 @@ declare function rgbToHwb(rgb: RGBAColor | RGBColor): HWBColor;
  * @param rgb _RGB(A)_ color
  * @returns _HWBA_ color
  */
-declare function rgbToHwba(rgb: RGBAColor | RGBColor): HWBAColor;
-//#endregion
-export { convertRgbToHex, convertRgbToHsla, convertRgbToHwba, getColorFromRgb, getRgbValue, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba };
+export declare function rgbToHwba(rgb: RGBAColor | RGBColor): HWBAColor;
+export declare function setRgbValue(this: InternalColor, value: unknown): void;
+export declare function setRgbaValue(this: InternalColor, value: unknown): void;
+//#endregion