highcharts 9.2.1 → 9.3.2

package/es-modules/Accessibility/Utils/ChartUtilities.js

@@ -10,15 +10,44 @@
  *
  * */
 'use strict';
-import HTMLUtilities from './HTMLUtilities.js';
-var stripHTMLTags = HTMLUtilities.stripHTMLTagsFromString;
 import H from '../../Core/Globals.js';
 var doc = H.doc;
+import HU from './HTMLUtilities.js';
+var stripHTMLTags = HU.stripHTMLTagsFromString;
 import U from '../../Core/Utilities.js';
 var defined = U.defined, find = U.find, fireEvent = U.fireEvent;
+/* *
+ *
+ *  Functions
+ *
+ * */
 /* eslint-disable valid-jsdoc */
 /**
- * @return {string}
+ * Fire an event on an element that is either wrapped by Highcharts,
+ * or a DOM element.
+ * @private
+ */
+function fireEventOnWrappedOrUnwrappedElement(el, eventObject) {
+    var type = eventObject.type;
+    var hcEvents = el.hcEvents;
+    if (doc.createEvent &&
+        (el.dispatchEvent || el.fireEvent)) {
+        if (el.dispatchEvent) {
+            el.dispatchEvent(eventObject);
+        }
+        else {
+            el.fireEvent(type, eventObject);
+        }
+    }
+    else if (hcEvents && hcEvents[type]) {
+        fireEvent(el, type, eventObject);
+    }
+    else if (el.element) {
+        fireEventOnWrappedOrUnwrappedElement(el.element, eventObject);
+    }
+}
+/**
+ * @private
  */
 function getChartTitle(chart) {
     return stripHTMLTags(chart.options.title.text ||
@@ -26,8 +55,7 @@ function getChartTitle(chart) {
 }
 /**
  * Return string with the axis name/title.
- * @param {Highcharts.Axis} axis
- * @return {string}
+ * @private
  */
 function getAxisDescription(axis) {
     return axis && (axis.userOptions && axis.userOptions.accessibility &&
@@ -40,8 +68,11 @@ function getAxisDescription(axis) {
 }
 /**
  * Return string with text description of the axis range.
- * @param {Highcharts.Axis} axis The axis to get range desc of.
- * @return {string} A string with the range description for the axis.
+ * @private
+ * @param {Highcharts.Axis} axis
+ * The axis to get range desc of.
+ * @return {string}
+ * A string with the range description for the axis.
  */
 function getAxisRangeDescription(axis) {
     var axisOptions = axis.options || {};
@@ -64,8 +95,7 @@ function getAxisRangeDescription(axis) {
 }
 /**
  * Describe the range of a category axis.
- * @param {Highcharts.Axis} axis
- * @return {string}
+ * @private
  */
 function getCategoryAxisRangeDesc(axis) {
     var chart = axis.chart;
@@ -80,12 +110,10 @@ function getCategoryAxisRangeDesc(axis) {
 }
 /**
  * Describe the length of the time window shown on an axis.
- * @param {Highcharts.Axis} axis
- * @return {string}
+ * @private
  */
 function getAxisTimeLengthDesc(axis) {
-    var chart = axis.chart;
-    var range = {};
+    var chart = axis.chart, range = {};
     var rangeUnit = 'Seconds';
     range.Seconds = ((axis.max || 0) - (axis.min || 0)) / 1000;
     range.Minutes = range.Seconds / 60;
@@ -108,16 +136,13 @@ function getAxisTimeLengthDesc(axis) {
 }
 /**
  * Describe an axis from-to range.
- * @param {Highcharts.Axis} axis
- * @return {string}
+ * @private
  */
 function getAxisFromToDescription(axis) {
-    var chart = axis.chart;
-    var dateRangeFormat = (chart.options &&
-        chart.options.accessibility &&
-        chart.options.accessibility.screenReaderSection.axisRangeDateFormat ||
-        '');
-    var format = function (axisKey) {
+    var chart = axis.chart, options = chart.options, dateRangeFormat = (options &&
+        options.accessibility &&
+        options.accessibility.screenReaderSection.axisRangeDateFormat ||
+        ''), format = function (axisKey) {
         return axis.dateTime ? chart.time.dateFormat(dateRangeFormat, axis[axisKey]) : axis[axisKey];
     };
     return chart.langFormat('accessibility.axis.rangeFromTo', {
@@ -162,8 +187,6 @@ function getSeriesA11yElement(series) {
  * Remove aria-hidden from element. Also unhides parents of the element, and
  * hides siblings that are not explicitly unhidden.
  * @private
- * @param {Highcharts.Chart} chart
- * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} element
  */
 function unhideChartElementFromAT(chart, element) {
     element.setAttribute('aria-hidden', false);
@@ -185,9 +208,6 @@ function unhideChartElementFromAT(chart, element) {
 /**
  * Hide series from screen readers.
  * @private
- * @param {Highcharts.Series} series
- * The series to hide
- * @return {void}
  */
 function hideSeriesFromAT(series) {
     var seriesEl = getSeriesA11yElement(series);
@@ -198,9 +218,6 @@ function hideSeriesFromAT(series) {
 /**
  * Get series objects by series name.
  * @private
- * @param {Highcharts.Chart} chart
- * @param {string} name
- * @return {Array<Highcharts.Series>}
  */
 function getSeriesFromName(chart, name) {
     if (!name) {
@@ -213,10 +230,6 @@ function getSeriesFromName(chart, name) {
 /**
  * Get point in a series from x/y values.
  * @private
- * @param {Array<Highcharts.Series>} series
- * @param {number} x
- * @param {number} y
- * @return {Highcharts.Point|undefined}
  */
 function getPointFromXY(series, x, y) {
     var i = series.length, res;
@@ -232,31 +245,22 @@ function getPointFromXY(series, x, y) {
 /**
  * Get relative position of point on an x/y axis from 0 to 1.
  * @private
- * @param {Highcharts.Axis} axis
- * @param {Highcharts.Point} point
- * @return {number}
  */
 function getRelativePointAxisPosition(axis, point) {
     if (!defined(axis.dataMin) || !defined(axis.dataMax)) {
         return 0;
     }
-    var axisStart = axis.toPixels(axis.dataMin);
-    var axisEnd = axis.toPixels(axis.dataMax);
+    var axisStart = axis.toPixels(axis.dataMin), axisEnd = axis.toPixels(axis.dataMax), 
     // We have to use pixel position because of axis breaks, log axis etc.
-    var positionProp = axis.coll === 'xAxis' ? 'x' : 'y';
-    var pointPos = axis.toPixels(point[positionProp] || 0);
+    positionProp = axis.coll === 'xAxis' ? 'x' : 'y', pointPos = axis.toPixels(point[positionProp] || 0);
     return (pointPos - axisStart) / (axisEnd - axisStart);
 }
 /**
  * Get relative position of point on an x/y axis from 0 to 1.
  * @private
- * @param {Highcharts.Point} point
  */
 function scrollToPoint(point) {
-    var xAxis = point.series.xAxis;
-    var yAxis = point.series.yAxis;
-    var axis = (xAxis && xAxis.scrollbar ? xAxis : yAxis);
-    var scrollbar = (axis && axis.scrollbar);
+    var xAxis = point.series.xAxis, yAxis = point.series.yAxis, axis = (xAxis && xAxis.scrollbar ? xAxis : yAxis), scrollbar = (axis && axis.scrollbar);
     if (scrollbar && defined(scrollbar.to) && defined(scrollbar.from)) {
         var range = scrollbar.to - scrollbar.from;
         var pos = getRelativePointAxisPosition(axis, point);
@@ -269,7 +273,13 @@ function scrollToPoint(point) {
         });
     }
 }
+/* *
+ *
+ *  Default Export
+ *
+ * */
 var ChartUtilities = {
+    fireEventOnWrappedOrUnwrappedElement: fireEventOnWrappedOrUnwrappedElement,
     getChartTitle: getChartTitle,
     getAxisDescription: getAxisDescription,
     getAxisRangeDescription: getAxisRangeDescription,

package/es-modules/Accessibility/Utils/DOMElementProvider.js

@@ -13,38 +13,50 @@
 'use strict';
 import H from '../../Core/Globals.js';
 var doc = H.doc;
-import HTMLUtilities from './HTMLUtilities.js';
-var removeElement = HTMLUtilities.removeElement;
-import U from '../../Core/Utilities.js';
-var extend = U.extend;
-/* eslint-disable no-invalid-this, valid-jsdoc */
+import HU from './HTMLUtilities.js';
+var removeElement = HU.removeElement;
+/* *
+ *
+ *  Class
+ *
+ * */
 /**
  * @private
- * @class
  */
-var DOMElementProvider = function () {
-    this.elements = [];
-};
-extend(DOMElementProvider.prototype, {
+var DOMElementProvider = /** @class */ (function () {
+    /* *
+     *
+     *  Constructor
+     *
+     * */
+    function DOMElementProvider() {
+        this.elements = [];
+    }
     /**
      * Create an element and keep track of it for later removal.
      * Same args as document.createElement
      * @private
      */
-    createElement: function () {
+    DOMElementProvider.prototype.createElement = function () {
         var el = doc.createElement.apply(doc, arguments);
         this.elements.push(el);
         return el;
-    },
+    };
     /**
      * Destroy all created elements, removing them from the DOM.
      * @private
      */
-    destroyCreatedElements: function () {
+    DOMElementProvider.prototype.destroyCreatedElements = function () {
         this.elements.forEach(function (element) {
             removeElement(element);
         });
         this.elements = [];
-    }
-});
+    };
+    return DOMElementProvider;
+}());
+/* *
+ *
+ *  Default Export
+ *
+ * */
 export default DOMElementProvider;

package/es-modules/Accessibility/Utils/EventProvider.js

@@ -12,37 +12,47 @@
 'use strict';
 import H from '../../Core/Globals.js';
 import U from '../../Core/Utilities.js';
-var addEvent = U.addEvent, extend = U.extend;
-/* eslint-disable no-invalid-this, valid-jsdoc */
+var addEvent = U.addEvent;
+/* *
+ *
+ *  Class
+ *
+ * */
 /**
  * @private
- * @class
  */
-var EventProvider = function () {
-    this.eventRemovers = [];
-};
-extend(EventProvider.prototype, {
+var EventProvider = /** @class */ (function () {
+    /* *
+     *
+     *  Constructor
+     *
+     * */
+    function EventProvider() {
+        this.eventRemovers = [];
+    }
     /**
      * Add an event to an element and keep track of it for later removal.
      * Same args as Highcharts.addEvent.
      * @private
-     * @return {Function}
      */
-    addEvent: function () {
+    EventProvider.prototype.addEvent = function () {
         var remover = addEvent.apply(H, arguments);
         this.eventRemovers.push(remover);
         return remover;
-    },
+    };
     /**
      * Remove all added events.
      * @private
-     * @return {void}
      */
-    removeAddedEvents: function () {
-        this.eventRemovers.forEach(function (remover) {
-            remover();
-        });
+    EventProvider.prototype.removeAddedEvents = function () {
+        this.eventRemovers.forEach(function (remover) { return remover(); });
         this.eventRemovers = [];
-    }
-});
+    };
+    return EventProvider;
+}());
+/* *
+ *
+ *  Default Export
+ *
+ * */
 export default EventProvider;

package/es-modules/Accessibility/Utils/HTMLUtilities.js

@@ -9,10 +9,16 @@
  *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
+'use strict';
 import H from '../../Core/Globals.js';
 var doc = H.doc, win = H.win;
 import U from '../../Core/Utilities.js';
-var merge = U.merge;
+var css = U.css;
+/* *
+ *
+ *  Functions
+ *
+ * */
 /* eslint-disable valid-jsdoc */
 /**
  * @private
@@ -28,13 +34,87 @@ function addClass(el, className) {
         // Note: Dumb check for class name exists, should be fine for practical
         // use cases, but will return false positives if the element has a class
         // that contains the className.
-        el.className += className;
+        el.className += ' ' + className;
+    }
+}
+/**
+ * @private
+ * @param {Highcharts.HTMLDOMElement} el
+ * @param {string} className
+ * @return {void}
+ */
+function removeClass(el, className) {
+    if (el.classList) {
+        el.classList.remove(className);
+    }
+    else {
+        // Note: Dumb logic that will break if the element has a class name that
+        // consists of className plus something else.
+        el.className = el.className.replace(new RegExp(className, 'g'), '');
+    }
+}
+/**
+ * Utility function to clone a mouse event for re-dispatching.
+ * @private
+ */
+function cloneMouseEvent(e) {
+    if (typeof win.MouseEvent === 'function') {
+        return new win.MouseEvent(e.type, e);
+    }
+    // No MouseEvent support, try using initMouseEvent
+    if (doc.createEvent) {
+        var evt = doc.createEvent('MouseEvent');
+        if (evt.initMouseEvent) {
+            evt.initMouseEvent(e.type, e.bubbles, // #10561, #12161
+            e.cancelable, e.view || win, e.detail, e.screenX, e.screenY, e.clientX, e.clientY, e.ctrlKey, e.altKey, e.shiftKey, e.metaKey, e.button, e.relatedTarget);
+            return evt;
+        }
+    }
+    return getFakeMouseEvent(e.type);
+}
+/**
+ * Utility function to clone a touch event for re-dispatching.
+ * @private
+ */
+function cloneTouchEvent(e) {
+    var touchListToTouchArray = function (l) {
+        var touchArray = [];
+        for (var i = 0; i < l.length; ++i) {
+            var item = l.item(i);
+            if (item) {
+                touchArray.push(item);
+            }
+        }
+        return touchArray;
+    };
+    if (typeof win.TouchEvent === 'function') {
+        var newEvent = new win.TouchEvent(e.type, {
+            touches: touchListToTouchArray(e.touches),
+            targetTouches: touchListToTouchArray(e.targetTouches),
+            changedTouches: touchListToTouchArray(e.changedTouches),
+            ctrlKey: e.ctrlKey,
+            shiftKey: e.shiftKey,
+            altKey: e.altKey,
+            metaKey: e.metaKey,
+            bubbles: e.bubbles,
+            cancelable: e.cancelable,
+            composed: e.composed,
+            detail: e.detail,
+            view: e.view
+        });
+        if (e.defaultPrevented) {
+            newEvent.preventDefault();
+        }
+        return newEvent;
     }
+    var fakeEvt = cloneMouseEvent(e);
+    fakeEvt.touches = e.touches;
+    fakeEvt.changedTouches = e.changedTouches;
+    fakeEvt.targetTouches = e.targetTouches;
+    return fakeEvt;
 }
 /**
  * @private
- * @param {string} str
- * @return {string}
  */
 function escapeStringForHTML(str) {
     return str
@@ -47,22 +127,32 @@ function escapeStringForHTML(str) {
 }
 /**
  * Get an element by ID
- * @param {string} id
  * @private
- * @return {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement|null}
  */
 function getElement(id) {
     return doc.getElementById(id);
 }
 /**
  * Get a fake mouse event of a given type
- * @param {string} type
  * @private
- * @return {global.MouseEvent}
  */
-function getFakeMouseEvent(type) {
+function getFakeMouseEvent(type, position) {
+    var pos = position || {
+        x: 0,
+        y: 0
+    };
     if (typeof win.MouseEvent === 'function') {
-        return new win.MouseEvent(type);
+        return new win.MouseEvent(type, {
+            bubbles: true,
+            cancelable: true,
+            composed: true,
+            view: win,
+            detail: type === 'click' ? 1 : 0,
+            screenX: pos.x,
+            screenY: pos.y,
+            clientX: pos.x,
+            clientY: pos.y
+        });
     }
     // No MouseEvent support, try using initMouseEvent
     if (doc.createEvent) {
@@ -73,7 +163,7 @@ function getFakeMouseEvent(type) {
             win, // View
             type === 'click' ? 1 : 0, // Detail
             // Coords
-            0, 0, 0, 0, 
+            pos.x, pos.y, pos.x, pos.y, 
             // Pressed keys
             false, false, false, false, 0, // button
             null // related target
@@ -100,8 +190,7 @@ function getFakeMouseEvent(type) {
  */
 function getHeadingTagNameForElement(element) {
     var getIncreasedHeadingLevel = function (tagName) {
-        var headingLevel = parseInt(tagName.slice(1), 10);
-        var newLevel = Math.min(6, headingLevel + 1);
+        var headingLevel = parseInt(tagName.slice(1), 10), newLevel = Math.min(6, headingLevel + 1);
         return 'h' + newLevel;
     };
     var isHeading = function (tagName) { return /H[1-6]/.test(tagName); };
@@ -145,41 +234,30 @@ function removeElement(element) {
     }
 }
 /**
- * Utility function. Reverses child nodes of a DOM element.
+ * Remove all child nodes from an element.
  * @private
- * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} node
+ * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} [element]
  * @return {void}
  */
-function reverseChildNodes(node) {
-    var i = node.childNodes.length;
-    while (i--) {
-        node.appendChild(node.childNodes[i]);
+function removeChildNodes(element) {
+    while (element.lastChild) {
+        element.removeChild(element.lastChild);
     }
 }
 /**
- * Set attributes on element. Set to null to remove attribute.
+ * Utility function. Reverses child nodes of a DOM element.
  * @private
- * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} el
- * @param {Highcharts.HTMLAttributes|Highcharts.SVGAttributes} attrs
- * @return {void}
  */
-function setElAttrs(el, attrs) {
-    Object.keys(attrs).forEach(function (attr) {
-        var val = attrs[attr];
-        if (val === null) {
-            el.removeAttribute(attr);
-        }
-        else {
-            el.setAttribute(attr, val);
-        }
-    });
+function reverseChildNodes(node) {
+    var i = node.childNodes.length;
+    while (i--) {
+        node.appendChild(node.childNodes[i]);
+    }
 }
 /**
  * Used for aria-label attributes, painting on a canvas will fail if the
  * text contains tags.
  * @private
- * @param {string} str
- * @return {string}
  */
 function stripHTMLTagsFromString(str) {
     return typeof str === 'string' ?
@@ -189,11 +267,9 @@ function stripHTMLTagsFromString(str) {
  * Utility function for hiding an element visually, but still keeping it
  * available to screen reader users.
  * @private
- * @param {Highcharts.HTMLDOMElement} element
- * @return {void}
  */
 function visuallyHideElement(element) {
-    var hiddenStyle = {
+    css(element, {
         position: 'absolute',
         width: '1px',
         height: '1px',
@@ -203,19 +279,26 @@ function visuallyHideElement(element) {
         marginTop: '-3px',
         '-ms-filter': 'progid:DXImageTransform.Microsoft.Alpha(Opacity=1)',
         filter: 'alpha(opacity=1)',
-        opacity: '0.01'
-    };
-    merge(true, element.style, hiddenStyle);
+        opacity: 0.01
+    });
 }
+/* *
+ *
+ *  Default Export
+ *
+ * */
 var HTMLUtilities = {
     addClass: addClass,
+    cloneMouseEvent: cloneMouseEvent,
+    cloneTouchEvent: cloneTouchEvent,
     escapeStringForHTML: escapeStringForHTML,
     getElement: getElement,
     getFakeMouseEvent: getFakeMouseEvent,
     getHeadingTagNameForElement: getHeadingTagNameForElement,
+    removeChildNodes: removeChildNodes,
+    removeClass: removeClass,
     removeElement: removeElement,
     reverseChildNodes: reverseChildNodes,
-    setElAttrs: setElAttrs,
     stripHTMLTagsFromString: stripHTMLTagsFromString,
     visuallyHideElement: visuallyHideElement
 };

package/es-modules/Core/Animation/Fx.js

@@ -64,7 +64,6 @@ var Fx = /** @class */ (function () {
      *
      * @function Highcharts.Fx#dSetter
      *
-     * @return {void}
      */
     Fx.prototype.dSetter = function () {
         var paths = this.paths, start = paths && paths[0], end = paths && paths[1], now = this.now || 0;
@@ -110,7 +109,6 @@ var Fx = /** @class */ (function () {
      *
      * @function Highcharts.Fx#update
      *
-     * @return {void}
      */
     Fx.prototype.update = function () {
         var elem = this.elem, prop = this.prop, // if destroyed, it is null
@@ -147,7 +145,6 @@ var Fx = /** @class */ (function () {
      * @param {string} unit
      *        The property unit, for example `px`.
      *
-     * @return {void}
      */
     Fx.prototype.run = function (from, to, unit) {
         var self = this, options = self.options, timer = function (gotoEnd) {
@@ -167,7 +164,8 @@ var Fx = /** @class */ (function () {
         };
         if (from === to && !this.elem['forceAnimate:' + this.prop]) {
             delete options.curAnim[this.prop];
-            if (options.complete && Object.keys(options.curAnim).length === 0) {
+            if (options.complete &&
+                Object.keys(options.curAnim).length === 0) {
                 options.complete.call(this.elem);
             }
         }
@@ -220,7 +218,8 @@ var Fx = /** @class */ (function () {
         }
         else {
             this.pos = options.easing((t - this.startTime) / duration);
-            this.now = this.start + ((this.end - this.start) * this.pos);
+            this.now = this.start + ((this.end -
+                this.start) * this.pos);
             this.update();
             ret = true;
         }
@@ -254,9 +253,6 @@ var Fx = /** @class */ (function () {
         /**
          * If shifting points, prepend a dummy point to the end path.
          * @private
-         * @param {Highcharts.SVGPathArray} arr - array
-         * @param {Highcharts.SVGPathArray} other - array
-         * @return {void}
          */
         function prepend(arr, other) {
             while (arr.length < fullLength) {
@@ -291,9 +287,6 @@ var Fx = /** @class */ (function () {
         /**
          * Copy and append last point until the length matches the end length.
          * @private
-         * @param {Highcharts.SVGPathArray} arr - array
-         * @param {Highcharts.SVGPathArray} other - array
-         * @return {void}
          */
         function append(arr, other) {
             while (arr.length < fullLength) {
@@ -365,7 +358,6 @@ var Fx = /** @class */ (function () {
      *
      * @function Highcharts.Fx#fillSetter
      *
-     * @return {void}
      */
     Fx.prototype.fillSetter = function () {
         Fx.prototype.strokeSetter.apply(this, arguments);
@@ -375,10 +367,9 @@ var Fx = /** @class */ (function () {
      *
      * @function Highcharts.Fx#strokeSetter
      *
-     * @return {void}
      */
     Fx.prototype.strokeSetter = function () {
-        this.elem.attr(this.prop, color(this.start).tweenTo(color(this.end), this.pos), null, true);
+        this.elem.attr(this.prop, color(this.start).tweenTo(color(this.end), this.pos), void 0, true);
     };
     /* *
      *