@amcharts/amcharts5 5.2.49 → 5.3.0

package/.internal/core/util/Utils.js

@@ -1,4 +1,3 @@
-import { __extends, __read, __spreadArray } from "tslib";
 import * as $type from "./Type";
 import * as $array from "./Array";
 import * as $object from "./Object";
@@ -20,13 +19,13 @@ export function ready(f) {
         f();
     }
     else {
-        var listener_1 = function () {
+        const listener = () => {
             if (document.readyState !== "loading") {
-                document.removeEventListener("readystatechange", listener_1);
+                document.removeEventListener("readystatechange", listener);
                 f();
             }
         };
-        document.addEventListener("readystatechange", listener_1);
+        document.addEventListener("readystatechange", listener);
     }
 }
 /**
@@ -51,7 +50,7 @@ export function addEventListener(dom, type, listener, options) {
     //@todo proper type check for options: EventListenerOptions | boolean (TS for some reason gives error on passive parameter)
     //console.log(type, dom);
     dom.addEventListener(type, listener, options || false);
-    return new Disposer(function () {
+    return new Disposer(() => {
         dom.removeEventListener(type, listener, options || false);
     });
 }
@@ -63,7 +62,7 @@ export function addEventListener(dom, type, listener, options) {
  */
 export function onZoom(listener) {
     // TODO use matchMedia instead ?
-    return addEventListener(window, "resize", function (_ev) {
+    return addEventListener(window, "resize", (_ev) => {
         listener();
     });
 }
@@ -90,7 +89,7 @@ export function supports(cap) {
  * @ignore
  */
 export function getPointerId(event) {
-    var id = event.pointerId || 0;
+    let id = event.pointerId || 0;
     //console.log(event);
     return id;
 }
@@ -105,7 +104,7 @@ export function blur() {
             document.activeElement.blur();
         }
         else {
-            var input = document.createElement("button");
+            let input = document.createElement("button");
             input.style.position = "fixed";
             input.style.top = "0px";
             input.style.left = "-10000px";
@@ -206,7 +205,7 @@ export function getStyle(dom, property) {
  * @return Contains?
  */
 export function contains(a, b) {
-    var cursor = b;
+    let cursor = b;
     while (true) {
         if (a === cursor) {
             return true;
@@ -256,7 +255,7 @@ export function setInteractive(target, interactive) {
  * @return Root
  */
 export function getShadowRoot(a) {
-    var cursor = a;
+    let cursor = a;
     while (true) {
         if (cursor.parentNode === null) {
             // TODO better ShadowRoot detection
@@ -278,14 +277,13 @@ export function getShadowRoot(a) {
  * @ignore Exclude from docs
  * @todo Description
  */
-var rootStylesheet;
+let rootStylesheet;
 /**
  * @ignore Exclude from docs
  */
-function createStylesheet(element, text, nonce) {
-    if (nonce === void 0) { nonce = ""; }
+function createStylesheet(element, text, nonce = "") {
     // TODO use createElementNS ?
-    var e = document.createElement("style");
+    const e = document.createElement("style");
     e.type = "text/css";
     if (nonce != "") {
         e.setAttribute("nonce", nonce);
@@ -306,12 +304,11 @@ function createStylesheet(element, text, nonce) {
  * @todo Description
  * @return [description]
  */
-function getStylesheet(element, nonce) {
-    if (nonce === void 0) { nonce = ""; }
+function getStylesheet(element, nonce = "") {
     if (element === null) {
         if (rootStylesheet == null) {
             // TODO use createElementNS ?
-            var e = document.createElement("style");
+            const e = document.createElement("style");
             e.type = "text/css";
             if (nonce != "") {
                 e.setAttribute("nonce", nonce);
@@ -323,7 +320,7 @@ function getStylesheet(element, nonce) {
     }
     else {
         // TODO use createElementNS ?
-        var e = document.createElement("style");
+        const e = document.createElement("style");
         e.type = "text/css";
         if (nonce != "") {
             e.setAttribute("nonce", nonce);
@@ -341,7 +338,7 @@ function getStylesheet(element, nonce) {
  * @return [description]
  */
 function appendStylesheet(root, selector) {
-    var index = root.cssRules.length;
+    const index = root.cssRules.length;
     root.insertRule(selector + "{}", index);
     return root.cssRules[index];
 }
@@ -350,18 +347,16 @@ function appendStylesheet(root, selector) {
  *
  * Can be used to dynamically add CSS to the document.
  */
-var StyleRule = /** @class */ (function (_super) {
-    __extends(StyleRule, _super);
+export class StyleRule extends DisposerClass {
     /**
      * Constructor.
      *
      * @param selector  CSS selector
      * @param styles    An object of style attribute - value pairs
      */
-    function StyleRule(element, selector, styles, nonce) {
-        if (nonce === void 0) { nonce = ""; }
-        var _this = _super.call(this) || this;
-        Object.defineProperty(_this, "_root", {
+    constructor(element, selector, styles, nonce = "") {
+        super();
+        Object.defineProperty(this, "_root", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -370,140 +365,108 @@ var StyleRule = /** @class */ (function (_super) {
         /**
          * CSS rule.
          */
-        Object.defineProperty(_this, "_rule", {
+        Object.defineProperty(this, "_rule", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        _this._root = getStylesheet(element, nonce);
+        this._root = getStylesheet(element, nonce);
         try {
-            _this._rule = appendStylesheet(_this._root, selector);
-            $object.each(styles, function (key, value) {
-                _this.setStyle(key, value);
+            this._rule = appendStylesheet(this._root, selector);
+            $object.each(styles, (key, value) => {
+                this.setStyle(key, value);
             });
         }
         catch (err) {
             // Create an empty rule on failed selectors
-            _this._rule = new CSSStyleRule();
+            this._rule = new CSSStyleRule();
         }
-        return _this;
     }
-    Object.defineProperty(StyleRule.prototype, "selector", {
-        /**
-         * @return CSS selector
-         */
-        get: function () {
-            return this._rule.selectorText;
-        },
-        /**
-         * A CSS selector text.
-         *
-         * E.g.: `.myClass p`
-         *
-         * @param selector  CSS selector
-         */
-        set: function (selector) {
-            this._rule.selectorText = selector;
-        },
-        enumerable: false,
-        configurable: true
-    });
+    /**
+     * A CSS selector text.
+     *
+     * E.g.: `.myClass p`
+     *
+     * @param selector  CSS selector
+     */
+    set selector(selector) {
+        this._rule.selectorText = selector;
+    }
+    /**
+     * @return CSS selector
+     */
+    get selector() {
+        return this._rule.selectorText;
+    }
     // TODO test this
-    Object.defineProperty(StyleRule.prototype, "_dispose", {
-        enumerable: false,
-        configurable: true,
-        writable: true,
-        value: function () {
-            // TODO a bit hacky
-            var index = $array.indexOf(this._root.cssRules, this._rule);
-            if (index === -1) {
-                throw new Error("Could not dispose StyleRule");
-            }
-            else {
-                // TODO if it's empty remove it from the DOM ?
-                this._root.deleteRule(index);
-            }
+    _dispose() {
+        // TODO a bit hacky
+        const index = $array.indexOf(this._root.cssRules, this._rule);
+        if (index === -1) {
+            throw new Error("Could not dispose StyleRule");
         }
-    });
+        else {
+            // TODO if it's empty remove it from the DOM ?
+            this._root.deleteRule(index);
+        }
+    }
     /**
      * Sets the same style properties with browser-specific prefixes.
      *
      * @param name   Attribute name
      * @param value  Attribute value
      */
-    Object.defineProperty(StyleRule.prototype, "_setVendorPrefixName", {
-        enumerable: false,
-        configurable: true,
-        writable: true,
-        value: function (name, value) {
-            var style = this._rule.style;
-            style.setProperty("-webkit-" + name, value, "");
-            style.setProperty("-moz-" + name, value, "");
-            style.setProperty("-ms-" + name, value, "");
-            style.setProperty("-o-" + name, value, "");
-            style.setProperty(name, value, "");
-        }
-    });
+    _setVendorPrefixName(name, value) {
+        const style = this._rule.style;
+        style.setProperty("-webkit-" + name, value, "");
+        style.setProperty("-moz-" + name, value, "");
+        style.setProperty("-ms-" + name, value, "");
+        style.setProperty("-o-" + name, value, "");
+        style.setProperty(name, value, "");
+    }
     /**
      * Sets a value for specific style attribute.
      *
      * @param name   Attribute
      * @param value  Value
      */
-    Object.defineProperty(StyleRule.prototype, "setStyle", {
-        enumerable: false,
-        configurable: true,
-        writable: true,
-        value: function (name, value) {
-            if (name === "transition") {
-                this._setVendorPrefixName(name, value);
-            }
-            else {
-                this._rule.style.setProperty(name, value, "");
-            }
+    setStyle(name, value) {
+        if (name === "transition") {
+            this._setVendorPrefixName(name, value);
         }
-    });
-    return StyleRule;
-}(DisposerClass));
-export { StyleRule };
+        else {
+            this._rule.style.setProperty(name, value, "");
+        }
+    }
+}
 /**
  * Defines a class for an entire CSS style sheet.
  *
  * Can be used to dynamically add CSS to the document.
  */
-var StyleSheet = /** @class */ (function (_super) {
-    __extends(StyleSheet, _super);
+export class StyleSheet extends DisposerClass {
     /**
      * Constructor.
      *
      * @param text  CSS stylesheet
      */
-    function StyleSheet(element, text, nonce) {
-        if (nonce === void 0) { nonce = ""; }
-        var _this = _super.call(this) || this;
-        Object.defineProperty(_this, "_element", {
+    constructor(element, text, nonce = "") {
+        super();
+        Object.defineProperty(this, "_element", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        _this._element = createStylesheet(element, text, nonce);
-        return _this;
-    }
-    Object.defineProperty(StyleSheet.prototype, "_dispose", {
-        enumerable: false,
-        configurable: true,
-        writable: true,
-        value: function () {
-            if (this._element.parentNode) {
-                this._element.parentNode.removeChild(this._element);
-            }
+        this._element = createStylesheet(element, text, nonce);
+    }
+    _dispose() {
+        if (this._element.parentNode) {
+            this._element.parentNode.removeChild(this._element);
         }
-    });
-    return StyleSheet;
-}(DisposerClass));
-export { StyleSheet };
+    }
+}
 /**
  * Adds a class name to an HTML or SVG element.
  *
@@ -516,15 +479,15 @@ export function addClass(element, className) {
         return;
     }
     if (element.classList) {
-        var classes = className.split(" ");
-        $array.each(classes, function (name) {
+        const classes = className.split(" ");
+        $array.each(classes, (name) => {
             element.classList.add(name);
         });
     }
     else {
-        var currentClassName = element.getAttribute("class");
+        let currentClassName = element.getAttribute("class");
         if (currentClassName) {
-            element.setAttribute("class", currentClassName.split(" ").filter(function (item) {
+            element.setAttribute("class", currentClassName.split(" ").filter((item) => {
                 return item !== className;
             }).join(" ") + " " + className);
         }
@@ -548,9 +511,9 @@ export function removeClass(element, className) {
         element.classList.remove(className);
     }
     else {
-        var currentClassName = element.getAttribute("class");
+        let currentClassName = element.getAttribute("class");
         if (currentClassName) {
-            element.setAttribute("class", currentClassName.split(" ").filter(function (item) {
+            element.setAttribute("class", currentClassName.split(" ").filter((item) => {
                 return item !== className;
             }).join(" "));
         }
@@ -631,7 +594,7 @@ export function relativeToValue(percent, full) {
  * @return Number of decimals
  */
 export function decimalPlaces(number) {
-    var match = ('' + number).match(/(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/);
+    let match = ('' + number).match(/(?:\.(\d+))?(?:[eE]([+-]?\d+))?$/);
     if (!match) {
         return 0;
     }
@@ -651,9 +614,7 @@ export function decimalPlaces(number) {
  * @param char   A character to use for padding
  * @return Padded value as string
  */
-export function padString(value, len, char) {
-    if (len === void 0) { len = 0; }
-    if (char === void 0) { char = "0"; }
+export function padString(value, len = 0, char = "0") {
     if (typeof value !== "string") {
         value = value.toString();
     }
@@ -687,7 +648,7 @@ export function getFormat(format) {
     // Trim
     format = format.trim();
     // Check for any explicit format hints (i.e. /Date)
-    var hints = format.match(/\/(date|number|duration)$/);
+    let hints = format.match(/\/(date|number|duration)$/);
     if (hints) {
         return hints[1];
     }
@@ -750,6 +711,23 @@ export function plainText(text) {
 export function escapeForRgex(value) {
     return value.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
 }
+/**
+ * Adds space before each uppercase letter.
+ *
+ * @param   str Input string
+ * @return      Output string
+ */
+export function addSpacing(str) {
+    let result = "";
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charAt(i);
+        if (char.toUpperCase() == char && i != 0) {
+            result += " ";
+        }
+        result += char;
+    }
+    return result;
+}
 /**
  * ============================================================================
  * DATE-RELATED FUNCTIONS
@@ -764,13 +742,12 @@ export function escapeForRgex(value) {
  * @return Year day
  * @todo Account for UTC
  */
-export function getYearDay(date, utc) {
-    if (utc === void 0) { utc = false; }
+export function getYearDay(date, utc = false) {
     // TODO: utc needed?
     utc;
-    var start = new Date(date.getFullYear(), 0, 0);
-    var diff = (date.getTime() - start.getTime()) + ((start.getTimezoneOffset() - date.getTimezoneOffset()) * 60 * 1000);
-    var oneDay = 1000 * 60 * 60 * 24;
+    const start = new Date(date.getFullYear(), 0, 0);
+    const diff = (date.getTime() - start.getTime()) + ((start.getTimezoneOffset() - date.getTimezoneOffset()) * 60 * 1000);
+    const oneDay = 1000 * 60 * 60 * 24;
     return Math.floor(diff / oneDay);
 }
 /**
@@ -781,14 +758,29 @@ export function getYearDay(date, utc) {
  * @return Week number
  * @todo Account for UTC
  */
-export function getWeek(date, _utc) {
-    if (_utc === void 0) { _utc = false; }
-    var d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
-    var day = d.getUTCDay() || 7;
+export function getWeek(date, _utc = false) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    const day = d.getUTCDay() || 7;
     d.setUTCDate(d.getUTCDate() + 4 - day);
-    var firstDay = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    const firstDay = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
     return Math.ceil((((d.getTime() - firstDay.getTime()) / 86400000) + 1) / 7);
 }
+/**
+ * Returns a "week year" of the given date.
+ *
+ * @param date  Date
+ * @param utc   Assume UTC dates?
+ * @return Year of week
+ * @since 5.3.0
+ * @todo Account for UTC
+ */
+export function getWeekYear(date, _utc = false) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    const day = d.getUTCDay() || 7;
+    d.setUTCDate(d.getUTCDate() + 4 - day);
+    const firstDay = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    return firstDay.getFullYear();
+}
 /**
  * Returns a week number in the month.
  *
@@ -796,10 +788,9 @@ export function getWeek(date, _utc) {
  * @param utc   Assume UTC dates?
  * @return Week number in month
  */
-export function getMonthWeek(date, utc) {
-    if (utc === void 0) { utc = false; }
-    var firstWeek = getWeek(new Date(date.getFullYear(), date.getMonth(), 1), utc);
-    var currentWeek = getWeek(date, utc);
+export function getMonthWeek(date, utc = false) {
+    const firstWeek = getWeek(new Date(date.getFullYear(), date.getMonth(), 1), utc);
+    let currentWeek = getWeek(date, utc);
     if (currentWeek == 1) {
         currentWeek = 53;
     }
@@ -814,14 +805,12 @@ export function getMonthWeek(date, utc) {
  * @param utc      Assume UTC dates
  * @return Day in a year
  */
-export function getDayFromWeek(week, year, weekday, utc) {
-    if (weekday === void 0) { weekday = 1; }
-    if (utc === void 0) { utc = false; }
-    var date = new Date(year, 0, 4, 0, 0, 0, 0);
+export function getDayFromWeek(week, year, weekday = 1, utc = false) {
+    let date = new Date(year, 0, 4, 0, 0, 0, 0);
     if (utc) {
         date.setUTCFullYear(year);
     }
-    var day = week * 7 + weekday - ((date.getDay() || 7) + 3);
+    let day = week * 7 + weekday - ((date.getDay() || 7) + 3);
     return day;
 }
 /**
@@ -848,15 +837,12 @@ export function get12Hours(hours, base) {
  * @param utc      Assume UTC dates
  * @return Time zone name
  */
-export function getTimeZone(date, long, savings, utc) {
-    if (long === void 0) { long = false; }
-    if (savings === void 0) { savings = false; }
-    if (utc === void 0) { utc = false; }
+export function getTimeZone(date, long = false, savings = false, utc = false) {
     if (utc) {
         return long ? "Coordinated Universal Time" : "UTC";
     }
-    var wotz = date.toLocaleString("UTC");
-    var wtz = date.toLocaleString("UTC", { timeZoneName: long ? "long" : "short" }).substr(wotz.length);
+    let wotz = date.toLocaleString("UTC");
+    let wtz = date.toLocaleString("UTC", { timeZoneName: long ? "long" : "short" }).substr(wotz.length);
     //wtz = wtz.replace(/[+-]+[0-9]+$/, "");
     if (savings === false) {
         wtz = wtz.replace(/ (standard|daylight|summer|winter) /i, " ");
@@ -864,9 +850,9 @@ export function getTimeZone(date, long, savings, utc) {
     return wtz;
 }
 export function getTimezoneOffset(timezone) {
-    var date = new Date(Date.UTC(2012, 0, 1, 0, 0, 0, 0));
-    var utcDate = new Date(date.toLocaleString('en-US', { timeZone: 'UTC' }));
-    var tzDate = new Date(date.toLocaleString('en-US', { timeZone: timezone }));
+    const date = new Date(Date.UTC(2012, 0, 1, 0, 0, 0, 0));
+    const utcDate = new Date(date.toLocaleString('en-US', { timeZone: 'UTC' }));
+    const tzDate = new Date(date.toLocaleString('en-US', { timeZone: timezone }));
     return (tzDate.getTime() - utcDate.getTime()) / 6e4 * -1;
 }
 export function capitalizeFirst(text) {
@@ -894,15 +880,15 @@ export function capitalizeFirst(text) {
  * @return The RGB representation
  */
 export function hslToRgb(color) {
-    var r, g, b;
-    var h = color.h;
-    var s = color.s;
-    var l = color.l;
+    let r, g, b;
+    let h = color.h;
+    let s = color.s;
+    let l = color.l;
     if (s == 0) {
         r = g = b = l; // achromatic
     }
     else {
-        var hue2rgb = function hue2rgb(p, q, t) {
+        let hue2rgb = function hue2rgb(p, q, t) {
             if (t < 0) {
                 t += 1;
             }
@@ -920,8 +906,8 @@ export function hslToRgb(color) {
             }
             return p;
         };
-        var q = l < 0.5 ? l * (1 + s) : l + s - l * s;
-        var p = 2 * l - q;
+        let q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+        let p = 2 * l - q;
         r = hue2rgb(p, q, h + 1 / 3);
         g = hue2rgb(p, q, h);
         b = hue2rgb(p, q, h - 1 / 3);
@@ -948,19 +934,19 @@ export function hslToRgb(color) {
  * @return The HSL representation
  */
 export function rgbToHsl(color) {
-    var r = color.r / 255;
-    var g = color.g / 255;
-    var b = color.b / 255;
-    var max = Math.max(r, g, b);
-    var min = Math.min(r, g, b);
-    var h = 0;
-    var s = 0;
-    var l = (max + min) / 2;
+    let r = color.r / 255;
+    let g = color.g / 255;
+    let b = color.b / 255;
+    let max = Math.max(r, g, b);
+    let min = Math.min(r, g, b);
+    let h = 0;
+    let s = 0;
+    let l = (max + min) / 2;
     if (max === min) {
         h = s = 0; // achromatic
     }
     else {
-        var d = max - min;
+        let d = max - min;
         s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
         switch (max) {
             case r:
@@ -1013,7 +999,7 @@ export function lighten(rgb, percent) {
  * @return Step
  */
 export function getLightnessStep(value, percent) {
-    var base = percent > 0 ? 255 - value : value;
+    let base = percent > 0 ? 255 - value : value;
     return Math.round(base * percent);
 }
 /**
@@ -1026,9 +1012,9 @@ export function getLightnessStep(value, percent) {
  */
 export function brighten(rgb, percent) {
     if (rgb) {
-        var base = Math.min(Math.max(rgb.r, rgb.g, rgb.b), 230);
+        let base = Math.min(Math.max(rgb.r, rgb.g, rgb.b), 230);
         //let base = Math.max(rgb.r, rgb.g, rgb.b);
-        var step = getLightnessStep(base, percent);
+        let step = getLightnessStep(base, percent);
         return {
             r: Math.max(0, Math.min(255, Math.round(rgb.r + step))),
             g: Math.max(0, Math.min(255, Math.round(rgb.g + step))),
@@ -1051,7 +1037,7 @@ export function brighten(rgb, percent) {
  * @return Step
  */
 export function getBrightnessStep(_value, percent) {
-    var base = 255; //percent > 0 ? 255 - value : value;
+    let base = 255; //percent > 0 ? 255 - value : value;
     return Math.round(base * percent);
 }
 /**
@@ -1082,15 +1068,13 @@ export function saturate(rgb, saturation) {
     if (rgb === undefined || saturation == 1) {
         return rgb;
     }
-    var hsl = rgbToHsl(rgb);
+    let hsl = rgbToHsl(rgb);
     hsl.s = saturation;
     return hslToRgb(hsl);
 }
-export function alternativeColor(color, lightAlternative, darkAlternative) {
-    if (lightAlternative === void 0) { lightAlternative = { r: 255, g: 255, b: 255 }; }
-    if (darkAlternative === void 0) { darkAlternative = { r: 255, g: 255, b: 255 }; }
-    var light = lightAlternative;
-    var dark = darkAlternative;
+export function alternativeColor(color, lightAlternative = { r: 255, g: 255, b: 255 }, darkAlternative = { r: 255, g: 255, b: 255 }) {
+    let light = lightAlternative;
+    let dark = darkAlternative;
     if (isLight(darkAlternative)) {
         light = darkAlternative;
         dark = lightAlternative;
@@ -1128,7 +1112,7 @@ export function mergeTags(tags1, tags2) {
     if (!tags1) {
         tags1 = [];
     }
-    return __spreadArray(__spreadArray([], __read(tags1), false), __read(tags2), false).filter(function (value, index, self) {
+    return [...tags1, ...tags2].filter((value, index, self) => {
         return self.indexOf(value) === index;
     });
 }