ph-utils 0.20.1 → 1.0.0

package/lib/color-CUZrwrjD.js

@@ -0,0 +1,206 @@
+//#region src/color.ts
+const hueStep = 2;
+const saturationStep = .16;
+const saturationStep2 = .05;
+const brightnessStep1 = .05;
+const brightnessStep2 = .15;
+const rgbRegex = /^\s*rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*(\d*\.?\d+)\s*)?\)\s*$/;
+const hexRegex = /^#(?:([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})|([0-9A-Fa-f])([0-9A-Fa-f])([0-9A-Fa-f]))$/;
+const clamp = (value, min, max) => value < min ? min : value > max ? max : value;
+const clamp01 = (value) => clamp(value, 0, 1);
+const round2 = (value) => Math.round(value * 100) / 100;
+function isRgb(color) {
+	return color?.r != null && color?.g != null && color?.b != null;
+}
+function isHsv(color) {
+	return color?.h != null && color?.s != null && color?.v != null;
+}
+function parseRgbString(color) {
+	const colorValue = color.match(rgbRegex);
+	if (colorValue == null) return;
+	const r = parseInt(colorValue[1], 10);
+	const g = parseInt(colorValue[2], 10);
+	const b = parseInt(colorValue[3], 10);
+	if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b)) throw new Error("Invalid RGB color.");
+	let a = 1;
+	if (colorValue[4] != null) {
+		a = parseFloat(colorValue[4]);
+		if (Number.isNaN(a)) a = 1;
+	}
+	return {
+		r,
+		g,
+		b,
+		a
+	};
+}
+function parseHexString(color) {
+	const colorMatch = color.match(hexRegex);
+	if (colorMatch == null) return;
+	const isShortForm = colorMatch[4] !== void 0;
+	const r = parseInt(isShortForm ? colorMatch[4] + colorMatch[4] : colorMatch[1], 16);
+	const g = parseInt(isShortForm ? colorMatch[5] + colorMatch[5] : colorMatch[2], 16);
+	const b = parseInt(isShortForm ? colorMatch[6] + colorMatch[6] : colorMatch[3], 16);
+	if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b)) throw new Error("Invalid HEX color.");
+	return {
+		r,
+		g,
+		b
+	};
+}
+/**
+* 将输入的颜色值转换为RGB对象格式。
+* @param color 可以是字符串, 也可以是一个 HSV 对象[一个包含 h、s、v 属性的对象]
+* @returns 返回一个包含r、g、b和a（透明度）属性的RGB对象。
+* @throws 如果输入的字符串不是有效的颜色表示，则抛出错误。
+*/
+function toRgb(color) {
+	if (typeof color === "string") {
+		const rgb = parseHexString(color) ?? parseRgbString(color);
+		if (rgb != null) return rgb;
+		throw new Error("Invalid color string");
+	}
+	if (isRgb(color)) return color;
+	if (isHsv(color)) return hsvToRgb(color);
+	throw new Error("Invalid color");
+}
+/**
+* 将颜色转换为HSV颜色模型。
+* @param color - 字符串或者RGB对象
+* @returns 返回一个包含h、s、v属性的对象，代表HSV颜色值，其中h是色相（取值范围0到360），s是饱和度（取值范围0到1），v是明度（取值范围0到1）。
+*/
+function toHsv(color) {
+	if (isHsv(color)) return color;
+	const rgbColor = toRgb(color);
+	const r = rgbColor.r / 255;
+	const g = rgbColor.g / 255;
+	const b = rgbColor.b / 255;
+	const max = Math.max(r, g, b);
+	const delta = max - Math.min(r, g, b);
+	const v = max;
+	const s = max === 0 ? 0 : delta / max;
+	if (delta === 0) return {
+		h: 0,
+		s,
+		v
+	};
+	let h = 0;
+	switch (max) {
+		case r:
+			h = ((g - b) / delta + (g < b ? 6 : 0)) / 6;
+			break;
+		case g:
+			h = ((b - r) / delta + 2) / 6;
+			break;
+		case b: h = ((r - g) / delta + 4) / 6;
+	}
+	return {
+		h: h * 360,
+		s,
+		v
+	};
+}
+/**
+* 将HSV颜色模型转换为RGB颜色模型。
+* @param hsv 包含色相(h)、饱和度(s)和明度(v)的对象。s 和 v 可以是 0~1之间的小数, 也可以是 0~100 直接的整数, 推荐为小数，结果更精准
+* @returns 返回一个包含红色(r)、绿色(g)和蓝色(b)值的对象，范围为0-255。
+*/
+function hsvToRgb(hsv) {
+	const s = hsv.s > 1 ? hsv.s / 100 : hsv.s;
+	const v = hsv.v > 1 ? hsv.v / 100 : hsv.v;
+	const hh = (hsv.h % 360 + 360) % 360 / 60;
+	const hi = Math.floor(hh);
+	const f = hh - hi;
+	const p = v * (1 - s);
+	const q = v * (1 - f * s);
+	const t = v * (1 - (1 - f) * s);
+	let r = 0;
+	let g = 0;
+	let b = 0;
+	switch (hi) {
+		case 0:
+			r = v;
+			g = t;
+			b = p;
+			break;
+		case 1:
+			r = q;
+			g = v;
+			b = p;
+			break;
+		case 2:
+			r = p;
+			g = v;
+			b = t;
+			break;
+		case 3:
+			r = p;
+			g = q;
+			b = v;
+			break;
+		case 4:
+			r = t;
+			g = p;
+			b = v;
+			break;
+		case 5:
+			r = v;
+			g = p;
+			b = q;
+	}
+	return {
+		r: Math.round(r * 255),
+		g: Math.round(g * 255),
+		b: Math.round(b * 255)
+	};
+}
+function getHue(hsv, i, light) {
+	const h = Math.round(hsv.h);
+	return ((h >= 60 && h <= 240 ? light ? h - hueStep * i : h + hueStep * i : light ? h + hueStep * i : h - hueStep * i) % 360 + 360) % 360;
+}
+function getSaturation(hsv, i, light) {
+	if (hsv.h === 0 && hsv.s === 0) return hsv.s;
+	const saturation = light ? hsv.s - saturationStep * i : hsv.s + saturationStep2 * i;
+	return round2(clamp(saturation, .06, 1));
+}
+function getValue(hsv, i, light) {
+	const value = light ? hsv.v + brightnessStep1 * i : hsv.v - brightnessStep2 * i;
+	return round2(clamp01(value));
+}
+/**
+* 将RGB颜色对象转换为十六进制颜色字符串。
+* @param rgb - 包含红色(r), 绿色(g), 蓝色(b)成分的对象。
+* @returns 返回一个表示RGB颜色的十六进制字符串，例如"#FF0000"。
+*/
+function rgbToHex(rgb) {
+	const toHex = (n) => n.toString(16).padStart(2, "0");
+	return `#${toHex(rgb.r)}${toHex(rgb.g)}${toHex(rgb.b)}`.toUpperCase();
+}
+/**
+* 将颜色转换为 16 进制字符串
+* @param color - 颜色, 可以 rgb(0,0,0),rgba(0,0,0,0)字符串, 也可以是 rgb、hsv对象
+* @returns 返回颜色的十六进制字符串，例如"#FF0000"
+*/
+function toHex(color) {
+	if (typeof color === "string" && hexRegex.test(color)) return color;
+	return rgbToHex(toRgb(color));
+}
+/**
+* 调整给定颜色深[darken]浅[lighten]
+* @param color - 输入的颜色，可以是任意颜色表示方式
+* @param level - 调整深浅级别, 可以是小数。默认: 1
+* @param light - 控制调整的方向。如果为true，[lighten] 变浅，如果为false，[darken] 变深。默认: true
+* 1. 颜色变浅
+* adjust('#4998f4', 3, true)
+* @returns 返回调整后颜色的十六进制字符串表示。
+*/
+function adjust(color, level = 1, light = true) {
+	const hsv = toHsv(color);
+	return toHex({
+		h: getHue(hsv, level, light),
+		s: getSaturation(hsv, level, light),
+		v: getValue(hsv, level, light)
+	});
+}
+//#endregion
+export { toRgb as a, toHsv as i, rgbToHex as n, toHex as r, adjust as t };