Color improvements and add OKLab

Author: williamngan

bench/baselines/node24-linux-x64-intel-core-i9-9820x-3-30ghz.json

@@ -86,6 +86,22 @@ export default defineSuite("color", (b, { Pts, fx }) => {
         sink(acc);
       },
     });
+
+    // The normalized flags take a different path (denormalize on the way
+    // in, map through Color.ranges on the way out), so measure it too.
+    b.case(`Color.${name} (normalized)`, {
+      batch: N,
+      setupOnce: () =>
+        fx
+          .colors(`color:${name}:normalized`, N, sourceMode)
+          .map((c) => c.$normalize()),
+      run: (source) => {
+        let acc = 0;
+        for (let i = 0; i < N; i++)
+          acc += Color[name](source[i], true, true)[0];
+        sink(acc);
+      },
+    });
   }
 
   b.case("Color.toMode (no conversion)", {

bench/suites/color.bench.mjs

@@ -139,7 +139,7 @@ type CanvasSpaceOptions = {
   offscreen?: boolean;
   pixelDensity?: number;
 };
-type ColorType = "rgb" | "hsl" | "hsb" | "lab" | "lch" | "luv" | "xyz";
+type ColorType = "rgb" | "hsl" | "hsb" | "lab" | "lch" | "luv" | "xyz" | "oklab" | "oklch";
 type DelaunayShape = {
   i: number;
   j: number;
@@ -969,11 +969,15 @@ declare class Color extends Pt {
   static lch(...args: any[]): Color;
   static luv(...args: any[]): Color;
   static xyz(...args: any[]): Color;
+  static oklab(...args: any[]): Color;
+  static oklch(...args: any[]): Color;
   static maxValues(mode: string): Pt;
   get hex(): string;
   get rgb(): string;
   get rgba(): string;
   clone(): Color;
+  private static _denorm;
+  private static _normOut;
   toMode(mode: ColorType, convert?: boolean): this;
   get mode(): ColorType;
   get r(): number;
@@ -1021,6 +1025,12 @@ declare class Color extends Pt {
   static LUVtoXYZ(luv: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
   static LABtoLCH(lab: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
   static LCHtoLAB(lch: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static RGBtoOKLAB(rgb: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLABtoRGB(oklab: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static RGBtoOKLCH(rgb: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLCHtoRGB(oklch: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLABtoOKLCH(oklab: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLCHtoOKLAB(oklch: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
 }
 //#endregion
 //#region src/Util.d.ts

dist/index.d.mts

@@ -139,7 +139,7 @@ type CanvasSpaceOptions = {
   offscreen?: boolean;
   pixelDensity?: number;
 };
-type ColorType = "rgb" | "hsl" | "hsb" | "lab" | "lch" | "luv" | "xyz";
+type ColorType = "rgb" | "hsl" | "hsb" | "lab" | "lch" | "luv" | "xyz" | "oklab" | "oklch";
 type DelaunayShape = {
   i: number;
   j: number;
@@ -969,11 +969,15 @@ declare class Color extends Pt {
   static lch(...args: any[]): Color;
   static luv(...args: any[]): Color;
   static xyz(...args: any[]): Color;
+  static oklab(...args: any[]): Color;
+  static oklch(...args: any[]): Color;
   static maxValues(mode: string): Pt;
   get hex(): string;
   get rgb(): string;
   get rgba(): string;
   clone(): Color;
+  private static _denorm;
+  private static _normOut;
   toMode(mode: ColorType, convert?: boolean): this;
   get mode(): ColorType;
   get r(): number;
@@ -1021,6 +1025,12 @@ declare class Color extends Pt {
   static LUVtoXYZ(luv: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
   static LABtoLCH(lab: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
   static LCHtoLAB(lch: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static RGBtoOKLAB(rgb: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLABtoRGB(oklab: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static RGBtoOKLCH(rgb: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLCHtoRGB(oklch: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLABtoOKLCH(oklab: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
+  static OKLCHtoOKLAB(oklch: Color, normalizedInput?: boolean, normalizedOutput?: boolean): Color;
 }
 //#endregion
 //#region src/Util.d.ts