@oscarpalmer/atoms 0.188.1 → 0.189.0

package/dist/index.d.mts

@@ -59,11 +59,11 @@ type NestedArray<Value> = Value extends Array<infer NestedValue> ? NestedArray<N
  * All nested keys of an object as dot notation strings _(up to 5 levels deep)_
  */
 type NestedKeys<Value extends PlainObject> = _NestedKeys<Value>;
-type _NestedKeys<Value, Depth extends number = 5> = Depth extends 0 ? never : Value extends readonly any[] ? Value extends readonly [any, ...any] ? { [ItemKey in keyof Value]-?: ItemKey extends `${number}` ? NonNullable<Value[ItemKey]> extends readonly any[] | PlainObject ? `${ItemKey}` | `${ItemKey}.${_NestedKeys<NonNullable<Value[ItemKey]>, SubtractDepth<Depth>>}` : `${ItemKey}` : never }[number] : never : Value extends PlainObject ? { [ItemKey in keyof Value]-?: ItemKey extends number | string ? NonNullable<Value[ItemKey]> extends readonly any[] | PlainObject ? `${ItemKey}` | `${ItemKey}.${_NestedKeys<NonNullable<Value[ItemKey]>, SubtractDepth<Depth>>}` : `${ItemKey}` : never }[keyof Value] : never;
+type _NestedKeys<Value, Depth extends number = 5> = Depth extends 0 ? never : Value extends readonly any[] ? Value extends readonly [any, ...any] ? { [ItemKey in keyof Value]-?: ItemKey extends `${number}` ? NonNullable<Value[ItemKey]> extends readonly any[] | PlainObject ? `${ItemKey}` | `${ItemKey}.${_NestedKeys<NonNullable<Value[ItemKey]>, SubtractDepth<Depth>>}` : `${ItemKey}` : never; }[number] : never : Value extends PlainObject ? { [ItemKey in keyof Value]-?: ItemKey extends number | string ? NonNullable<Value[ItemKey]> extends readonly any[] | PlainObject ? `${ItemKey}` | `${ItemKey}.${_NestedKeys<NonNullable<Value[ItemKey]>, SubtractDepth<Depth>>}` : `${ItemKey}` : never; }[keyof Value] : never;
 /**
  * An extended version of `Partial` that allows for nested properties to be optional
  */
-type NestedPartial<Value> = { [ItemKey in keyof Value]?: Value[ItemKey] extends object ? NestedPartial<Value[ItemKey]> : Value[ItemKey] };
+type NestedPartial<Value> = { [ItemKey in keyof Value]?: Value[ItemKey] extends object ? NestedPartial<Value[ItemKey]> : Value[ItemKey]; };
 /**
  * The value for a nested key of an object
  */
@@ -72,15 +72,15 @@ type _NestedValue<Value, Path extends string> = Path extends `${infer ItemKey}.$
 /**
  * The nested _(keyed)_ values of an object _(up to 5 levels deep)_
  */
-type NestedValues<Value extends PlainObject> = { [Path in NestedKeys<Value>]: NestedValue<Value, Path> };
+type NestedValues<Value extends PlainObject> = { [Path in NestedKeys<Value>]: NestedValue<Value, Path>; };
 /**
  * The numerical keys of an object
  */
-type NumericalKeys<Value> = { [ItemKey in keyof Value]: ItemKey extends number ? ItemKey : ItemKey extends `${number}` ? ItemKey : never }[keyof Value];
+type NumericalKeys<Value> = { [ItemKey in keyof Value]: ItemKey extends number ? ItemKey : ItemKey extends `${number}` ? ItemKey : never; }[keyof Value];
 /**
  * The numerical values of an object
  */
-type NumericalValues<Item extends PlainObject> = { [ItemKey in keyof Item as Item[ItemKey] extends number ? ItemKey : never]: Item[ItemKey] };
+type NumericalValues<Item extends PlainObject> = { [ItemKey in keyof Item as Item[ItemKey] extends number ? ItemKey : never]: Item[ItemKey]; };
 /**
  * An asynchronous function that can only be called once, returning the same value on subsequent calls
  */
@@ -131,7 +131,7 @@ type RequiredKeys<Model extends object, Keys extends keyof Model> = Required<Pic
  *
  * _(Thanks, type-fest!)_
  */
-type Simplify<Value> = { [ValueKey in keyof Value]: Value[ValueKey] } & {};
+type Simplify<Value> = { [ValueKey in keyof Value]: Value[ValueKey]; } & {};
 type SubtractDepth<Value extends number> = Value extends 5 ? 4 : Value extends 4 ? 3 : Value extends 3 ? 2 : Value extends 2 ? 1 : Value extends 1 ? 0 : never;
 /**
  * Get the value's type as a string
@@ -2881,7 +2881,7 @@ type ArrayKeySorter<Item extends PlainObject, ItemKey extends keyof Item> = {
 /**
  * Sorters based on keys in an object
  */
-type ArrayKeySorters<Item extends PlainObject> = { [ItemKey in keyof Item]: ArrayKeySorter<Item, ItemKey> }[keyof Item];
+type ArrayKeySorters<Item extends PlainObject> = { [ItemKey in keyof Item]: ArrayKeySorter<Item, ItemKey>; }[keyof Item];
 /**
  * Sorter to use for sorting
  */
@@ -3787,7 +3787,7 @@ type AssertProperty<Value extends PlainObject, Path extends NestedKeys<Value>, A
  * A function that asserts a value is of a specific type, throwing an error if it is not
  */
 type Asserter<Value> = (value: unknown) => asserts value is Value;
-type NestedPick<Value, Path extends string> = Value extends PlainObject ? Path extends `${infer Head}.${infer Rest}` ? Head extends keyof Value ? { [Key in Head]: NestedPick<Value[Key], Rest> } : never : Path extends keyof Value ? { [Key in Path]: Value[Key] } : never : never;
+type NestedPick<Value, Path extends string> = Value extends PlainObject ? Path extends `${infer Head}.${infer Rest}` ? Head extends keyof Value ? { [Key in Head]: NestedPick<Value[Key], Rest>; } : never : Path extends keyof Value ? { [Key in Path]: Value[Key]; } : never : never;
 /**
  * Asserts that a condition is true, throwing an error if it is not
  *
@@ -5482,7 +5482,7 @@ declare function diff<First, Second = First>(first: First, second: Second, optio
 /**
  * A frozen value with readonly properties _(going as deep as possible)_
  */
-type Frozen<Value> = Value extends unknown[] ? Readonly<Value> : Value extends PlainObject ? { readonly [Key in keyof Value]: Frozen<Value[Key]> } : Value extends Map<infer Key, infer Value> ? ReadonlyMap<Key, Frozen<Value>> : Value extends Set<infer Item> ? ReadonlySet<Frozen<Item>> : Readonly<Value>;
+type Frozen<Value> = Value extends unknown[] ? Readonly<Value> : Value extends PlainObject ? { readonly [Key in keyof Value]: Frozen<Value[Key]>; } : Value extends Map<infer Key, infer Value> ? ReadonlyMap<Key, Frozen<Value>> : Value extends Set<infer Item> ? ReadonlySet<Frozen<Item>> : Readonly<Value>;
 /**
  * Freeze an array and its indiced values, but not any nested values
  *
@@ -5643,7 +5643,7 @@ declare function pick<Value extends PlainObject, ValueKey extends keyof Value>(v
 /**
  * A shaken object, without any `undefined` values
  */
-type Shaken<Value extends PlainObject> = { [Key in keyof Value]: Value[Key] extends undefined ? never : Value[Key] };
+type Shaken<Value extends PlainObject> = { [Key in keyof Value]: Value[Key] extends undefined ? never : Value[Key]; };
 /**
  * Shake an object, removing all keys with `undefined` values
  *
@@ -5656,7 +5656,7 @@ declare function shake<Value extends PlainObject>(value: Value): Shaken<Value>;
 /**
  * A smushed object, with all nested objects flattened into a single level, using dot notation keys
  */
-type Smushed<Value extends PlainObject> = Simplify<{ [NestedKey in NestedKeys<Value>]: NestedValue<Value, ToString<NestedKey>> }>;
+type Smushed<Value extends PlainObject> = Simplify<{ [NestedKey in NestedKeys<Value>]: NestedValue<Value, ToString<NestedKey>>; }>;
 /**
  * Smush an object into a flat object that uses dot notation keys
  *
@@ -5673,7 +5673,7 @@ type KeysOfUnion<ObjectType> = keyof UnionToIntersection<ObjectType extends unkn
 /**
  * An unsmushed object, with all dot notation keys turned into nested keys
  */
-type Unsmushed<Value extends PlainObject> = Simplify<Omit<{ [UnionKey in KeysOfUnion<Value>]: Value[UnionKey] }, `${string}.${string}`>>;
+type Unsmushed<Value extends PlainObject> = Simplify<Omit<{ [UnionKey in KeysOfUnion<Value>]: Value[UnionKey]; }, `${string}.${string}`>>;
 /**
  * Unsmush a smushed object _(turning dot notation keys into nested keys)_
  *
@@ -5795,7 +5795,7 @@ type TransformCallback<Value extends PlainObject, Key extends keyof Value> = (ke
 /**
  * A collection of keyed callbacks to transform an object's properties
  */
-type TransformCallbacks<Value extends PlainObject> = Partial<{ [Key in keyof Value]: (value: Value[Key]) => Value[Key] }>;
+type TransformCallbacks<Value extends PlainObject> = Partial<{ [Key in keyof Value]: (value: Value[Key]) => Value[Key]; }>;
 /**
  * A transformer function for an object, with predefined callbacks for transforming its properties
  */
@@ -6001,6 +6001,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)_
  */
@@ -6036,16 +6051,13 @@ declare class Color {
    */
   private readonly $color;
   /**
-   * Get the alpha channel _(opacity)_ of the color
+   * Get the alpha channel _(opacity)_ of the color as a percentage between `0` and `100`
    *
-   * @returns Current alpha channel value between `0` and `1`
+   * @returns Current alpha channel value
    */
   get alpha(): number;
   /**
-   * Set the alpha channel _(opacity)_ of the color, as:
-   *
-   * - A number between `0` and `1`, where `0` is fully transparent and `1` is fully opaque
-   * - A number between `0` and `100`, where `0` is fully transparent and `100` is fully opaque
+   * Set the alpha channel _(opacity)_ of the color as a percentage between `0` and `100`
    *
    * @param value New alpha channel value
    */
@@ -6108,6 +6120,30 @@ declare class Color {
    * @param value New _HSLA_ color
    */
   set hsla(value: HSLAColor);
+  /**
+   * Get the color as an _HWB_ color
+   *
+   * @returns Current color as an _HWB_ color
+   */
+  get hwb(): HWBColor;
+  /**
+   * Set colors from an _HWB_ color
+   *
+   * @param value New _HWB_ color
+   */
+  set hwb(value: HWBColor);
+  /**
+   * Get the color as an _HWBA_ color
+   *
+   * @returns Current color as an _HWBA_ color
+   */
+  get hwba(): HWBAColor;
+  /**
+   * Set colors and alpha from an _HWBA_ color
+   *
+   * @param value New _HWBA_ color
+   */
+  set hwba(value: HWBAColor);
   /**
    * Get the color as an _RGB_ color
    *
@@ -6147,6 +6183,13 @@ declare class Color {
    * @returns _HSL(A)_ color string
    */
   toHslString(alpha?: boolean): string;
+  /**
+   * Get the color as an _HWB(A)_ string
+   *
+   * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+   * @returns _HWB(A)_ color string
+   */
+  toHwbString(alpha?: boolean): string;
   /**
    * Get the color as an _RGB(A)_ string
    *
@@ -6163,10 +6206,20 @@ declare class Color {
 }
 //#endregion
 //#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
@@ -6176,8 +6229,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
@@ -6186,7 +6239,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
@@ -6196,17 +6249,37 @@ declare function getHexColor(value: unknown): string;
 /**
  * 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
@@ -6216,8 +6289,8 @@ declare function getHslColor(value: unknown): HSLColor;
 /**
  * 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
@@ -6226,7 +6299,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
@@ -6273,7 +6346,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?
  *
@@ -6288,6 +6395,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
 //#region src/color/space/hex.d.ts
@@ -6301,12 +6414,46 @@ declare function isRgbLike(value: unknown): value is Record<keyof RGBColor, unkn
  * @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
@@ -6315,7 +6462,7 @@ 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
@@ -6323,30 +6470,105 @@ declare function hexToRgb(value: string): RGBColor;
 declare function hexToRgba(value: string): RGBAColor;
 //#endregion
 //#region src/color/space/hsl.d.ts
+/**
+ * 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
+//#region src/color/space/hwb.d.ts
+/**
+ * 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
 //#region src/color/space/rgb.d.ts
 /**
  * Convert an _RGB(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
@@ -6361,7 +6583,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_
  *
@@ -6372,7 +6594,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_
  *
@@ -6380,12 +6602,33 @@ 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
 //#region src/color/index.d.ts
 /**
  * Get a _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 is unable to be parsed, a black _Color_ will be returned
  *
  * @param value Original value
@@ -6724,6 +6967,16 @@ declare function max<Item extends PlainObject, ItemKey extends keyof NumericalVa
  */
 declare function max(values: number[]): number;
 //#endregion
+//#region src/internal/math/misc.d.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
+ */
+declare function round(value: number, decimals?: number): number;
+//#endregion
 //#region src/math.d.ts
 /**
  * Get the average value from a list of items
@@ -6835,14 +7088,6 @@ declare function min<Item extends PlainObject>(items: Item[], key: keyof Numeric
  * @returns Minimum value, or `Number.NaN` if no minimum can be found
  */
 declare function min(values: number[]): number;
-/**
- * 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
- */
-declare function round(value: number, decimals?: number): number;
 /**
  * Get the sum of a list of items
  *
@@ -6973,7 +7218,7 @@ type PromiseStrategy = 'complete' | 'first';
 declare class PromiseTimeoutError extends Error {
   constructor();
 }
-type PromisesItems<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Promise<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Promise<Value> : Promise<Items[ItemsKey]> };
+type PromisesItems<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Promise<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Promise<Value> : Promise<Items[ItemsKey]>; };
 /**
  * Options for handling multiple _Promises_
  */
@@ -6987,10 +7232,10 @@ type PromisesOptions = {
    */
   strategy?: PromiseStrategy;
 };
-type PromisesResult<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? Result<Awaited<Value>> : never };
-type PromisesUnwrapped<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Awaited<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Awaited<Value> : never };
+type PromisesResult<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? Result<Awaited<Value>> : never; };
+type PromisesUnwrapped<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Awaited<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Awaited<Value> : never; };
 type PromisesValue<Value> = FulfilledPromise<Value> | RejectedPromise;
-type PromisesValues<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never : Items[ItemsKey] extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never };
+type PromisesValues<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never : Items[ItemsKey] extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never; };
 /**
  * A _Promise_ that was rejected
  */
@@ -8186,4 +8431,4 @@ declare class SizedSet<Value = unknown> extends Set<Value> {
   get(value: Value, update?: boolean): Value | undefined;
 }
 //#endregion
-export { AnyResult, ArrayComparison, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayValueSorter, AssertProperty, Asserter, AssignOptions, Assigner, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, type Events, ExtendedErr, ExtendedResult, Flow, FlowPromise, Frozen, FulfilledPromise, FuzzyConfiguration, FuzzyOptions, FuzzyResult, FuzzySearchOptions, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, type Herald, Key$1 as Key, type KeyedQueue, KeyedValue, Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NormalizeOptions, Normalizer, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, 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, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, type QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, type Shaken, Simplify, SizedMap, SizedSet, type Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type TimedLogger, ToString, Transformer, TypedArray, UnionToIntersection, type Unsmushed, Unsubscriber, UnwrapValue, 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, 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, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isSorted, 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, 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 { AnyResult, ArrayComparison, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayValueSorter, AssertProperty, Asserter, AssignOptions, Assigner, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, type Events, ExtendedErr, ExtendedResult, Flow, FlowPromise, Frozen, FulfilledPromise, FuzzyConfiguration, FuzzyOptions, FuzzyResult, FuzzySearchOptions, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, type HWBAColor, type HWBColor, type Herald, Key$1 as Key, type KeyedQueue, KeyedValue, Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NormalizeOptions, Normalizer, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, 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, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, type QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, type Shaken, Simplify, SizedMap, SizedSet, type Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type TimedLogger, ToString, Transformer, TypedArray, UnionToIntersection, type Unsmushed, Unsubscriber, UnwrapValue, 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, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isHwbColor, isHwbLike, isHwbaColor, isHwbaLike, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isSorted, 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 };