@thi.ng/color 5.4.6 → 5.5.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-03-27T19:05:48Z
+- **Last updated**: 2023-04-19T09:28:07Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ 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.5.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/color@5.5.0) (2023-04-19)
+
+#### 🚀 Features
+
+- add TypedColor.xyz 3-channel accessor, update all impls ([c62e0ee](https://github.com/thi-ng/umbrella/commit/c62e0ee))
+- add mostSimilar() ([8cfc36d](https://github.com/thi-ng/umbrella/commit/8cfc36d))
+
 ## [5.4.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/color@5.4.0) (2023-03-02)
 
 #### 🚀 Features

package/README.md

@@ -601,7 +601,7 @@ For Node.js REPL:
 const color = await import("@thi.ng/color");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 15.51 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 15.58 KB
 
 ## Dependencies
 
@@ -638,6 +638,7 @@ A selection:
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/pixel-indexed.jpg" width="240"/>                 | Image dithering and remapping using indexed palettes                        | [Demo](https://demo.thi.ng/umbrella/pixel-indexed/)      | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/pixel-indexed)      |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/pixel-sorting.png" width="240"/>                 | Interactive pixel sorting tool using thi.ng/color & thi.ng/pixel            | [Demo](https://demo.thi.ng/umbrella/pixel-sorting/)      | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/pixel-sorting)      |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/shader-ast-workers.jpg" width="240"/>            | Fork-join worker-based raymarch renderer (JS/CPU only)                      | [Demo](https://demo.thi.ng/umbrella/shader-ast-workers/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/shader-ast-workers) |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/trace-bitmap.jpg" width="240"/>                  | Multi-layer vectorization & dithering of bitmap images                      | [Demo](https://demo.thi.ng/umbrella/trace-bitmap/)       | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/trace-bitmap)       |
 
 ## API
 

package/api.d.ts

@@ -145,6 +145,11 @@ export interface TypedColor<T> extends IColor, IDeref<Color>, IEqualsDelta<T>, I
      * colors into the color space used by this type.
      */
     readonly range: [ReadonlyColor, ReadonlyColor];
+    /**
+     * Returns first 3 color components as tuple/vector. Not to be confused with
+     * {@link XYZD50} or {@link XYZD65} color modes.
+     */
+    readonly xyz: [number, number, number];
     /**
      * Clamps all color channels so that colors is inside RGB gamut.
      *

package/defcolor.js

@@ -55,6 +55,9 @@ export const defColor = (spec) => {
         get [Symbol.toStringTag]() {
             return spec.mode;
         }
+        get xyz() {
+            return [this[0], this[1], this[2]];
+        }
         [Symbol.iterator]() {
             return stridedValues(this.buf, this.length, this.offset, this.stride);
         }

package/hcy/hcy.d.ts

@@ -13,6 +13,7 @@ export declare class HCY implements TypedColor<HCY> {
     readonly mode: "hcy";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): HCY;

package/hsi/hsi.d.ts

@@ -13,6 +13,7 @@ export declare class HSI implements TypedColor<HSI> {
     readonly mode: "hsi";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): HSI;

package/hsl/hsl.d.ts

@@ -13,6 +13,7 @@ export declare class HSL implements TypedColor<HSL> {
     readonly mode: "hsl";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): HSL;

package/hsv/hsv.d.ts

@@ -13,6 +13,7 @@ export declare class HSV implements TypedColor<HSV> {
     readonly mode: "hsv";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): HSV;

package/int/int.d.ts

@@ -17,6 +17,7 @@ export declare abstract class Int32<T extends TypedColor<T>> implements TypedCol
     get range(): [ReadonlyColor, ReadonlyColor];
     get alpha(): number;
     set alpha(x: number);
+    get xyz(): [number, number, number];
     [Symbol.iterator](): Generator<number, void, unknown>;
     deref(): number[];
     randomize(rnd?: IRandom): this;

package/int/int.js

@@ -35,6 +35,14 @@ export class Int32 {
     set alpha(x) {
         this[0] = (this[0] & 0xffffff) | __scale8bit(x, 24);
     }
+    get xyz() {
+        const val = this[0];
+        return [
+            ((val >> 16) & 0xff) / 0xff,
+            ((val >> 8) & 0xff) / 0xff,
+            (val & 0xff) / 0xff,
+        ];
+    }
     *[Symbol.iterator]() {
         yield this[0];
     }

package/lab/lab50.d.ts

@@ -13,6 +13,7 @@ export declare class LabD50 implements TypedColor<LabD50> {
     readonly mode: "lab50";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): LabD50;

package/lab/lab65.d.ts

@@ -13,6 +13,7 @@ export declare class LabD65 implements TypedColor<LabD65> {
     readonly mode: "lab65";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): LabD65;

package/lch/lch.d.ts

@@ -13,6 +13,7 @@ export declare class LCH implements TypedColor<LCH> {
     readonly mode: "lch";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): LCH;

package/oklab/oklab.d.ts

@@ -13,6 +13,7 @@ export declare class Oklab implements TypedColor<Oklab> {
     readonly mode: "oklab";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): Oklab;

package/oklch/oklch.d.ts

@@ -13,6 +13,7 @@ export declare class Oklch implements TypedColor<Oklch> {
     readonly mode: "oklch";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): Oklch;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/color",
-  "version": "5.4.6",
+  "version": "5.5.0",
   "description": "Array-based color types, CSS parsing, conversions, transformations, declarative theme generation, gradients, presets",
   "type": "module",
   "module": "./index.js",
@@ -38,27 +38,27 @@
     "tool:swatches": "tools:node-esm tools/index.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.7.5",
-    "@thi.ng/arrays": "^2.5.9",
-    "@thi.ng/binary": "^3.3.22",
-    "@thi.ng/checks": "^3.3.11",
-    "@thi.ng/compare": "^2.1.28",
-    "@thi.ng/compose": "^2.1.30",
-    "@thi.ng/defmulti": "^2.1.34",
-    "@thi.ng/errors": "^2.2.14",
-    "@thi.ng/math": "^5.4.6",
-    "@thi.ng/random": "^3.3.28",
-    "@thi.ng/strings": "^3.4.3",
-    "@thi.ng/transducers": "^8.4.1",
-    "@thi.ng/vectors": "^7.6.10"
+    "@thi.ng/api": "^8.8.0",
+    "@thi.ng/arrays": "^2.5.11",
+    "@thi.ng/binary": "^3.3.24",
+    "@thi.ng/checks": "^3.3.12",
+    "@thi.ng/compare": "^2.1.30",
+    "@thi.ng/compose": "^2.1.32",
+    "@thi.ng/defmulti": "^2.1.36",
+    "@thi.ng/errors": "^2.2.15",
+    "@thi.ng/math": "^5.4.8",
+    "@thi.ng/random": "^3.4.0",
+    "@thi.ng/strings": "^3.4.5",
+    "@thi.ng/transducers": "^8.4.3",
+    "@thi.ng/vectors": "^7.6.12"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.34.4",
-    "@thi.ng/testament": "^0.3.14",
+    "@thi.ng/testament": "^0.3.15",
     "rimraf": "^4.4.1",
     "tools": "^0.0.1",
     "typedoc": "^0.23.28",
-    "typescript": "^5.0.2"
+    "typescript": "^5.0.4"
   },
   "keywords": [
     "color",
@@ -445,5 +445,5 @@
       "vectors"
     ]
   },
-  "gitHead": "83b15b34326d480cbca0472b20390d4d3bbb792a\n"
+  "gitHead": "3a56bc490f1e68754762a503d06327b5b34ff7eb\n"
 }

package/rgb/rgb.d.ts

@@ -13,6 +13,7 @@ export declare class RGB implements TypedColor<RGB> {
     readonly mode: "rgb";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): RGB;

package/sort.d.ts

@@ -21,7 +21,7 @@ export declare const proximity: (target: ReadonlyColor, dist?: ColorDistance) =>
  * @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[];
+export declare const sort: <T extends import("@thi.ng/vectors").ReadonlyVec>(colors: T[], key: Fn<ReadonlyColor, number>, isReverse?: boolean) => T[];
 /**
  * Similar to {@link sort}, but only for memory mapped colors (e.g. mapping a
  * pixel buffer). Does NOT change the order of elements in given `colors` array,
@@ -61,4 +61,5 @@ export declare const sort: (colors: ReadonlyColor[], key: Fn<ReadonlyColor, numb
  * @param isReverse -
  */
 export declare const sortMapped: <T extends TypedColor<any>>(colors: T[], key: Fn<ReadonlyColor, number>, isReverse?: boolean) => T[];
+export declare const mostSimilar: <T extends import("@thi.ng/vectors").ReadonlyVec>(colors: T[], key: Fn<ReadonlyColor, number>) => T;
 //# sourceMappingURL=sort.d.ts.map

package/sort.js

@@ -78,3 +78,4 @@ export const sortMapped = (colors, key, isReverse = false) => {
     });
     return colors;
 };
+export const mostSimilar = (colors, key) => sort(colors.slice(), key)[0];

package/srgb/srgb.d.ts

@@ -13,6 +13,7 @@ export declare class SRGB implements TypedColor<SRGB> {
     readonly mode: "srgb";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): SRGB;

package/swatches.d.ts

@@ -1,8 +1,8 @@
 import type { Fn2, IObjectOf } from "@thi.ng/api";
 import type { ReadonlyColor } from "./api.js";
-export declare const swatches: (cols: (ReadonlyColor | string)[], shapeFn: Fn2<ReadonlyColor | string, number, any[]>, attribs?: IObjectOf<any>) => (string | IObjectOf<any>)[];
-export declare const swatchesH: (cols: (ReadonlyColor | string)[], w?: number, h?: number, gap?: number, attribs?: IObjectOf<any>) => (string | IObjectOf<any>)[];
-export declare const dotsH: (cols: (ReadonlyColor | string)[], r?: number, gap?: number, attribs?: IObjectOf<any>) => (string | IObjectOf<any>)[];
-export declare const swatchesV: (cols: (ReadonlyColor | string)[], w?: number, h?: number, gap?: number, attribs?: IObjectOf<any>) => (string | IObjectOf<any>)[];
-export declare const dotsV: (cols: (ReadonlyColor | string)[], r?: number, gap?: number, attribs?: IObjectOf<any>) => (string | IObjectOf<any>)[];
+export declare const swatches: (cols: (ReadonlyColor | string)[], shapeFn: Fn2<ReadonlyColor | string, number, any[]>, attribs?: IObjectOf<any>) => (string | any[] | IObjectOf<any>)[];
+export declare const swatchesH: (cols: (ReadonlyColor | string)[], w?: number, h?: number, gap?: number, attribs?: IObjectOf<any>) => (string | any[] | IObjectOf<any>)[];
+export declare const dotsH: (cols: (ReadonlyColor | string)[], r?: number, gap?: number, attribs?: IObjectOf<any>) => (string | any[] | IObjectOf<any>)[];
+export declare const swatchesV: (cols: (ReadonlyColor | string)[], w?: number, h?: number, gap?: number, attribs?: IObjectOf<any>) => (string | any[] | IObjectOf<any>)[];
+export declare const dotsV: (cols: (ReadonlyColor | string)[], r?: number, gap?: number, attribs?: IObjectOf<any>) => (string | any[] | IObjectOf<any>)[];
 //# sourceMappingURL=swatches.d.ts.map

package/xyy/xyy.d.ts

@@ -13,6 +13,7 @@ export declare class XYY implements TypedColor<XYY> {
     readonly mode: "xyy";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): XYY;

package/xyz/xyz50.d.ts

@@ -13,6 +13,7 @@ export declare class XYZD50 implements TypedColor<XYZD50> {
     readonly mode: "xyz50";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): XYZD50;

package/xyz/xyz65.d.ts

@@ -13,6 +13,7 @@ export declare class XYZD65 implements TypedColor<XYZD65> {
     readonly mode: "xyz65";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): XYZD65;

package/ycc/ycc.d.ts

@@ -13,6 +13,7 @@ export declare class YCC implements TypedColor<YCC> {
     readonly mode: "ycc";
     readonly length: 4;
     readonly range: [ReadonlyColor, ReadonlyColor];
+    readonly xyz: [number, number, number];
     [Symbol.iterator](): Iterator<number, any, undefined>;
     clamp(): this;
     copy(): YCC;