toosoon-utils 1.4.0 → 2.0.0

package/lib/colors.d.ts

@@ -1,155 +0,0 @@
-import { ColorRepresentation } from './types';
-/**
- * Normalize a color representation into RGB
- *
- * @param {ColorRepresentation} color Color representation
- * @returns {[number,number,number]} Normalized RGB color
- */
-export declare function normalizeColor(color: ColorRepresentation): [number, number, number];
-/**
- * Normalize an hexadecimal string
- *
- * @param {string} hex Hexadecimal string
- * @returns {string} Normalized hexadecimal string
- */
-export declare function normalizeHexString(hex: string): string;
-/**
- * Convert RGB to hexadecimal
- * Note: rgb values are contained in the interval [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {number} Hexadecimal color
- */
-export declare function rgbToHex([r, g, b]: [number, number, number]): number;
-/**
- * Convert RGB to hexadecimal string
- * Note: rgb values are contained in the interval [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {string} Hexadecimal string
- */
-export declare function rgbToHexString([r, g, b]: [number, number, number]): string;
-/**
- * Convert hexadecimal to RGB
- * Note: rgb values are contained in the interval [0, 1]
- *
- * @param  {(number|string)} hex Hexadecimal color
- * @returns {[number, number, number]} RGB color
- */
-export declare function hexToRgb(hex: number | string): [number, number, number];
-/**
- * Lighten a color
- *
- * @param {string} hex        Hexadecimal string
- * @param {number} [amount=0] Amount of the color offset
- * @returns {string} Computed hexadecimal
- */
-export declare function lighten(hex: string, amount?: number): string;
-/**
- * Darken a color
- *
- * @param {string} hex        Hexadecimal string
- * @param {number} [amount=0] Amount of the color offset
- * @returns {string} Computed hexadecimal
- */
-export declare function darken(hex: string, amount?: number): string;
-/**
- * Normalize an HSL string
- * Note: hsl values are contained in the intervals H: [0, 360], S: [0, 1], L: [0, 1]
- *
- * @param  {string} hsl HSL string (format: 'hsl(360, 100%, 100%)')
- * @returns {[number, number, number]} Normalized HSL color
- */
-export declare function normalizeHslString(hsl: string): [number, number, number];
-/**
- * Convert RGB to HSL
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsl values are contained in the intervals H: [0, 360], S: [0, 1], L: [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} HSL color
- */
-export declare function rgbToHsl([r, g, b]: [number, number, number]): [number, number, number];
-/**
- * Convert HSL to RGB
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsl values are contained in the intervals H: [0, 360], S: [0, 1], L: [0, 1]
- *
- * @param  {[number, number, number]} hsl HSL color
- * @returns {[number, number, number]} RGB color
- */
-export declare function hslToRgb([h, s, l]: [number, number, number]): [number, number, number];
-/**
- * Convert RGB to HSB
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsb values are contained in the intervals H: [0, 360], S: [0, 1], B: [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} HSB color
- */
-export declare function rgbToHsb([r, g, b]: [number, number, number]): [number, number, number];
-/**
- * Convert HSB to RGB
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsb values are contained in the intervals H: [0, 360], S: [0, 1], B: [0, 1]
- *
- * @param  {[number, number, number]} hsb HSB color
- * @returns {[number, number, number]} RGB color
- */
-export declare function hsbToRgb([h, s, b]: [number, number, number]): [number, number, number];
-/**
- * Convert LAB to HCL
- * -> http://www.brucelindbloom.com/index.html?Eqn_Lab_to_LCH.html
- *
- * @param {[number, number, number]} lab LAB color
- * @returns {[number, number, number]} HCL color
- */
-export declare function labToHcl([l, a, b]: [number, number, number]): [number, number, number];
-/**
- * Convert HCL to LAB
- * -> http://www.brucelindbloom.com/index.html?Eqn_LCH_to_Lab.html
- *
- * @param {[number, number, number]} hcl HCL color
- * @returns {[number, number, number]} LAB color space
- */
-export declare function hclToLab([h, c, l]: [number, number, number]): [number, number, number];
-/**
- * Converts LAB to RGB
- *
- * @param {[number, number, number]} lab LAB color
- * @returns {[number, number, number]} RGB color
- */
-export declare function labToRgb([l, a, b]: [number, number, number]): [number, number, number];
-/**
- * Converts RGB to LAB
- *
- * @param {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} LAB color
- */
-export declare function rgbToLab([r, g, b]: [number, number, number]): [number, number, number];
-/**
- * Get the delta from two LAB colors
- *
- * @param {[number, number, number]} labA First LAB color
- * @param {[number, number, number]} labB Second LAB color
- * @returns {number} Delta
- */
-export declare function deltaE(labA: [number, number, number], labB: [number, number, number]): number;
-/**
- * Convert RGB to HCL
- *
- * @param {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} HCL color
- */
-export declare function rgbToHcl([r, g, b]: [number, number, number]): [number, number, number];
-/**
- * Converts HCL to RGB
- *
- * @param {[number, number, number]} hcl RGB color
- * @returns {[number, number, number]} RGB color
- */
-export declare function hclToRgb([h, c, l]: [number, number, number]): [number, number, number];

package/lib/colors.js

@@ -1,367 +0,0 @@
-import { W3CX11 } from './constants';
-import { toDegrees, toRadians } from './geometry';
-import { clamp } from './maths';
-/**
- * Normalize a color representation into RGB
- *
- * @param {ColorRepresentation} color Color representation
- * @returns {[number,number,number]} Normalized RGB color
- */
-export function normalizeColor(color) {
-    var _a;
-    if (typeof color === 'string') {
-        return hexToRgb((_a = W3CX11[color]) !== null && _a !== void 0 ? _a : color);
-    }
-    else if (typeof color === 'number') {
-        return hexToRgb(color);
-    }
-    else {
-        return color;
-    }
-}
-// ******************************************
-// RGB & Hexadecimal color spaces
-// ******************************************
-/**
- * Normalize an hexadecimal string
- *
- * @param {string} hex Hexadecimal string
- * @returns {string} Normalized hexadecimal string
- */
-export function normalizeHexString(hex) {
-    var match;
-    var result = '000000';
-    hex = hex.toLocaleLowerCase();
-    if ((match = hex.match(/(#|0x)?([a-f0-9]{6})/i))) {
-        result = match[2];
-    }
-    else if ((match = hex.match(/^#?([a-f0-9])([a-f0-9])([a-f0-9])$/i))) {
-        result = match[1] + match[1] + match[2] + match[2] + match[3] + match[3];
-    }
-    else if ((match = hex.match(/rgb\(\s*(\d*)\s*,\s*(\d*)\s*,\s*(\d*)\s*\)/))) {
-        result =
-            parseInt(match[1]).toString(16).padStart(2, '0') +
-                parseInt(match[2]).toString(16).padStart(2, '0') +
-                parseInt(match[3]).toString(16).padStart(2, '0');
-    }
-    return "#".concat(result);
-}
-/**
- * Convert RGB to hexadecimal
- * Note: rgb values are contained in the interval [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {number} Hexadecimal color
- */
-export function rgbToHex(_a) {
-    var r = _a[0], g = _a[1], b = _a[2];
-    return ((r * 255) << 16) ^ ((g * 255) << 8) ^ ((b * 255) << 0);
-}
-/**
- * Convert RGB to hexadecimal string
- * Note: rgb values are contained in the interval [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {string} Hexadecimal string
- */
-export function rgbToHexString(_a) {
-    var r = _a[0], g = _a[1], b = _a[2];
-    r = clamp(Math.round(r * 255), 0, 255);
-    g = clamp(Math.round(g * 255), 0, 255);
-    b = clamp(Math.round(b * 255), 0, 255);
-    var result = (b | (g << 8) | (r << 16) | (1 << 24)).toString(16).slice(1);
-    return "#".concat(result);
-}
-/**
- * Convert hexadecimal to RGB
- * Note: rgb values are contained in the interval [0, 1]
- *
- * @param  {(number|string)} hex Hexadecimal color
- * @returns {[number, number, number]} RGB color
- */
-export function hexToRgb(hex) {
-    if (typeof hex === 'number') {
-        hex = Math.floor(hex);
-    }
-    else if (typeof hex === 'string') {
-        hex = normalizeHexString(hex).replace(/^#/, '');
-        hex = parseInt(hex, 16);
-    }
-    var r = ((hex >> 16) & 255) / 255;
-    var g = ((hex >> 8) & 255) / 255;
-    var b = (hex & 255) / 255;
-    return [r, g, b];
-}
-/**
- * Lighten a color
- *
- * @param {string} hex        Hexadecimal string
- * @param {number} [amount=0] Amount of the color offset
- * @returns {string} Computed hexadecimal
- */
-export function lighten(hex, amount) {
-    if (amount === void 0) { amount = 0; }
-    var prefix = '';
-    if (hex[0] === '#') {
-        hex = hex.slice(1);
-        prefix = '#';
-    }
-    var value = parseInt(hex, 16);
-    var r = clamp((value >> 16) + amount, 0, 255);
-    var b = clamp(((value >> 8) & 0x00ff) + amount, 0, 255);
-    var g = clamp((value & 0x0000ff) + amount, 0, 255);
-    var result = g | (b << 8) | (r << 16);
-    if (r === 0 && g === 0 && b === 0 && amount !== 0) {
-        result = '000000';
-    }
-    return prefix + result.toString(16);
-}
-/**
- * Darken a color
- *
- * @param {string} hex        Hexadecimal string
- * @param {number} [amount=0] Amount of the color offset
- * @returns {string} Computed hexadecimal
- */
-export function darken(hex, amount) {
-    if (amount === void 0) { amount = 0; }
-    return lighten(hex, -amount);
-}
-// ***************************************************
-// RGB & Hue-Saturation-Lightness (HSL) color spaces
-// ***************************************************
-/**
- * Normalize an HSL string
- * Note: hsl values are contained in the intervals H: [0, 360], S: [0, 1], L: [0, 1]
- *
- * @param  {string} hsl HSL string (format: 'hsl(360, 100%, 100%)')
- * @returns {[number, number, number]} Normalized HSL color
- */
-export function normalizeHslString(hsl) {
-    var _a, _b;
-    var _c = (_b = (_a = hsl.match(/\d+/g)) === null || _a === void 0 ? void 0 : _a.map(Number)) !== null && _b !== void 0 ? _b : [0, 0, 0], h = _c[0], s = _c[1], l = _c[2];
-    return [h, s / 100, l / 100];
-}
-/**
- * Convert RGB to HSL
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsl values are contained in the intervals H: [0, 360], S: [0, 1], L: [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} HSL color
- */
-export function rgbToHsl(_a) {
-    var r = _a[0], g = _a[1], b = _a[2];
-    var l = Math.max(r, g, b);
-    var s = l - Math.min(r, g, b);
-    var h = s ? (l === r ? (g - b) / s : l === g ? 2 + (b - r) / s : 4 + (r - g) / s) : 0;
-    return [
-        60 * h < 0 ? 60 * h + 360 : 60 * h,
-        s ? (l <= 0.5 ? s / (2 * l - s) : s / (2 - (2 * l - s))) : 0,
-        (2 * l - s) / 2
-    ];
-}
-/**
- * Convert HSL to RGB
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsl values are contained in the intervals H: [0, 360], S: [0, 1], L: [0, 1]
- *
- * @param  {[number, number, number]} hsl HSL color
- * @returns {[number, number, number]} RGB color
- */
-export function hslToRgb(_a) {
-    var h = _a[0], s = _a[1], l = _a[2];
-    var a = s * Math.min(l, 1 - l);
-    var k = function (v) { return (v + h / 30) % 12; };
-    var f = function (v) { return l - a * Math.max(-1, Math.min(k(v) - 3, Math.min(9 - k(v), 1))); };
-    return [f(0), f(8), f(4)];
-}
-// ***************************************************
-// RGB & Hue-Saturation-Brightness (HSB) color spaces
-// ***************************************************
-/**
- * Convert RGB to HSB
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsb values are contained in the intervals H: [0, 360], S: [0, 1], B: [0, 1]
- *
- * @param  {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} HSB color
- */
-export function rgbToHsb(_a) {
-    var r = _a[0], g = _a[1], b = _a[2];
-    var max = Math.max(r, g, b);
-    var min = Math.min(r, g, b);
-    var delta = max - min;
-    var h = delta === 0 ? 0 : delta && max === r ? (g - b) / delta : max === g ? 2 + (b - r) / delta : 4 + (r - g) / delta;
-    return [60 * (h < 0 ? h + 6 : h), max && delta / max, max];
-}
-/**
- * Convert HSB to RGB
- * Notes:
- *  - rgb values are contained in the interval [0, 1]
- *  - hsb values are contained in the intervals H: [0, 360], S: [0, 1], B: [0, 1]
- *
- * @param  {[number, number, number]} hsb HSB color
- * @returns {[number, number, number]} RGB color
- */
-export function hsbToRgb(_a) {
-    var h = _a[0], s = _a[1], b = _a[2];
-    var k = function (v) { return (v + h / 60) % 6; };
-    var f = function (v) { return b * (1 - s * Math.max(0, Math.min(k(v), 4 - k(v), 1))); };
-    return [f(5), f(3), f(1)];
-}
-// *********************************************
-// LAB & Hue-Chroma-Luminance (HCL) color spaces
-// *********************************************
-/**
- * Convert LAB to HCL
- * -> http://www.brucelindbloom.com/index.html?Eqn_Lab_to_LCH.html
- *
- * @param {[number, number, number]} lab LAB color
- * @returns {[number, number, number]} HCL color
- */
-export function labToHcl(_a) {
-    var l = _a[0], a = _a[1], b = _a[2];
-    var c = Math.sqrt(a * a + b * b);
-    var h = abToHue(a, b);
-    return [h, c, l];
-}
-/**
- * Convert HCL to LAB
- * -> http://www.brucelindbloom.com/index.html?Eqn_LCH_to_Lab.html
- *
- * @param {[number, number, number]} hcl HCL color
- * @returns {[number, number, number]} LAB color space
- */
-export function hclToLab(_a) {
-    var h = _a[0], c = _a[1], l = _a[2];
-    var a = c * Math.cos(toRadians(h));
-    var b = c * Math.sin(toRadians(h));
-    return [l, a, b];
-}
-/**
- * Convert A and B of LAB to Hue of LCH
- * -> https://stackoverflow.com/questions/53733379/conversion-of-cielab-to-cielchab-not-yielding-correct-result
- *
- * @param {number} a A value of LAB color
- * @param {number} b B value of LAB color
- * @returns {number} Hue value
- */
-function abToHue(a, b) {
-    if (a >= 0 && b === 0) {
-        return 0;
-    }
-    if (a < 0 && b === 0) {
-        return 180;
-    }
-    if (a === 0 && b > 0) {
-        return 90;
-    }
-    if (a === 0 && b < 0) {
-        return 270;
-    }
-    var xBias = 0;
-    if (a > 0 && b > 0) {
-        xBias = 0;
-    }
-    else if (a < 0) {
-        xBias = 180;
-    }
-    else if (a > 0 && b < 0) {
-        xBias = 360;
-    }
-    return toDegrees(Math.atan(b / a)) + xBias;
-}
-// ******************************************
-// LAB & RGB color spaces
-// ******************************************
-var f1 = function (v) { return (v * v * v > 0.008856 ? v * v * v : (v - 16 / 116) / 7.787); };
-var f2 = function (v) { return (v > 0.0031308 ? 1.055 * Math.pow(v, 1 / 2.4) - 0.055 : 12.92 * v); };
-var f3 = function (v) { return (v > 0.04045 ? Math.pow((v + 0.055) / 1.055, 2.4) : v / 12.92); };
-var f4 = function (v) { return (v > 0.008856 ? Math.pow(v, 1 / 3) : 7.787 * v + 16 / 116); };
-/**
- * Converts LAB to RGB
- *
- * @param {[number, number, number]} lab LAB color
- * @returns {[number, number, number]} RGB color
- */
-export function labToRgb(_a) {
-    var l = _a[0], a = _a[1], b = _a[2];
-    var y = (l + 16) / 116;
-    var x = a / 500 + y;
-    var z = y - b / 200;
-    x = 0.95047 * f1(x);
-    y = 1.0 * f1(y);
-    z = 1.08883 * f1(z);
-    return [
-        clamp(f2(x * 3.2406 + y * -1.5372 + z * -0.4986)),
-        clamp(f2(x * -0.9689 + y * 1.8758 + z * 0.0415)),
-        clamp(f2(x * 0.0557 + y * -0.204 + z * 1.057))
-    ];
-}
-/**
- * Converts RGB to LAB
- *
- * @param {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} LAB color
- */
-export function rgbToLab(_a) {
-    var r = _a[0], g = _a[1], b = _a[2];
-    r = f3(r);
-    g = f3(g);
-    b = f3(b);
-    var x = f4((r * 0.4124 + g * 0.3576 + b * 0.1805) / 0.95047);
-    var y = f4((r * 0.2126 + g * 0.7152 + b * 0.0722) / 1);
-    var z = f4((r * 0.0193 + g * 0.1192 + b * 0.9505) / 1.08883);
-    return [116 * y - 16, 500 * (x - y), 200 * (y - z)];
-}
-/**
- * Get the delta from two LAB colors
- *
- * @param {[number, number, number]} labA First LAB color
- * @param {[number, number, number]} labB Second LAB color
- * @returns {number} Delta
- */
-export function deltaE(labA, labB) {
-    var deltaL = labA[0] - labB[0];
-    var deltaA = labA[1] - labB[1];
-    var deltaB = labA[2] - labB[2];
-    var c1 = Math.sqrt(labA[1] * labA[1] + labA[2] * labA[2]);
-    var c2 = Math.sqrt(labB[1] * labB[1] + labB[2] * labB[2]);
-    var deltaC = c1 - c2;
-    var deltaH = deltaA * deltaA + deltaB * deltaB - deltaC * deltaC;
-    deltaH = deltaH < 0 ? 0 : Math.sqrt(deltaH);
-    var sc = 1.0 + 0.045 * c1;
-    var sh = 1.0 + 0.015 * c1;
-    var deltaLKlsl = deltaL / 1;
-    var deltaCkcsc = deltaC / sc;
-    var deltaHkhsh = deltaH / sh;
-    var i = deltaLKlsl * deltaLKlsl + deltaCkcsc * deltaCkcsc + deltaHkhsh * deltaHkhsh;
-    return i < 0 ? 0 : Math.sqrt(i);
-}
-// *********************************************
-// RGB & Hue-Chroma-Luminance (HCL) color spaces
-// *********************************************
-/**
- * Convert RGB to HCL
- *
- * @param {[number, number, number]} rgb RGB color
- * @returns {[number, number, number]} HCL color
- */
-export function rgbToHcl(_a) {
-    var r = _a[0], g = _a[1], b = _a[2];
-    return labToHcl(rgbToLab([r, g, b]));
-}
-/**
- * Converts HCL to RGB
- *
- * @param {[number, number, number]} hcl RGB color
- * @returns {[number, number, number]} RGB color
- */
-export function hclToRgb(_a) {
-    var h = _a[0], c = _a[1], l = _a[2];
-    return labToRgb(hclToLab([h, c, l]));
-}

package/lib/constants.d.ts

@@ -1,162 +0,0 @@
-export declare const EPSILON = 1e-10;
-export declare const PI: number;
-export declare const TWO_PI: number;
-export declare const HALF_PI: number;
-export declare const QUARTER_PI: number;
-export declare const W3CX11: {
-    aliceblue: number;
-    antiquewhite: number;
-    aqua: number;
-    aquamarine: number;
-    azure: number;
-    beige: number;
-    bisque: number;
-    black: number;
-    blanchedalmond: number;
-    blue: number;
-    blueviolet: number;
-    brown: number;
-    burlywood: number;
-    cadetblue: number;
-    chartreuse: number;
-    chocolate: number;
-    coral: number;
-    cornflower: number;
-    cornflowerblue: number;
-    cornsilk: number;
-    crimson: number;
-    cyan: number;
-    darkblue: number;
-    darkcyan: number;
-    darkgoldenrod: number;
-    darkgray: number;
-    darkgreen: number;
-    darkgrey: number;
-    darkkhaki: number;
-    darkmagenta: number;
-    darkolivegreen: number;
-    darkorange: number;
-    darkorchid: number;
-    darkred: number;
-    darksalmon: number;
-    darkseagreen: number;
-    darkslateblue: number;
-    darkslategray: number;
-    darkslategrey: number;
-    darkturquoise: number;
-    darkviolet: number;
-    deeppink: number;
-    deepskyblue: number;
-    dimgray: number;
-    dimgrey: number;
-    dodgerblue: number;
-    firebrick: number;
-    floralwhite: number;
-    forestgreen: number;
-    fuchsia: number;
-    gainsboro: number;
-    ghostwhite: number;
-    gold: number;
-    goldenrod: number;
-    gray: number;
-    green: number;
-    greenyellow: number;
-    grey: number;
-    honeydew: number;
-    hotpink: number;
-    indianred: number;
-    indigo: number;
-    ivory: number;
-    khaki: number;
-    laserlemon: number;
-    lavender: number;
-    lavenderblush: number;
-    lawngreen: number;
-    lemonchiffon: number;
-    lightblue: number;
-    lightcoral: number;
-    lightcyan: number;
-    lightgoldenrod: number;
-    lightgoldenrodyellow: number;
-    lightgray: number;
-    lightgreen: number;
-    lightgrey: number;
-    lightpink: number;
-    lightsalmon: number;
-    lightseagreen: number;
-    lightskyblue: number;
-    lightslategray: number;
-    lightslategrey: number;
-    lightsteelblue: number;
-    lightyellow: number;
-    lime: number;
-    limegreen: number;
-    linen: number;
-    magenta: number;
-    maroon: number;
-    maroon2: number;
-    maroon3: number;
-    mediumaquamarine: number;
-    mediumblue: number;
-    mediumorchid: number;
-    mediumpurple: number;
-    mediumseagreen: number;
-    mediumslateblue: number;
-    mediumspringgreen: number;
-    mediumturquoise: number;
-    mediumvioletred: number;
-    midnightblue: number;
-    mintcream: number;
-    mistyrose: number;
-    moccasin: number;
-    navajowhite: number;
-    navy: number;
-    oldlace: number;
-    olive: number;
-    olivedrab: number;
-    orange: number;
-    orangered: number;
-    orchid: number;
-    palegoldenrod: number;
-    palegreen: number;
-    paleturquoise: number;
-    palevioletred: number;
-    papayawhip: number;
-    peachpuff: number;
-    peru: number;
-    pink: number;
-    plum: number;
-    powderblue: number;
-    purple: number;
-    purple2: number;
-    purple3: number;
-    rebeccapurple: number;
-    red: number;
-    rosybrown: number;
-    royalblue: number;
-    saddlebrown: number;
-    salmon: number;
-    sandybrown: number;
-    seagreen: number;
-    seashell: number;
-    sienna: number;
-    silver: number;
-    skyblue: number;
-    slateblue: number;
-    slategray: number;
-    slategrey: number;
-    snow: number;
-    springgreen: number;
-    steelblue: number;
-    tan: number;
-    teal: number;
-    thistle: number;
-    tomato: number;
-    turquoise: number;
-    violet: number;
-    wheat: number;
-    white: number;
-    whitesmoke: number;
-    yellow: number;
-    yellowgreen: number;
-};