@thi.ng/color 5.2.17 → 5.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-01-10T15:20:18Z
+- **Last updated**: 2023-02-10T13:55:29Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,17 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [5.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/color@5.3.0) (2023-02-10)
+
+#### 🚀 Features
+
+- add hue() function ([c5c3dd5](https://github.com/thi-ng/umbrella/commit/c5c3dd5))
+- add distLch() ([f1b509d](https://github.com/thi-ng/umbrella/commit/f1b509d))
+
+#### 🩹 Bug fixes
+
+- fix invert() for HSL ([84d0640](https://github.com/thi-ng/umbrella/commit/84d0640))
+
 ## [5.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/color@5.2.0) (2022-09-21)
 
 #### 🚀 Features

package/README.md

@@ -571,7 +571,7 @@ concatenation (see `concat()`) for more efficient application.
 
 ## Support packages
 
-- [@thi.ng/color-palettes](https://github.com/thi-ng/umbrella/tree/develop/packages/color-palettes) - Collection of 190+ image based color palettes
+- [@thi.ng/color-palettes](https://github.com/thi-ng/umbrella/tree/develop/packages/color-palettes) - Collection of 200+ image based color themes & composable theme query filters
 
 ## Related packages
 
@@ -598,7 +598,7 @@ For Node.js REPL:
 const color = await import("@thi.ng/color");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 15.21 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 15.25 KB
 
 ## Dependencies
 

package/distance.d.ts

@@ -15,6 +15,15 @@ export declare const distChannel: (id: number) => ColorDistance;
  * @param b -
  */
 export declare const distHsv: ColorDistance;
+/**
+ * Similar to {@link distHsv}, but computes distance between two LCH colors
+ * (with different channel order), i.e. the eucledian distance between points in
+ * a cyclinder.
+ *
+ * @param a -
+ * @param b -
+ */
+export declare const distLch: ColorDistance;
 /**
  * Computes difference in saturation between two HSV colors.
  *

package/distance.js

@@ -25,6 +25,19 @@ export const distHsv = (a, b) => {
     const bb = cossin(b[0] * TAU, b[1]);
     return hypot(aa[0] - bb[0], aa[1] - bb[1], a[2] - b[2]);
 };
+/**
+ * Similar to {@link distHsv}, but computes distance between two LCH colors
+ * (with different channel order), i.e. the eucledian distance between points in
+ * a cyclinder.
+ *
+ * @param a -
+ * @param b -
+ */
+export const distLch = (a, b) => {
+    const aa = cossin(a[2] * TAU, a[1]);
+    const bb = cossin(b[2] * TAU, b[1]);
+    return hypot(aa[0] - bb[0], aa[1] - bb[1], a[0] - b[0]);
+};
 /**
  * Computes difference in saturation between two HSV colors.
  *

package/hue.d.ts

@@ -0,0 +1,10 @@
+import type { TypedColor } from "./api.js";
+/**
+ * Returns the (normalized) hue of given color.
+ *
+ * @remarks
+ * Since LCH uses different hue values than the more familiar HSV/HSL color
+ * wheel, LCH colors will be first converted to HSV to ensure uniform results.
+ */
+export declare const hue: import("@thi.ng/defmulti").MultiFn1<TypedColor<any>, number>;
+//# sourceMappingURL=hue.d.ts.map

package/hue.js

@@ -0,0 +1,18 @@
+import { DEFAULT, defmulti } from "@thi.ng/defmulti/defmulti";
+import { hsv } from "./hsv/hsv.js";
+import { __dispatch0 } from "./internal/dispatch.js";
+/**
+ * Returns the (normalized) hue of given color.
+ *
+ * @remarks
+ * Since LCH uses different hue values than the more familiar HSV/HSL color
+ * wheel, LCH colors will be first converted to HSV to ensure uniform results.
+ */
+export const hue = defmulti(__dispatch0, {
+    hcy: "hsv",
+    hsi: "hsv",
+    hsl: "hsv",
+}, {
+    [DEFAULT]: (col) => hsv(col)[0],
+    hsv: (col) => col[0],
+});

package/index.d.ts

@@ -47,6 +47,7 @@ export * from "./color-range.js";
 export * from "./cosine-gradients.js";
 export * from "./distance.js";
 export * from "./gradients.js";
+export * from "./hue.js";
 export * from "./invert.js";
 export * from "./is-black.js";
 export * from "./is-gamut.js";

package/index.js

@@ -47,6 +47,7 @@ export * from "./color-range.js";
 export * from "./cosine-gradients.js";
 export * from "./distance.js";
 export * from "./gradients.js";
+export * from "./hue.js";
 export * from "./invert.js";
 export * from "./is-black.js";
 export * from "./is-gamut.js";

package/invert.js

@@ -32,7 +32,7 @@ export const invertInt = (src) => src ^ 0xffffff;
 export const invert = defmulti(__dispatch1, {
     hcy: "hsv",
     hsi: "hsv",
-    hsl: "hsl",
+    hsl: "hsv",
     labD65: "labD50",
     oklab: "labD50",
     srgb: "rgb",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/color",
-  "version": "5.2.17",
+  "version": "5.3.0",
   "description": "Array-based color types, CSS parsing, conversions, transformations, declarative theme generation, gradients, presets",
   "type": "module",
   "module": "./index.js",
@@ -36,27 +36,27 @@
     "tool:swatches": "tools:node-esm tools/index.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.6.3",
-    "@thi.ng/arrays": "^2.5.1",
-    "@thi.ng/binary": "^3.3.16",
-    "@thi.ng/checks": "^3.3.7",
-    "@thi.ng/compare": "^2.1.22",
-    "@thi.ng/compose": "^2.1.24",
-    "@thi.ng/defmulti": "^2.1.27",
-    "@thi.ng/errors": "^2.2.8",
-    "@thi.ng/math": "^5.4.0",
-    "@thi.ng/random": "^3.3.21",
-    "@thi.ng/strings": "^3.3.23",
-    "@thi.ng/transducers": "^8.3.30",
-    "@thi.ng/vectors": "^7.5.31"
+    "@thi.ng/api": "^8.7.1",
+    "@thi.ng/arrays": "^2.5.3",
+    "@thi.ng/binary": "^3.3.18",
+    "@thi.ng/checks": "^3.3.8",
+    "@thi.ng/compare": "^2.1.24",
+    "@thi.ng/compose": "^2.1.26",
+    "@thi.ng/defmulti": "^2.1.29",
+    "@thi.ng/errors": "^2.2.10",
+    "@thi.ng/math": "^5.4.2",
+    "@thi.ng/random": "^3.3.23",
+    "@thi.ng/strings": "^3.3.25",
+    "@thi.ng/transducers": "^8.3.32",
+    "@thi.ng/vectors": "^7.6.1"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.33.7",
-    "@thi.ng/testament": "^0.3.9",
-    "rimraf": "^3.0.2",
+    "@microsoft/api-extractor": "^7.34.2",
+    "@thi.ng/testament": "^0.3.10",
+    "rimraf": "^4.1.2",
     "tools": "^0.0.1",
-    "typedoc": "^0.23.22",
-    "typescript": "^4.9.4"
+    "typedoc": "^0.23.24",
+    "typescript": "^4.9.5"
   },
   "keywords": [
     "color",
@@ -222,6 +222,9 @@
     "./hsv/hsv": {
       "default": "./hsv/hsv.js"
     },
+    "./hue": {
+      "default": "./hue.js"
+    },
     "./int/int-css": {
       "default": "./int/int-css.js"
     },
@@ -424,5 +427,5 @@
       "vectors"
     ]
   },
-  "gitHead": "3f0b3e2a7c82aefc7e46fb4338369836b5e1b8cf\n"
+  "gitHead": "2b5a99a8af71670780875637299be9118b01084d\n"
 }