highcharts 8.2.0 → 8.2.2

package/bower.json

@@ -1,6 +1,6 @@
 {
   "name": "highcharts",
-  "version": "8.2.0",
+  "version": "8.2.2",
   "main": "highcharts.js",
   "license": "https://www.highcharts.com/license",
   "types": "highcharts.d.ts"

package/es-modules/Accessibility/Accessibility.js

@@ -12,13 +12,14 @@
 'use strict';
 import ChartUtilities from './Utils/ChartUtilities.js';
 import H from '../Core/Globals.js';
+var doc = H.doc;
 import KeyboardNavigationHandler from './KeyboardNavigationHandler.js';
+import CartesianSeries from '../Core/Series/CartesianSeries.js';
 import O from '../Core/Options.js';
 var defaultOptions = O.defaultOptions;
 import Point from '../Core/Series/Point.js';
 import U from '../Core/Utilities.js';
 var addEvent = U.addEvent, extend = U.extend, fireEvent = U.fireEvent, merge = U.merge;
-var doc = H.win.document;
 import AccessibilityComponent from './AccessibilityComponent.js';
 import KeyboardNavigation from './KeyboardNavigation.js';
 import LegendComponent from './Components/LegendComponent.js';
@@ -258,7 +259,7 @@ addEvent(Point, 'update', function () {
     });
 });
 ['update', 'updatedData', 'remove'].forEach(function (event) {
-    addEvent(H.Series, event, function () {
+    addEvent(CartesianSeries, event, function () {
         if (this.chart.accessibility) {
             this.chart.a11yDirty = true;
         }

package/es-modules/Accessibility/AccessibilityComponent.js

@@ -9,17 +9,16 @@
  *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
-'use strict';
-import H from '../Core/Globals.js';
-var win = H.win, doc = win.document;
-import U from '../Core/Utilities.js';
-var extend = U.extend, fireEvent = U.fireEvent, merge = U.merge;
-import HTMLUtilities from './Utils/HTMLUtilities.js';
-var removeElement = HTMLUtilities.removeElement, getFakeMouseEvent = HTMLUtilities.getFakeMouseEvent;
 import ChartUtilities from './Utils/ChartUtilities.js';
 var unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT;
-import EventProvider from './Utils/EventProvider.js';
 import DOMElementProvider from './Utils/DOMElementProvider.js';
+import EventProvider from './Utils/EventProvider.js';
+import H from '../Core/Globals.js';
+var doc = H.doc, win = H.win;
+import HTMLUtilities from './Utils/HTMLUtilities.js';
+var removeElement = HTMLUtilities.removeElement, getFakeMouseEvent = HTMLUtilities.getFakeMouseEvent;
+import U from '../Core/Utilities.js';
+var extend = U.extend, fireEvent = U.fireEvent, merge = U.merge;
 /* eslint-disable valid-jsdoc */
 /** @lends Highcharts.AccessibilityComponent */
 var functionsToOverrideByDerivedClasses = {

package/es-modules/Accessibility/Components/ContainerComponent.js

@@ -9,16 +9,15 @@
  *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
-'use strict';
+import AccessibilityComponent from '../AccessibilityComponent.js';
+import ChartUtilities from '../Utils/ChartUtilities.js';
+var unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT, getChartTitle = ChartUtilities.getChartTitle;
 import H from '../../Core/Globals.js';
-var doc = H.win.document;
-import U from '../../Core/Utilities.js';
-var extend = U.extend;
+var doc = H.doc;
 import HTMLUtilities from '../Utils/HTMLUtilities.js';
 var stripHTMLTags = HTMLUtilities.stripHTMLTagsFromString;
-import ChartUtilities from '../Utils/ChartUtilities.js';
-var unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT, getChartTitle = ChartUtilities.getChartTitle;
-import AccessibilityComponent from '../AccessibilityComponent.js';
+import U from '../../Core/Utilities.js';
+var extend = U.extend;
 /* eslint-disable valid-jsdoc */
 /**
  * The ContainerComponent class

package/es-modules/Accessibility/Components/InfoRegionsComponent.js

@@ -9,7 +9,6 @@
  *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
-'use strict';
 import H from '../../Core/Globals.js';
 var doc = H.doc;
 import U from '../../Core/Utilities.js';

package/es-modules/Accessibility/Components/RangeSelectorComponent.js

@@ -10,15 +10,15 @@
  *
  * */
 'use strict';
-import H from '../../Core/Globals.js';
-import U from '../../Core/Utilities.js';
-var extend = U.extend;
 import AccessibilityComponent from '../AccessibilityComponent.js';
-import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
 import ChartUtilities from '../Utils/ChartUtilities.js';
 var unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT;
+import H from '../../Core/Globals.js';
 import HTMLUtilities from '../Utils/HTMLUtilities.js';
 var setElAttrs = HTMLUtilities.setElAttrs;
+import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
+import U from '../../Core/Utilities.js';
+var extend = U.extend;
 /* eslint-disable no-invalid-this, valid-jsdoc */
 /**
  * @private

package/es-modules/Accessibility/Components/SeriesComponent/ForcedMarkers.js

@@ -10,7 +10,7 @@
  *
  * */
 'use strict';
-import H from '../../../Core/Globals.js';
+import CartesianSeries from '../../../Core/Series/CartesianSeries.js';
 import U from '../../../Core/Utilities.js';
 var addEvent = U.addEvent, merge = U.merge;
 /* eslint-disable no-invalid-this, valid-jsdoc */
@@ -121,7 +121,7 @@ function addForceMarkersEvents() {
      * Keep track of forcing markers.
      * @private
      */
-    addEvent(H.Series, 'render', function () {
+    addEvent(CartesianSeries, 'render', function () {
         var series = this, options = series.options;
         if (shouldForceMarkers(series)) {
             if (options.marker && options.marker.enabled === false) {
@@ -141,14 +141,14 @@ function addForceMarkersEvents() {
      * Keep track of options to reset markers to if no longer forced.
      * @private
      */
-    addEvent(H.Series, 'afterSetOptions', function (e) {
+    addEvent(CartesianSeries, 'afterSetOptions', function (e) {
         this.resetA11yMarkerOptions = merge(e.options.marker || {}, this.userOptions.marker || {});
     });
     /**
      * Process marker graphics after render
      * @private
      */
-    addEvent(H.Series, 'afterRender', function () {
+    addEvent(CartesianSeries, 'afterRender', function () {
         var series = this;
         // For styled mode the rendered graphic does not reflect the style
         // options, and we need to add/remove classes to achieve the same.

package/es-modules/Accessibility/Components/SeriesComponent/NewDataAnnouncer.js

@@ -11,6 +11,7 @@
  * */
 'use strict';
 import H from '../../../Core/Globals.js';
+import CartesianSeries from '../../../Core/Series/CartesianSeries.js';
 import U from '../../../Core/Utilities.js';
 var extend = U.extend, defined = U.defined;
 import ChartUtilities from '../../Utils/ChartUtilities.js';
@@ -92,13 +93,13 @@ extend(NewDataAnnouncer.prototype, {
         e.addEvent(chart, 'afterDrilldown', function () {
             announcer.lastAnnouncementTime = 0;
         });
-        e.addEvent(H.Series, 'updatedData', function () {
+        e.addEvent(CartesianSeries, 'updatedData', function () {
             announcer.onSeriesUpdatedData(this);
         });
         e.addEvent(chart, 'afterAddSeries', function (e) {
             announcer.onSeriesAdded(e.series);
         });
-        e.addEvent(H.Series, 'addPoint', function (e) {
+        e.addEvent(CartesianSeries, 'addPoint', function (e) {
             announcer.onPointAdded(e.point);
         });
         e.addEvent(chart, 'redraw', function () {

package/es-modules/Accessibility/Components/SeriesComponent/SeriesDescriber.js

@@ -10,15 +10,15 @@
  *
  * */
 'use strict';
-import U from '../../../Core/Utilities.js';
-var find = U.find, format = U.format, isNumber = U.isNumber, numberFormat = U.numberFormat, pick = U.pick, defined = U.defined;
 import AnnotationsA11y from '../AnnotationsA11y.js';
 var getPointAnnotationTexts = AnnotationsA11y.getPointAnnotationTexts;
-import HTMLUtilities from '../../Utils/HTMLUtilities.js';
-var escapeStringForHTML = HTMLUtilities.escapeStringForHTML, reverseChildNodes = HTMLUtilities.reverseChildNodes, stripHTMLTags = HTMLUtilities.stripHTMLTagsFromString;
 import ChartUtilities from '../../Utils/ChartUtilities.js';
 var getAxisDescription = ChartUtilities.getAxisDescription, getSeriesFirstPointElement = ChartUtilities.getSeriesFirstPointElement, getSeriesA11yElement = ChartUtilities.getSeriesA11yElement, unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT;
+import HTMLUtilities from '../../Utils/HTMLUtilities.js';
+var escapeStringForHTML = HTMLUtilities.escapeStringForHTML, reverseChildNodes = HTMLUtilities.reverseChildNodes, stripHTMLTags = HTMLUtilities.stripHTMLTagsFromString;
 import Tooltip from '../../../Core/Tooltip.js';
+import U from '../../../Core/Utilities.js';
+var find = U.find, format = U.format, isNumber = U.isNumber, numberFormat = U.numberFormat, pick = U.pick, defined = U.defined;
 /* eslint-disable valid-jsdoc */
 /**
  * @private

package/es-modules/Accessibility/Components/SeriesComponent/SeriesKeyboardNavigation.js

@@ -10,8 +10,10 @@
  *
  * */
 'use strict';
+import Series from '../../../Core/Series/Series.js';
+var seriesTypes = Series.seriesTypes;
+import CartesianSeries from '../../../Core/Series/CartesianSeries.js';
 import Chart from '../../../Core/Chart/Chart.js';
-import H from '../../../Core/Globals.js';
 import Point from '../../../Core/Series/Point.js';
 import U from '../../../Core/Utilities.js';
 var defined = U.defined, extend = U.extend;
@@ -26,10 +28,10 @@ import '../../../Series/PieSeries.js';
  * Set for which series types it makes sense to move to the closest point with
  * up/down arrows, and which series types should just move to next series.
  */
-H.Series.prototype.keyboardMoveVertical = true;
+CartesianSeries.prototype.keyboardMoveVertical = true;
 ['column', 'pie'].forEach(function (type) {
-    if (H.seriesTypes[type]) {
-        H.seriesTypes[type].prototype.keyboardMoveVertical = false;
+    if (seriesTypes[type]) {
+        seriesTypes[type].prototype.keyboardMoveVertical = false;
     }
 });
 /**
@@ -234,7 +236,7 @@ Chart.prototype.highlightAdjacentPoint = function (next) {
  *
  * @return {boolean|Highcharts.Point}
  */
-H.Series.prototype.highlightFirstValidPoint = function () {
+CartesianSeries.prototype.highlightFirstValidPoint = function () {
     var curPoint = this.chart.highlightedPoint, start = (curPoint && curPoint.series) === this ?
         getPointIndex(curPoint) :
         0, points = this.points, len = points.length;
@@ -400,7 +402,7 @@ extend(SeriesKeyboardNavigation.prototype, /** @lends Highcharts.SeriesKeyboardN
      */
     init: function () {
         var keyboardNavigation = this, chart = this.chart, e = this.eventProvider = new EventProvider();
-        e.addEvent(H.Series, 'destroy', function () {
+        e.addEvent(CartesianSeries, 'destroy', function () {
             return keyboardNavigation.onSeriesDestroy(this);
         });
         e.addEvent(chart, 'afterDrilldown', function () {

package/es-modules/Accessibility/Components/ZoomComponent.js

@@ -10,15 +10,16 @@
  *
  * */
 'use strict';
-import H from '../../Core/Globals.js';
-import U from '../../Core/Utilities.js';
-var extend = U.extend, pick = U.pick;
 import AccessibilityComponent from '../AccessibilityComponent.js';
-import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
 import ChartUtilities from '../Utils/ChartUtilities.js';
 var unhideChartElementFromAT = ChartUtilities.unhideChartElementFromAT;
+import H from '../../Core/Globals.js';
+var noop = H.noop;
 import HTMLUtilities from '../Utils/HTMLUtilities.js';
-var setElAttrs = HTMLUtilities.setElAttrs, removeElement = HTMLUtilities.removeElement;
+var removeElement = HTMLUtilities.removeElement, setElAttrs = HTMLUtilities.setElAttrs;
+import KeyboardNavigationHandler from '../KeyboardNavigationHandler.js';
+import U from '../../Core/Utilities.js';
+var extend = U.extend, pick = U.pick;
 /* eslint-disable no-invalid-this, valid-jsdoc */
 /**
  * @private
@@ -57,7 +58,7 @@ H.Axis.prototype.panStep = function (direction, granularity) {
  * @class
  * @name Highcharts.ZoomComponent
  */
-var ZoomComponent = function () { };
+var ZoomComponent = noop;
 ZoomComponent.prototype = new AccessibilityComponent();
 extend(ZoomComponent.prototype, /** @lends Highcharts.ZoomComponent */ {
     /**

package/es-modules/Accessibility/KeyboardNavigation.js

@@ -80,9 +80,13 @@ KeyboardNavigation.prototype = {
         this.update();
         ep.addEvent(this.tabindexContainer, 'keydown', function (e) { return _this.onKeydown(e); });
         ep.addEvent(this.tabindexContainer, 'focus', function (e) { return _this.onFocus(e); });
-        ep.addEvent(doc, 'mouseup', function () { return _this.onMouseUp(); });
-        ep.addEvent(chart.renderTo, 'mousedown', function () {
-            _this.isClickingChart = true;
+        ['mouseup', 'touchend'].forEach(function (eventName) {
+            return ep.addEvent(doc, eventName, function () { return _this.onMouseUp(); });
+        });
+        ['mousedown', 'touchstart'].forEach(function (eventName) {
+            return ep.addEvent(chart.renderTo, eventName, function () {
+                _this.isClickingChart = true;
+            });
         });
         ep.addEvent(chart.renderTo, 'mouseover', function () {
             _this.pointerIsOverChart = true;

package/es-modules/Accessibility/Options/Options.js

@@ -9,7 +9,6 @@
  *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
-'use strict';
 /**
  * Formatter callback for the accessibility announcement.
  *
@@ -76,7 +75,7 @@ var options = {
      * [accessibility module](https://code.highcharts.com/modules/accessibility.js)
      * to be loaded. For a description of the module and information
      * on its features, see
-     * [Highcharts Accessibility](https://www.highcharts.com/docs/chart-concepts/accessibility).
+     * [Highcharts Accessibility](https://www.highcharts.com/docs/accessibility/accessibility-module).
      *
      * @since        5.0.0
      * @requires     modules/accessibility

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

@@ -44,10 +44,10 @@ function getAxisDescription(axis) {
  * The DOM element for the point.
  */
 function getSeriesFirstPointElement(series) {
-    if (series.points &&
-        series.points.length &&
-        series.points[0].graphic) {
-        return series.points[0].graphic.element;
+    var _a, _b;
+    if ((_a = series.points) === null || _a === void 0 ? void 0 : _a.length) {
+        var firstPointWithGraphic = find(series.points, function (p) { return !!p.graphic; });
+        return (_b = firstPointWithGraphic === null || firstPointWithGraphic === void 0 ? void 0 : firstPointWithGraphic.graphic) === null || _b === void 0 ? void 0 : _b.element;
     }
 }
 /**

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

@@ -12,11 +12,11 @@
  * */
 'use strict';
 import H from '../../Core/Globals.js';
-var doc = H.win.document;
-import U from '../../Core/Utilities.js';
-var extend = U.extend;
+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 */
 /**
  * @private

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

@@ -9,11 +9,10 @@
  *  !!!!!!! 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;
-import H from '../../Core/Globals.js';
-var win = H.win, doc = win.document;
 /* eslint-disable valid-jsdoc */
 /**
  * @private

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

@@ -0,0 +1,193 @@
+/* *
+ *
+ *  (c) 2010-2020 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+import Fx from './Fx.js';
+import H from '../Globals.js';
+import U from '../Utilities.js';
+var defined = U.defined, getStyle = U.getStyle, isArray = U.isArray, isNumber = U.isNumber, isObject = U.isObject, merge = U.merge, objectEach = U.objectEach, pick = U.pick;
+/**
+ * Set the global animation to either a given value, or fall back to the given
+ * chart's animation option.
+ *
+ * @function Highcharts.setAnimation
+ *
+ * @param {boolean|Partial<Highcharts.AnimationOptionsObject>|undefined} animation
+ *        The animation object.
+ *
+ * @param {Highcharts.Chart} chart
+ *        The chart instance.
+ *
+ * @todo
+ * This function always relates to a chart, and sets a property on the renderer,
+ * so it should be moved to the SVGRenderer.
+ */
+var setAnimation = H.setAnimation = function setAnimation(animation, chart) {
+    chart.renderer.globalAnimation = pick(animation, chart.options.chart.animation, true);
+};
+/**
+ * Get the animation in object form, where a disabled animation is always
+ * returned as `{ duration: 0 }`.
+ *
+ * @function Highcharts.animObject
+ *
+ * @param {boolean|Highcharts.AnimationOptionsObject} [animation=0]
+ *        An animation setting. Can be an object with duration, complete and
+ *        easing properties, or a boolean to enable or disable.
+ *
+ * @return {Highcharts.AnimationOptionsObject}
+ *         An object with at least a duration property.
+ */
+var animObject = H.animObject = function animObject(animation) {
+    return isObject(animation) ?
+        H.merge({ duration: 500, defer: 0 }, animation) :
+        { duration: animation ? 500 : 0, defer: 0 };
+};
+/**
+ * Get the defer as a number value from series animation options.
+ *
+ * @function Highcharts.getDeferredAnimation
+ *
+ * @param {Highcharts.Chart} chart
+ *        The chart instance.
+ *
+ * @param {boolean|Highcharts.AnimationOptionsObject} animation
+ *        An animation setting. Can be an object with duration, complete and
+ *        easing properties, or a boolean to enable or disable.
+ *
+ * @param {Highcharts.Series} [series]
+ *        Series to defer animation.
+ *
+ * @return {number}
+ *        The numeric value.
+ */
+var getDeferredAnimation = H.getDeferredAnimation = function (chart, animation, series) {
+    var labelAnimation = animObject(animation);
+    var s = series ? [series] : chart.series;
+    var defer = 0;
+    var duration = 0;
+    s.forEach(function (series) {
+        var seriesAnim = animObject(series.options.animation);
+        defer = animation && defined(animation.defer) ?
+            labelAnimation.defer :
+            Math.max(defer, seriesAnim.duration + seriesAnim.defer);
+        duration = Math.min(labelAnimation.duration, seriesAnim.duration);
+    });
+    // Disable defer for exporting
+    if (chart.renderer.forExport) {
+        defer = 0;
+    }
+    var anim = {
+        defer: Math.max(0, defer - duration),
+        duration: Math.min(defer, duration)
+    };
+    return anim;
+};
+/**
+ * The global animate method, which uses Fx to create individual animators.
+ *
+ * @function Highcharts.animate
+ *
+ * @param {Highcharts.HTMLDOMElement|Highcharts.SVGElement} el
+ *        The element to animate.
+ *
+ * @param {Highcharts.CSSObject|Highcharts.SVGAttributes} params
+ *        An object containing key-value pairs of the properties to animate.
+ *        Supports numeric as pixel-based CSS properties for HTML objects and
+ *        attributes for SVGElements.
+ *
+ * @param {Partial<Highcharts.AnimationOptionsObject>} [opt]
+ *        Animation options.
+ *
+ * @return {void}
+ */
+var animate = H.animate = function (el, params, opt) {
+    var start, unit = '', end, fx, args;
+    if (!isObject(opt)) { // Number or undefined/null
+        args = arguments;
+        opt = {
+            duration: args[2],
+            easing: args[3],
+            complete: args[4]
+        };
+    }
+    if (!isNumber(opt.duration)) {
+        opt.duration = 400;
+    }
+    opt.easing = typeof opt.easing === 'function' ?
+        opt.easing :
+        (Math[opt.easing] || Math.easeInOutSine);
+    opt.curAnim = merge(params);
+    objectEach(params, function (val, prop) {
+        // Stop current running animation of this property
+        stop(el, prop);
+        fx = new Fx(el, opt, prop);
+        end = null;
+        if (prop === 'd' && isArray(params.d)) {
+            fx.paths = fx.initPath(el, el.pathArray, params.d);
+            fx.toD = params.d;
+            start = 0;
+            end = 1;
+        }
+        else if (el.attr) {
+            start = el.attr(prop);
+        }
+        else {
+            start = parseFloat(getStyle(el, prop)) || 0;
+            if (prop !== 'opacity') {
+                unit = 'px';
+            }
+        }
+        if (!end) {
+            end = val;
+        }
+        if (end && end.match && end.match('px')) {
+            end = end.replace(/px/g, ''); // #4351
+        }
+        fx.run(start, end, unit);
+    });
+};
+/**
+ * Stop running animation.
+ *
+ * @function Highcharts.stop
+ *
+ * @param {Highcharts.SVGElement} el
+ *        The SVGElement to stop animation on.
+ *
+ * @param {string} [prop]
+ *        The property to stop animating. If given, the stop method will stop a
+ *        single property from animating, while others continue.
+ *
+ * @return {void}
+ *
+ * @todo
+ * A possible extension to this would be to stop a single property, when
+ * we want to continue animating others. Then assign the prop to the timer
+ * in the Fx.run method, and check for the prop here. This would be an
+ * improvement in all cases where we stop the animation from .attr. Instead of
+ * stopping everything, we can just stop the actual attributes we're setting.
+ */
+var stop = H.stop = function (el, prop) {
+    var i = H.timers.length;
+    // Remove timers related to this element (#4519)
+    while (i--) {
+        if (H.timers[i].elem === el && (!prop || prop === H.timers[i].prop)) {
+            H.timers[i].stopped = true; // #4667
+        }
+    }
+};
+var animationExports = {
+    animate: animate,
+    animObject: animObject,
+    getDeferredAnimation: getDeferredAnimation,
+    setAnimation: setAnimation,
+    stop: stop
+};
+export default animationExports;