plotboilerplate 1.27.0 → 1.28.0

package/src/_cjs/utils/datastructures/Color.js

@@ -0,0 +1,1084 @@
+"use strict";
+/**
+ * @author Extended, bugfixed and ported to TypeScript by Ikaros Kappler.
+ * @modified 2018-xx-xx Added a clone() function.
+ * @modified 2018-xx-xx Allowing leading '#' in the makeHEX() function.
+ * @modified 2018-11-28 Fixed the checkHEX() function to accept 000000.
+ * @modified 2019-11-18 Added a generic parse(string) function that detects the format.
+ * @modified 2020-01-09 Fixed a bug in the parse(string) function. Hex colors with only three elements were considered faulty.
+ * @modified 2020-10-23 Ported to Typescript.
+ * @modified 2021-02-08 Fixed a lot of es2015 compatibility issues.
+ * @modified 2021-02-08 Added basic tsdoc/jsdoc comments.
+ * @modified 2021-11-05 Fixing the regex to parse rgba-strings.
+ * @modified 2021-11-05 Added return value `this` to all modifier functions (for chaining).
+ * @modified 2021-11-07 Changed the behavior of `darken` and `lighten`: the passed value is handled relative now which makes values much easier predictable and makes the change feel more 'natural'.
+ * @modified 2021-11-07 Did the same with `saturate` and `desaturate`.
+ * @modified 2021-11-07 Did the same with the `fadein` and `fadeout` functions.
+ * @modified 2021-11-07 Added setRed, setGreen, setBlue, setHue, setSaturation, setLiminance functions.
+ * @modified 2022-05-11 Modified the `clone` function by just copying the numeric calues, not re-calculating the whole color.
+ * @modified 2022-05-11 Fixed the `interpolate` function.
+ * @modified 2023-01-23 Added `Color.set(Color)` function to set all values (r,g,b,h,s,l,a) simultanoeusly.
+ * @modified 2024-03-10 Fixed some NaN type check for Typescript 5 compatibility.
+ * @modified 2025-08-08 Fixed an issue in the static `makeRGB` method: values in [0..1] are now correctly reconized (1.0 was excluded).
+ * @modified 2025-08-08 Added static color instances (singletons): Color.Red, Color.Gold, Color.Yellow, Color.Green, Color.LimeGreen, Color.Blue, Color.MediumBlue, Color.Purple.
+ * @modified 2025-09-01 Adding all standard web colors. Source: https://en.wikipedia.org/wiki/Web_colors
+ * @modified 2025-09-01 Modifying the `Sanitizer.RGB` helper method: recognoizing 0 to 255 as valid values (not only 1 to 255).
+ * @modified 2025-09-01 Modifying the `Color.parse` method: recognizing CSS color strings now.
+ * @version 0.0.14
+ **/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Color = void 0;
+/**
+ * @classdesc A color class, inspired by neolitec's Javascript class.
+ *    Original found at
+ *      https://gist.github.com/neolitec/1344610
+ *    Thanks to neolitec
+ */
+var Color = /** @class */ (function () {
+    /**
+     * Construct a new color with `r=0 g=0 b=0`.
+     *
+     * Consider using the `makeHex`, `makeRGB` or `makeHSL` functions.
+     *
+     * @constructor
+     * @instance
+     * @memberof Color
+     */
+    function Color() {
+        this.r = this.g = this.b = 0;
+        this.h = this.s = this.l = 0;
+        this.a = 1;
+    }
+    // --- RGB ----------------------------------
+    /**
+     * Get this color as a CSS `rgb` string.
+     *
+     * Consult this for details: https://developer.mozilla.org/en-US/docs/Web/CSS/color_value
+     *
+     * @method cssRGB
+     * @instance
+     * @memberof Color
+     * @return {string} This color as a CSS rgb string.
+     */
+    Color.prototype.cssRGB = function () {
+        return "rgb(" + Math.round(255 * this.r) + "," + Math.round(255 * this.g) + "," + Math.round(255 * this.b) + ")";
+    };
+    /**
+     * Get this color as a CSS `rgba` string.
+     *
+     * Consult this for details: https://developer.mozilla.org/en-US/docs/Web/CSS/color_value
+     *
+     * @method cssRGBA
+     * @instance
+     * @memberof Color
+     * @return {string} This color as a CSS rgba string.
+     */
+    Color.prototype.cssRGBA = function () {
+        return "rgba(".concat(Math.round(255 * this.r), ",").concat(Math.round(255 * this.g), ",").concat(Math.round(255 * this.b), ",").concat(this.a, ")");
+    };
+    /**
+     * Get the red component of this RGB(A)color. This method just returns the `r` color attribute.
+     *
+     * @method red
+     * @instance
+     * @memberof Color
+     * @return {number} A value between 0.0 and 1.0.
+     */
+    Color.prototype.red = function () {
+        return this.r;
+    };
+    /**
+     * Get the green component of this RGB(A) color. This method just returns the `g` color attribute.
+     *
+     * @method green
+     * @instance
+     * @memberof Color
+     * @return {number} A value between 0.0 and 1.0.
+     */
+    Color.prototype.green = function () {
+        return this.g;
+    };
+    /**
+     * Get the blue component of this RGB(A) color. This method just returns the `b` color attribute.
+     *
+     * @method blue
+     * @instance
+     * @memberof Color
+     * @return {number} A value between 0.0 and 1.0.
+     */
+    Color.prototype.blue = function () {
+        return this.b;
+    };
+    Color.prototype.set = function (color) {
+        this.r = color.r;
+        this.g = color.g;
+        this.b = color.b;
+        this.a = color.a;
+        this.h = color.h;
+        this.s = color.s;
+        this.l = color.l;
+        return this;
+    };
+    Color.prototype.setRed = function (r) {
+        this.r = r;
+        return this;
+    };
+    Color.prototype.setBlue = function (b) {
+        this.b = b;
+        Color.Converter.RGBToHSL(this);
+        return this;
+    };
+    Color.prototype.setAlpha = function (a) {
+        this.a = a;
+        Color.Converter.RGBToHSL(this);
+        return this;
+    };
+    Color.prototype.setGreen = function (g) {
+        this.g = g;
+        Color.Converter.RGBToHSL(this);
+        return this;
+    };
+    Color.prototype.setHue = function (h) {
+        this.h = h;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.setSaturation = function (s) {
+        this.s = s;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.setLuminance = function (l) {
+        this.l = l;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    // --- HSL ----------------------------------
+    /**
+     * Get this color as a CSS `hsl` string.
+     *
+     * @method cssHSL
+     * @instance
+     * @memberof Color
+     * @return {string} This color as a CSS hsl string.
+     */
+    Color.prototype.cssHSL = function () {
+        return "hsl(" + Math.round(360 * this.h) + "," + Math.round(100 * this.s) + "%," + Math.round(100 * this.l) + "%)";
+    };
+    /**
+     * Get this color as a CSS `hsla` string.
+     *
+     * @method cssHSLA
+     * @instance
+     * @memberof Color
+     * @return {string} This color as a CSS hsla string.
+     */
+    Color.prototype.cssHSLA = function () {
+        return ("hsla(" +
+            Math.round(360 * this.h) +
+            "," +
+            Math.round(100 * this.s) +
+            "%," +
+            Math.round(100 * this.l) +
+            "%," +
+            Math.round(this.a) +
+            ")");
+    };
+    /**
+     * Get the hue component of this HSL(A) color. This method just returns the `h` color attribute.
+     *
+     * @method hue
+     * @instance
+     * @memberof Color
+     * @return {number} A value between 0.0 and 1.0.
+     */
+    Color.prototype.hue = function () {
+        return this.h;
+    };
+    /**
+     * Get the saturation component of this HSL(A) color. This method just returns the `s` color attribute.
+     *
+     * @method saturation
+     * @instance
+     * @memberof Color
+     * @return {number} A value between 0.0 and 1.0.
+     */
+    Color.prototype.saturation = function () {
+        return this.s;
+    };
+    /**
+     * Get the lightness component of this HSL(A) color. This method just returns the `l` color attribute.
+     *
+     * @method lightness
+     * @instance
+     * @memberof Color
+     * @return {number} A value between 0.0 and 1.0.
+     */
+    Color.prototype.lightness = function () {
+        return this.l;
+    };
+    // --- HEX ----------------------------------
+    /**
+     * Get this color as a CSS-HEX string (non-alpha): #rrggbb
+     *
+     * @method cssHEX
+     * @instance
+     * @memberof Color
+     * @return {string} This color as a CSS-HEX string.
+     */
+    Color.prototype.cssHEX = function () {
+        return ("#" +
+            (255 * this.r < 16 ? "0" : "") +
+            Math.round(255 * this.r).toString(16) +
+            (255 * this.g < 16 ? "0" : "") +
+            Math.round(255 * this.g).toString(16) +
+            (255 * this.b < 16 ? "0" : "") +
+            Math.round(255 * this.b).toString(16));
+    };
+    // --- Transparency ----------------------------------
+    /**
+     * Get the alpha channel (transparency) of this color.
+     *
+     * @method alpha
+     * @instance
+     * @memberof Color
+     * @return {number} A value between 0.0 and 1.0.
+     */
+    Color.prototype.alpha = function () {
+        return this.a;
+    };
+    // --- Modifiers ----------------------------------
+    //   saturate(v: string | number): Color {
+    //     if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) {
+    //       this.s += v / 100;
+    //     } else if ("number" == typeof v) {
+    //       // range 255
+    //       this.s += v / 255;
+    //     } else {
+    //       throw new Error("error: bad modifier format (percent or number)");
+    //     }
+    //     if (this.s > 1) this.s = 1;
+    //     else if (this.s < 0) this.s = 0;
+    //     Color.Converter.HSLToRGB(this);
+    //     return this;
+    //   }
+    Color.prototype.saturate = function (v) {
+        // if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) {
+        if ("string" == typeof v && v.indexOf("%") > -1 && !Number.isNaN((v = parseInt(v)))) {
+            this.s += (1 - this.s) * (v / 100);
+        }
+        else if ("number" == typeof v) {
+            if (v >= -0.0 && v <= 1.0) {
+                // range 255
+                this.s += (1 - this.s) * v;
+            }
+            else {
+                // range 0-1
+                this.s += (1 - this.s) * (v / 255);
+            }
+        }
+        else {
+            throw new Error("error: bad modifier format (percent or number)");
+        }
+        if (this.s > 1)
+            this.s = 1;
+        else if (this.s < 0)
+            this.s = 0;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.desaturate = function (v) {
+        // if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) {
+        if ("string" == typeof v && v.indexOf("%") > -1 && !Number.isNaN((v = parseInt(v)))) {
+            this.s -= v / 100;
+        }
+        else if ("number" == typeof v) {
+            if (v >= 0.0 && v <= 1.0) {
+                // range 255
+                this.s -= this.s * v;
+            }
+            else {
+                // range 0-1
+                this.s -= this.s * (v / 255);
+            }
+        }
+        else {
+            throw new Error("error: bad modifier format (percent or number)");
+        }
+        if (this.s > 1)
+            this.s = 1;
+        else if (this.s < 0)
+            this.s = 0;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.lighten = function (v) {
+        // if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) {
+        if ("string" == typeof v && v.indexOf("%") > -1 && !Number.isNaN((v = parseInt(v)))) {
+            this.l += (1 - this.l) * (v / 100);
+        }
+        else if ("number" == typeof v) {
+            if (v >= 0.0 && v <= 1.0) {
+                // range 0.0...1.0
+                this.l += (1 - this.l) * v;
+            }
+            else {
+                // range 255
+                this.l += (1 - this.l) * (v / 255);
+            }
+        }
+        else {
+            throw new Error("error: bad modifier format (percent or number)");
+        }
+        if (this.l > 1)
+            this.l = 1;
+        else if (this.l < 0)
+            this.l = 0;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.darken = function (v) {
+        // if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) {
+        if ("string" == typeof v && v.indexOf("%") > -1 && !Number.isNaN((v = parseInt(v)))) {
+            this.l -= this.l * (v / 100);
+        }
+        else if ("number" == typeof v) {
+            if (v >= 0.0 && v <= 1.0) {
+                // range 0.0...1.0
+                this.l -= this.l * v;
+            }
+            else {
+                // range 255
+                this.l -= this.l * (v / 255);
+            }
+        }
+        else {
+            throw new Error("error: bad modifier format (percent or number)");
+        }
+        if (this.l > 1)
+            this.l = 1;
+        else if (this.l < 0)
+            this.l = 0;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.fadein = function (v) {
+        // if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) {
+        if ("string" == typeof v && v.indexOf("%") > -1 && !Number.isNaN((v = parseInt(v)))) {
+            this.a += (1 - this.a) * (v / 100);
+        }
+        else if ("number" == typeof v) {
+            if (v >= 0.0 && v <= 1.0) {
+                // range 0-1
+                this.a += (1 - this.a) * v;
+            }
+            else {
+                // range 255
+                this.a += (1 - this.a) * (v / 255);
+            }
+        }
+        else {
+            throw new Error("error: bad modifier format (percent or number)");
+        }
+        console.log("New alpha", this.a);
+        if (this.a > 1)
+            this.a = 1;
+        else if (this.a < 0)
+            this.a = 0;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.fadeout = function (v) {
+        // if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) {
+        if ("string" == typeof v && v.indexOf("%") > -1 && !Number.isNaN((v = parseInt(v)))) {
+            this.a -= v / 100;
+        }
+        else if ("number" == typeof v) {
+            if (v >= 0.0 && v <= 1.0) {
+                // range 0-1
+                this.a -= v;
+            }
+            else {
+                // range 255
+                this.a -= v / 255;
+            }
+        }
+        else {
+            throw new Error("error: bad modifier format (percent or number)");
+        }
+        if (this.a > 1)
+            this.a = 1;
+        else if (this.a < 0)
+            this.a = 0;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.prototype.spin = function (v) {
+        // if ("string" == typeof v && v.indexOf("%") > -1 && (v = parseInt(v)) != NaN) this.h += v / 100;
+        if ("string" == typeof v && v.indexOf("%") > -1 && !Number.isNaN((v = parseInt(v)))) {
+            this.h += v / 100;
+        }
+        else if ("number" == typeof v) {
+            // range 360
+            this.h += v / 360;
+        }
+        else {
+            throw new Error("error: bad modifier format (percent or number)");
+        }
+        if (this.h > 1)
+            this.h = 1;
+        else if (this.h < 0)
+            this.h = 0;
+        Color.Converter.HSLToRGB(this);
+        return this;
+    };
+    Color.makeRGB = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var c = new Color();
+        var sanitized;
+        if (args.length < 3 || args.length > 4) {
+            throw new Error("error: 3 or 4 arguments");
+        }
+        sanitized = Color.Sanitizer.RGB(args[0], args[1], args[2]);
+        c.r = sanitized[0];
+        c.g = sanitized[1];
+        c.b = sanitized[2];
+        if (args.length == 4) {
+            c.a = args[3];
+        }
+        else {
+            c.a = 1.0;
+        }
+        Color.Converter.RGBToHSL(c);
+        return c;
+    };
+    Color.makeHSL = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var c = new Color();
+        var sanitized;
+        if (args.length < 3 || args.length > 4) {
+            throw new Error("error: 3 or 4 arguments");
+        }
+        sanitized = Color.Sanitizer.HSL(args[0], args[1], args[2]);
+        c.h = sanitized[0];
+        c.s = sanitized[1];
+        c.l = sanitized[2];
+        if (args.length == 4) {
+            c.a = typeof args[3] === "string" ? Number.parseFloat(args[3]) : args[3];
+        }
+        else {
+            c.a = 1.0;
+        }
+        Color.Converter.HSLToRGB(c);
+        return c;
+    };
+    Color.makeHEX = function (value) {
+        var c = new Color(), sanitized;
+        // Edit Ika 2018-0308
+        // Allow leading '#'
+        if (value && value.startsWith("#")) {
+            value = value.substr(1);
+        }
+        Color.Validator.checkHEX(value);
+        if (value.length == 3) {
+            sanitized = Color.Sanitizer.RGB(parseInt(value.substr(0, 1) + value.substr(0, 1), 16), parseInt(value.substr(1, 1) + value.substr(1, 1), 16), parseInt(value.substr(2, 1) + value.substr(2, 1), 16));
+        }
+        else if (value.length == 6) {
+            sanitized = Color.Sanitizer.RGB(parseInt(value.substr(0, 2), 16), parseInt(value.substr(2, 2), 16), parseInt(value.substr(4, 2), 16));
+        }
+        else {
+            throw new Error("error: 3 or 6 arguments");
+        }
+        c.r = sanitized[0];
+        c.g = sanitized[1];
+        c.b = sanitized[2];
+        c.a = 1.0; // TODO: Accept #xxxxxxxx (8 chars, too, for alpha)
+        Color.Converter.RGBToHSL(c);
+        return c;
+    };
+    /**
+     * Parse the given color string. Currently only these formate are recognized: hex, rgb, rgba.
+     *
+     * @method parse
+     * @static
+     * @memberof Color
+     * @param {string} str - The string representation to parse.
+     * @return {Color} The color instance that's represented by the given string.
+     */
+    Color.parse = function (str) {
+        if (typeof str == "undefined") {
+            return null;
+        }
+        if ((str = str.trim().toLowerCase()).length == 0) {
+            return null;
+        }
+        if (str.startsWith("#")) {
+            return Color.makeHEX(str.substring(1, str.length));
+        }
+        if (str.startsWith("rgb")) {
+            var parts = str.match(/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,?\s*(\d*(?:\.\d+\s*)?)\)$/);
+            if (!parts) {
+                throw "Unrecognized color format (2): " + str;
+            }
+            // [ str, r, g, b, a|undefined ]
+            //   console.log("parts", parts);
+            if (parts.length <= 4 || typeof parts[4] == "undefined" || parts[4] == "") {
+                return Color.makeRGB(parts[1], parts[2], parts[3]);
+            }
+            else {
+                return Color.makeRGB(parts[1], parts[2], parts[3], Number(parts[4]));
+            }
+        }
+        // Try to locate by CSS color name
+        var keys = Object.keys(Color.CSS_COLORS);
+        var cssColorKey = keys.reduce(function (prevKey, curKey) {
+            if (curKey && curKey.toLowerCase() === str.toLowerCase()) {
+                return curKey;
+            }
+            return prevKey;
+        }, null);
+        if (cssColorKey) {
+            var cssColor = Color.CSS_COLORS[cssColorKey];
+            // console.log("cssColor?", cssColor, str, cssColorKey);
+            if (cssColor) {
+                // console.log("CONSTRUCTOR?", cssColor.constructor);
+                return cssColor.clone();
+            }
+        }
+        throw "Unrecognized color format (1): " + str;
+    };
+    /**
+     * Create a clone of this color (RGB).
+     *
+     * @method clone
+     * @instance
+     * @memberof Color
+     * @return {Color} A clone of this color (in RGB mode).
+     */
+    Color.prototype.clone = function () {
+        // return Color.makeRGB(this.r, this.g, this.b, this.a);
+        var col = new Color();
+        col.r = this.r;
+        col.g = this.g;
+        col.b = this.b;
+        col.a = this.a;
+        col.h = this.h;
+        col.s = this.s;
+        col.l = this.l;
+        return col;
+    };
+    /**
+     * Interpolate this color on the RGB scale.
+     *
+     * @method interpolate
+     * @instance
+     * @memberof Color
+     * @param {Color} c - The color to interpolate to.
+     * @param {number} t - An interpolation value between 0.0 and 1.0.
+     * @return {Color} A clone of this color (in RGB mode).
+     */
+    Color.prototype.interpolate = function (c, t) {
+        this.r += (c.r - this.r) * t;
+        this.g += (c.g - this.g) * t;
+        this.b += (c.b - this.b) * t;
+        this.a += (c.a - this.a) * t;
+        return this;
+    };
+    Color.Sanitizer = {
+        RGB: function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            var o = [];
+            if (args.length == 0) {
+                return [];
+            }
+            // const allAreFrac = Color.testFrac( arguments );
+            for (var i = 0; i < args.length; i++) {
+                var c = args[i];
+                if ("string" == typeof c && c.indexOf("%") > -1) {
+                    // if ((c = parseInt(c)) == NaN) throw new Error("Bad format");
+                    if (Number.isNaN((c = parseInt(c)))) {
+                        throw new Error("Bad format");
+                    }
+                    if (c < 0 || c > 100)
+                        throw new Error("Bad format");
+                    o[i] = c / 100;
+                }
+                else {
+                    // if ("string" == typeof c && (c = parseInt(c)) == NaN) {
+                    if ("string" == typeof c && Number.isNaN((c = parseInt(c)))) {
+                        throw new Error("Bad format");
+                    }
+                    if (c < 0) {
+                        throw new Error("Bad format");
+                    }
+                    //else if( allAreFrac ) o[i] = c; // c >= 0 && c <= 1 (all)
+                    else if (c >= 0 && c <= 1) {
+                        o[i] = c;
+                    }
+                    // else if(c >= 0.0 && c <= 1.0) o[i] = c;
+                    else if (c >= 0 && c < 256) {
+                        o[i] = c / 255;
+                    }
+                    // ???
+                    // else if(c >= 0 && c < 256) o[i] = c/255;
+                    else
+                        throw new Error("Bad format (" + c + ")");
+                }
+            }
+            return o;
+        },
+        HSL: function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            if (args.length < 3 || args.length > 4) {
+                throw new Error("3 or 4 arguments required");
+            }
+            var h = args[0], s = args[1], l = args[2];
+            // if ("string" == typeof h && (h = parseFloat(h)) == NaN) throw new Error("Bad format for hue");
+            if ("string" == typeof h && Number.isNaN((h = parseFloat(h)))) {
+                throw new Error("Bad format for hue");
+            }
+            if (h < 0 || h > 360)
+                throw new Error("Hue out of range (0..360)");
+            else if ((("" + h).indexOf(".") > -1 && h > 1) || ("" + h).indexOf(".") == -1)
+                h /= 360;
+            if ("string" == typeof s && s.indexOf("%") > -1) {
+                // if ((s = parseInt(s)) == NaN) throw new Error("Bad format for saturation");
+                if (Number.isNaN((s = parseInt(s)))) {
+                    throw new Error("Bad format for saturation");
+                }
+                if (s < 0 || s > 100) {
+                    throw new Error("Bad format for saturation");
+                }
+                s /= 100;
+            }
+            else {
+                s = typeof s === "string" ? Number.parseFloat(s) : s;
+                if (s < 0 || s > 1) {
+                    throw new Error("Bad format for saturation");
+                }
+            }
+            if ("string" == typeof l && l.indexOf("%") > -1) {
+                // if ((l = parseInt(l)) == NaN) throw new Error("Bad format for lightness");
+                if (Number.isNaN((l = parseInt(l)))) {
+                    throw new Error("Bad format for lightness");
+                }
+                if (l < 0 || l > 100) {
+                    throw new Error("Bad format for lightness");
+                }
+                l /= 100;
+            }
+            else {
+                l = typeof l === "string" ? Number.parseFloat(l) : l;
+                if (l < 0 || l > 1) {
+                    throw new Error("Bad format for lightness");
+                }
+            }
+            return [h, s, l];
+        }
+    }; // ENd sanitizer
+    Color.Validator = {
+        /**
+         * Check a hexa color (without #)
+         */
+        checkHEX: function (value) {
+            if (value.length != 6 && value.length != 3)
+                throw new Error("Hexa color: bad length (" + value.length + ")," + value);
+            value = value.toLowerCase();
+            //for( var i in value ) {
+            for (var i = 0; i < value.length; i++) {
+                var c = value.charCodeAt(i);
+                if (!((c >= 48 && c <= 57) || (c >= 97 && c <= 102)))
+                    throw new Error("Hexa color: out of range for \"".concat(value, "\" at position ").concat(i, "."));
+            }
+        }
+    };
+    Color.Converter = {
+        /**
+         * Calculates HSL Color.
+         * RGB must be normalized.
+         * http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript
+         */
+        RGBToHSL: function (color) {
+            var r = color.r;
+            var g = color.g;
+            var b = color.b;
+            var max = Math.max(r, g, b);
+            var min = Math.min(r, g, b);
+            color.l = (max + min) / 2;
+            if (max == min) {
+                color.h = color.s = 0; // achromatic
+            }
+            else {
+                var d = max - min;
+                color.s = color.l > 0.5 ? d / (2 - max - min) : d / (max + min);
+                switch (max) {
+                    case r:
+                        color.h = (g - b) / d + (g < b ? 6 : 0);
+                        break;
+                    case g:
+                        color.h = (b - r) / d + 2;
+                        break;
+                    case b:
+                        color.h = (r - g) / d + 4;
+                        break;
+                }
+                color.h /= 6;
+            }
+        },
+        /**
+         * Calculates RGB color (nomalized).
+         * HSL must be normalized.
+         *
+         * http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript
+         */
+        HSLToRGB: function (color) {
+            var h = color.h;
+            var s = color.s;
+            var l = color.l;
+            if (s == 0) {
+                color.r = color.g = color.b = l; // achromatic
+            }
+            else {
+                var q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+                var p = 2 * l - q;
+                color.r = Color.Converter.hue2rgb(p, q, h + 1 / 3);
+                color.g = Color.Converter.hue2rgb(p, q, h);
+                color.b = Color.Converter.hue2rgb(p, q, h - 1 / 3);
+            }
+        },
+        hue2rgb: function (p, q, t) {
+            if (t < 0)
+                t += 1;
+            if (t > 1)
+                t -= 1;
+            if (t < 1 / 6)
+                return p + (q - p) * 6 * t;
+            if (t < 1 / 2)
+                return q;
+            if (t < 2 / 3)
+                return p + (q - p) * (2 / 3 - t) * 6;
+            return p;
+        }
+    };
+    // Source
+    //    https://en.wikipedia.org/wiki/Web_colors
+    // Pink colors
+    Color.MediumVioletRed = Color.makeRGB(199, 21, 133);
+    Color.DeepPink = Color.makeRGB(255, 20, 147);
+    Color.PaleVioletRed = Color.makeRGB(219, 112, 147);
+    Color.HotPink = Color.makeRGB(255, 105, 180);
+    Color.LightPink = Color.makeRGB(255, 182, 193);
+    Color.Pink = Color.makeRGB(255, 192, 203);
+    // Red colors
+    Color.DarkRed = Color.makeRGB(139, 0, 0);
+    Color.Red = Color.makeRGB(255, 0, 0);
+    Color.Firebrick = Color.makeRGB(178, 34, 34);
+    Color.Crimson = Color.makeRGB(220, 20, 60);
+    Color.IndianRed = Color.makeRGB(205, 92, 92);
+    Color.LightCoral = Color.makeRGB(240, 128, 128);
+    Color.Salmon = Color.makeRGB(250, 128, 114);
+    Color.DarkSalmon = Color.makeRGB(233, 150, 122);
+    Color.LightSalmon = Color.makeRGB(255, 160, 122);
+    // Orange colors
+    Color.OrangeRed = Color.makeRGB(255, 69, 0);
+    Color.Tomato = Color.makeRGB(255, 99, 71);
+    Color.DarkOrange = Color.makeRGB(255, 140, 0);
+    Color.Coral = Color.makeRGB(255, 127, 80);
+    Color.Orange = Color.makeRGB(255, 165, 0);
+    // Yellow colors
+    Color.DarkKhaki = Color.makeRGB(189, 183, 107);
+    Color.Gold = Color.makeRGB(255, 215, 0);
+    Color.Khaki = Color.makeRGB(240, 230, 140);
+    Color.PeachPuff = Color.makeRGB(255, 218, 185);
+    Color.Yellow = Color.makeRGB(255, 255, 0);
+    Color.PaleGoldenrod = Color.makeRGB(238, 232, 170);
+    Color.Moccasin = Color.makeRGB(255, 228, 181);
+    Color.PapayaWhip = Color.makeRGB(255, 239, 213);
+    Color.LightGoldenrodYellow = Color.makeRGB(250, 250, 210);
+    Color.LemonChiffon = Color.makeRGB(255, 250, 205);
+    Color.LightYellow = Color.makeRGB(255, 255, 224);
+    // Brown colors
+    Color.Maroon = Color.makeRGB(128, 0, 0);
+    Color.Brown = Color.makeRGB(165, 42, 42);
+    Color.SaddleBrown = Color.makeRGB(139, 69, 19);
+    Color.Sienna = Color.makeRGB(160, 82, 45);
+    Color.Chocolate = Color.makeRGB(210, 105, 30);
+    Color.DarkGoldenrod = Color.makeRGB(184, 134, 11);
+    Color.Peru = Color.makeRGB(205, 133, 63);
+    Color.RosyBrown = Color.makeRGB(188, 143, 143);
+    Color.Goldenrod = Color.makeRGB(218, 165, 32);
+    Color.SandyBrown = Color.makeRGB(244, 164, 96);
+    Color.Tan = Color.makeRGB(210, 180, 140);
+    Color.Burlywood = Color.makeRGB(222, 184, 135);
+    Color.Wheat = Color.makeRGB(245, 222, 179);
+    Color.NavajoWhite = Color.makeRGB(255, 222, 173);
+    Color.Bisque = Color.makeRGB(255, 228, 196);
+    Color.BlanchedAlmond = Color.makeRGB(255, 235, 205);
+    Color.Cornsilk = Color.makeRGB(255, 248, 220);
+    // Purple, violet, and magenta colors
+    Color.Indigo = Color.makeRGB(75, 0, 130);
+    Color.Purple = Color.makeRGB(128, 0, 128);
+    Color.DarkMagenta = Color.makeRGB(139, 0, 139);
+    Color.DarkViolet = Color.makeRGB(148, 0, 211);
+    Color.DarkSlateBlue = Color.makeRGB(72, 61, 139);
+    Color.BlueViolet = Color.makeRGB(138, 43, 226);
+    Color.DarkOrchid = Color.makeRGB(153, 50, 204);
+    Color.Fuchsia = Color.makeRGB(255, 0, 255);
+    Color.Magenta = Color.makeRGB(255, 0, 255);
+    Color.SlateBlue = Color.makeRGB(106, 90, 205);
+    Color.MediumSlateBlue = Color.makeRGB(123, 104, 238);
+    Color.MediumOrchid = Color.makeRGB(186, 85, 211);
+    Color.MediumPurple = Color.makeRGB(147, 112, 219);
+    Color.Orchid = Color.makeRGB(218, 112, 214);
+    Color.Violet = Color.makeRGB(238, 130, 238);
+    Color.Plum = Color.makeRGB(221, 160, 221);
+    Color.Thistle = Color.makeRGB(216, 191, 216);
+    Color.Lavender = Color.makeRGB(230, 230, 250);
+    // Blue colors
+    Color.MidnightBlue = Color.makeRGB(25, 25, 112);
+    Color.Navy = Color.makeRGB(0, 0, 128);
+    Color.DarkBlue = Color.makeRGB(0, 0, 139);
+    Color.MediumBlue = Color.makeRGB(0, 0, 205);
+    Color.Blue = Color.makeRGB(0, 0, 255);
+    Color.RoyalBlue = Color.makeRGB(65, 105, 225);
+    Color.SteelBlue = Color.makeRGB(70, 130, 180);
+    Color.DodgerBlue = Color.makeRGB(30, 144, 255);
+    Color.DeepSkyBlue = Color.makeRGB(0, 191, 255);
+    Color.CornflowerBlue = Color.makeRGB(100, 149, 237);
+    Color.SkyBlue = Color.makeRGB(135, 206, 235);
+    Color.LightSkyBlue = Color.makeRGB(135, 206, 250);
+    Color.LightSteelBlue = Color.makeRGB(176, 196, 222);
+    Color.LightBlue = Color.makeRGB(173, 216, 230);
+    Color.PowderBlue = Color.makeRGB(176, 224, 230);
+    // Cyan colors
+    Color.Teal = Color.makeRGB(0, 128, 128);
+    Color.DarkCyan = Color.makeRGB(0, 139, 139);
+    Color.LightSeaGreen = Color.makeRGB(32, 178, 170);
+    Color.CadetBlue = Color.makeRGB(95, 158, 160);
+    Color.DarkTurquoise = Color.makeRGB(0, 206, 209);
+    Color.MediumTurquoise = Color.makeRGB(72, 209, 204);
+    Color.Turquoise = Color.makeRGB(64, 224, 208);
+    Color.Aqua = Color.makeRGB(0, 255, 255);
+    Color.Cyan = Color.makeRGB(0, 255, 255);
+    Color.Aquamarine = Color.makeRGB(127, 255, 212);
+    Color.PaleTurquoise = Color.makeRGB(175, 238, 238);
+    Color.LightCyan = Color.makeRGB(224, 255, 255);
+    // Green colors
+    Color.DarkGreen = Color.makeRGB(0, 100, 0);
+    Color.Green = Color.makeRGB(0, 128, 0);
+    Color.DarkOliveGreen = Color.makeRGB(85, 107, 47);
+    Color.ForestGreen = Color.makeRGB(34, 139, 34);
+    Color.SeaGreen = Color.makeRGB(46, 139, 87);
+    Color.Olive = Color.makeRGB(128, 128, 0);
+    Color.OliveDrab = Color.makeRGB(107, 142, 35);
+    Color.MediumSeaGreen = Color.makeRGB(60, 179, 113);
+    Color.LimeGreen = Color.makeRGB(50, 205, 50);
+    Color.Lime = Color.makeRGB(0, 255, 0);
+    Color.SpringGreen = Color.makeRGB(0, 255, 127);
+    Color.MediumSpringGreen = Color.makeRGB(0, 250, 154);
+    Color.DarkSeaGreen = Color.makeRGB(143, 188, 143);
+    Color.MediumAquamarine = Color.makeRGB(102, 205, 170);
+    Color.YellowGreen = Color.makeRGB(154, 205, 50);
+    Color.LawnGreen = Color.makeRGB(124, 252, 0);
+    Color.Chartreuse = Color.makeRGB(127, 255, 0);
+    Color.LightGreen = Color.makeRGB(144, 238, 144);
+    Color.GreenYellow = Color.makeRGB(173, 255, 47);
+    Color.PaleGreen = Color.makeRGB(152, 251, 152);
+    // White colors
+    Color.MistyRose = Color.makeRGB(255, 228, 225);
+    Color.AntiqueWhite = Color.makeRGB(250, 235, 215);
+    Color.Linen = Color.makeRGB(250, 240, 230);
+    Color.Beige = Color.makeRGB(245, 245, 220);
+    Color.WhiteSmoke = Color.makeRGB(245, 245, 245);
+    Color.LavenderBlush = Color.makeRGB(255, 240, 245);
+    Color.OldLace = Color.makeRGB(253, 245, 230);
+    Color.AliceBlue = Color.makeRGB(240, 248, 255);
+    Color.Seashell = Color.makeRGB(255, 245, 238);
+    Color.GhostWhite = Color.makeRGB(248, 248, 255);
+    Color.Honeydew = Color.makeRGB(240, 255, 240);
+    Color.FloralWhite = Color.makeRGB(255, 250, 240);
+    Color.Azure = Color.makeRGB(240, 255, 255);
+    Color.MintCream = Color.makeRGB(245, 255, 250);
+    Color.Snow = Color.makeRGB(255, 250, 250);
+    Color.Ivory = Color.makeRGB(255, 255, 240);
+    Color.White = Color.makeRGB(255, 255, 255);
+    // Gray and black colors
+    Color.Black = Color.makeRGB(0, 0, 0);
+    Color.DarkSlateGray = Color.makeRGB(47, 79, 79);
+    Color.DimGray = Color.makeRGB(105, 105, 105);
+    Color.SlateGray = Color.makeRGB(112, 128, 144);
+    Color.Gray = Color.makeRGB(128, 128, 128);
+    Color.LightSlateGray = Color.makeRGB(119, 136, 153);
+    Color.DarkGray = Color.makeRGB(169, 169, 169);
+    Color.Silver = Color.makeRGB(192, 192, 192);
+    Color.LightGray = Color.makeRGB(211, 211, 211);
+    Color.Gainsboro = Color.makeRGB(220, 220, 220);
+    Color.CSS_COLORS = {
+        // Pink Color.XYZ,lors
+        MediumVioletRed: Color.MediumVioletRed,
+        DeepPink: Color.DeepPink,
+        PaleVioletRed: Color.PaleVioletRed,
+        HotPink: Color.HotPink,
+        LightPink: Color.LightPink,
+        Pink: Color.Pink,
+        // Red Color.XYZ,lors
+        DarkRed: Color.DarkRed,
+        Red: Color.Red,
+        Firebrick: Color.Firebrick,
+        Crimson: Color.Crimson,
+        IndianRed: Color.IndianRed,
+        LightCoral: Color.LightCoral,
+        Salmon: Color.Salmon,
+        DarkSalmon: Color.DarkSalmon,
+        LightSalmon: Color.LightSalmon,
+        // Orange Color.XYZ,lors
+        OrangeRed: Color.OrangeRed,
+        Tomato: Color.Tomato,
+        DarkOrange: Color.DarkOrange,
+        Coral: Color.Coral,
+        Orange: Color.Orange,
+        // Yellow Color.XYZ,lors
+        DarkKhaki: Color.DarkKhaki,
+        Gold: Color.Gold,
+        Khaki: Color.Khaki,
+        PeachPuff: Color.PeachPuff,
+        Yellow: Color.Yellow,
+        PaleGoldenrod: Color.PaleGoldenrod,
+        Moccasin: Color.Moccasin,
+        PapayaWhip: Color.PapayaWhip,
+        LightGoldenrodYellow: Color.LightGoldenrodYellow,
+        LemonChiffon: Color.LemonChiffon,
+        LightYellow: Color.LightYellow,
+        // Brown Color.XYZ,lors
+        Maroon: Color.Maroon,
+        Brown: Color.Brown,
+        SaddleBrown: Color.SaddleBrown,
+        Sienna: Color.Sienna,
+        Chocolate: Color.Chocolate,
+        DarkGoldenrod: Color.DarkGoldenrod,
+        Peru: Color.Peru,
+        RosyBrown: Color.RosyBrown,
+        Goldenrod: Color.Goldenrod,
+        SandyBrown: Color.SandyBrown,
+        Tan: Color.Tan,
+        Burlywood: Color.Burlywood,
+        Wheat: Color.Wheat,
+        NavajoWhite: Color.NavajoWhite,
+        Bisque: Color.Bisque,
+        BlanchedAlmond: Color.BlanchedAlmond,
+        Cornsilk: Color.Cornsilk,
+        // Purple, violet, and magenta Color.XYZ,lors
+        Indigo: Color.Indigo,
+        Purple: Color.Purple,
+        DarkMagenta: Color.DarkMagenta,
+        DarkViolet: Color.DarkViolet,
+        DarkSlateBlue: Color.DarkSlateBlue,
+        BlueViolet: Color.BlueViolet,
+        DarkOrchid: Color.DarkOrchid,
+        Fuchsia: Color.Fuchsia,
+        Magenta: Color.Magenta,
+        SlateBlue: Color.SlateBlue,
+        MediumSlateBlue: Color.MediumSlateBlue,
+        MediumOrchid: Color.MediumOrchid,
+        MediumPurple: Color.MediumPurple,
+        Orchid: Color.Orchid,
+        Violet: Color.Violet,
+        Plum: Color.Plum,
+        Thistle: Color.Thistle,
+        Lavender: Color.Lavender,
+        // Blue Colors
+        MidnightBlue: Color.MidnightBlue,
+        Navy: Color.Navy,
+        DarkBlue: Color.DarkBlue,
+        MediumBlue: Color.MediumBlue,
+        Blue: Color.Blue,
+        RoyalBlue: Color.RoyalBlue,
+        SteelBlue: Color.SteelBlue,
+        DodgerBlue: Color.DodgerBlue,
+        DeepSkyBlue: Color.DeepSkyBlue,
+        CornflowerBlue: Color.CornflowerBlue,
+        SkyBlue: Color.SkyBlue,
+        LightSkyBlue: Color.LightSkyBlue,
+        LightSteelBlue: Color.LightSteelBlue,
+        LightBlue: Color.LightBlue,
+        PowderBlue: Color.PowderBlue,
+        // Coyan Colors
+        Teal: Color.Teal,
+        DarkCyan: Color.DarkCyan,
+        LightSeaGreen: Color.LightSeaGreen,
+        CadetBlue: Color.CadetBlue,
+        DarkTurquoise: Color.DarkTurquoise,
+        MediumTurquoise: Color.MediumTurquoise,
+        Turquoise: Color.Turquoise,
+        Aqua: Color.Aqua,
+        Cyan: Color.Cyan,
+        Aquamarine: Color.Aquamarine,
+        PaleTurquoise: Color.PaleTurquoise,
+        LightCyan: Color.LightCyan,
+        // Green Colors
+        DarkGreen: Color.DarkGreen,
+        Green: Color.Green,
+        DarkOliveGreen: Color.DarkOliveGreen,
+        ForestGreen: Color.ForestGreen,
+        SeaGreen: Color.SeaGreen,
+        Olive: Color.Olive,
+        OliveDrab: Color.OliveDrab,
+        MediumSeaGreen: Color.MediumSeaGreen,
+        LimeGreen: Color.LimeGreen,
+        Lime: Color.Lime,
+        SpringGreen: Color.SpringGreen,
+        MediumSpringGreen: Color.MediumSpringGreen,
+        DarkSeaGreen: Color.DarkSeaGreen,
+        MediumAquamarine: Color.MediumAquamarine,
+        YellowGreen: Color.YellowGreen,
+        LawnGreen: Color.LawnGreen,
+        Chartreuse: Color.Chartreuse,
+        LightGreen: Color.LightGreen,
+        GreenYellow: Color.GreenYellow,
+        PaleGreen: Color.PaleGreen,
+        // White Color.XYZ,lors
+        MistyRose: Color.MistyRose,
+        AntiqueWhite: Color.AntiqueWhite,
+        Linen: Color.Linen,
+        Beige: Color.Beige,
+        WhiteSmoke: Color.WhiteSmoke,
+        LavenderBlush: Color.LavenderBlush,
+        OldLace: Color.OldLace,
+        AliceBlue: Color.AliceBlue,
+        Seashell: Color.Seashell,
+        GhostWhite: Color.GhostWhite,
+        Honeydew: Color.Honeydew,
+        FloralWhite: Color.FloralWhite,
+        Azure: Color.Azure,
+        MintCream: Color.MintCream,
+        Snow: Color.Snow,
+        Ivory: Color.Ivory,
+        White: Color.White,
+        // Gray and black Color.XYZ,lors
+        Black: Color.Black,
+        DarkSlateGray: Color.DarkSlateGray,
+        DimGray: Color.DimGray,
+        SlateGray: Color.SlateGray,
+        Gray: Color.Gray,
+        LightSlateGray: Color.LightSlateGray,
+        DarkGray: Color.DarkGray,
+        Silver: Color.Silver,
+        LightGray: Color.LightGray,
+        Gainsboro: Color.Gainsboro
+    };
+    return Color;
+}()); // END class
+exports.Color = Color;
+//# sourceMappingURL=Color.js.map