@thi.ng/color 5.6.2 → 5.6.4

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-12-03T12:13:31Z
+- **Last updated**: 2023-12-11T10:07:09Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -602,7 +602,7 @@ For Node.js REPL:
 const color = await import("@thi.ng/color");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 15.69 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 15.70 KB
 
 ## Dependencies
 

package/alpha.js

@@ -1,11 +1,7 @@
 import { setC4 } from "@thi.ng/vectors/setc";
-export const alpha = (src) => src[3] !== undefined ? src[3] : 1;
-/**
- * Creates version of `src` color with modified `alpha` and writes result into
- * `out` (or if null, back into `src`).
- *
- * @param out
- * @param src
- * @param alpha
- */
-export const setAlpha = (out, src, alpha) => setC4(out || src, src[0], src[1], src[2], alpha);
+const alpha = (src) => src[3] !== void 0 ? src[3] : 1;
+const setAlpha = (out, src, alpha2) => setC4(out || src, src[0], src[1], src[2], alpha2);
+export {
+  alpha,
+  setAlpha
+};

package/analog.js

@@ -5,35 +5,24 @@ import { SYSTEM } from "@thi.ng/random/system";
 import { setC4 } from "@thi.ng/vectors/setc";
 import { __dispatch1 } from "./internal/dispatch.js";
 import { __ensureAlpha } from "./internal/ensure.js";
-/** @internal */
 const analogU = (x, delta, rnd) => delta !== 0 ? x + rnd.norm(delta) : x;
-/** @internal */
 const analogN = (x, delta, rnd, post = clamp01) => delta !== 0 ? post(x + rnd.norm(delta)) : x;
-/** @internal */
 const analogH = (x, delta, rnd) => analogN(x, delta, rnd, fract);
-/** @internal */
-const analogA = (a, delta, rnd) => delta !== 0
-    ? clamp01((a !== undefined ? a : 1) + rnd.norm(delta))
-    : __ensureAlpha(a);
-export const defAnalog = (x, y, z) => (out, src, delta, rnd = SYSTEM) => setC4(out || src, x(src[0], delta, rnd), y(src[1], delta, rnd), z(src[2], delta, rnd), __ensureAlpha(src[3]));
-/** @internal */
+const analogA = (a, delta, rnd) => delta !== 0 ? clamp01((a !== void 0 ? a : 1) + rnd.norm(delta)) : __ensureAlpha(a);
+const defAnalog = (x, y, z) => (out, src, delta, rnd = SYSTEM) => setC4(
+  out || src,
+  x(src[0], delta, rnd),
+  y(src[1], delta, rnd),
+  z(src[2], delta, rnd),
+  __ensureAlpha(src[3])
+);
 const analogHNN = defAnalog(analogH, analogN, analogN);
-/** @internal */
 const analogNNN = defAnalog(analogN, analogN, analogN);
-/** @internal */
 const analogNUU = defAnalog(analogN, analogU, analogU);
-/**
- * Returns a random analog color based on given `src` color and variance
- * `delta`. Each channel will be randomized by +/- `delta`, optionally using
- * provided
- * [`IRandom`](https://docs.thi.ng/umbrella/random/interfaces/IRandom.html)
- * PRNG.
- *
- * @remarks
- * If `out` is null, the resulting color will be written back into `src`.
- *
- */
-export const analog = defmulti(__dispatch1, { oklab: "lab50", oklch: "lch" }, {
+const analog = defmulti(
+  __dispatch1,
+  { oklab: "lab50", oklch: "lch" },
+  {
     hcy: analogHNN,
     hsi: analogHNN,
     hsl: analogHNN,
@@ -42,47 +31,26 @@ export const analog = defmulti(__dispatch1, { oklab: "lab50", oklch: "lch" }, {
     lab65: analogNUU,
     lch: defAnalog(analogN, analogN, analogH),
     ycc: analogNUU,
-    [DEFAULT]: analogNNN,
-});
-/**
- * Similar to {@link analogRGB}. Returns an analog color based on given HSVA
- * color, with each channel randomly varied by given channel-specific delta
- * amounts (and optionally given
- * [`IRandom`](https://docs.thi.ng/umbrella/random/interfaces/IRandom.html)
- * PRNG).
- *
- * @remarks
- * This function provides more user control than {@link analog}, but the latter
- * is recommended for most use cases.
- *
- * By default (unless `deltaS`, `deltaV`, `deltaA` are provided) only the hue of
- * the color will be modulated.
- *
- * @param out -
- * @param src -
- * @param deltaH -
- * @param deltaS -
- * @param deltaV -
- * @param deltaA -
- * @param rnd -
- */
-export const analogHsv = (out, src, deltaH, deltaS = 0, deltaV = 0, deltaA = 0, rnd = SYSTEM) => setC4(out || src, analogN(src[0], deltaH, rnd, fract), analogN(src[1], deltaS, rnd), analogN(src[2], deltaV, rnd), analogA(src[3], deltaA, rnd));
-/**
- * Similar to {@link analogHSV}. Returns an analog color based on given RGBA
- * color, with each channel randomly varied by given delta amounts (and
- * optionally given
- * [`IRandom`](https://docs.thi.ng/umbrella/random/interfaces/IRandom.html)
- * PRNG).
- *
- * @remarks
- * By default the green and blue channel variance will be the same as `deltaR`.
- *
- * @param out -
- * @param src -
- * @param deltaR -
- * @param deltaG -
- * @param deltaB -
- * @param deltaA -
- * @param rnd -
- */
-export const analogRgb = (out, src, deltaR, deltaG = deltaR, deltaB = deltaR, deltaA = 0, rnd = SYSTEM) => setC4(out || src, analogN(src[0], deltaR, rnd), analogN(src[1], deltaG, rnd), analogN(src[2], deltaB, rnd), analogA(src[3], deltaA, rnd));
+    [DEFAULT]: analogNNN
+  }
+);
+const analogHsv = (out, src, deltaH, deltaS = 0, deltaV = 0, deltaA = 0, rnd = SYSTEM) => setC4(
+  out || src,
+  analogN(src[0], deltaH, rnd, fract),
+  analogN(src[1], deltaS, rnd),
+  analogN(src[2], deltaV, rnd),
+  analogA(src[3], deltaA, rnd)
+);
+const analogRgb = (out, src, deltaR, deltaG = deltaR, deltaB = deltaR, deltaA = 0, rnd = SYSTEM) => setC4(
+  out || src,
+  analogN(src[0], deltaR, rnd),
+  analogN(src[1], deltaG, rnd),
+  analogN(src[2], deltaB, rnd),
+  analogA(src[3], deltaA, rnd)
+);
+export {
+  analog,
+  analogHsv,
+  analogRgb,
+  defAnalog
+};

package/api/constants.js

@@ -1,167 +1,139 @@
 import { float } from "@thi.ng/strings/float";
 import { percent } from "@thi.ng/strings/percent";
-/**
- * RGB black
- */
-export const BLACK = Object.freeze([0, 0, 0, 1]);
-/**
- * RGB white
- */
-export const WHITE = Object.freeze([1, 1, 1, 1]);
-/**
- * RGB red
- */
-export const RED = Object.freeze([1, 0, 0, 1]);
-/**
- * RGB green
- */
-export const GREEN = Object.freeze([0, 1, 0, 1]);
-/**
- * RGB blue
- */
-export const BLUE = Object.freeze([0, 0, 1, 1]);
-/**
- * RGB cyan
- */
-export const CYAN = Object.freeze([0, 1, 1, 1]);
-/**
- * RGB magenta
- */
-export const MAGENTA = Object.freeze([1, 0, 1, 1]);
-/**
- * RGB yellow
- */
-export const YELLOW = Object.freeze([1, 1, 0, 1]);
-/**
- * ITU-R BT.601 RGB luminance coeffs
- *
- * @remarks
- * Reference:
- * https://en.wikipedia.org/wiki/YCbCr#ITU-R_BT.601_conversion
- */
-export const RGB_LUMINANCE_REC601 = [0.299, 0.587, 0.114];
-/**
- * ITU-R BT.709 RGB luminance coeffs
- *
- * @remarks
- * Reference:
- * https://en.wikipedia.org/wiki/YCbCr#ITU-R_BT.709_conversion
- */
-export const RGB_LUMINANCE_REC709 = [0.2126, 0.7152, 0.0722];
-/**
- * ITU-R BT.2020 RGB luminance coeffs
- *
- * @remarks
- * Reference:
- * https://en.wikipedia.org/wiki/YCbCr#ITU-R_BT.2020_conversion
- */
-export const RGB_LUMINANCE_REC2020 = [0.2627, 0.678, 0.0593];
-/**
- * sRGB to XYZ D65 conversion matrix
- *
- * @remarks
- * Reference:
- * http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
- */
-export const RGB_XYZ_D50 = [
-    0.4360747, 0.2225045, 0.0139322, 0.3850649, 0.7168786, 0.0971045, 0.1430804,
-    0.0606169, 0.7141733,
+const BLACK = Object.freeze([0, 0, 0, 1]);
+const WHITE = Object.freeze([1, 1, 1, 1]);
+const RED = Object.freeze([1, 0, 0, 1]);
+const GREEN = Object.freeze([0, 1, 0, 1]);
+const BLUE = Object.freeze([0, 0, 1, 1]);
+const CYAN = Object.freeze([0, 1, 1, 1]);
+const MAGENTA = Object.freeze([1, 0, 1, 1]);
+const YELLOW = Object.freeze([1, 1, 0, 1]);
+const RGB_LUMINANCE_REC601 = [0.299, 0.587, 0.114];
+const RGB_LUMINANCE_REC709 = [0.2126, 0.7152, 0.0722];
+const RGB_LUMINANCE_REC2020 = [0.2627, 0.678, 0.0593];
+const RGB_XYZ_D50 = [
+  0.4360747,
+  0.2225045,
+  0.0139322,
+  0.3850649,
+  0.7168786,
+  0.0971045,
+  0.1430804,
+  0.0606169,
+  0.7141733
 ];
-/**
- * XYZ D50 to sRGB conversion matrix
- *
- * @remarks
- * Reference:
- * http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
- */
-export const XYZ_RGB_D50 = [
-    3.1338561, -0.9787684, 0.0719453, -1.6168667, 1.9161415, -0.2289914,
-    -0.4906146, 0.033454, 1.4052427,
+const XYZ_RGB_D50 = [
+  3.1338561,
+  -0.9787684,
+  0.0719453,
+  -1.6168667,
+  1.9161415,
+  -0.2289914,
+  -0.4906146,
+  0.033454,
+  1.4052427
 ];
-/**
- * sRGB to XYZ D65 conversion matrix
- *
- * @remarks
- * Reference:
- * http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
- */
-export const RGB_XYZ_D65 = [
-    0.4124564, 0.2126729, 0.0193339, 0.3575761, 0.7151522, 0.119192, 0.1804375,
-    0.072175, 0.9503041,
+const RGB_XYZ_D65 = [
+  0.4124564,
+  0.2126729,
+  0.0193339,
+  0.3575761,
+  0.7151522,
+  0.119192,
+  0.1804375,
+  0.072175,
+  0.9503041
 ];
-/**
- * XYZ D65 to sRGB conversion matrix
- *
- * @remarks
- * Reference:
- * http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
- */
-export const XYZ_RGB_D65 = [
-    3.2404542, -0.969266, 0.0556434, -1.5371385, 1.8760108, -0.2040259,
-    -0.4985314, 0.041556, 1.0572252,
+const XYZ_RGB_D65 = [
+  3.2404542,
+  -0.969266,
+  0.0556434,
+  -1.5371385,
+  1.8760108,
+  -0.2040259,
+  -0.4985314,
+  0.041556,
+  1.0572252
 ];
-/**
- * D50 -> D65 chromatic adaptation matrix. Inverse of {@link BRADFORD_D65_D50}.
- *
- * @remarks
- * Reference:
- * http://www.brucelindbloom.com/index.html?Eqn_ChromAdapt.html
- */
-export const BRADFORD_D50_D65 = [
-    0.9555766, -0.0282895, 0.0122982, -0.0230393, 1.0099416, -0.020483,
-    0.0631636, 0.0210077, 1.3299098,
+const BRADFORD_D50_D65 = [
+  0.9555766,
+  -0.0282895,
+  0.0122982,
+  -0.0230393,
+  1.0099416,
+  -0.020483,
+  0.0631636,
+  0.0210077,
+  1.3299098
 ];
-/**
- * D65 -> D50 chromatic adaptation matrix. Inverse of {@link BRADFORD_D50_D65}.
- *
- * @remarks
- * Reference:
- * http://www.brucelindbloom.com/index.html?Eqn_ChromAdapt.html
- */
-export const BRADFORD_D65_D50 = [
-    1.0478112, 0.0295424, -0.0092345, 0.0228866, 0.9904844, 0.0150436,
-    -0.050127, -0.0170491, 0.7521316,
+const BRADFORD_D65_D50 = [
+  1.0478112,
+  0.0295424,
+  -92345e-7,
+  0.0228866,
+  0.9904844,
+  0.0150436,
+  -0.050127,
+  -0.0170491,
+  0.7521316
 ];
-/**
- * CIE Standard Illuminant D50
- */
-export const D50 = [0.96422, 1, 0.82521];
-/**
- * CIE Standard Illuminant D65
- *
- * Reference:
- * https://en.wikipedia.org/wiki/Illuminant_D65
- */
-export const D65 = [0.95047, 1, 1.08883];
-export const OKLAB_M1 = [
-    0.8189330101, 0.0329845436, 0.0482003018, 0.3618667424, 0.9293118715,
-    0.2643662691, -0.1288597137, 0.0361456387, 0.633851707,
+const D50 = [0.96422, 1, 0.82521];
+const D65 = [0.95047, 1, 1.08883];
+const OKLAB_M1 = [
+  0.8189330101,
+  0.0329845436,
+  0.0482003018,
+  0.3618667424,
+  0.9293118715,
+  0.2643662691,
+  -0.1288597137,
+  0.0361456387,
+  0.633851707
 ];
-export const OKLAB_M2 = [
-    0.2104542553, 1.9779984951, 0.0259040371, 0.793617785, -2.428592205,
-    0.7827717662, -0.0040720468, 0.4505937099, -0.808675766,
+const OKLAB_M2 = [
+  0.2104542553,
+  1.9779984951,
+  0.0259040371,
+  0.793617785,
+  -2.428592205,
+  0.7827717662,
+  -0.0040720468,
+  0.4505937099,
+  -0.808675766
 ];
-/**
- * Float value formatter
- *
- * @internal
- */
-export let FF = float(3);
-/**
- * Percentage value formatter
- *
- * @internal
- */
-export let PC = percent(3);
-/**
- * Sets precision for CSS formatted values to `x` significant digits (default:
- * 3).
- *
- * @param x -
- */
-export const setPrecision = (x) => {
-    FF = float(x);
-    PC = percent(x);
+let FF = float(3);
+let PC = percent(3);
+const setPrecision = (x) => {
+  FF = float(x);
+  PC = percent(x);
+};
+const INV8BIT = 1 / 255;
+const EPS = 1 / 256;
+export {
+  BLACK,
+  BLUE,
+  BRADFORD_D50_D65,
+  BRADFORD_D65_D50,
+  CYAN,
+  D50,
+  D65,
+  EPS,
+  FF,
+  GREEN,
+  INV8BIT,
+  MAGENTA,
+  OKLAB_M1,
+  OKLAB_M2,
+  PC,
+  RED,
+  RGB_LUMINANCE_REC2020,
+  RGB_LUMINANCE_REC601,
+  RGB_LUMINANCE_REC709,
+  RGB_XYZ_D50,
+  RGB_XYZ_D65,
+  WHITE,
+  XYZ_RGB_D50,
+  XYZ_RGB_D65,
+  YELLOW,
+  setPrecision
 };
-export const INV8BIT = 1 / 0xff;
-export const EPS = 1 / 256;

package/api/gradients.js

@@ -1 +0,0 @@
-export {};