@thi.ng/color 5.6.30 → 5.6.32

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-03-09T09:18:17Z
+- **Last updated**: 2024-03-13T14:04:31Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -714,7 +714,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/webgl-texture-paint.jpg" width="240"/>           | TODO                                                                        | [Demo](https://demo.thi.ng/umbrella/webgl-texture-paint/)  | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/webgl-texture-paint)  |
+| <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)  |
 
 ## API
 

package/color-range.d.ts

@@ -54,13 +54,15 @@ export declare function colorsFromRange(range: ColorRange | keyof typeof COLOR_R
  * is 1.0.
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/colors-from-theme.ts
  * import { colorsFromTheme } from "@thi.ng/color";
  *
- * [...colorsFromTheme(
- *   [["cool", "aliceblue"], ["bright", "orange", 0.25], ["hotpink", 0.1]],
- *   { num: 10 }
- * )]
+ * console.log(
+ *   [...colorsFromTheme(
+ *     [["cool", "aliceblue"], ["bright", "orange", 0.25], ["hotpink", 0.1]],
+ *     { num: 10 }
+ *   )]
+ * );
  * ```
  *
  * @param parts -

package/color.d.ts

@@ -5,19 +5,19 @@ import type { Color, ColorMode, ParsedColor, TypedColor } from "./api.js";
  * for it (potentially by first parsing the color).
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/color.ts
  * import { color } from "@thi.ng/color";
  *
- * color("springgreen");
+ * console.log(color("springgreen"));
  * // $Color [srgb] { offset: 0, stride: 1, buf: [ 0, 1, 0.498, 1 ] }
  *
- * color("#ff0")
+ * console.log(color("#ff0"));
  * // $Color [srgb] { offset: 0, stride: 1, buf: [ 1, 1, 0, 1 ] }
  *
- * color("oklch(60% 0.15 50)");
+ * console.log(color("oklch(60% 0.15 50)"));
  * // $Color [oklch] { offset: 0, stride: 1, buf: [ 0.6, 0.0015, 0.139, 1 ] }
  *
- * color("hsv", [0.5, 1, 1, 1])
+ * console.log(color("hsv", [0.5, 1, 1, 1]));
  * // $Color [hsv] { offset: 0, stride: 1, buf: [ 0.5, 1, 1, 1 ] }
  * ```
  *

package/cosine-gradients.d.ts

@@ -66,7 +66,7 @@ export declare const cosineCoeffs: FnU2<ReadonlyColor, CosGradientSpec>;
  * [`tween()`](https://docs.thi.ng/umbrella/transducers/functions/tween.html)
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/cosine-gradient.ts
  * import { multiCosineGradient, srgb } from "@thi.ng/color";
  *
  * multiCosineGradient({

package/gradients.d.ts

@@ -4,7 +4,7 @@ import type { GradientOpts } from "./api/gradients.js";
 /**
  * Similar to {@link multiCosineGradient}, but using any number of gradient
  * color stops and isn't limited to RGB, but for arbitrary color types. The
- * optional `isABGR` boolean arg can be used to autoconvert resulting colors
+ * optional `isABGR` boolean arg can be used to auto-convert resulting colors
  * into packed ARGB (false) or ABGR (true) integers. If that arg is given, an
  * array of numbers will be returned.
  *
@@ -13,12 +13,13 @@ import type { GradientOpts } from "./api/gradients.js";
  * [`tween()`](https://docs.thi.ng/umbrella/transducers/functions/tween.html)
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/multi-color-gradient.ts
  * import { lch, multiColorGradient, swatchesH } from "@thi.ng/color";
  * import { serialize } from "@thi.ng/hiccup";
  * import { svg } from "@thi.ng/hiccup-svg";
+ * import { writeFileSync } from "node:fs";
  *
- * gradient = multiColorGradient({
+ * const gradient = multiColorGradient({
  *   num: 100,
  *   // LCH color stops
  *   stops: [

package/mix.d.ts

@@ -54,14 +54,18 @@ export declare const mixNNNN: ColorMixFn;
  * functions to create non-linear interpolations. For example:
  *
  * @example
- * ```ts
+ * ```ts tangle:../export/mix.ts
  * import { mix, rgb, RED, GREEN } from "@thi.ng/color";
  * import { circular } from "@thi.ng/math";
  *
- * mix([], rgb("#f00"), rgb("#0f0"), 0.5);
+ * console.log(
+ *   mix([], rgb("#f00"), rgb("#0f0"), 0.5)
+ * );
  * // [ 0.5, 0.5, 0, 1 ]
  *
- * mix([], RED, GREEN, circular(0.5));
+ * console.log(
+ *   mix([], rgb(RED), rgb(GREEN), circular(0.5))
+ * );
  * // [ 0.1339745962155614, 0.8660254037844386, 0, 1 ]
  * ```
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/color",
-  "version": "5.6.30",
+  "version": "5.6.32",
   "description": "Array-based color types, CSS parsing, conversions, transformations, declarative theme generation, gradients, presets",
   "type": "module",
   "module": "./index.js",
@@ -40,26 +40,26 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.29",
-    "@thi.ng/arrays": "^2.8.7",
-    "@thi.ng/binary": "^3.4.18",
-    "@thi.ng/checks": "^3.5.2",
-    "@thi.ng/compare": "^2.2.25",
-    "@thi.ng/compose": "^2.1.68",
-    "@thi.ng/defmulti": "^3.0.30",
-    "@thi.ng/errors": "^2.4.20",
-    "@thi.ng/math": "^5.10.6",
-    "@thi.ng/random": "^3.6.36",
-    "@thi.ng/strings": "^3.7.22",
-    "@thi.ng/transducers": "^8.9.11",
-    "@thi.ng/vectors": "^7.10.17"
+    "@thi.ng/api": "^8.9.30",
+    "@thi.ng/arrays": "^2.8.8",
+    "@thi.ng/binary": "^3.4.19",
+    "@thi.ng/checks": "^3.5.3",
+    "@thi.ng/compare": "^2.2.26",
+    "@thi.ng/compose": "^2.1.69",
+    "@thi.ng/defmulti": "^3.0.31",
+    "@thi.ng/errors": "^2.5.0",
+    "@thi.ng/math": "^5.10.7",
+    "@thi.ng/random": "^3.6.37",
+    "@thi.ng/strings": "^3.7.23",
+    "@thi.ng/transducers": "^8.9.12",
+    "@thi.ng/vectors": "^7.10.18"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.40.1",
-    "esbuild": "^0.20.0",
+    "@microsoft/api-extractor": "^7.42.3",
+    "esbuild": "^0.20.1",
     "rimraf": "^5.0.5",
-    "typedoc": "^0.25.7",
-    "typescript": "^5.3.3"
+    "typedoc": "^0.25.12",
+    "typescript": "^5.4.2"
   },
   "keywords": [
     "color",
@@ -446,5 +446,5 @@
       "vectors"
     ]
   },
-  "gitHead": "69100942474942f7446ac645d59d91e7dfc352f9\n"
+  "gitHead": "7f3fcbd6c0462b0ce45afa141fe163d1f297fd51\n"
 }

package/sort.d.ts

@@ -21,14 +21,14 @@ 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: <T extends import("@thi.ng/vectors").ReadonlyVec>(colors: T[], key: Fn<ReadonlyColor, number>, isReverse?: boolean) => T[];
+export declare const sort: <T extends import("@thi.ng/vectors/api").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,
  * BUT sorts the **apparent** order by swapping the contents of the backing
  * memory.
  *
- * ```ts
+ * ```ts tangle:../export/sort-mapped.ts
  * import { css, luminanceSrgb, sortMapped, srgb } from "@thi.ng/color";
  *
  * // memory buffer of 4 sRGB colors
@@ -65,5 +65,5 @@ export declare const sort: <T extends import("@thi.ng/vectors").ReadonlyVec>(col
  * @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;
+export declare const mostSimilar: <T extends import("@thi.ng/vectors/api").ReadonlyVec>(colors: T[], key: Fn<ReadonlyColor, number>) => T;
 //# sourceMappingURL=sort.d.ts.map

package/transform.d.ts

@@ -10,7 +10,7 @@ import type { ColorMatrix, ReadonlyColor } from "./api.js";
  * @param src - source color
  * @param clampOut - true, if result should be clamped to [0..1]
  */
-export declare const transform: (out: import("@thi.ng/vectors").Vec | null, mat: ColorMatrix, src: import("@thi.ng/vectors").ReadonlyVec, clampOut?: boolean) => import("@thi.ng/vectors").Vec;
+export declare const transform: (out: import("@thi.ng/vectors").Vec | null, mat: ColorMatrix, src: import("@thi.ng/vectors/api").ReadonlyVec, clampOut?: boolean) => import("@thi.ng/vectors").Vec;
 /**
  * Concatenates given color matrices by pairwise multiplying them in
  * left-right order. Returns combined result matrix to be used with