@thi.ng/color 4.1.5 → 5.0.0

package/max-chroma.js

@@ -0,0 +1,240 @@
+import { clamp01 } from "@thi.ng/math/interval";
+import { mix, mixBilinear } from "@thi.ng/math/mix";
+import { fract } from "@thi.ng/math/prec";
+import { lch } from "./lch/lch.js";
+// LUT generated via tools/max-chroma.ts
+/** @internal */
+const MAX_CHROMA = [
+    [
+        4, 22, 30, 34, 38, 43, 47, 52, 56, 61, 66, 70, 75, 80, 84, 74, 65, 56,
+        47, 39, 32, 25, 18, 11, 5,
+    ],
+    [
+        4, 22, 30, 34, 39, 43, 48, 52, 57, 61, 66, 71, 75, 80, 82, 72, 63, 54,
+        46, 38, 31, 24, 17, 10, 5,
+    ],
+    [
+        4, 22, 31, 35, 39, 44, 49, 53, 58, 63, 67, 72, 77, 82, 83, 73, 63, 54,
+        46, 38, 31, 24, 17, 10, 5,
+    ],
+    [
+        3, 20, 32, 37, 41, 46, 51, 55, 60, 65, 70, 75, 80, 85, 85, 74, 65, 55,
+        47, 39, 31, 24, 17, 10, 5,
+    ],
+    [
+        2, 15, 27, 39, 44, 49, 54, 59, 64, 69, 75, 80, 85, 90, 89, 78, 67, 57,
+        48, 40, 32, 25, 18, 10, 5,
+    ],
+    [
+        2, 11, 22, 32, 43, 53, 59, 64, 70, 76, 81, 87, 93, 99, 96, 84, 72, 61,
+        51, 42, 34, 26, 19, 11, 5,
+    ],
+    [
+        1, 10, 19, 27, 36, 44, 52, 59, 66, 72, 77, 83, 88, 93, 98, 92, 79, 67,
+        56, 45, 36, 28, 20, 12, 6,
+    ],
+    [
+        1, 9, 17, 24, 31, 38, 45, 51, 57, 61, 66, 70, 75, 79, 84, 88, 90, 75,
+        62, 51, 40, 30, 22, 13, 6,
+    ],
+    [
+        1, 8, 15, 22, 28, 35, 40, 46, 50, 54, 58, 62, 66, 70, 74, 78, 82, 86,
+        73, 59, 46, 35, 24, 15, 7,
+    ],
+    [
+        1, 7, 13, 20, 26, 32, 37, 42, 46, 50, 53, 57, 61, 64, 68, 72, 75, 79,
+        83, 72, 55, 41, 29, 18, 8,
+    ],
+    [
+        1, 7, 12, 19, 25, 30, 35, 40, 43, 47, 50, 54, 57, 60, 64, 67, 71, 74,
+        78, 81, 73, 53, 36, 22, 10,
+    ],
+    [
+        1, 7, 12, 19, 24, 29, 34, 38, 42, 45, 48, 51, 55, 58, 61, 65, 68, 71,
+        75, 78, 82, 79, 50, 29, 12,
+    ],
+    [
+        1, 7, 12, 19, 24, 29, 33, 37, 41, 44, 47, 50, 54, 57, 60, 63, 67, 70,
+        73, 77, 80, 83, 86, 48, 19,
+    ],
+    [
+        1, 7, 12, 19, 24, 29, 33, 37, 41, 44, 47, 50, 53, 57, 60, 63, 66, 70,
+        73, 76, 80, 83, 86, 90, 45,
+    ],
+    [
+        1, 7, 12, 19, 25, 30, 34, 38, 41, 44, 48, 51, 54, 58, 61, 64, 67, 71,
+        74, 78, 81, 84, 88, 91, 94,
+    ],
+    [
+        1, 7, 13, 20, 26, 31, 35, 39, 43, 46, 49, 53, 56, 60, 63, 66, 70, 73,
+        77, 80, 84, 87, 91, 94, 60,
+    ],
+    [
+        1, 8, 15, 21, 27, 33, 37, 42, 45, 49, 52, 56, 59, 63, 66, 70, 74, 77,
+        81, 85, 88, 92, 96, 96, 44,
+    ],
+    [
+        1, 9, 16, 23, 29, 35, 40, 45, 49, 52, 56, 60, 64, 68, 72, 76, 80, 84,
+        87, 91, 95, 99, 103, 77, 35,
+    ],
+    [
+        1, 10, 18, 26, 33, 39, 44, 48, 52, 56, 60, 65, 69, 73, 77, 82, 86, 90,
+        94, 99, 103, 107, 110, 65, 30,
+    ],
+    [
+        2, 10, 21, 28, 30, 34, 37, 40, 44, 47, 51, 55, 58, 62, 65, 69, 73, 76,
+        80, 83, 87, 91, 94, 58, 26,
+    ],
+    [
+        1, 10, 18, 24, 26, 29, 32, 35, 38, 41, 44, 47, 50, 53, 56, 60, 63, 66,
+        69, 72, 75, 78, 81, 52, 24,
+    ],
+    [
+        1, 8, 15, 21, 23, 26, 28, 31, 33, 36, 39, 42, 44, 47, 50, 53, 55, 58,
+        61, 64, 66, 69, 72, 48, 22,
+    ],
+    [
+        1, 7, 13, 19, 21, 23, 25, 28, 30, 33, 35, 37, 40, 42, 45, 47, 50, 52,
+        55, 57, 60, 62, 65, 46, 21,
+    ],
+    [
+        1, 7, 12, 17, 19, 21, 23, 25, 28, 30, 32, 34, 37, 39, 41, 44, 46, 48,
+        50, 53, 55, 57, 60, 44, 20,
+    ],
+    [
+        1, 6, 11, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 39, 41, 43, 45,
+        47, 49, 51, 54, 56, 43, 19,
+    ],
+    [
+        1, 6, 11, 15, 17, 19, 21, 23, 25, 27, 29, 31, 33, 35, 37, 39, 41, 43,
+        45, 47, 49, 51, 53, 43, 19,
+    ],
+    [
+        1, 6, 10, 15, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 35, 37, 39, 41,
+        43, 45, 47, 49, 51, 43, 20,
+    ],
+    [
+        1, 6, 10, 13, 16, 18, 20, 21, 23, 25, 27, 29, 31, 33, 35, 37, 39, 41,
+        43, 45, 46, 48, 49, 33, 16,
+    ],
+    [
+        1, 6, 10, 13, 16, 18, 19, 21, 23, 25, 27, 29, 31, 33, 35, 37, 39, 41,
+        42, 44, 46, 48, 37, 25, 11,
+    ],
+    [
+        1, 7, 11, 13, 16, 18, 20, 22, 23, 25, 27, 29, 31, 33, 35, 37, 39, 41,
+        43, 45, 47, 40, 30, 20, 10,
+    ],
+    [
+        1, 7, 11, 15, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, 40, 42,
+        44, 46, 43, 34, 26, 17, 8,
+    ],
+    [
+        1, 7, 12, 15, 17, 19, 21, 23, 25, 27, 29, 31, 34, 36, 38, 40, 42, 44,
+        46, 46, 38, 31, 23, 15, 7,
+    ],
+    [
+        1, 8, 13, 16, 18, 20, 22, 25, 27, 29, 31, 33, 36, 38, 40, 42, 45, 47,
+        49, 42, 35, 28, 21, 13, 7,
+    ],
+    [
+        1, 10, 15, 18, 20, 22, 24, 27, 29, 31, 34, 36, 39, 41, 43, 46, 48, 51,
+        46, 40, 33, 26, 19, 12, 6,
+    ],
+    [
+        2, 10, 17, 19, 22, 24, 27, 29, 32, 35, 37, 40, 43, 45, 48, 51, 53, 51,
+        44, 38, 31, 25, 18, 11, 6,
+    ],
+    [
+        2, 13, 19, 22, 25, 28, 30, 33, 36, 39, 42, 45, 48, 51, 54, 57, 56, 49,
+        43, 37, 30, 24, 18, 11, 6,
+    ],
+    [
+        3, 17, 22, 26, 29, 32, 36, 39, 42, 46, 49, 53, 56, 60, 63, 62, 55, 49,
+        43, 36, 30, 24, 18, 11, 6,
+    ],
+    [
+        6, 23, 27, 31, 35, 39, 43, 47, 51, 56, 60, 64, 68, 73, 69, 62, 56, 49,
+        43, 36, 30, 24, 18, 11, 6,
+    ],
+    [
+        18, 30, 34, 39, 44, 49, 54, 60, 65, 70, 76, 81, 84, 77, 70, 64, 57, 50,
+        44, 37, 31, 25, 18, 11, 6,
+    ],
+    [
+        12, 41, 45, 52, 59, 66, 73, 80, 87, 94, 102, 95, 88, 81, 74, 66, 60, 53,
+        46, 39, 32, 26, 19, 11, 6,
+    ],
+    [
+        9, 58, 65, 75, 85, 96, 106, 117, 124, 116, 109, 101, 93, 86, 78, 71, 63,
+        56, 49, 42, 34, 27, 20, 12, 6,
+    ],
+    [
+        7, 42, 58, 66, 74, 82, 91, 99, 108, 117, 119, 110, 102, 94, 85, 77, 69,
+        61, 53, 45, 37, 30, 22, 13, 7,
+    ],
+    [
+        6, 34, 47, 53, 60, 67, 74, 81, 88, 95, 102, 109, 114, 105, 95, 86, 77,
+        68, 59, 51, 42, 33, 25, 16, 8,
+    ],
+    [
+        5, 29, 40, 46, 52, 57, 63, 70, 76, 82, 88, 94, 100, 107, 110, 100, 89,
+        79, 69, 58, 48, 38, 29, 19, 9,
+    ],
+    [
+        4, 26, 36, 41, 46, 52, 57, 62, 68, 73, 79, 85, 90, 96, 101, 104, 91, 79,
+        67, 56, 45, 35, 26, 17, 8,
+    ],
+    [
+        4, 24, 34, 38, 43, 48, 53, 58, 63, 68, 73, 78, 83, 88, 94, 91, 79, 69,
+        59, 49, 40, 31, 23, 15, 7,
+    ],
+    [
+        4, 23, 32, 36, 40, 45, 50, 55, 59, 64, 69, 74, 79, 84, 89, 82, 72, 62,
+        53, 44, 36, 28, 20, 12, 6,
+    ],
+    [
+        4, 22, 31, 35, 39, 44, 48, 53, 57, 62, 67, 71, 76, 81, 86, 77, 67, 58,
+        50, 41, 33, 26, 19, 11, 6,
+    ],
+];
+const RES_H = MAX_CHROMA.length;
+const RES_L = MAX_CHROMA[0].length;
+export const maxChroma = (l, h) => {
+    h = fract(h);
+    l = clamp01(l);
+    if (l < 1) {
+        const h1 = (h * RES_H) | 0;
+        const l1 = (l * RES_L) | 0;
+        const lutH1 = MAX_CHROMA[h1];
+        const lutH2 = MAX_CHROMA[(h1 + 1) % RES_H];
+        return (mixBilinear(lutH1[l1], lutH2[l1], l1 < RES_L - 1 ? lutH1[l1 + 1] : 0, l1 < RES_L - 1 ? lutH2[l1 + 1] : 0, h * RES_H - h1, l * RES_L - l1) * 0.01);
+    }
+    return 0;
+};
+export const lchMaxChroma = (l, h, a = 1) => lch(l, maxChroma(l, h), h, a);
+export const maxLumaChroma = (h) => {
+    const h1 = (fract(h) * RES_H) | 0;
+    const t = h * RES_H - h1;
+    const [l1, c1] = __maxLC(MAX_CHROMA[h1]);
+    const [l2, c2] = __maxLC(MAX_CHROMA[(h1 + 1) % RES_H]);
+    return { l: mix(l1, l2, t) / RES_L, c: mix(c1, c2, t) * 0.01 };
+};
+export const lchMaxLumaChroma = (h, a = 1) => {
+    const max = maxLumaChroma(h);
+    return lch(max.l, max.c, h, a);
+};
+/** @internal */
+const __maxLC = (chroma) => {
+    let maxL = 0;
+    let maxC = 0;
+    for (let i = RES_L; i-- > 0;) {
+        if (chroma[i] >= maxC) {
+            maxC = chroma[i];
+            maxL = i;
+        }
+        else
+            break;
+    }
+    return [maxL, maxC];
+};

package/mix.d.ts

@@ -4,10 +4,10 @@ import type { ColorMixFn, TypedColor } from "./api.js";
  * HOF color mix function. Takes 4 scalar mix fns (one per color channel) and
  * returns new {@link ColorMixFn}.
  *
- * @param x
- * @param y
- * @param z
- * @param alpha
+ * @param x -
+ * @param y -
+ * @param z -
+ * @param alpha -
  */
 export declare const defMix: FnU4<FnN3, ColorMixFn>;
 /**
@@ -22,9 +22,9 @@ export declare const mixH: FnN3;
 /**
  * Single channel linear interpolation function.
  *
- * @param a
- * @param b
- * @param t
+ * @param a -
+ * @param b -
+ * @param t -
  */
 export declare const mixN: FnN3;
 export declare const mixHNNN: ColorMixFn<import("@thi.ng/vectors").ReadonlyVec>;
@@ -67,5 +67,5 @@ export declare const mixNNNN: ColorMixFn;
  * @param b -
  * @param t -
  */
-export declare const mix: import("@thi.ng/defmulti/api").MultiFn4<import("@thi.ng/vectors").Vec | null, TypedColor<any>, TypedColor<any>, number, import("@thi.ng/vectors").Vec>;
+export declare const mix: import("@thi.ng/defmulti").MultiFn4<import("@thi.ng/vectors").Vec | null, TypedColor<any>, TypedColor<any>, number, import("@thi.ng/vectors").Vec>;
 //# sourceMappingURL=mix.d.ts.map

package/mix.js

@@ -3,14 +3,15 @@ import { mix as $mix } from "@thi.ng/math/mix";
 import { fract } from "@thi.ng/math/prec";
 import { mixN4 } from "@thi.ng/vectors/mixn";
 import { setC4 } from "@thi.ng/vectors/setc";
+import { __dispatch1 } from "./internal/dispatch.js";
 /**
  * HOF color mix function. Takes 4 scalar mix fns (one per color channel) and
  * returns new {@link ColorMixFn}.
  *
- * @param x
- * @param y
- * @param z
- * @param alpha
+ * @param x -
+ * @param y -
+ * @param z -
+ * @param alpha -
  */
 export const defMix = (x, y, z, alpha) => (out, a, b, t) => setC4(out || a, x(a[0], b[0], t), y(a[1], b[1], t), z(a[2], b[2], t), alpha(a[3], b[3], t));
 /**
@@ -36,9 +37,9 @@ export const mixH = (a, b, t) => {
 /**
  * Single channel linear interpolation function.
  *
- * @param a
- * @param b
- * @param t
+ * @param a -
+ * @param b -
+ * @param t -
  */
 export const mixN = $mix;
 export const mixHNNN = defMix(mixH, mixN, mixN, mixN);
@@ -81,7 +82,7 @@ export const mixNNNN = mixN4;
  * @param b -
  * @param t -
  */
-export const mix = defmulti((_, a) => a.mode, {}, {
+export const mix = defmulti(__dispatch1, {}, {
     hcy: mixHNNN,
     hsi: mixHNNN,
     hsl: mixHNNN,

package/oklab/oklab-rgb.d.ts

@@ -3,8 +3,8 @@ import type { ColorOp } from "../api.js";
  * @remarks
  * Reference: https://bottosson.github.io/posts/oklab/
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export declare const oklabRgb: ColorOp;
 //# sourceMappingURL=oklab-rgb.d.ts.map

package/oklab/oklab-rgb.js

@@ -7,8 +7,8 @@ const LMS_CONE = [
  * @remarks
  * Reference: https://bottosson.github.io/posts/oklab/
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export const oklabRgb = (out, { 0: l, 1: a, 2: b, 3: alpha }) => __mulV33(out, LMS_CONE, [
     (l + 0.3963377774 * a + 0.2158037573 * b) ** 3,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/color",
-  "version": "4.1.5",
+  "version": "5.0.0",
   "description": "Array-based color types, CSS parsing, conversions, transformations, declarative theme generation, gradients, presets",
   "type": "module",
   "module": "./index.js",
@@ -32,30 +32,31 @@
     "doc:stats": "tools:module-stats",
     "pub": "yarn npm publish --access public",
     "test": "testament test",
+    "tool:maxchroma": "tools:node-esm tools/max-chroma.ts",
     "tool:swatches": "tools:node-esm tools/index.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.3.2",
-    "@thi.ng/arrays": "^2.1.2",
-    "@thi.ng/binary": "^3.1.2",
-    "@thi.ng/checks": "^3.1.2",
-    "@thi.ng/compare": "^2.1.2",
-    "@thi.ng/compose": "^2.1.2",
-    "@thi.ng/defmulti": "^2.1.2",
-    "@thi.ng/errors": "^2.1.2",
-    "@thi.ng/math": "^5.1.2",
-    "@thi.ng/random": "^3.2.2",
-    "@thi.ng/strings": "^3.3.0",
-    "@thi.ng/transducers": "^8.1.2",
-    "@thi.ng/vectors": "^7.4.1"
+    "@thi.ng/api": "^8.3.4",
+    "@thi.ng/arrays": "^2.2.0",
+    "@thi.ng/binary": "^3.2.0",
+    "@thi.ng/checks": "^3.1.4",
+    "@thi.ng/compare": "^2.1.4",
+    "@thi.ng/compose": "^2.1.4",
+    "@thi.ng/defmulti": "^2.1.4",
+    "@thi.ng/errors": "^2.1.4",
+    "@thi.ng/math": "^5.3.0",
+    "@thi.ng/random": "^3.2.4",
+    "@thi.ng/strings": "^3.3.2",
+    "@thi.ng/transducers": "^8.3.0",
+    "@thi.ng/vectors": "^7.5.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.18.19",
-    "@thi.ng/testament": "^0.2.2",
+    "@microsoft/api-extractor": "^7.19.4",
+    "@thi.ng/testament": "^0.2.4",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.22.9",
-    "typescript": "^4.5.2"
+    "typedoc": "^0.22.13",
+    "typescript": "^4.6.2"
   },
   "keywords": [
     "color",
@@ -239,6 +240,9 @@
     "./is-black": {
       "import": "./is-black.js"
     },
+    "./is-gamut": {
+      "import": "./is-gamut.js"
+    },
     "./is-gray": {
       "import": "./is-gray.js"
     },
@@ -272,6 +276,9 @@
     "./lch/lch": {
       "import": "./lch/lch.js"
     },
+    "./lighten": {
+      "import": "./lighten.js"
+    },
     "./linear": {
       "import": "./linear.js"
     },
@@ -281,6 +288,9 @@
     "./luminance": {
       "import": "./luminance.js"
     },
+    "./max-chroma": {
+      "import": "./max-chroma.js"
+    },
     "./mix": {
       "import": "./mix.js"
     },
@@ -335,6 +345,9 @@
     "./rgb/rgb": {
       "import": "./rgb/rgb.js"
     },
+    "./rotate": {
+      "import": "./rotate.js"
+    },
     "./sort": {
       "import": "./sort.js"
     },
@@ -350,12 +363,21 @@
     "./srgb/srgb": {
       "import": "./srgb/srgb.js"
     },
+    "./strategies": {
+      "import": "./strategies.js"
+    },
     "./swatches": {
       "import": "./swatches.js"
     },
+    "./tint": {
+      "import": "./tint.js"
+    },
     "./transform": {
       "import": "./transform.js"
     },
+    "./variations": {
+      "import": "./variations.js"
+    },
     "./xyy/xyy-xyz": {
       "import": "./xyy/xyy-xyz.js"
     },
@@ -399,5 +421,5 @@
       "vectors"
     ]
   },
-  "gitHead": "32cf1a96854f9bb97aca65ffa05ca862ea377059\n"
+  "gitHead": "0fc692a3225c068aacafdc4cb6140cf603c67ad8\n"
 }

package/rgb/rgb-lab.d.ts

@@ -6,15 +6,15 @@ import type { ColorOp } from "../api.js";
  * Important: We're using a normalized Lab space w/ all three coordinates
  * divided by 100 (normalized to 100% luminance).
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export declare const rgbLab: ColorOp;
 /**
  * Same as {@link rgbLab}, but using {@link D65} white point.
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export declare const rgbLabD65: ColorOp;
 //# sourceMappingURL=rgb-lab.d.ts.map

package/rgb/rgb-lab.js

@@ -7,14 +7,14 @@ import { xyzLab, xyzLabD65 } from "../xyz/xyz-lab.js";
  * Important: We're using a normalized Lab space w/ all three coordinates
  * divided by 100 (normalized to 100% luminance).
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export const rgbLab = (out, src) => xyzLab(null, rgbXyz(out, src));
 /**
  * Same as {@link rgbLab}, but using {@link D65} white point.
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export const rgbLabD65 = (out, src) => xyzLabD65(null, rgbXyzD65(out, src));

package/rgb/rgb-oklab.d.ts

@@ -3,8 +3,8 @@ import type { ColorOp } from "../api.js";
  * @remarks
  * Reference: https://bottosson.github.io/posts/oklab/
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export declare const rgbOklab: ColorOp;
 //# sourceMappingURL=rgb-oklab.d.ts.map

package/rgb/rgb-oklab.js

@@ -9,7 +9,7 @@ const CONE_LMS = [
  * @remarks
  * Reference: https://bottosson.github.io/posts/oklab/
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export const rgbOklab = (out, src) => __mulV33(null, OKLAB_M2, powN3(null, __mulV33(out, CONE_LMS, src), 1 / 3));

package/rgb/rgb-xyz.d.ts

@@ -14,8 +14,8 @@ export declare const rgbXyz: (out: Color | null, src: ReadonlyColor, mat?: numbe
  * Same as {@link rgbXyz}, but hard coded to use {@link D65} white point (via
  * {@link RGB_XYZ_D65} matrix).
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export declare const rgbXyzD65: ColorOp;
 //# sourceMappingURL=rgb-xyz.d.ts.map

package/rgb/rgb-xyz.js

@@ -16,7 +16,7 @@ export const rgbXyz = (out, src, mat = RGB_XYZ_D50) => __mulV33(null, mat, clamp
  * Same as {@link rgbXyz}, but hard coded to use {@link D65} white point (via
  * {@link RGB_XYZ_D65} matrix).
  *
- * @param out
- * @param src
+ * @param out -
+ * @param src -
  */
 export const rgbXyzD65 = (out, src) => rgbXyz(out, src, RGB_XYZ_D65);

package/rgb/rgb-ycc.d.ts

@@ -9,9 +9,9 @@ import type { Color, ReadonlyColor } from "../api.js";
  * - https://en.wikipedia.org/wiki/YCbCr#ITU-R_BT.709_conversion
  * - https://en.wikipedia.org/wiki/Rec._709
  *
- * @param out
- * @param src
- * @param luma
+ * @param out -
+ * @param src -
+ * @param luma -
  */
 export declare const rgbYcc: (out: Color | null, src: ReadonlyColor, luma?: number[]) => import("@thi.ng/vectors").Vec;
 //# sourceMappingURL=rgb-ycc.d.ts.map

package/rgb/rgb-ycc.js

@@ -12,9 +12,9 @@ import { __ensureAlpha } from "../internal/ensure.js";
  * - https://en.wikipedia.org/wiki/YCbCr#ITU-R_BT.709_conversion
  * - https://en.wikipedia.org/wiki/Rec._709
  *
- * @param out
- * @param src
- * @param luma
+ * @param out -
+ * @param src -
+ * @param luma -
  */
 export const rgbYcc = (out, src, luma = RGB_LUMINANCE_REC709) => {
     const y = dot3(src, luma);

package/rotate.d.ts

@@ -0,0 +1,4 @@
+import type { Color, TypedColor } from "./api.js";
+export declare const rotate: import("@thi.ng/defmulti").MultiFn3<import("@thi.ng/vectors").Vec | null, TypedColor<any>, number, import("@thi.ng/vectors").Vec>;
+export declare const complementary: (out: Color | null, src: TypedColor<any>) => import("@thi.ng/vectors").Vec;
+//# sourceMappingURL=rotate.d.ts.map

package/rotate.js

@@ -0,0 +1,10 @@
+import { defmulti } from "@thi.ng/defmulti/defmulti";
+import { fract } from "@thi.ng/math/prec";
+import { setC4 } from "@thi.ng/vectors/setc";
+import { __dispatch1 } from "./internal/dispatch.js";
+import { __ensureAlpha } from "./internal/ensure.js";
+export const rotate = defmulti(__dispatch1, { hsv: "hsl", hsi: "hsl", hcy: "hsl" }, {
+    hsl: (out, src, theta) => setC4(out || src, fract(src[0] + theta), src[1], src[2], __ensureAlpha(src[3])),
+    lch: (out, src, theta) => setC4(out || src, src[0], src[1], fract(src[2] + theta), __ensureAlpha(src[3])),
+});
+export const complementary = (out, src) => rotate(out, src, 0.5);

package/sort.d.ts

@@ -7,8 +7,8 @@ export declare const selectChannel: (id: number) => (col: ReadonlyColor) => numb
  * function for {@link sort} to compute the distance metric of a color to the
  * given `target`.
  *
- * @param target
- * @param dist
+ * @param target -
+ * @param dist -
  */
 export declare const proximity: (target: ReadonlyColor, dist?: ColorDistance) => (col: ReadonlyColor) => number;
 /**
@@ -17,8 +17,8 @@ export declare const proximity: (target: ReadonlyColor, dist?: ColorDistance) =>
  * function (default: {@link distEucledian3}) and will be in sRGB space. Hence
  * given `target` color should be provided in the same space too.
  *
- * @param target
- * @param dist
+ * @param target -
+ * @param dist -
  */
 export declare const proximityABGR32: (target: ReadonlyColor, dist?: ColorDistance) => (col: ReadonlyColor) => number;
 export declare const sort: (colors: ReadonlyColor[], key: Fn<ReadonlyColor, number>, isReverse?: boolean) => import("@thi.ng/vectors").ReadonlyVec[];
@@ -56,9 +56,9 @@ export declare const sort: (colors: ReadonlyColor[], key: Fn<ReadonlyColor, numb
  * // ]
  * ```
  *
- * @param colors
- * @param key
- * @param isReverse
+ * @param colors -
+ * @param key -
+ * @param isReverse -
  */
 export declare const sortMapped: <T extends TypedColor<any>>(colors: T[], key: Fn<ReadonlyColor, number>, isReverse?: boolean) => T[];
 //# sourceMappingURL=sort.d.ts.map

package/sort.js

@@ -12,8 +12,8 @@ export const selectChannel = (id) => (col) => col[id];
  * function for {@link sort} to compute the distance metric of a color to the
  * given `target`.
  *
- * @param target
- * @param dist
+ * @param target -
+ * @param dist -
  */
 export const proximity = (target, dist = distEucledian3) => (col) => dist(target, col);
 /**
@@ -22,8 +22,8 @@ export const proximity = (target, dist = distEucledian3) => (col) => dist(target
  * function (default: {@link distEucledian3}) and will be in sRGB space. Hence
  * given `target` color should be provided in the same space too.
  *
- * @param target
- * @param dist
+ * @param target -
+ * @param dist -
  */
 export const proximityABGR32 = (target, dist = distEucledian3) => (col) => dist(target, intAbgr32Srgb([], col[0]));
 export const sort = (colors, key, isReverse = false) => sortByCachedKey(colors, key, isReverse ? compareNumDesc : compareNumAsc);
@@ -61,9 +61,9 @@ export const sort = (colors, key, isReverse = false) => sortByCachedKey(colors,
  * // ]
  * ```
  *
- * @param colors
- * @param key
- * @param isReverse
+ * @param colors -
+ * @param key -
+ * @param isReverse -
  */
 export const sortMapped = (colors, key, isReverse = false) => {
     if (!colors.length)