@oscarpalmer/atoms 0.192.0 → 0.193.1

package/src/color/space/hex.ts

@@ -1,184 +0,0 @@
-import {join} from '../../internal/string';
-import {
-	COLOR_ALPHA,
-	COLOR_DEFAULTS,
-	COLOR_EXPRESSION,
-	COLOR_LENGTHS,
-	COLOR_MAX,
-	COLOR_TYPE,
-} from '../constants';
-import {getHexValue, getPercentage} from '../misc/get';
-import {isHexColor} from '../misc/is';
-import type {
-	ColorState,
-	ColorType,
-	HSLAColor,
-	HSLColor,
-	HWBAColor,
-	HWBColor,
-	RGBAColor,
-	RGBColor,
-} from '../models';
-import {convertRgbToHsla, convertRgbToHwba} from './rgb';
-
-// #region Functions
-
-function convertHexToRgba(value: string): RGBAColor {
-	const normalized = getNormalizedHex(value, true);
-	const pairs = COLOR_EXPRESSION.hexLong.exec(normalized) as RegExpExecArray;
-	const values: number[] = [];
-
-	const {length} = pairs;
-
-	for (let index = 1; index < length; index += 1) {
-		values.push(Number.parseInt(pairs[index], 16));
-	}
-
-	return {
-		alpha: getPercentage((values[3] / COLOR_MAX.hex) * 100),
-		blue: getHexValue(values[2]),
-		green: getHexValue(values[1]),
-		red: getHexValue(values[0]),
-	};
-}
-
-export function getColorFromHex<Type extends ColorType>(
-	state: ColorState,
-	type: Type,
-): NonNullable<ColorState[Type]> {
-	switch (type) {
-		case COLOR_TYPE.hsl:
-			state.hsl ??= hexToHsl(state.hex!);
-			break;
-
-		case COLOR_TYPE.hwb:
-			state.hwb ??= hexToHwb(state.hex!);
-			break;
-
-		case COLOR_TYPE.rgb:
-			state.rgb ??= hexToRgb(state.hex!);
-			break;
-	}
-
-	return state[type]!;
-}
-
-/**
- * Get the normalized hex color from a value
- *
- * _If the value is unable to be parsed or normalized, a hex color of `000000` will be returned, with the alpha channel _(opacity)_ value `0` included, if specified_
- *
- * @param value Value to normalize
- * @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
- * @returns Normalized hex color
- */
-export function getNormalizedHex(value: unknown, alpha?: boolean): string {
-	const includeAlpha = alpha ?? false;
-
-	if (!isHexColor(value)) {
-		return `${COLOR_DEFAULTS.hexBlack}${includeAlpha ? COLOR_ALPHA.fullHexLong : ''}`;
-	}
-
-	const normalized = value.replace(COLOR_EXPRESSION.prefix, '');
-
-	if (normalized.length < COLOR_LENGTHS.hexLong) {
-		const hex = normalized.slice(0, COLOR_LENGTHS.hexShort);
-		const a = includeAlpha ? (normalized[COLOR_LENGTHS.hexShort] ?? COLOR_ALPHA.fullHexShort) : '';
-
-		return join(`${hex}${a}`.split('').map(character => character.repeat(2)));
-	}
-
-	const hex = normalized.slice(0, COLOR_LENGTHS.hexLong);
-
-	const a = includeAlpha ? normalized.slice(COLOR_LENGTHS.hexLong) || COLOR_ALPHA.fullHexLong : '';
-
-	return `${hex}${a}`;
-}
-
-/**
- * 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
- */
-export function hexToHsl(value: string): HSLColor {
-	const {hue, lightness, saturation} = hexToHsla(value);
-
-	return {
-		hue,
-		lightness,
-		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
- */
-export function hexToHsla(value: string): HSLAColor {
-	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
- */
-export function hexToHwb(value: string): HWBColor {
-	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
- */
-export function hexToHwba(value: string): HWBAColor {
-	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_
- *
- * @param value Original value
- * @returns _RGB_ color
- */
-export function hexToRgb(value: string): RGBColor {
-	const {blue, green, red} = convertHexToRgba(value);
-
-	return {blue, green, red};
-}
-
-/**
- * Convert a hex color to an _RGBA_ color
- *
- * _If the value is unable to be converted, a black _RGBA_ color will be returned_
- *
- * @param value Original value
- * @returns _RGBA_ color
- */
-export function hexToRgba(value: string): RGBAColor {
-	return convertHexToRgba(value);
-}
-
-// #endregion

package/src/color/space/hsl.ts

@@ -1,174 +0,0 @@
-import {COLOR_DEFAULTS, COLOR_MAX, COLOR_TYPE} from '../constants';
-import {getAlphaValue} from '../misc/alpha';
-import {getDegrees, getHexValue, getPercentage} from '../misc/get';
-import {isHslLike} from '../misc/is';
-import type {
-	ColorState,
-	ColorType,
-	HSLAColor,
-	HSLColor,
-	HWBAColor,
-	HWBColor,
-	RGBAColor,
-	RGBColor,
-} from '../models';
-import {convertRgbToHex} from './rgb';
-
-// #region Functions
-
-function convertHslToHwba(input: unknown): HWBAColor {
-	const hsl = isHslLike(input) ? getHslValue(input) : {...COLOR_DEFAULTS.hsl};
-
-	let {hue, lightness, saturation} = hsl;
-
-	lightness /= COLOR_MAX.percent;
-	saturation /= COLOR_MAX.percent;
-
-	const value = lightness + saturation * Math.min(lightness, 1 - lightness);
-
-	if (value === 0) {
-		saturation = 0;
-	} else {
-		saturation = 2 * (1 - lightness / value);
-	}
-
-	const blackness = 1 - value;
-	const whiteness = (1 - saturation) * value;
-
-	return {
-		hue,
-		whiteness: whiteness * COLOR_MAX.percent,
-		blackness: blackness * COLOR_MAX.percent,
-		alpha: getAlphaValue((input as HSLAColor)?.alpha ?? COLOR_MAX.percent),
-	};
-}
-
-function convertHslToRgba(input: unknown): RGBAColor {
-	const hsl = isHslLike(input) ? getHslValue(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;
-
-	return {
-		alpha: getAlphaValue((input as HSLAColor)?.alpha ?? COLOR_MAX.percent),
-		blue: getHexValue(getHexyValue(hue, lightness, saturation, 4)),
-		green: getHexValue(getHexyValue(hue, lightness, saturation, 8)),
-		red: getHexValue(getHexyValue(hue, lightness, saturation, 0)),
-	};
-}
-
-export function getColorFromHsl<Type extends ColorType>(
-	state: ColorState,
-	type: Type,
-): NonNullable<ColorState[Type]> {
-	switch (type) {
-		case COLOR_TYPE.hex:
-			state.hex = hslToHex(state.hsl!);
-			break;
-
-		case COLOR_TYPE.hwb:
-			state.hwb = hslToHwb(state.hsl!);
-			break;
-
-		case COLOR_TYPE.rgb:
-			state.rgb = hslToRgb(state.hsl!);
-			break;
-	}
-
-	return state[type]!;
-}
-
-function getHexyValue(hue: number, lightness: number, saturation: number, value: number): number {
-	const part = (value + hue / 30) % 12;
-	const mod = saturation * Math.min(lightness, 1 - lightness);
-
-	return (lightness - mod * Math.max(-1, Math.min(part - 3, 9 - part, 1))) * COLOR_MAX.hex;
-}
-
-export function getHslValue(value: Record<keyof HSLColor, unknown>): HSLColor {
-	return {
-		hue: getDegrees(value.hue),
-		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
- */
-export function hslToHex(hsl: HSLAColor | HSLColor, alpha?: boolean): string {
-	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
- */
-export function hslToHwb(hsl: HSLAColor | HSLColor): HWBColor {
-	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
- */
-export function hslToHwba(hsl: HSLAColor | HSLColor): HWBAColor {
-	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_
- *
- * _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61_
- *
- * @param hsl HSL(A) color
- * @returns _RGB_ color
- */
-export function hslToRgb(hsl: HSLAColor | HSLColor): RGBColor {
-	const {blue, green, red} = convertHslToRgba(hsl);
-
-	return {
-		blue,
-		green,
-		red,
-	};
-}
-
-/**
- * Convert an _HSL(A)_ color to an _RGBA_ color
- *
- * _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
- */
-export function hslToRgba(hsl: HSLAColor | HSLColor): RGBAColor {
-	return convertHslToRgba(hsl);
-}
-
-// #endregion

package/src/color/space/hwb.ts

@@ -1,153 +0,0 @@
-import {COLOR_DEFAULTS, COLOR_MAX, COLOR_TYPE} from '../constants';
-import {getAlphaValue} from '../misc/alpha';
-import {getDegrees, getPercentage} from '../misc/get';
-import {isHwbLike} from '../misc/is';
-import type {
-	ColorState,
-	ColorType,
-	HSLAColor,
-	HSLColor,
-	HWBAColor,
-	HWBColor,
-	RGBAColor,
-	RGBColor,
-} from '../models';
-import {hslToRgb, hslToRgba} from './hsl';
-import {rgbToHex} from './rgb';
-
-// #region Functions
-
-export function convertHwbToHsl(input: HWBAColor | HWBColor): HSLAColor {
-	let {blackness, hue, whiteness} = isHwbLike(input) ? getHwbValue(input) : COLOR_DEFAULTS.hwb;
-
-	blackness /= COLOR_MAX.percent;
-	whiteness /= COLOR_MAX.percent;
-
-	if (blackness + whiteness > 1) {
-		const total = blackness + whiteness;
-
-		blackness /= total;
-		whiteness /= total;
-	}
-
-	const lightness = (1 - blackness + whiteness) / 2;
-
-	const saturation = getHwbSaturation(blackness, whiteness, lightness);
-
-	return {
-		hue,
-		saturation: saturation * COLOR_MAX.percent,
-		lightness: lightness * COLOR_MAX.percent,
-		alpha: getAlphaValue((input as HWBAColor)?.alpha ?? COLOR_MAX.percent),
-	};
-}
-
-export function getColorFromHwb<Type extends ColorType>(
-	state: ColorState,
-	type: Type,
-): NonNullable<ColorState[Type]> {
-	switch (type) {
-		case COLOR_TYPE.hex:
-			state.hex = hwbToHex(state.hwb!);
-			break;
-
-		case COLOR_TYPE.hsl:
-			state.hsl = hwbToHsl(state.hwb!);
-			break;
-
-		case COLOR_TYPE.rgb:
-			state.rgb = hwbToRgb(state.hwb!);
-			break;
-	}
-
-	return state[type]!;
-}
-
-function getHwbSaturation(blackness: number, whiteness: number, lightness: number): number {
-	const value = 1 - blackness;
-
-	const hue = value - whiteness;
-
-	if (hue <= 0) {
-		return 0;
-	}
-
-	return hue / Math.min(2 * lightness, 2 - 2 * lightness);
-}
-
-export function getHwbValue(value: Record<keyof HWBColor, unknown>): HWBColor {
-	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
- */
-export function hwbToHex(hwb: HWBAColor | HWBColor, alpha?: boolean): string {
-	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
- */
-export function hwbToHsl(hwb: HWBAColor | HWBColor): HSLColor {
-	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
- */
-export function hwbToHsla(hwb: HWBAColor | HWBColor): HSLAColor {
-	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
- */
-export function hwbToRgb(hwb: HWBAColor | HWBColor): RGBColor {
-	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
- */
-export function hwbToRgba(hwb: HWBAColor | HWBColor): RGBAColor {
-	return hslToRgba(hwbToHsla(hwb));
-}
-
-// #endregion