@thi.ng/color 5.7.23 → 5.7.25

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-01-29T16:25:48Z
+- **Last updated**: 2025-02-19T20:59:58Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 201 standalone projects, maintained as part
+> This is one of 202 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -715,7 +715,7 @@ Note: @thi.ng/api is in _most_ cases a type-only import (not used at runtime)
 
 ## Usage examples
 
-27 projects in this repo's
+28 projects in this repo's
 [/examples](https://github.com/thi-ng/umbrella/tree/develop/examples)
 directory are using this package:
 
@@ -746,6 +746,7 @@ directory are using this package:
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/simd-plot.png" width="240"/>                     | Fitting, transforming & plotting 10k data points per frame using SIMD            | [Demo](https://demo.thi.ng/umbrella/simd-plot/)              | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/simd-plot)              |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/stacked-layout.png" width="240"/>                | Responsive & reactively computed stacked column layout                           | [Demo](https://demo.thi.ng/umbrella/stacked-layout/)         | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/stacked-layout)         |
 | <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)           |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/tsne-colors.avif" width="240"/>                  | Animated t-SNE visualization of 4D data                                          | [Demo](https://demo.thi.ng/umbrella/tsne-colors/)            | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/tsne-colors)            |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/viz-ridge-lines.avif" width="240"/>              | Interactive ridge-line plot                                                      | [Demo](https://demo.thi.ng/umbrella/viz-ridge-lines/)        | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/viz-ridge-lines)        |
 | <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/webgl-texture-paint.jpg" width="240"/>           | Interactively drawing to & reading from a WebGL offscreen render texture         | [Demo](https://demo.thi.ng/umbrella/webgl-texture-paint/)    | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/webgl-texture-paint)    |
 

package/api.d.ts

@@ -42,7 +42,7 @@ export interface ChannelSpec {
      * color spaces to be slightly outside that sRGB gamut. These are soft
      * limits, for orientation only.
      *
-     * @defaultValue [0,1]
+     * @defaultValue `[0,1]`
      */
     range?: Range;
     /**
@@ -161,7 +161,7 @@ export interface TypedColor<T> extends IColor, IDeref<Color>, IEqualsDelta<T>, I
     clamp(): this;
     /**
      * Randomizes all color channels based on channel ranges defined for this
-     * color type (usually [0..1] interval). Alpha channel will remain
+     * color type (usually `[0,1]` interval). Alpha channel will remain
      * untouched.
      *
      * @param rnd -

package/clamp.d.ts

@@ -1,7 +1,7 @@
 import type { Color, ReadonlyColor } from "./api.js";
 /**
- * Clamps all color channels to [0,1] interval and calls `ensureAlpha` to ensure
- * alpha channel is defined (if missing sets it to `alpha`, default: 1).
+ * Clamps all color channels to `[0,1]` interval and calls `ensureAlpha` to
+ * ensure alpha channel is defined (if missing sets it to `alpha`, default: 1).
  *
  * @remarks
  * If `out` is null, the resulting color will be written back into `src`.
@@ -17,8 +17,8 @@ import type { Color, ReadonlyColor } from "./api.js";
  */
 export declare const clamp: (out: Color | null, src: ReadonlyColor, alpha?: number) => import("@thi.ng/vectors").Vec;
 /**
- * Similar to {@link clamp}, but calls `ensureHue` to fold (instead of
- * clamping) the hue into [0,1] interval.
+ * Similar to {@link clamp}, but calls `ensureHue` to fold (instead of clamping)
+ * the hue into the `[0,1]` interval.
  *
  * @remarks
  * If `out` is null, the resulting color will be written back into `src`.

package/cosine-gradients.d.ts

@@ -13,7 +13,7 @@ import type { CosGradientSpec, CosineGradientOpts, CosineGradientPreset } from "
 export declare const COSINE_GRADIENTS: Record<CosineGradientPreset, CosGradientSpec>;
 /**
  * Computes a single linear RGBA color for given gradient spec and normalized
- * position `t` (in [0..1] interval).
+ * position `t` (in `[0,1]` interval).
  *
  * @param spec -
  * @param t -
@@ -39,7 +39,7 @@ export declare const cosineGradient: (n: number, spec: CosGradientSpec, tx?: FnU
  *
  * @remarks
  * Intended use case for this function: 1D texturemap/tonemap generation, e.g.
- * for dataviz etc. Also @see {@link multiColorGradientBuffer}.
+ * for dataviz etc. Also see {@link multiColorGradientBuffer}.
  *
  * @param n -  number of colors
  * @param spec - gradient spec
@@ -62,8 +62,7 @@ export declare const cosineCoeffs: FnU2<ReadonlyColor, CosGradientSpec>;
  * an array of `n+1` linear RGBA color samples.
  *
  * @remarks
- * See
- * [`tween()`](https://docs.thi.ng/umbrella/transducers/functions/tween.html)
+ * See [`tween`](https://docs.thi.ng/umbrella/transducers/functions/tween.html)
  *
  * @example
  * ```ts tangle:../export/cosine-gradient.ts

package/css/css.d.ts

@@ -9,7 +9,7 @@ export type CSSConversions = Partial<Record<ColorMode, Fn<any, string>>>;
  * {@link setDefaultCSSConversions} to change default.
  *
  * Reference:
- * - https://www.w3.org/TR/css-color-3/
+ * https://www.w3.org/TR/css-color-3/
  */
 export declare const CSS_LEVEL3: CSSConversions;
 /**
@@ -20,7 +20,7 @@ export declare const CSS_LEVEL3: CSSConversions;
  * Use {@link setDefaultCSSConversions} to use as default.
  *
  * Reference:
- * - https://www.w3.org/TR/css-color-4/
+ * https://www.w3.org/TR/css-color-4/
  */
 export declare const CSS_LEVEL4: CSSConversions;
 /**

package/css/parse-css.d.ts

@@ -9,7 +9,7 @@ import { type IParsedColor } from "../api.js";
  * The following syntax versions are supported:
  *
  * - CSS named colors
- * - CSS system colors @see {@link CSS_SYSTEM_COLORS}
+ * - CSS system colors, see {@link CSS_SYSTEM_COLORS}
  * - hex3/4/6/8
  * - `rgb(r% g% b% / a%?)`
  * - `rgb(r g b / a?)`

package/distance.d.ts

@@ -21,7 +21,8 @@ export declare const distHsv: ColorDistance;
  * a cyclinder (using Law of Cosines).
  *
  * @remarks
- * Reference:
+ * References:
+ *
  * - https://math.stackexchange.com/a/3612602
  * - https://en.wikipedia.org/wiki/Law_of_cosines
  *
@@ -90,6 +91,7 @@ export declare const distRgbBlue: ColorDistance;
  *
  * @remarks
  * References:
+ *
  * - https://en.wikipedia.org/wiki/Color_difference#CIEDE2000
  * - http://www2.ece.rochester.edu/~gsharma/ciede2000/ciede2000noteCRNA.pdf
  *
@@ -109,6 +111,7 @@ export declare const distCIEDE2000: (weights?: ReadonlyVec) => ColorDistance;
  * `distCMC(a, b) !== distCMC(b, a)`
  *
  * References:
+ *
  * - https://en.wikipedia.org/wiki/Color_difference#CMC_l:c_(1984)
  */
 export declare const distCMC: (kl?: number, kc?: number) => ColorDistance;

package/gradients.d.ts

@@ -9,8 +9,7 @@ import type { GradientOpts } from "./api/gradients.js";
  * array of numbers will be returned.
  *
  * @remarks
- * See
- * [`tween()`](https://docs.thi.ng/umbrella/transducers/functions/tween.html)
+ * See [`tween`](https://docs.thi.ng/umbrella/transducers/functions/tween.html)
  *
  * @example
  * ```ts tangle:../export/multi-color-gradient.ts
@@ -56,7 +55,7 @@ export declare function multiColorGradient<T extends TypedColor<any>>(opts: Grad
  *
  * @remarks
  * Intended use case for this function: 1D texturemap/tonemap generation, e.g.
- * for dataviz etc. Also @see {@link cosineGradientBuffer}.
+ * for dataviz etc. Also see {@link cosineGradientBuffer}.
  *
  * @param opts -
  * @param buffer - target buffer/array

package/hcy/hcy.d.ts

@@ -28,7 +28,7 @@ export declare class HCY implements TypedColor<HCY> {
 /**
  * @remarks
  * Note: As with other hue-based color modes in this package, the hue is stored
- * normalized (in [0..1] interval) and NOT as degrees.
+ * normalized (in `[0,1]` interval) and NOT as degrees.
  */
 export declare const hcy: ColorFactory<HCY>;
 //# sourceMappingURL=hcy.d.ts.map

package/hsi/hsi.d.ts

@@ -28,7 +28,7 @@ export declare class HSI implements TypedColor<HSI> {
 /**
  * @remarks
  * Note: As with other hue-based color modes in this package, the hue is stored
- * normalized (in [0..1] interval) and NOT as degrees.
+ * normalized (in `[0,1]` interval) and NOT as degrees.
  */
 export declare const hsi: ColorFactory<HSI>;
 //# sourceMappingURL=hsi.d.ts.map

package/hsl/hsl.d.ts

@@ -28,7 +28,7 @@ export declare class HSL implements TypedColor<HSL> {
 /**
  * @remarks
  * Note: As with other hue-based color modes in this package, the hue is stored
- * normalized (in [0..1] interval) and NOT as degrees.
+ * normalized (in `[0,1]` interval) and NOT as degrees.
  */
 export declare const hsl: ColorFactory<HSL>;
 //# sourceMappingURL=hsl.d.ts.map

package/hsv/hsv.d.ts

@@ -28,7 +28,7 @@ export declare class HSV implements TypedColor<HSV> {
 /**
  * @remarks
  * Note: As with other hue-based color modes in this package, the hue is stored
- * normalized (in [0..1] interval) and NOT as degrees.
+ * normalized (in `[0,1]` interval) and NOT as degrees.
  */
 export declare const hsv: ColorFactory<HSV>;
 //# sourceMappingURL=hsv.d.ts.map

package/lab/lab-css.d.ts

@@ -1,9 +1,12 @@
 import type { ReadonlyColor } from "../api.js";
 /**
  * @remarks
- * Only supported in CSS Color Level 4 onwards
- * https://www.w3.org/TR/css-color-4/#specifying-lab-lch
- * https://test.csswg.org/harness/results/css-color-4_dev/grouped/ (test reports)
+ * Only supported in CSS Color Level 4 onwards.
+ *
+ * References:
+ *
+ * - https://www.w3.org/TR/css-color-4/#specifying-lab-lch
+ * - https://test.csswg.org/harness/results/css-color-4_dev/grouped/ (test reports)
  *
  * @param src -
  */

package/lch/lch-css.d.ts

@@ -1,9 +1,12 @@
 import type { ReadonlyColor } from "../api.js";
 /**
  * @remarks
- * Only supported in CSS Color Level 4 onwards
- * https://www.w3.org/TR/css-color-4/#specifying-lab-lch
- * https://test.csswg.org/harness/results/css-color-4_dev/grouped/ (test reports)
+ * Only supported in CSS Color Level 4 onwards.
+ *
+ * References:
+ *
+ * - https://www.w3.org/TR/css-color-4/#specifying-lab-lch
+ * - https://test.csswg.org/harness/results/css-color-4_dev/grouped/ (test reports)
  *
  * @param src -
  */

package/lch/lch.d.ts

@@ -31,7 +31,7 @@ export declare class LCH implements TypedColor<LCH> {
  *
  * @remarks
  * Note: As with other hue-based color modes in this package, the hue is stored
- * normalized (in [0..1] interval) and NOT as degrees.
+ * normalized (in `[0,1]` interval) and NOT as degrees.
  */
 export declare const lch: ColorFactory<LCH>;
 //# sourceMappingURL=lch.d.ts.map

package/mix.d.ts

@@ -14,8 +14,8 @@ export declare const defMix: FnU4<FnN3, ColorMixFn>;
  * Single channel interpolation for (normalized) hues. Always interpolates via
  * smallest angle difference, i.e. such that the effective `abs(a-b) <= 0.5`.
  *
- * @param a - start hue in [0,1) interval
- * @param b - end hue in [0,1) interval
+ * @param a - start hue in `[0,1)` interval
+ * @param b - end hue in `[0,1)` interval
  * @param t - interpolation factor
  */
 export declare const mixH: FnN3;
@@ -30,7 +30,7 @@ export declare const mixN: FnN3;
 export declare const mixHNNN: ColorMixFn;
 export declare const mixNNHN: ColorMixFn;
 /**
- * Channelwise linear interpolation between colors `a` and `b` using `t` [0..1]
+ * Channelwise linear interpolation between colors `a` and `b` using `t` `[0,1]`
  * as blend factor.
  *
  * @param out -
@@ -41,7 +41,7 @@ export declare const mixNNHN: ColorMixFn;
 export declare const mixNNNN: ColorMixFn;
 /**
  * Channelwise and {@link ColorMode}-aware interpolation between colors `a` and
- * `b` using `t` [0..1] as blend factor. `a` and `b` MUST be of same color
+ * `b` using `t` `[0,1]` as blend factor. `a` and `b` MUST be of same color
  * type.
  *
  * @remarks

package/oklab/oklab-css.d.ts

@@ -1,9 +1,12 @@
 import type { ReadonlyColor } from "../api.js";
 /**
  * @remarks
- * Only supported in CSS Color Level 4 onwards
- * https://www.w3.org/TR/css-color-4/#specifying-lab-lch
- * https://test.csswg.org/harness/results/css-color-4_dev/grouped/ (test reports)
+ * Only supported in CSS Color Level 4 onwards.
+ *
+ * References:
+ *
+ * - https://www.w3.org/TR/css-color-4/#specifying-lab-lch
+ * - https://test.csswg.org/harness/results/css-color-4_dev/grouped/ (test reports)
  *
  * @param src -
  */

package/oklch/oklch-css.d.ts

@@ -2,6 +2,7 @@ import type { ReadonlyColor } from "../api.js";
 /**
  * @remarks
  * Only supported in CSS Color Level 4 onwards
+ *
  * - https://www.w3.org/TR/css-color-4/#specifying-oklab-oklch
  * - https://test.csswg.org/harness/results/css-color-4_dev/grouped/ (test reports)
  *

package/oklch/oklch-oklab.d.ts

@@ -2,7 +2,7 @@ import type { ColorOp } from "../api.js";
 /**
  * @remarks
  * Reference:
- * - https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js
+ * https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js
  *
  * @param out
  * @param src

package/oklch/oklch.d.ts

@@ -30,7 +30,7 @@ export declare class Oklch implements TypedColor<Oklch> {
  *
  * @remarks
  * Note: As with other hue-based color modes in this package, the hue is stored
- * normalized (in [0..1] interval) and NOT as degrees.
+ * normalized (in `[0,1]` interval) and NOT as degrees.
  *
  * Reference: https://bottosson.github.io/posts/oklab/
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/color",
-  "version": "5.7.23",
+  "version": "5.7.25",
   "description": "Array-based color types, CSS parsing, conversions, transformations, declarative theme generation, gradients, presets",
   "type": "module",
   "module": "./index.js",
@@ -43,23 +43,23 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.19",
-    "@thi.ng/arrays": "^2.10.14",
-    "@thi.ng/binary": "^3.4.42",
-    "@thi.ng/checks": "^3.6.22",
-    "@thi.ng/compare": "^2.4.11",
-    "@thi.ng/compose": "^3.0.22",
-    "@thi.ng/defmulti": "^3.0.59",
-    "@thi.ng/errors": "^2.5.25",
-    "@thi.ng/math": "^5.11.19",
-    "@thi.ng/random": "^4.1.10",
-    "@thi.ng/strings": "^3.9.4",
-    "@thi.ng/transducers": "^9.2.17",
-    "@thi.ng/vectors": "^7.12.19"
+    "@thi.ng/api": "^8.11.21",
+    "@thi.ng/arrays": "^2.10.16",
+    "@thi.ng/binary": "^3.4.44",
+    "@thi.ng/checks": "^3.6.24",
+    "@thi.ng/compare": "^2.4.13",
+    "@thi.ng/compose": "^3.0.24",
+    "@thi.ng/defmulti": "^3.0.61",
+    "@thi.ng/errors": "^2.5.27",
+    "@thi.ng/math": "^5.11.21",
+    "@thi.ng/random": "^4.1.12",
+    "@thi.ng/strings": "^3.9.6",
+    "@thi.ng/transducers": "^9.2.19",
+    "@thi.ng/vectors": "^7.12.21"
   },
   "devDependencies": {
-    "esbuild": "^0.24.2",
-    "typedoc": "^0.27.6",
+    "esbuild": "^0.25.0",
+    "typedoc": "^0.27.7",
     "typescript": "^5.7.3"
   },
   "keywords": [
@@ -446,5 +446,5 @@
       "vectors"
     ]
   },
-  "gitHead": "dcc1dbfa6eae31ac65e12843987b94d4a7edc144\n"
+  "gitHead": "bee617702ac61d093465b967f8f973dc566faa6b\n"
 }

package/rgb/kelvin-rgba.d.ts

@@ -2,6 +2,7 @@ import { type SRGB } from "../srgb/srgb.js";
 /**
  * @remarks
  * Based on:
+ *
  * - https://github.com/neilbartlett/color-temperature/blob/develop/index.js
  * - http://www.zombieprototypes.com/?p=210
  *

package/rotate.d.ts

@@ -7,7 +7,7 @@ import type { Color, TypedColor } from "./api.js";
  * If `out` is null, the resulting will be written back into `src`.
  *
  * As with all hue-based color modes in this package, the hue is stored
- * normalized (in [0..1] interval) and NOT as degrees. The same goes for the
+ * normalized (in `[0,1]` interval) and NOT as degrees. The same goes for the
  * rotation angle `theta`.
  *
  * Only supported for hue based color modes:

package/transform.d.ts

@@ -8,7 +8,7 @@ import type { ColorMatrix, ReadonlyColor } from "./api.js";
  * @param out - result
  * @param mat - transform matrix
  * @param src - source color
- * @param clampOut - true, if result should be clamped to [0..1]
+ * @param clampOut - true, if result should be clamped to `[0,1]`
  */
 export declare const transform: (out: import("./api.js").Color | null, mat: ColorMatrix, src: ReadonlyColor, clampOut?: boolean) => import("@thi.ng/vectors").Vec;
 /**
@@ -53,7 +53,7 @@ export declare const saturationMat: (x: number) => ColorMatrix;
 export declare const hueRotateMat: (theta: number) => ColorMatrix;
 /**
  * Color temperature adjustment matrix. `x` controls blue/yellow, `y` controls
- * green/magenta axis (both params in [-1,1] range).
+ * green/magenta axis (both params in `[-1,1]` range).
  *
  * @param x
  * @param y

package/xyy/xyy-xyz.d.ts

@@ -1,8 +1,8 @@
 import type { ColorOp } from "../api.js";
 /**
  * @remarks
- * https://en.wikipedia.org/wiki/CIE_1931_color_space#CIE_xy_chromaticity_diagram_and_the_CIE_xyY_color_space
- * https://gamedev.stackexchange.com/a/70049
+ * - https://en.wikipedia.org/wiki/CIE_1931_color_space#CIE_xy_chromaticity_diagram_and_the_CIE_xyY_color_space
+ * - https://gamedev.stackexchange.com/a/70049
  *
  * @param out -
  * @param src -

package/xyz/xyz-xyy.d.ts

@@ -1,8 +1,8 @@
 import type { ColorOp } from "../api.js";
 /**
  * @remarks
- * https://en.wikipedia.org/wiki/CIE_1931_color_space#CIE_xy_chromaticity_diagram_and_the_CIE_xyY_color_space
- * https://gamedev.stackexchange.com/a/70049
+ * - https://en.wikipedia.org/wiki/CIE_1931_color_space#CIE_xy_chromaticity_diagram_and_the_CIE_xyY_color_space
+ * - https://gamedev.stackexchange.com/a/70049
  *
  * @param out -
  * @param src -