@thi.ng/color 5.4.0 → 5.4.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-03-02T18:09:03Z
+- **Last updated**: 2023-03-02T19:20:16Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/oklch/oklab-oklch.d.ts

@@ -0,0 +1,3 @@
+import type { ColorOp } from "../api.js";
+export declare const oklabOklch: ColorOp;
+//# sourceMappingURL=oklab-oklch.d.ts.map

package/oklch/oklab-oklch.js

@@ -0,0 +1,15 @@
+import { atan2Abs } from "@thi.ng/math/angle";
+import { INV_TAU } from "@thi.ng/math/api";
+import { setC4 } from "@thi.ng/vectors/setc";
+import { __ensureAlpha } from "../internal/ensure.js";
+export const oklabOklch = (out, src) => setC4(out || src, src[0], Math.hypot(src[1], src[2]), atan2Abs(src[2], src[1]) * INV_TAU, __ensureAlpha(src[3]));
+/*
+export function OKLab_to_OKLCH(OKLab: Color): Color {
+    const hue = Math.atan2(OKLab[2], OKLab[1]) * 180 / Math.PI;
+    return [
+        OKLab[0], // L is still L
+        Math.sqrt(OKLab[1] ** 2 + OKLab[2] ** 2), // Chroma
+        hue >= 0 ? hue : hue + 360, // Hue, in degrees [0 to 360)
+    ];
+}
+*/

package/oklch/oklch-css.d.ts

@@ -0,0 +1,11 @@
+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)
+ *
+ * @param src -
+ */
+export declare const oklchCss: (src: ReadonlyColor) => string;
+//# sourceMappingURL=oklch-css.d.ts.map

package/oklch/oklch-css.js

@@ -0,0 +1,10 @@
+import { __lchCss } from "../internal/css.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)
+ *
+ * @param src -
+ */
+export const oklchCss = (src) => __lchCss("oklch", src, 1);

package/oklch/oklch-oklab.d.ts

@@ -0,0 +1,11 @@
+import type { ColorOp } from "../api.js";
+/**
+ * @remarks
+ * Reference:
+ * - https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js
+ *
+ * @param out
+ * @param src
+ */
+export declare const oklchOklab: ColorOp;
+//# sourceMappingURL=oklch-oklab.d.ts.map

package/oklch/oklch-oklab.js

@@ -0,0 +1,13 @@
+import { cossin } from "@thi.ng/math/angle";
+import { TAU } from "@thi.ng/math/api";
+import { setC4 } from "@thi.ng/vectors/setc";
+import { __ensureAlpha } from "../internal/ensure.js";
+/**
+ * @remarks
+ * Reference:
+ * - https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js
+ *
+ * @param out
+ * @param src
+ */
+export const oklchOklab = (out, src) => setC4(out || src, src[0], ...cossin(src[2] * TAU, src[1]), __ensureAlpha(src[3]));

package/oklch/oklch.d.ts

@@ -0,0 +1,37 @@
+import type { NumericArray } from "@thi.ng/api";
+import type { IRandom } from "@thi.ng/random";
+import type { Color, ColorFactory, ReadonlyColor, TypedColor } from "../api.js";
+export declare class Oklch implements TypedColor<Oklch> {
+    buf: NumericArray;
+    offset: number;
+    stride: number;
+    l: number;
+    c: number;
+    h: number;
+    alpha: number;
+    [id: number]: number;
+    readonly mode: "oklch";
+    readonly length: 4;
+    readonly range: [ReadonlyColor, ReadonlyColor];
+    [Symbol.iterator](): Iterator<number, any, undefined>;
+    clamp(): this;
+    copy(): Oklch;
+    copyView(): Oklch;
+    deref(): Color;
+    empty(): Oklch;
+    eqDelta(o: Oklch, eps?: number): boolean;
+    randomize(rnd?: IRandom): this;
+    set(src: ReadonlyColor): this;
+    toJSON(): number[];
+}
+/**
+ * Oklch color type aka polar version of {@link oklab}.
+ *
+ * @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.
+ *
+ * Reference: https://bottosson.github.io/posts/oklab/
+ */
+export declare const oklch: ColorFactory<Oklch>;
+//# sourceMappingURL=oklch.d.ts.map

package/oklch/oklch.js

@@ -0,0 +1,26 @@
+import { defColor } from "../defcolor.js";
+import { oklabRgb } from "../oklab/oklab-rgb.js";
+import { rgbOklab } from "../rgb/rgb-oklab.js";
+import { oklabOklch } from "./oklab-oklch.js";
+import { oklchOklab } from "./oklch-oklab.js";
+/**
+ * Oklch color type aka polar version of {@link oklab}.
+ *
+ * @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.
+ *
+ * Reference: https://bottosson.github.io/posts/oklab/
+ */
+export const oklch = defColor({
+    mode: "oklch",
+    channels: {
+        c: { range: [0, 0.3225] },
+    },
+    order: ["l", "c", "h", "alpha"],
+    from: {
+        oklab: oklabOklch,
+        rgb: (out, src) => oklabOklch(null, rgbOklab(out, src)),
+    },
+    toRgb: [oklchOklab, oklabRgb],
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/color",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "description": "Array-based color types, CSS parsing, conversions, transformations, declarative theme generation, gradients, presets",
   "type": "module",
   "module": "./index.js",
@@ -118,6 +118,7 @@
     "lab",
     "lch",
     "oklab",
+    "oklch",
     "rgb",
     "srgb",
     "xyy",
@@ -444,5 +445,5 @@
       "vectors"
     ]
   },
-  "gitHead": "a2915dee637c1b8cd2e11a78a23bd035e4f750e7\n"
+  "gitHead": "f2df4bbd52e8e78e9e7499d73f974f9a2f70f017\n"
 }