@lakuna/color 1.0.0

package/src/utility/xyzToLab.ts

@@ -0,0 +1,27 @@
+import type Lab from "../types/Lab.js";
+import StandardIlluminant from "./StandardIlluminant.js";
+import type Xyz from "../types/Xyz.js";
+import getReference from "./getReference.js";
+
+/**
+ * Convert the given CIEXYZ color to a CIELAB color. Based on the EasyRGB pseudo-code.
+ * @param color - The CIEXYZ color.
+ * @param ref - A standard illuminant that represents the white point.
+ * @returns A CIELAB color.
+ * @public
+ */
+export default function xyzToLab(
+	color: Xyz,
+	ref: Xyz = getReference(StandardIlluminant.D65_2)
+): Lab {
+	const i0 = color[0] / ref[0];
+	const i1 = color[1] / ref[1];
+	const i2 = color[2] / ref[2];
+	const i3 = i1 > 0.008856 ? i1 ** 0.33333333 : 7.787 * i1 + 0.13793103; // `1 / 3`; `16 / 116`
+
+	return [
+		116 * i3 - 16,
+		500 * ((i0 > 0.008856 ? i0 ** 0.33333333 : 7.787 * i0 + 0.13793103) - i3), // `1 / 3`; `16 / 116`
+		200 * (i3 - (i2 > 0.008856 ? i2 ** 0.33333333 : 7.787 * i2 + 0.13793103)) // `1 / 3`; `16 / 116`
+	];
+}

package/src/utility/xyzToLuv.ts

@@ -0,0 +1,38 @@
+import type Luv from "../types/Luv.js";
+import StandardIlluminant from "./StandardIlluminant.js";
+import type Xyz from "../types/Xyz.js";
+import getReference from "./getReference.js";
+
+/**
+ * Convert the given CIEXYZ color to a CIELUV color. Based on the EasyRGB pseudo-code.
+ * @param color - The CIEXYZ color.
+ * @param ref - A standard illuminant that represents the white point.
+ * @returns A CIELUV color.
+ * @public
+ */
+export default function xyzToLuv(
+	color: Xyz,
+	ref: Xyz = getReference(StandardIlluminant.D65_2)
+): Luv {
+	// eslint-disable-next-line prefer-destructuring
+	const x = color[0];
+	// eslint-disable-next-line prefer-destructuring
+	const y = color[1];
+	// eslint-disable-next-line prefer-destructuring
+	const rx = ref[0];
+	// eslint-disable-next-line prefer-destructuring
+	const ry = ref[1];
+
+	const i0 = x + 15 * y + 3 * color[2];
+	const i1 = rx + 15 * ry + 3 * ref[2];
+	const i2 = y / 100;
+	const l =
+		116 * (i2 > 0.008856 ? i2 ** 0.33333333 : 7.787 * i2 + 0.13793103) - 16; // `1 / 3`; `16 / 116`
+	const i3 = 13 * l;
+
+	return [
+		l,
+		i3 * ((4 * x) / i0 - (4 * rx) / i1),
+		i3 * ((9 * y) / i0 - (9 * ry) / i1)
+	];
+}

package/src/utility/xyzToRgb.ts

@@ -0,0 +1,23 @@
+import type Rgb from "../types/Rgb.js";
+import type Xyz from "../types/Xyz.js";
+
+/**
+ * Convert the given CIEXYZ D65/2° standard illuminant color to an sRGB color. Based on the EasyRGB pseudo-code.
+ * @param color - The CIEXYZ color.
+ * @returns An sRGB color.
+ * @public
+ */
+export default function xyzToRgb(color: Xyz): Rgb {
+	const i0 = color[0] / 100;
+	const i1 = color[1] / 100;
+	const i2 = color[2] / 100;
+	const i3 = i0 * 3.2406 + i1 * -1.5372 + i2 * -0.4986;
+	const i4 = i0 * -0.9689 + i1 * 1.8758 + i2 * 0.0415;
+	const i5 = i0 * 0.0557 + i1 * -0.204 + i2 * 1.057;
+
+	return [
+		(i3 > 0.0031308 ? 1.055 * i3 ** 0.41666666 - 0.055 : i3 * 12.92) * 0xff, // `1 / 2.4`
+		(i4 > 0.0031308 ? 1.055 * i4 ** 0.41666666 - 0.055 : i4 * 12.92) * 0xff, // `1 / 2.4`
+		(i5 > 0.0031308 ? 1.055 * i5 ** 0.41666666 - 0.055 : i5 * 12.92) * 0xff // `1 / 2.4`
+	];
+}

package/src/utility/xyzToYxy.ts

@@ -0,0 +1,19 @@
+import type Xyz from "../types/Xyz.js";
+import type Yxy from "../types/Yxy.js";
+
+/**
+ * Convert the given CIEXYZ color to Yxy format. Based on the EasyRGB pseudo-code.
+ * @param color - The CIEXYZ color.
+ * @returns The CIEXYZ color in yxy format.
+ * @public
+ */
+export default function xyzToYxy(color: Xyz): Yxy {
+	// eslint-disable-next-line prefer-destructuring
+	const X = color[0];
+	// eslint-disable-next-line prefer-destructuring
+	const Y = color[1];
+	// eslint-disable-next-line prefer-destructuring
+	const Z = color[2];
+
+	return [Y, X / (X + Y + Z), Y / (X + Y + Z)];
+}

package/src/utility/yxyToXyz.ts

@@ -0,0 +1,19 @@
+import type Xyz from "../types/Xyz.js";
+import type Yxy from "../types/Yxy.js";
+
+/**
+ * Convert a CIEXYZ color from Yxy format to XYZ format. Based on the EasyRGB pseudo-code.
+ * @param color - The CIEXYZ color in Yxy format.
+ * @returns A CIEXYZ color.
+ * @public
+ */
+export default function yxyToXyz(color: Yxy): Xyz {
+	// eslint-disable-next-line prefer-destructuring
+	const Y = color[0];
+	// eslint-disable-next-line prefer-destructuring
+	const x = color[1];
+	// eslint-disable-next-line prefer-destructuring
+	const y = color[2];
+
+	return [x * (Y / y), Y, (1 - x - y) * (Y / y)];
+}