css-color-parser: skip whitepoint conversion when it isn't needed during color conversion

Author: romainmenke

packages/color-helpers/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changes to Color Helpers
 
+### Unreleased (minor)
+
+- Add `d65` conversion helpers
+
 ### 6.0.2
 
 _February 21, 2026_

packages/color-helpers/dist/index.d.ts

@@ -7,6 +7,15 @@
  */
 export declare function a98_RGB_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function a98_RGB_to_XYZ_D65(x: Color): Color;
+
 export declare function clip(color: Color): Color;
 
 export declare type Color = [number, number, number];
@@ -46,6 +55,15 @@ export declare function gam_sRGB(RGB: Color): Color;
  */
 export declare function HSL_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [h, s, l]
+ * - Hue as degrees 0..360;
+ * - Saturation as number 0..100;
+ * - Lightness as number 0..100;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function HSL_to_XYZ_D65(x: Color): Color;
+
 /**
  * @param {Color} color [h, w, b]
  * - Hue as degrees 0..360;
@@ -55,6 +73,15 @@ export declare function HSL_to_XYZ_D50(x: Color): Color;
  */
 export declare function HWB_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [h, w, b]
+ * - Hue as degrees 0..360;
+ * - Whiteness as number 0..100;
+ * - Blackness as number 0..100;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function HWB_to_XYZ_D65(x: Color): Color;
+
 export declare function inGamut(x: Color): boolean;
 
 /**
@@ -66,6 +93,15 @@ export declare function inGamut(x: Color): boolean;
  */
 export declare function Lab_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [l, a, b]
+ * - Lightness as number 0..100;
+ * - a as number -160..160;
+ * - b as number -160..160;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function Lab_to_XYZ_D65(x: Color): Color;
+
 /**
  * @param {Color} color [l, c, h]
  * - Lightness as number 0..100;
@@ -75,6 +111,15 @@ export declare function Lab_to_XYZ_D50(x: Color): Color;
  */
 export declare function LCH_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [l, c, h]
+ * - Lightness as number 0..100;
+ * - Chroma as number 0..230;
+ * - Hue as degrees 0..360;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function LCH_to_XYZ_D65(x: Color): Color;
+
 /**
  * Convert an array of display-p3 RGB values in the range 0.0 - 1.0
  * to linear light (un-companded) form.
@@ -103,6 +148,15 @@ export declare function lin_P3_to_XYZ(rgb: Color): Color;
  */
 export declare function lin_P3_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function lin_P3_to_XYZ_D65(x: Color): Color;
+
 /**
  * Convert an array of of sRGB values where in-gamut values are in the range
  * [0 - 1] to linear light (un-companded) form.
@@ -134,6 +188,15 @@ export declare function lin_sRGB_to_XYZ(rgb: Color): Color;
  */
 export declare function lin_sRGB_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function lin_sRGB_to_XYZ_D65(x: Color): Color;
+
 export declare function mapGamut(startOKLCH: Color, toDestination: (x: Color) => Color, fromDestination: (x: Color) => Color): Color;
 
 /**
@@ -168,6 +231,15 @@ export declare function OKLab_to_XYZ(OKLab: Color): Color;
  */
 export declare function OKLab_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [l, a, b]
+ * - Lightness as number 0..1;
+ * - a as number 0..0.5;
+ * - b as number 0..0.5;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function OKLab_to_XYZ_D65(x: Color): Color;
+
 /**
  * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
  * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
@@ -184,6 +256,15 @@ export declare function OKLCH_to_OKLab(OKLCH: Color): Color;
  */
 export declare function OKLCH_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [l, c, h]
+ * - Lightness as number 0..1;
+ * - Chroma as number 0..0.5;
+ * - Hue as degrees 0..360;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function OKLCH_to_XYZ_D65(x: Color): Color;
+
 /**
  * @param {Color} color [r, g, b]
  * - Red as number 0..1;
@@ -193,6 +274,15 @@ export declare function OKLCH_to_XYZ_D50(x: Color): Color;
  */
 export declare function P3_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function P3_to_XYZ_D65(x: Color): Color;
+
 /**
  * @param {Color} color [r, g, b]
  * - Red as number 0..1;
@@ -202,6 +292,15 @@ export declare function P3_to_XYZ_D50(x: Color): Color;
  */
 export declare function ProPhoto_RGB_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function ProPhoto_RGB_to_XYZ_D65(x: Color): Color;
+
 /**
  * @param {Color} color [r, g, b]
  * - Red as number 0..1;
@@ -211,6 +310,15 @@ export declare function ProPhoto_RGB_to_XYZ_D50(x: Color): Color;
  */
 export declare function rec_2020_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function rec_2020_to_XYZ_D65(x: Color): Color;
+
 /**
  * @param {Color} color [r, g, b]
  * - Red as number 0..1;
@@ -220,6 +328,15 @@ export declare function rec_2020_to_XYZ_D50(x: Color): Color;
  */
 export declare function sRGB_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function sRGB_to_XYZ_D65(x: Color): Color;
+
 /**
  * @param {Color} color [x, y, z]
  * - X as number 0..1;
@@ -394,6 +511,162 @@ export declare function XYZ_D50_to_XYZ_D50(x: Color): Color;
  */
 export declare function XYZ_D50_to_XYZ_D65(x: Color): Color;
 
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} a98 sRGB [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ */
+export declare function XYZ_D65_to_a98_RGB(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} HSL [r, g, b]
+ * - Hue as degrees 0..360;
+ * - Saturation as number 0..100;
+ * - Lightness as number 0..100;
+ */
+export declare function XYZ_D65_to_HSL(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} HWB [r, g, b]
+ * - Hue as degrees 0..360;
+ * - Whiteness as number 0..100;
+ * - Blackness as number 0..100;
+ */
+export declare function XYZ_D65_to_HWB(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} Lab [r, g, b]
+ * - Lightness as number 0..100;
+ * - a as number -160..160;
+ * - b as number -160..160;
+ */
+export declare function XYZ_D65_to_Lab(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} LCH [r, g, b]
+ * - Lightness as number 0..100;
+ * - Chroma as number 0..230;
+ * - Hue as degrees 0..360;
+ */
+export declare function XYZ_D65_to_LCH(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} P3 [r, g, b]
+ * - R as number 0..1;
+ * - G as number 0..1;
+ * - B as number 0..1;
+ */
+export declare function XYZ_D65_to_lin_P3(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} linear sRGB [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ */
+export declare function XYZ_D65_to_lin_sRGB(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} OKLab [r, g, b]
+ * - Lightness as number 0..1;
+ * - a as number 0..0.5;
+ * - b as number 0..0.5;
+ */
+export declare function XYZ_D65_to_OKLab(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} OKLCH [r, g, b]
+ * - Lightness as number 0..1;
+ * - Chroma as number 0..0.5;
+ * - Hue as degrees 0..360;
+ */
+export declare function XYZ_D65_to_OKLCH(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} P3 [r, g, b]
+ * - R as number 0..1;
+ * - G as number 0..1;
+ * - B as number 0..1;
+ */
+export declare function XYZ_D65_to_P3(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} ProPhoto [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ */
+export declare function XYZ_D65_to_ProPhoto(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} rec 2020 [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ */
+export declare function XYZ_D65_to_rec_2020(x: Color): Color;
+
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} sRGB [r, g, b]
+ * - Red as number 0..1;
+ * - Green as number 0..1;
+ * - Blue as number 0..1;
+ */
+export declare function XYZ_D65_to_sRGB(x: Color): Color;
+
 /**
  * @param {Color} color [x, y, z]
  * - X as number 0..1;
@@ -403,6 +676,15 @@ export declare function XYZ_D50_to_XYZ_D65(x: Color): Color;
  */
 export declare function XYZ_D65_to_XYZ_D50(x: Color): Color;
 
+/**
+ * @param {Color} color [x, y, z]
+ * - X as number 0..1;
+ * - Y as number 0..1;
+ * - Z as number 0..1;
+ * @return {Color} D50 XYZ [x, y, z]
+ */
+export declare function XYZ_D65_to_XYZ_D65(x: Color): Color;
+
 /**
  * Convert XYZ to linear-light P3
  *