highcharts 8.1.0 → 8.2.2

package/es-modules/{modules/accessibility/options/deprecatedOptions.js → Accessibility/Options/DeprecatedOptions.js}

@@ -58,22 +58,9 @@
  */
 /* eslint-enable max-len */
 'use strict';
-import U from '../../../parts/Utilities.js';
+import U from '../../Core/Utilities.js';
 var error = U.error, pick = U.pick;
 /* eslint-disable valid-jsdoc */
-/**
- * Warn user that a deprecated option was used.
- * @private
- * @param {Highcharts.Chart} chart
- * @param {string} oldOption
- * @param {string} newOption
- * @return {void}
- */
-function warn(chart, oldOption, newOption) {
-    error('Highcharts: Deprecated option ' + oldOption +
-        ' used. This will be removed from future versions of Highcharts. Use ' +
-        newOption + ' instead.', false, chart);
-}
 /**
  * Set a new option on a root prop, where the option is defined as an array of
  * suboptions.
@@ -106,11 +93,13 @@ function deprecateFromOptionsMap(chart, rootOldAsArray, rootNewAsArray, mapToNew
     }
     var rootOld = getChildProp(chart.options, rootOldAsArray), rootNew = getChildProp(chart.options, rootNewAsArray);
     Object.keys(mapToNewOptions).forEach(function (oldOptionKey) {
+        var _a;
         var val = rootOld[oldOptionKey];
         if (typeof val !== 'undefined') {
             traverseSetOption(rootNew, mapToNewOptions[oldOptionKey], val);
-            warn(chart, rootOldAsArray.join('.') + '.' + oldOptionKey, rootNewAsArray.join('.') + '.' +
-                mapToNewOptions[oldOptionKey].join('.'));
+            error(32, false, chart, (_a = {},
+                _a[rootOldAsArray.join('.') + "." + oldOptionKey] = rootNewAsArray.join('.') + "." + mapToNewOptions[oldOptionKey].join('.'),
+                _a));
         }
     });
 }
@@ -120,9 +109,10 @@ function deprecateFromOptionsMap(chart, rootOldAsArray, rootNewAsArray, mapToNew
 function copyDeprecatedChartOptions(chart) {
     var chartOptions = chart.options.chart || {}, a11yOptions = chart.options.accessibility || {};
     ['description', 'typeDescription'].forEach(function (prop) {
+        var _a;
         if (chartOptions[prop]) {
             a11yOptions[prop] = chartOptions[prop];
-            warn(chart, 'chart.' + prop, 'accessibility.' + prop);
+            error(32, false, chart, (_a = {}, _a["chart." + prop] = "use accessibility." + prop, _a));
         }
     });
 }
@@ -135,7 +125,7 @@ function copyDeprecatedAxisOptions(chart) {
         if (opts && opts.description) {
             opts.accessibility = opts.accessibility || {};
             opts.accessibility.description = opts.description;
-            warn(chart, 'axis.description', 'axis.accessibility.description');
+            error(32, false, chart, { 'axis.description': 'use axis.accessibility.description' });
         }
     });
 }
@@ -158,6 +148,7 @@ function copyDeprecatedSeriesOptions(chart) {
     chart.series.forEach(function (series) {
         // Handle series wide options
         Object.keys(oldToNewSeriesOptions).forEach(function (oldOption) {
+            var _a;
             var optionVal = series.options[oldOption];
             if (typeof optionVal !== 'undefined') {
                 // Set the new option
@@ -166,8 +157,7 @@ function copyDeprecatedSeriesOptions(chart) {
                 // value, since we set enabled rather than disabled
                 oldOption === 'skipKeyboardNavigation' ?
                     !optionVal : optionVal);
-                warn(chart, 'series.' + oldOption, 'series.' +
-                    oldToNewSeriesOptions[oldOption].join('.'));
+                error(32, false, chart, (_a = {}, _a["series." + oldOption] = "series." + oldToNewSeriesOptions[oldOption].join('.'), _a));
             }
         });
     });

package/es-modules/{modules/accessibility/options/langOptions.js → Accessibility/Options/LangOptions.js}

@@ -105,7 +105,7 @@ var langOptions = {
          */
         legend: {
             legendLabel: 'Toggle series visibility',
-            legendItem: 'Toggle visibility of {itemName}'
+            legendItem: 'Hide {itemName}'
         },
         /**
          * Chart and map zoom accessibility language options.

package/es-modules/{modules/accessibility/options/options.js → 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/{modules/accessibility/utils → Accessibility/Utils}/Announcer.js

@@ -10,9 +10,9 @@
  *
  * */
 'use strict';
-import H from '../../../parts/Globals.js';
+import H from '../../Core/Globals.js';
 import DOMElementProvider from './DOMElementProvider.js';
-import HTMLUtilities from './htmlUtilities.js';
+import HTMLUtilities from './HTMLUtilities.js';
 var visuallyHideElement = HTMLUtilities.visuallyHideElement;
 var Announcer = /** @class */ (function () {
     function Announcer(chart, type) {

package/es-modules/{modules/accessibility/utils/chartUtilities.js → Accessibility/Utils/ChartUtilities.js}

@@ -10,10 +10,10 @@
  *
  * */
 'use strict';
-import HTMLUtilities from './htmlUtilities.js';
+import HTMLUtilities from './HTMLUtilities.js';
 var stripHTMLTags = HTMLUtilities.stripHTMLTagsFromString;
-import U from '../../../parts/Utilities.js';
-var defined = U.defined, find = U.find;
+import U from '../../Core/Utilities.js';
+var defined = U.defined, find = U.find, fireEvent = U.fireEvent;
 /* eslint-disable valid-jsdoc */
 /**
  * @return {string}
@@ -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;
     }
 }
 /**
@@ -71,7 +71,6 @@ function getSeriesA11yElement(series) {
  * @private
  * @param {Highcharts.Chart} chart
  * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} element
- * @return {void}
  */
 function unhideChartElementFromAT(chart, element) {
     element.setAttribute('aria-hidden', false);
@@ -166,7 +165,7 @@ function scrollToPoint(point) {
         var range = scrollbar.to - scrollbar.from;
         var pos = getRelativePointAxisPosition(axis, point);
         scrollbar.updatePosition(pos - range / 2, pos + range / 2);
-        Highcharts.fireEvent(scrollbar, 'changed', {
+        fireEvent(scrollbar, 'changed', {
             from: scrollbar.from,
             to: scrollbar.to,
             trigger: 'scrollbar',

package/es-modules/{modules/accessibility/utils → Accessibility/Utils}/DOMElementProvider.js

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

package/es-modules/{modules/accessibility/utils → Accessibility/Utils}/EventProvider.js

@@ -10,8 +10,8 @@
  *
  * */
 'use strict';
-import H from '../../../parts/Globals.js';
-import U from '../../../parts/Utilities.js';
+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 */
 /**

package/es-modules/{modules/accessibility/utils/htmlUtilities.js → Accessibility/Utils/HTMLUtilities.js}

@@ -9,11 +9,10 @@
  *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
  *
  * */
-'use strict';
-import U from '../../../parts/Utilities.js';
+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 '../../../parts/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;