Merge remote-tracking branch 'origin/main' into feature/color-helpers

packages/color-helpers/.gitignore

@@ -3,4 +3,3 @@ package-lock.json
 yarn.lock
 *.result.css
 *.result.css.map
-dist/*

packages/color-helpers/dist/calculations/binary-search-gamut.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/map-gamut.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function binarySearchGamut(startOKLCH: Color, toDestination: (x: Color) => Color, fromDestination: (x: Color) => Color): Color;

packages/color-helpers/dist/calculations/contrast.d.ts

@@ -0,0 +1 @@
+export declare function contrast(RGB1: Color, RGB2: Color): number;

packages/color-helpers/dist/calculations/delta-EOK.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description Calculate deltaE OK which is the simple root sum of squares
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/deltaEOK.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://github.com/w3c/csswg-drafts/blob/main/css-color-4/deltaEOK.js
+ */
+export declare function deltaEOK(reference: Color, sample: Color): number;

packages/color-helpers/dist/calculations/index.d.ts

@@ -0,0 +1,6 @@
+export * from './binary-search-gamut';
+export * from './polar-premultiply';
+export * from './map-gamut';
+export * from './delta-EOK';
+export * from './contrast';
+export * from './multiply-matrices';

packages/color-helpers/dist/calculations/map-gamut.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/map-gamut.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function mapGamut(startOKLCH: Color, toDestination: (x: Color) => Color, fromDestination: (x: Color) => Color): Color;

packages/color-helpers/dist/calculations/multiply-matrices.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Simple matrix (and vector) multiplication
+ * Warning: No error handling for incompatible dimensions!
+ * @author Lea Verou 2020 MIT License
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/multiply-matrices.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://github.com/w3c/csswg-drafts/blob/main/css-color-4/multiply-matrices.js
+ */
+export declare function multiplyMatrices(a: Array<Array<number>> | Array<number>, b: Array<Array<number>> | Array<number>): Array<Array<number>> | Array<number>;

packages/color-helpers/dist/calculations/polar-premultiply.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Given a color in a cylindical polar colorspace and an alpha value
+ * return the premultiplied form. The index says which entry in the
+ * color array corresponds to hue angle for example, in OKLCH it
+ * would be 2 while in HSL it would be 0
+ *
+ * @param color
+ * @param alpha
+ * @param hueIndex
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function polarPremultiply(color: Color, alpha: number, hueIndex: number): Color;

packages/color-helpers/dist/conversions/a98-rgb-to-srgb.d.ts

@@ -0,0 +1 @@
+export declare function a98_RGB_to_sRGB(a98: Color): Color;

packages/color-helpers/dist/conversions/cie-xyz-50-to-srgb.d.ts

@@ -0,0 +1 @@
+export declare function cie_XYZ_50_to_sRGB(xyz: Color): Color;

packages/color-helpers/dist/conversions/cie-xyz-65-to-srgb.d.ts

@@ -0,0 +1 @@
+export declare function cie_XYZ_65_to_sRGB(xyz: Color): Color;

packages/color-helpers/dist/conversions/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const D50: number[];
+export declare const D65: number[];

packages/color-helpers/dist/conversions/d50-to-d65.d.ts

@@ -0,0 +1 @@
+export declare function D50_to_D65(XYZ: Color): Color;

packages/color-helpers/dist/conversions/d65-to-d50.d.ts

@@ -0,0 +1 @@
+export declare function D65_to_D50(XYZ: Color): Color;

packages/color-helpers/dist/conversions/gam-2020.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert an array of linear-light rec2020 RGB  in the range 0.0-1.0
+ * to gamma corrected form ITU-R BT.2020-2 p.4
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function gam_2020(RGB: Color): Color;

packages/color-helpers/dist/conversions/gam-a98rgb.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert an array of linear-light a98-rgb in the range 0.0-1.0
+ * to gamma corrected form. Negative values are also now accepted
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function gam_a98rgb(RGB: Color): Color;

packages/color-helpers/dist/conversions/gam-p3.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert an array of linear-light display-p3 RGB in the range 0.0-1.0
+ * to gamma corrected form
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function gam_P3(RGB: Color): Color;

packages/color-helpers/dist/conversions/gam-pro-photo.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert an array of linear-light prophoto-rgb in the range 0.0-1.0
+ * to gamma corrected form.
+ * Transfer curve is gamma 1.8 with a small linear portion.
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function gam_ProPhoto(RGB: Color): Color;

packages/color-helpers/dist/conversions/gam-srgb.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Convert an array of linear-light sRGB values in the range 0.0-1.0 to gamma corrected form
+ * Extended transfer function:
+ *  For negative values, linear portion extends on reflection
+ *  of axis, then uses reflected pow below that
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://en.wikipedia.org/wiki/SRGB
+ */
+export declare function gam_sRGB(RGB: Color): Color;

packages/color-helpers/dist/conversions/hsl-to-rgb.d.ts

@@ -0,0 +1,14 @@
+/**
+ * For simplicity, this algorithm assumes that the hue has been normalized to a
+ * number in the half-open range [0, 6), and the saturation and lightness have
+ * been normalized to the range [0, 1]. It returns an array of three numbers
+ * representing the red, green, and blue channels of the colors, normalized
+ * to the range [0, 1]
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js
+ */
+export declare function HSLToRGB(hsl: Color): Color;

packages/color-helpers/dist/conversions/hue-to-rgb.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js
+ */
+export declare function hueToRGB(t1: number, t2: number, hue: number): number;

packages/color-helpers/dist/conversions/index.d.ts

@@ -0,0 +1,57 @@
+export * from './a98-rgb-to-srgb';
+export * from './cie-xyz-50-to-srgb';
+export * from './cie-xyz-65-to-srgb';
+export * from './constants';
+export * from './d50-to-d65';
+export * from './d65-to-d50';
+export * from './gam-2020';
+export * from './gam-a98rgb';
+export * from './gam-p3';
+export * from './gam-pro-photo';
+export * from './gam-srgb';
+export * from './hsl-to-rgb';
+export * from './hue-to-rgb';
+export * from './lab-to-lch';
+export * from './lab-to-p3';
+export * from './lab-to-srgb';
+export * from './lab-to-xyz';
+export * from './lch-to-lab';
+export * from './lch-to-p3';
+export * from './lch-to-rec2020';
+export * from './lch-to-srgb';
+export * from './lin-2020';
+export * from './lin-2020-to-xyz';
+export * from './lin-a98rgb';
+export * from './lin-a98rgb-to-xyz';
+export * from './lin-p3';
+export * from './lin-p3-to-xyz';
+export * from './lin-pro-photo';
+export * from './lin-pro-photo-to-xyz';
+export * from './lin-srgb';
+export * from './lin-srgb-to-xyz';
+export * from './naive-cmyk-to-srgb';
+export * from './oklab-to-oklch';
+export * from './oklab-to-p3';
+export * from './oklab-to-srgb';
+export * from './oklab-to-xyz';
+export * from './oklch-to-oklab';
+export * from './oklch-to-p3';
+export * from './oklch-to-srgb';
+export * from './p3-to-lch';
+export * from './p3-to-srgb';
+export * from './pro-photo-rgb-to-srgb';
+export * from './rec2020-to-lch';
+export * from './rec2020-to-srgb';
+export * from './srgb-linear-to-srgb';
+export * from './srgb-to-lch';
+export * from './srgb-to-luminance';
+export * from './srgb-to-srgb';
+export * from './xyz-to-lab';
+export * from './xyz-to-lin-2020';
+export * from './xyz-to-lin-a98rgb';
+export * from './xyz-to-lin-p3';
+export * from './xyz-to-lin-pro-photo';
+export * from './xyz-to-lin-srgb';
+export * from './xyz-to-oklab';
+export * from './xyz-to-uv';
+export * from './xyz-to-xy';

packages/color-helpers/dist/conversions/lab-to-lch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function Lab_to_LCH(Lab: Color): Color;

packages/color-helpers/dist/conversions/lab-to-p3.d.ts

@@ -0,0 +1 @@
+export declare function Lab_to_P3(labRaw: Color): [Color, boolean];

packages/color-helpers/dist/conversions/lab-to-srgb.d.ts

@@ -0,0 +1 @@
+export declare function Lab_to_sRGB(labRaw: Color): Color;

packages/color-helpers/dist/conversions/lab-to-xyz.d.ts

@@ -0,0 +1 @@
+export declare function Lab_to_XYZ(Lab: Color): Color;

packages/color-helpers/dist/conversions/lch-to-lab.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function LCH_to_Lab(LCH: Color): Color;

packages/color-helpers/dist/conversions/lch-to-p3.d.ts

@@ -0,0 +1 @@
+export declare function LCH_to_P3(lchRaw: Color): [Color, boolean];

packages/color-helpers/dist/conversions/lch-to-rec2020.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Convert an array of CIE LCH values to CIE Lab, and then to XYZ, adapt from
+ * D50 to D65, then convert XYZ to linear-light rec.2020 and finally to gamma
+ * corrected rec.2020 for in-gamut colors, components are in the 0.0 to 1.0
+ * range out of gamut colors may have negative components or components greater
+ * than 1.0 so check for that :)
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js
+ */
+export declare function LCH_to_rec2020(LCH: Color): Color;

packages/color-helpers/dist/conversions/lch-to-srgb.d.ts

@@ -0,0 +1 @@
+export declare function LCH_to_sRGB(lchRaw: Color): Color;

packages/color-helpers/dist/conversions/lin-2020-to-xyz.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Convert an array of linear-light rec2020 values to CIE XYZ
+ * using  D65 (no chromatic adaptation)
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
+ */
+export declare function lin_2020_to_XYZ(rgb: Color): Color;

packages/color-helpers/dist/conversions/lin-2020.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert an array of rec2020 RGB values in the range 0.0 - 1.0
+ * to linear light (un-companded) form.
+ * ITU-R BT.2020-2 p.4
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function lin_2020(RGB: Color): Color;

packages/color-helpers/dist/conversions/lin-a98rgb-to-xyz.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Convert an array of linear-light a98-rgb values to CIE XYZ
+ * http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
+ * has greater numerical precision than section 4.3.5.3 of
+ * https://www.adobe.com/digitalimag/pdfs/AdobeRGB1998.pdf
+ * but the values below were calculated from first principles
+ * from the chromaticity coordinates of R G B W
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
+ * @see https://www.adobe.com/digitalimag/pdfs/AdobeRGB1998.pdf
+ * @see https://github.com/w3c/csswg-drafts/blob/main/css-color-4/matrixmaker.html
+ */
+export declare function lin_a98rgb_to_XYZ(rgb: Color): Color;

packages/color-helpers/dist/conversions/lin-a98rgb.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert an array of a98-rgb values in the range 0.0 - 1.0
+ * to linear light (un-companded) form. Negative values are also now accepted
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function lin_a98rgb(RGB: Color): Color;

packages/color-helpers/dist/conversions/lin-p3-to-xyz.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Convert an array of linear-light display-p3 values to CIE XYZ
+ * using D65 (no chromatic adaptation)
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
+ */
+export declare function lin_P3_to_XYZ(rgb: Color): Color;

packages/color-helpers/dist/conversions/lin-p3.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert an array of display-p3 RGB values in the range 0.0 - 1.0
+ * to linear light (un-companded) form.
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function lin_P3(RGB: Color): Color;

packages/color-helpers/dist/conversions/lin-pro-photo-to-xyz.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Convert an array of linear-light prophoto-rgb values to CIE XYZ
+ * using D50 (so no chromatic adaptation needed afterwards)
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
+ */
+export declare function lin_ProPhoto_to_XYZ(rgb: Color): Color;

packages/color-helpers/dist/conversions/lin-pro-photo.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert an array of prophoto-rgb values where in-gamut Colors are in the
+ * range [0.0 - 1.0] to linear light (un-companded) form. Transfer curve is
+ * gamma 1.8 with a small linear portion. Extended transfer function
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function lin_ProPhoto(RGB: Color): Color;

packages/color-helpers/dist/conversions/lin-srgb-to-xyz.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert an array of linear-light sRGB values to CIE XYZ
+ * using sRGB's own white, D65 (no chromatic adaptation)
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ */
+export declare function lin_sRGB_to_XYZ(rgb: Color): Color;

packages/color-helpers/dist/conversions/lin-srgb.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Convert an array of of sRGB values where in-gamut values are in the range
+ * [0 - 1] to linear light (un-companded) form.
+ * Extended transfer function:
+ *  For negative values, linear portion is extended on reflection of axis,
+ *  then reflected power function is used.
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/conversions.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://en.wikipedia.org/wiki/SRGB
+ */
+export declare function lin_sRGB(RGB: Color): Color;

packages/color-helpers/dist/conversions/naive-cmyk-to-srgb.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CMYK is an array of four values in the range [0.0, 1.0] the output is an
+ * array of [RGB] also in the [0.0, 1.0] range because the naive algorithm
+ * does not generate out of gamut colors neither does it generate accurate
+ * simulations of practical CMYK colors
+ *
+ * @license W3C https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ *
+ * @copyright This software or document includes material copied from or derived from https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js. Copyright © 2022 W3C® (MIT, ERCIM, Keio, Beihang).
+ *
+ * @see https://github.com/w3c/csswg-drafts/blob/main/css-color-4/utilities.js
+ */
+export declare function naive_CMYK_to_sRGB(CMYK: [number, number, number, number]): Color;