highcharts 9.3.1 → 10.0.0

package/highcharts.src.js

@@ -1,11 +1,10 @@
 /**
- * @license Highcharts JS v9.3.1 (2021-11-05)
+ * @license Highcharts JS v10.0.0 (2022-03-07)
  *
  * (c) 2009-2021 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
-'use strict';
 (function (root, factory) {
     if (typeof module === 'object' && module.exports) {
         factory['default'] = factory;
@@ -22,11 +21,21 @@
         }
         root.Highcharts = factory(root);
     }
-}(typeof window !== 'undefined' ? window : this, function (win) {
+}(typeof window !== 'undefined' ? window : this, function (window) {
+    'use strict';
     var _modules = {};
     function _registerModule(obj, path, args, fn) {
         if (!obj.hasOwnProperty(path)) {
             obj[path] = fn.apply(null, args);
+
+            if (typeof CustomEvent === 'function') {
+                window.dispatchEvent(
+                    new CustomEvent(
+                        'HighchartsModuleLoaded',
+                        { detail: { path: path, module: obj[path] }
+                    })
+                );
+            }
         }
     }
     _registerModule(_modules, 'Core/Globals.js', [], function () {
@@ -39,23 +48,6 @@
          *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
          *
          * */
-        /* *
-         *
-         *  Constants
-         *
-         * */
-        /**
-         * @private
-         * @deprecated
-         * @todo Rename UMD argument `win` to `window`; move code to `Globals.win`
-         */
-        var w = (typeof win !== 'undefined' ?
-                win :
-                typeof window !== 'undefined' ?
-                    window :
-                    {}
-            // eslint-disable-next-line node/no-unsupported-features/es-builtins
-            );
         /* *
          *
          *  Namespace
@@ -71,7 +63,10 @@
              *  Constants
              *
              * */
-            Globals.SVG_NS = 'http://www.w3.org/2000/svg', Globals.product = 'Highcharts', Globals.version = '9.3.1', Globals.win = w, Globals.doc = Globals.win.document, Globals.svg = (Globals.doc &&
+            Globals.SVG_NS = 'http://www.w3.org/2000/svg', Globals.product = 'Highcharts', Globals.version = '10.0.0', Globals.win = (typeof window !== 'undefined' ?
+                window :
+                {}), // eslint-disable-line node/no-unsupported-features/es-builtins
+            Globals.doc = Globals.win.document, Globals.svg = (Globals.doc &&
                 Globals.doc.createElementNS &&
                 !!Globals.doc.createElementNS(Globals.SVG_NS, 'svg').createSVGRect), Globals.userAgent = (Globals.win.navigator && Globals.win.navigator.userAgent) || '', Globals.isChrome = Globals.userAgent.indexOf('Chrome') !== -1, Globals.isFirefox = Globals.userAgent.indexOf('Firefox') !== -1, Globals.isMS = /(edge|msie|trident)/i.test(Globals.userAgent) && !Globals.win.opera, Globals.isSafari = !Globals.isChrome && Globals.userAgent.indexOf('Safari') !== -1, Globals.isTouchDevice = /(Mobile|Android|Windows Phone)/.test(Globals.userAgent), Globals.isWebKit = Globals.userAgent.indexOf('AppleWebKit') !== -1, Globals.deg2rad = Math.PI * 2 / 360, Globals.hasBidiBug = (Globals.isFirefox &&
                 parseInt(Globals.userAgent.split('Firefox/')[1], 10) < 4 // issue #38
@@ -365,7 +360,9 @@
                     // Arrays, primitives and DOM nodes are copied directly
                 }
                 else if (isObject(newer[key]) ||
-                    newer[key] !== older[key]) {
+                    newer[key] !== older[key] ||
+                    // If the newer key is explicitly undefined, keep it (#10525)
+                    (key in newer && !(key in older))) {
                     result[key] = newer[key];
                 }
             });
@@ -533,7 +530,7 @@
          * @param {Highcharts.HTMLDOMElement|Highcharts.SVGDOMElement} elem
          *        The DOM element to receive the attribute(s).
          *
-         * @param {string|Highcharts.HTMLAttributes|Highcharts.SVGAttributes} [prop]
+         * @param {string|Highcharts.HTMLAttributes|Highcharts.SVGAttributes} [keyOrAttribs]
          *        The property or an object of key-value pairs.
          *
          * @param {number|string} [value]
@@ -542,33 +539,36 @@
          * @return {string|null|undefined}
          *         When used as a getter, return the value.
          */
-        function attr(elem, prop, value) {
+        function attr(elem, keyOrAttribs, value) {
+            var isGetter = isString(keyOrAttribs) && !defined(value);
             var ret;
-            // if the prop is a string
-            if (isString(prop)) {
-                // set the value
-                if (defined(value)) {
-                    elem.setAttribute(prop, value);
-                    // get the value
-                }
-                else if (elem && elem.getAttribute) {
-                    ret = elem.getAttribute(prop);
+            var attrSingle = function (value,
+                key) {
+                    // Set the value
+                    if (defined(value)) {
+                        elem.setAttribute(key,
+                value);
+                    // Get the value
+                }
+                else if (isGetter) {
+                    ret = elem.getAttribute(key);
                     // IE7 and below cannot get class through getAttribute (#7850)
-                    if (!ret && prop === 'class') {
-                        ret = elem.getAttribute(prop + 'Name');
+                    if (!ret && key === 'class') {
+                        ret = elem.getAttribute(key + 'Name');
                     }
+                    // Remove the value
                 }
-                // else if prop is defined, it is a hash of key/value pairs
+                else {
+                    elem.removeAttribute(key);
+                }
+            };
+            // If keyOrAttribs is a string
+            if (isString(keyOrAttribs)) {
+                attrSingle(value, keyOrAttribs);
+                // Else if keyOrAttribs is defined, it is a hash of key/value pairs
             }
             else {
-                objectEach(prop, function (val, key) {
-                    if (defined(val)) {
-                        elem.setAttribute(key, val);
-                    }
-                    else {
-                        elem.removeAttribute(key);
-                    }
-                });
+                objectEach(keyOrAttribs, attrSingle);
             }
             return ret;
         }
@@ -619,10 +619,8 @@
          *
          * @function Highcharts.clearTimeout
          *
-         * @param {number} id
-         *        Id of a timeout.
-         *
-         * @return {void}
+         * @param {number|undefined} id
+         * Id of a timeout.
          */
         function internalClearTimeout(id) {
             if (defined(id)) {
@@ -692,9 +690,8 @@
          */
         function css(el, styles) {
             if (H.isMS && !H.svg) { // #2686
-                if (styles && typeof styles.opacity !== 'undefined') {
-                    styles.filter =
-                        'alpha(opacity=' + (styles.opacity * 100) + ')';
+                if (styles && defined(styles.opacity)) {
+                    styles.filter = "alpha(opacity=" + styles.opacity * 100 + ")";
                 }
             }
             extend(el.style, styles);
@@ -761,7 +758,7 @@
             return obj;
         }
         /**
-         * Left-pad a string to a given length by adding a character repetetively.
+         * Left-pad a string to a given length by adding a character repetitively.
          *
          * @function Highcharts.pad
          *
@@ -1030,7 +1027,7 @@
             });
         }
         /**
-         * Discard a HTML element by moving it to the bin and delete.
+         * Discard a HTML element
          *
          * @function Highcharts.discardElement
          *
@@ -1038,17 +1035,10 @@
          *        The HTML node to discard.
          */
         function discardElement(element) {
-            // create a garbage bin element, not part of the DOM
-            if (!garbageBin) {
-                garbageBin = createElement('div');
-            }
-            // move the node and empty bin
-            if (element) {
-                garbageBin.appendChild(element);
+            if (element && element.parentElement) {
+                element.parentElement.removeChild(element);
             }
-            garbageBin.innerHTML = '';
         }
-        var garbageBin;
         /**
          * Fix JS round off float errors.
          *
@@ -1247,7 +1237,7 @@
                 var i;
                 var length = arr.length;
                 for (i = 0; i < length; i++) {
-                    if (callback(arr[i], i)) { // eslint-disable-line callback-return
+                    if (callback(arr[i], i)) { // eslint-disable-line node/callback-return
                         return arr[i];
                     }
                 }
@@ -1519,9 +1509,6 @@
             /* eslint-enable valid-jsdoc */
             /**
              * @private
-             * @param {string} type - event type
-             * @param {Highcharts.EventCallbackFunction<T>} fn - callback
-             * @return {void}
              */
             function removeOneEvent(type, fn) {
                 var removeEventListener = (el.removeEventListener || H.removeEventListenerPolyfill);
@@ -1531,8 +1518,6 @@
             }
             /**
              * @private
-             * @param {any} eventCollection - collection
-             * @return {void}
              */
             function removeAllEvents(eventCollection) {
                 var types,
@@ -2185,19 +2170,22 @@
          */
         var ChartDefaults = {
                 /**
-                 * Default `mapData` for all series. If set to a string,
-            it functions
-                 * as an index into the `Highcharts.maps` array. Otherwise it is
-                 * interpreted as map data.
+                 * Default `mapData` for all series,
+            in terms of a GeoJSON or TopoJSON
+                 * object. If set to a string,
+            it functions as an index into the
+                 * `Highcharts.maps` array.
                  *
-                 * @see [mapData](#series.map.mapData)
+                 * For picking out individual shapes and geometries to use for each series
+                 * of the map,
+            see [series.mapData](#series.map.mapData).
                  *
                  * @sample    maps/demo/geojson
-                 *            Loading geoJSON data
+                 *            Loading GeoJSON data
                  * @sample    maps/chart/topojson
-                 *            Loading topoJSON converted to geoJSON
+                 *            Loading TopoJSON data
                  *
-                 * @type      {string|Array<*>|Highcharts.GeoJSON}
+                 * @type      {string|Array<*>|Highcharts.GeoJSON|Highcharts.TopoJSON}
                  * @since     5.0.0
                  * @product   highmaps
                  * @apioption chart.map
@@ -2212,7 +2200,7 @@
                  * @apioption chart.mapTransforms
                  */
                 /**
-                 * When using multiple axis,
+                 * When using multiple axes,
             the ticks of two or more opposite axes
                  * will automatically be aligned by adding ticks to the axis or axes
                  * with the least ticks,
@@ -2223,8 +2211,8 @@
             it's a good idea to hide them for the secondary
                  * axis by setting `gridLineWidth` to 0.
                  *
-                 * If `startOnTick` or `endOnTick` in an Axis options are set to false,
-                 * then the `alignTicks ` will be disabled for the Axis.
+                 * If `startOnTick` or `endOnTick` in the axis options are set to false,
+                 * then the `alignTicks ` will be disabled for the axis.
                  *
                  * Disabled for logarithmic axes.
                  *
@@ -2242,6 +2230,31 @@
                  * @product   highcharts highstock gantt
                  * @apioption chart.alignTicks
                  */
+                /**
+                 * When using multiple axes,
+            align the thresholds. When this is true,
+            other
+                 * ticks will also be aligned.
+                 *
+                 * Note that for line series and some other series types,
+            the `threshold`
+                 * option is set to `null` by default. This will in turn cause their y-axis
+                 * to not have a threshold. In order to avoid that,
+            set the series
+                 * `threshold` to 0 or another number.
+                 *
+                 * If `startOnTick` or `endOnTick` in the axis options are set to false,
+            or
+                 * if the axis is logarithmic,
+            the threshold will not be aligned.
+                 *
+                 * @sample {highcharts} highcharts/chart/alignthresholds/ Set to true
+                 *
+                 * @since 10.0.0
+                 * @product   highcharts highstock gantt
+                 * @apioption chart.alignThresholds
+                 */
+                alignThresholds: false,
                 /**
                  * Set the overall animation for all chart updating. Animation can be
                  * disabled throughout the chart by setting it to false here. It can
@@ -3078,9 +3091,10 @@
              *         Y
              * @sample {highstock} stock/chart/zoomtype-xy/
              *         Xy
+             * @sample {highmaps} maps/chart/zoomtype-xy/
+             *         Map with selection zoom
              *
              * @type       {string}
-             * @product    highcharts highstock gantt
              * @validvalue ["x", "y", "xy"]
              * @apioption  chart.zoomType
              */
@@ -3882,7 +3896,8 @@
                     // time
                     if (unit === 'Milliseconds' ||
                         unit === 'Seconds' ||
-                        (unit === 'Minutes' && this.getTimezoneOffset(date) % 3600000 === 0) // #13961
+                        (unit === 'Minutes' &&
+                            this.getTimezoneOffset(date) % 3600000 === 0) // #13961
                     ) {
                         return date['setUTC' + unit](value);
                     }
@@ -3899,8 +3914,8 @@
                 }
                 // UTC time with no timezone handling
                 if (this.useUTC ||
-                    (hasNewSafariBug && unit === 'FullYear') // leap calculation in UTC only
-                ) {
+                    // leap calculation in UTC only
+                    (hasNewSafariBug && unit === 'FullYear')) {
                     return date['setUTC' + unit](value);
                 }
                 // Else, local time
@@ -3916,7 +3931,6 @@
              *
              * @param {Highcharts.TimeOptions} options
              *
-             * @return {void}
              */
             Time.prototype.update = function (options) {
                 var useUTC = pick(options && options.useUTC,
@@ -4005,6 +4019,7 @@
             Time.prototype.timezoneOffsetFunction = function () {
                 var time = this,
                     options = this.options,
+                    getTimezoneOffset = options.getTimezoneOffset,
                     moment = options.moment || win.moment;
                 if (!this.useUTC) {
                     return function (timestamp) {
@@ -4024,9 +4039,9 @@
                     }
                 }
                 // If not timezone is set, look for the getTimezoneOffset callback
-                if (this.useUTC && options.getTimezoneOffset) {
+                if (this.useUTC && getTimezoneOffset) {
                     return function (timestamp) {
-                        return options.getTimezoneOffset(timestamp.valueOf()) * 60000;
+                        return getTimezoneOffset(timestamp.valueOf()) * 60000;
                     };
                 }
                 // Last, use the `timezoneOffset` option if set
@@ -4160,8 +4175,10 @@
              * Resolve legacy formats of dateTimeLabelFormats (strings and arrays) into
              * an object.
              * @private
-             * @param {string|Array<T>|Highcharts.Dictionary<T>} f - General format description
-             * @return {Highcharts.Dictionary<T>} - The object definition
+             * @param {string|Array<T>|Highcharts.Dictionary<T>} f
+             * General format description
+             * @return {Highcharts.Dictionary<T>}
+             * The object definition
              */
             Time.prototype.resolveDTLFormat = function (f) {
                 if (!isObject(f, true)) { // check for string or array
@@ -4193,6 +4210,7 @@
              * @param {number} [startOfWeek=1]
              *
              * @return {Highcharts.AxisTickPositionsArray}
+             * Time positions
              */
             Time.prototype.getTimeTicks = function (normalizedInterval, min, max, startOfWeek) {
                 var time = this,
@@ -4462,8 +4480,8 @@
          * In case of loading the library from a `script` tag,
          * this option is not needed, it will be loaded from there by default.
          *
-         * @type {function}
-         * @since 8.2.0
+         * @type      {Function}
+         * @since     8.2.0
          * @apioption time.moment
          */
         ''; // keeps doclets above in JS file
@@ -6738,6 +6756,8 @@
                  *
                  * @sample {highcharts} highcharts/tooltip/pointformat/
                  *         A different point format with value suffix
+                 * @sample {highcharts|highstock} highcharts/tooltip/pointformat-extra-information/
+                 *         Show extra information about points in the tooltip
                  * @sample {highmaps} maps/tooltip/format/
                  *         Format demo
                  *
@@ -6982,6 +7002,7 @@
          * @function Highcharts.getOptions
          *
          * @return {Highcharts.Options}
+         * Default options.
          */
         function getOptions() {
             return defaultOptions;
@@ -6996,10 +7017,10 @@
          * @function Highcharts.setOptions
          *
          * @param {Highcharts.Options} options
-         *        The new custom chart options.
+         * The new custom chart options.
          *
          * @return {Highcharts.Options}
-         *         Updated options.
+         * Updated options.
          */
         function setOptions(options) {
             // Copy in the default options
@@ -7274,7 +7295,6 @@
              *
              * @function Highcharts.Fx#dSetter
              *
-             * @return {void}
              */
             Fx.prototype.dSetter = function () {
                 var paths = this.paths,
@@ -7323,7 +7343,6 @@
              *
              * @function Highcharts.Fx#update
              *
-             * @return {void}
              */
             Fx.prototype.update = function () {
                 var elem = this.elem,
@@ -7362,7 +7381,6 @@
              * @param {string} unit
              *        The property unit, for example `px`.
              *
-             * @return {void}
              */
             Fx.prototype.run = function (from, to, unit) {
                 var self = this,
@@ -7384,7 +7402,8 @@
                 };
                 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);
                     }
                 }
@@ -7443,7 +7462,8 @@
                 }
                 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;
                 }
@@ -7485,9 +7505,6 @@
                 /**
                  * 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) {
@@ -7523,9 +7540,6 @@
                 /**
                  * 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) {
@@ -7597,7 +7611,6 @@
              *
              * @function Highcharts.Fx#fillSetter
              *
-             * @return {void}
              */
             Fx.prototype.fillSetter = function () {
                 Fx.prototype.strokeSetter.apply(this, arguments);
@@ -7607,10 +7620,9 @@
              *
              * @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);
             };
             /* *
              *
@@ -7853,23 +7865,35 @@
          *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
          *
          * */
-        var SVG_NS = H.SVG_NS;
+        var SVG_NS = H.SVG_NS,
+            win = H.win;
         var attr = U.attr,
             createElement = U.createElement,
-            discardElement = U.discardElement,
+            css = U.css,
             error = U.error,
+            isFunction = U.isFunction,
             isString = U.isString,
             objectEach = U.objectEach,
             splat = U.splat;
+        var trustedTypes = win.trustedTypes;
         /* *
          *
          *  Constants
          *
          * */
+        // Create the trusted type policy. This should not be exposed.
+        var trustedTypesPolicy = (trustedTypes &&
+                isFunction(trustedTypes.createPolicy) &&
+                trustedTypes.createPolicy('highcharts', {
+                    createHTML: function (s) { return s; }
+                }));
+        var emptyHTML = trustedTypesPolicy ?
+                trustedTypesPolicy.createHTML('') :
+                '';
         // In IE8, DOMParser is undefined. IE9 and PhantomJS are only able to parse XML.
         var hasValidDOMParser = (function () {
                 try {
-                    return Boolean(new DOMParser().parseFromString('', 'text/html'));
+                    return Boolean(new DOMParser().parseFromString(emptyHTML, 'text/html'));
             }
             catch (e) {
                 return false;
@@ -7936,6 +7960,19 @@
                 });
                 return attributes;
             };
+            AST.parseStyle = function (style) {
+                return style
+                    .split(';')
+                    .reduce(function (styles, line) {
+                    var pair = line.split(':').map(function (s) { return s.trim(); }),
+                        key = pair[0].replace(/-([a-z])/g,
+                        function (g) { return g[1].toUpperCase(); });
+                    if (pair[1]) {
+                        styles[key] = pair[1];
+                    }
+                    return styles;
+                }, {});
+            };
             /**
              * Utility function to set html content for an element by passing in a
              * markup string. The markup is safely parsed by the AST class to avoid
@@ -7952,7 +7989,7 @@
              * Markup string
              */
             AST.setElementHTML = function (el, html) {
-                el.innerHTML = ''; // Clear previous
+                el.innerHTML = AST.emptyHTML; // Clear previous
                 if (html) {
                     var ast = new AST(html);
                     ast.addToDOM(el);
@@ -7977,9 +8014,12 @@
             AST.prototype.addToDOM = function (parent) {
                 /**
                  * @private
-                 * @param {Highcharts.ASTNode} subtree - HTML/SVG definition
-                 * @param {Element} [subParent] - parent node
-                 * @return {Highcharts.SVGDOMElement|Highcharts.HTMLDOMElement} The inserted node.
+                 * @param {Highcharts.ASTNode} subtree
+                 * HTML/SVG definition
+                 * @param {Element} [subParent]
+                 * parent node
+                 * @return {Highcharts.SVGDOMElement|Highcharts.HTMLDOMElement}
+                 * The inserted node.
                  */
                 function recurse(subtree, subParent) {
                     var ret;
@@ -7988,12 +8028,15 @@
                         var textNode = item.textContent ?
                                 H.doc.createTextNode(item.textContent) :
                                 void 0;
+                        // Whether to ignore the AST filtering totally, #15345
+                        var bypassHTMLFiltering = AST.bypassHTMLFiltering;
                         var node;
                         if (tagName) {
                             if (tagName === '#text') {
                                 node = textNode;
                             }
-                            else if (AST.allowedTags.indexOf(tagName) !== -1) {
+                            else if (AST.allowedTags.indexOf(tagName) !== -1 ||
+                                bypassHTMLFiltering) {
                                 var NS = tagName === 'svg' ?
                                         SVG_NS :
                                         (subParent.namespaceURI || SVG_NS);
@@ -8006,11 +8049,17 @@
                                     if (key !== 'tagName' &&
                                         key !== 'attributes' &&
                                         key !== 'children' &&
+                                        key !== 'style' &&
                                         key !== 'textContent') {
                                         attributes_1[key] = val;
                                     }
                                 });
-                                attr(element, AST.filterUserAttributes(attributes_1));
+                                attr(element, bypassHTMLFiltering ?
+                                    attributes_1 :
+                                    AST.filterUserAttributes(attributes_1));
+                                if (item.style) {
+                                    css(element, item.style);
+                                }
                                 // Add text content
                                 if (textNode) {
                                     element.appendChild(textNode);
@@ -8020,7 +8069,8 @@
                                 node = element;
                             }
                             else {
-                                error("Highcharts warning: Invalid tagName '" + tagName + "' in config");
+                                error('Highcharts warning: Invalid tagName ' +
+                                    tagName + ' in config');
                             }
                         }
                         // Add to the tree
@@ -8048,14 +8098,19 @@
              */
             AST.prototype.parseMarkup = function (markup) {
                 var nodes = [];
-                markup = markup.trim();
+                markup = markup
+                    .trim()
+                    // The style attribute throws a warning when parsing when CSP is
+                    // enabled (#6884), so use an alias and pick it up below
+                    .replace(/ style="/g, ' data-style="');
                 var doc;
-                var body;
                 if (hasValidDOMParser) {
-                    doc = new DOMParser().parseFromString(markup, 'text/html');
+                    doc = new DOMParser().parseFromString(trustedTypesPolicy ?
+                        trustedTypesPolicy.createHTML(markup) :
+                        markup, 'text/html');
                 }
                 else {
-                    body = createElement('div');
+                    var body = createElement('div');
                     body.innerHTML = markup;
                     doc = { body: body };
                 }
@@ -8074,7 +8129,12 @@
                     if (parsedAttributes) {
                         var attributes_2 = {};
                         [].forEach.call(parsedAttributes, function (attrib) {
-                            attributes_2[attrib.name] = attrib.value;
+                            if (attrib.name === 'data-style') {
+                                astNode.style = AST.parseStyle(attrib.value);
+                            }
+                            else {
+                                attributes_2[attrib.name] = attrib.value;
+                            }
                         });
                         astNode.attributes = attributes_2;
                     }
@@ -8091,9 +8151,6 @@
                     addTo.push(astNode);
                 };
                 [].forEach.call(doc.body.childNodes, function (childNode) { return appendChildNodes(childNode, nodes); });
-                if (body) {
-                    discardElement(body);
-                }
                 return nodes;
             };
             /* *
@@ -8280,6 +8337,35 @@
                 'ul',
                 '#text'
             ];
+            AST.emptyHTML = emptyHTML;
+            /**
+             * Allow all custom SVG and HTML attributes, references and tags (together
+             * with potentially harmful ones) to be added to the DOM from the chart
+             * configuration. In other words, disable the the allow-listing which is the
+             * primary functionality of the AST.
+             *
+             * WARNING: Setting this property to `true` while allowing untrusted user
+             * data in the chart configuration will expose your application to XSS
+             * security risks!
+             *
+             * Note that in case you want to allow a known set of tags or attributes,
+             * you should allow-list them instead of disabling the filtering totally.
+             * See [allowedAttributes](Highcharts.AST#.allowedAttributes),
+             * [allowedReferences](Highcharts.AST#.allowedReferences) and
+             * [allowedTags](Highcharts.AST#.allowedTags). The `bypassHTMLFiltering`
+             * setting is intended only for those cases where allow-listing is not
+             * practical, and the chart configuration already comes from a secure
+             * source.
+             *
+             * @example
+             * // Allow all custom attributes, references and tags (disable DOM XSS
+             * // filtering)
+             * Highcharts.AST.bypassHTMLFiltering = true;
+             *
+             * @name Highcharts.AST.bypassHTMLFiltering
+             * @static
+             */
+            AST.bypassHTMLFiltering = false;
             return AST;
         }());
         /* *
@@ -8615,7 +8701,8 @@
              * @private
              */
             function distribute(boxes, len, maxDistance) {
-                var origBoxes = boxes, // Original array will be altered with added .pos
+                // Original array will be altered with added .pos
+                var origBoxes = boxes,
                     reducedLen = origBoxes.reducedLen || len,
                     sortByRank = function (a,
                     b) {
@@ -8870,7 +8957,6 @@
              *
              * @param {Highcharts.SVGDOMElement} element
              *
-             * @return {void}
              */
             SVGElement.prototype._defaultSetter = function (value, key, element) {
                 element.setAttribute(key, value);
@@ -9023,7 +9109,8 @@
                     alignByTranslate = this.alignByTranslate;
                     alignTo = this.alignTo;
                 }
-                box = pick(box, renderer[alignTo], alignTo === 'scrollablePlotBox' ? renderer.plotBox : void 0, renderer);
+                box = pick(box, renderer[alignTo], alignTo === 'scrollablePlotBox' ?
+                    renderer.plotBox : void 0, renderer);
                 // Assign variables
                 var align = alignOptions.align,
                     vAlign = alignOptions.verticalAlign;
@@ -9122,7 +9209,7 @@
                     }, deferTime);
                 }
                 else {
-                    this.attr(params, void 0, complete);
+                    this.attr(params, void 0, complete || animOptions.complete);
                     // Call the end step synchronously
                     objectEach(params, function (val, prop) {
                         if (animOptions.step) {
@@ -9319,7 +9406,8 @@
                             // Let the shadow follow the main element
                             if (!this.styledMode &&
                                 this.shadows &&
-                                /^(width|height|visibility|x|y|d|transform|cx|cy|r)$/.test(key)) {
+                                /^(width|height|visibility|x|y|d|transform|cx|cy|r)$/
+                                    .test(key)) {
                                 this.updateShadows(key, val, setter);
                             }
                         }
@@ -9519,25 +9607,20 @@
              *         Return the SVG element for chaining.
              */
             SVGElement.prototype.css = function (styles) {
-                var oldStyles = this.styles, newStyles = {}, elem = this.element, 
-                    // These CSS properties are interpreted internally by the SVG
-                    // renderer, but are not supported by SVG and should not be added to
-                    // the DOM. In styled mode, no CSS should find its way to the DOM
-                    // whatsoever (#6173, #6474).
-                    svgPseudoProps = ['textOutline', 'textOverflow', 'width'];
+                var oldStyles = this.styles,
+                    newStyles = {},
+                    elem = this.element;
                 var textWidth,
-                    serializedCss = '',
-                    hyphenate,
                     hasNew = !oldStyles;
                 // convert legacy
-                if (styles && styles.color) {
+                if (styles.color) {
                     styles.fill = styles.color;
                 }
                 // Filter out existing styles to increase performance (#2640)
                 if (oldStyles) {
-                    objectEach(styles, function (style, n) {
-                        if (oldStyles && oldStyles[n] !== style) {
-                            newStyles[n] = style;
+                    objectEach(styles, function (value, n) {
+                        if (oldStyles && oldStyles[n] !== value) {
+                            newStyles[n] = value;
                             hasNew = true;
                         }
                     });
@@ -9548,41 +9631,30 @@
                         styles = extend(oldStyles, newStyles);
                     }
                     // Get the text width from style
-                    if (styles) {
-                        // Previously set, unset it (#8234)
-                        if (styles.width === null || styles.width === 'auto') {
-                            delete this.textWidth;
-                            // Apply new
-                        }
-                        else if (elem.nodeName.toLowerCase() === 'text' &&
-                            styles.width) {
-                            textWidth = this.textWidth = pInt(styles.width);
-                        }
+                    // Previously set, unset it (#8234)
+                    if (styles.width === null || styles.width === 'auto') {
+                        delete this.textWidth;
+                        // Apply new
+                    }
+                    else if (elem.nodeName.toLowerCase() === 'text' &&
+                        styles.width) {
+                        textWidth = this.textWidth = pInt(styles.width);
                     }
                     // store object
                     this.styles = styles;
                     if (textWidth && (!svg && this.renderer.forExport)) {
                         delete styles.width;
                     }
-                    // Serialize and set style attribute
-                    if (elem.namespaceURI === this.SVG_NS) { // #7633
-                        hyphenate = function (a, b) {
-                            return '-' + b.toLowerCase();
-                        };
-                        objectEach(styles, function (style, n) {
-                            if (svgPseudoProps.indexOf(n) === -1) {
-                                serializedCss +=
-                                    n.replace(/([A-Z])/g, hyphenate) + ':' +
-                                        style + ';';
-                            }
-                        });
-                        if (serializedCss) {
-                            attr(elem, 'style', serializedCss); // #1881
-                        }
-                    }
-                    else {
-                        css(elem, styles);
+                    var stylesToApply_1 = merge(styles);
+                    if (elem.namespaceURI === this.SVG_NS) {
+                        // These CSS properties are interpreted internally by the SVG
+                        // renderer, but are not supported by SVG and should not be
+                        // added to the DOM. In styled mode, no CSS should find its way
+                        // to the DOM whatsoever (#6173, #6474).
+                        ['textOutline', 'textOverflow', 'width'].forEach(function (key) { return (stylesToApply_1 &&
+                            delete stylesToApply_1[key]); });
                     }
+                    css(elem, stylesToApply_1);
                     if (this.added) {
                         // Rebuild text after added. Cache mechanisms in the buildText
                         // will prevent building if there are no significant changes.
@@ -9590,7 +9662,7 @@
                             this.renderer.buildText(this);
                         }
                         // Apply text outline after added
-                        if (styles && styles.textOutline) {
+                        if (styles.textOutline) {
                             this.applyTextOutline(styles.textOutline);
                         }
                     }
@@ -9708,7 +9780,6 @@
              * @private
              * @function Highcharts.SVGElement#destroyShadows
              *
-             * @return {void}
              */
             SVGElement.prototype.destroyShadows = function () {
                 (this.shadows || []).forEach(function (shadow) {
@@ -9948,8 +10019,7 @@
                             bBox.height = height = ({
                                 '11px,17': 14,
                                 '13px,20': 16
-                            }[styles &&
-                                styles.fontSize + ',' + Math.round(height)] ||
+                            }[(fontSize || '') + "," + Math.round(height)] ||
                                 height);
                         }
                         // Adjust for rotated text
@@ -10628,12 +10698,13 @@
              * @function Highcharts.SVGElement#translate
              *
              * @param {number} x
-             *        The x value.
+             * The x value.
              *
              * @param {number} y
-             *        The y value.
+             * The y value.
              *
              * @return {Highcharts.SVGElement}
+             * Translated element.
              */
             SVGElement.prototype.translate = function (x, y) {
                 return this.attr({
@@ -10727,7 +10798,6 @@
              *
              * @param {Highcharts.SVGDOMElement} element
              *
-             * @return {void}
              */
             SVGElement.prototype.visibilitySetter = function (value, key, element) {
                 // IE9-11 doesn't handle visibilty:inherit well, so we remove the
@@ -10743,10 +10813,6 @@
             /**
              * @private
              * @function Highcharts.SVGElement#xGetter
-             *
-             * @param {string} key
-             *
-             * @return {number|string|null}
              */
             SVGElement.prototype.xGetter = function (key) {
                 if (this.element.nodeName === 'circle') {
@@ -10762,9 +10828,6 @@
             /**
              * @private
              * @function Highcharts.SVGElement#zIndexSetter
-             * @param {number} [value]
-             * @param {string} [key]
-             * @return {boolean}
              */
             SVGElement.prototype.zIndexSetter = function (value, key) {
                 var renderer = this.renderer,
@@ -11249,7 +11312,8 @@
                         }
                     });
                     this.text.css(textStyles_1);
-                    var isWidth = 'width' in textStyles_1, isFontStyle = ('fontSize' in textStyles_1 || 'fontWeight' in textStyles_1);
+                    var isWidth = 'width' in textStyles_1, isFontStyle = ('fontSize' in textStyles_1 ||
+                            'fontWeight' in textStyles_1);
                     // Update existing text, box (#9400, #12163)
                     if (isFontStyle) {
                         this.updateTextPadding();
@@ -11419,13 +11483,15 @@
                                 this.renderer.symbol(this.symbolKey) :
                                 this.renderer.rect();
                         box.addClass(// Don't use label className for buttons
-                        (this.className === 'button' ? '' : 'highcharts-label-box') +
-                            (this.className ? ' highcharts-' + this.className + '-box' : ''));
+                        (this.className === 'button' ?
+                            '' : 'highcharts-label-box') +
+                            (this.className ?
+                                ' highcharts-' + this.className + '-box' : ''));
                         box.add(this);
                     }
                     crispAdjust = this.getCrispAdjust();
                     attribs.x = crispAdjust;
-                    attribs.y = (this.baseline ? -this.baselineOffset : 0) + crispAdjust;
+                    attribs.y = ((this.baseline ? -this.baselineOffset : 0) + crispAdjust);
                     // Apply the box attributes
                     attribs.width = Math.round(this.width);
                     attribs.height = Math.round(this.height);
@@ -11448,8 +11514,7 @@
                 if (defined(this.widthSetting) &&
                     this.bBox &&
                     (this.textAlign === 'center' || this.textAlign === 'right')) {
-                    textX += { center: 0.5, right: 1 }[this.textAlign] *
-                        (this.widthSetting - this.bBox.width);
+                    textX += { center: 0.5, right: 1 }[this.textAlign] * (this.widthSetting - this.bBox.width);
                 }
                 // update if anything changed
                 if (textX !== text.x || textY !== text.y) {
@@ -11477,7 +11542,9 @@
                     padding);
                 var paddingRight = pick(this.paddingRight,
                     padding);
-                return (this.widthSetting || this.bBox.width || 0) + paddingLeft + paddingRight;
+                return ((this.widthSetting || this.bBox.width || 0) +
+                    paddingLeft +
+                    paddingRight);
             };
             SVGLabel.prototype.xSetter = function (value) {
                 this.x = value; // for animation getter
@@ -11498,7 +11565,12 @@
              *  Static Properties
              *
              * */
-            SVGLabel.emptyBBox = { width: 0, height: 0, x: 0, y: 0 };
+            SVGLabel.emptyBBox = {
+                width: 0,
+                height: 0,
+                x: 0,
+                y: 0
+            };
             /**
              * For labels, these CSS properties are applied to the `text` node directly.
              *
@@ -11759,6 +11831,7 @@
             SVG_NS = H.SVG_NS,
             win = H.win;
         var attr = U.attr,
+            extend = U.extend,
             isString = U.isString,
             objectEach = U.objectEach,
             pick = U.pick;
@@ -11861,7 +11934,6 @@
              *
              * @private
              *
-             * @return {void}
              */
             TextBuilder.prototype.modifyDOM = function () {
                 var _this = this;
@@ -12005,7 +12077,7 @@
             TextBuilder.prototype.getLineHeight = function (node) {
                 var fontSizeStyle;
                 // If the node is a text node, use its parent
-                var element = node.nodeType === win.Node.TEXT_NODE ?
+                var element = (node.nodeType === win.Node.TEXT_NODE) ?
                         node.parentElement :
                         node;
                 if (!this.renderer.styledMode) {
@@ -12027,36 +12099,42 @@
              *
              * @param {ASTNode[]} nodes The AST nodes
              *
-             * @return {void}
              */
             TextBuilder.prototype.modifyTree = function (nodes) {
                 var _this = this;
                 var modifyChild = function (node,
                     i) {
-                        var tagName = node.tagName;
-                    var styledMode = _this.renderer.styledMode;
-                    var attributes = node.attributes || {};
+                        var _a = node.attributes,
+                    attributes = _a === void 0 ? {} : _a,
+                    children = node.children,
+                    _b = node.style,
+                    style = _b === void 0 ? {} : _b,
+                    tagName = node.tagName,
+                    styledMode = _this.renderer.styledMode;
                     // Apply styling to text tags
                     if (tagName === 'b' || tagName === 'strong') {
                         if (styledMode) {
-                            attributes['class'] = 'highcharts-strong'; // eslint-disable-line dot-notation
+                            // eslint-disable-next-line dot-notation
+                            attributes['class'] = 'highcharts-strong';
                         }
                         else {
-                            attributes.style = 'font-weight:bold;' + (attributes.style || '');
+                            style.fontWeight = 'bold';
                         }
                     }
                     else if (tagName === 'i' || tagName === 'em') {
                         if (styledMode) {
-                            attributes['class'] = 'highcharts-emphasized'; // eslint-disable-line dot-notation
+                            // eslint-disable-next-line dot-notation
+                            attributes['class'] = 'highcharts-emphasized';
                         }
                         else {
-                            attributes.style = 'font-style:italic;' + (attributes.style || '');
+                            style.fontStyle = 'italic';
                         }
                     }
-                    // Modify attributes
-                    if (isString(attributes.style)) {
-                        attributes.style = attributes.style.replace(/(;| |^)color([ :])/, '$1fill$2');
+                    // Modify styling
+                    if (style && style.color) {
+                        style.fill = style.color;
                     }
+                    // Handle breaks
                     if (tagName === 'br') {
                         attributes['class'] = 'highcharts-br'; // eslint-disable-line dot-notation
                         node.textContent = '\u200B'; // zero-width space
@@ -12066,14 +12144,23 @@
                             nextNode.textContent =
                                 nextNode.textContent.replace(/^ +/gm, '');
                         }
+                        // If an anchor has direct text node children, the text is unable to
+                        // wrap because there is no `getSubStringLength` function on the
+                        // element. Therefore we need to wrap the child text node or nodes
+                        // in a tspan. #16173.
+                    }
+                    else if (tagName === 'a' &&
+                        children &&
+                        children.some(function (child) { return child.tagName === '#text'; })) {
+                        node.children = [{ children: children, tagName: 'tspan' }];
                     }
                     if (tagName !== '#text' && tagName !== 'a') {
                         node.tagName = 'tspan';
                     }
-                    node.attributes = attributes;
+                    extend(node, { attributes: attributes, style: style });
                     // Recurse
-                    if (node.children) {
-                        node.children
+                    if (children) {
+                        children
                             .filter(function (c) { return c.tagName !== '#text'; })
                             .forEach(modifyChild);
                     }
@@ -12410,7 +12497,7 @@
                 this.url = this.getReferenceURL();
                 // Add description
                 var desc = this.createElement('desc').add();
-                desc.element.appendChild(doc.createTextNode('Created with Highcharts 9.3.1'));
+                desc.element.appendChild(doc.createTextNode('Created with Highcharts 10.0.0'));
                 renderer.defs = this.createElement('defs').add();
                 renderer.allowHTML = allowHTML;
                 renderer.forExport = forExport;
@@ -12602,6 +12689,7 @@
              * @function Highcharts.SVGRenderer#destroy
              *
              * @return {null}
+             * Pass through value.
              */
             SVGRenderer.prototype.destroy = function () {
                 var renderer = this,
@@ -12749,14 +12837,20 @@
                     // Make a copy of normalState (#13798)
                     // (reference to options.rangeSelector.buttonTheme)
                     normalState = theme ? merge(theme) : {};
-                var userNormalStyle = normalState && normalState.style || {};
+                var normalStyle = merge({
+                        color: "#333333" /* neutralColor80 */,
+                        cursor: 'pointer',
+                        fontWeight: 'normal'
+                    },
+                    normalState.style);
+                delete normalState.style;
                 // Remove stylable attributes
                 normalState = AST.filterUserAttributes(normalState);
                 // Default, non-stylable attributes
                 label.attr(merge({ padding: 8, r: 2 }, normalState));
-                // Presentational
-                var normalStyle,
-                    hoverStyle,
+                // Presentational. The string type is a mistake, it is just for
+                // compliance with SVGAttribute and is not used in button theme.
+                var hoverStyle,
                     pressedStyle,
                     disabledStyle;
                 if (!styledMode) {
@@ -12764,17 +12858,8 @@
                     normalState = merge({
                         fill: "#f7f7f7" /* neutralColor3 */,
                         stroke: "#cccccc" /* neutralColor20 */,
-                        'stroke-width': 1,
-                        style: {
-                            color: "#333333" /* neutralColor80 */,
-                            cursor: 'pointer',
-                            fontWeight: 'normal'
-                        }
-                    }, {
-                        style: userNormalStyle
+                        'stroke-width': 1
                     }, normalState);
-                    normalStyle = normalState.style;
-                    delete normalState.style;
                     // Hover state
                     hoverState = merge(normalState, {
                         fill: "#e6e6e6" /* neutralColor10 */
@@ -12829,13 +12914,16 @@
                             hoverState,
                             pressedState,
                             disabledState
-                        ][state || 0])
-                            .css([
-                            normalStyle,
-                            hoverStyle,
-                            pressedStyle,
-                            disabledStyle
                         ][state || 0]);
+                        var css_1 = [
+                                normalStyle,
+                                hoverStyle,
+                                pressedStyle,
+                                disabledStyle
+                            ][state || 0];
+                        if (isObject(css_1)) {
+                            label.css(css_1);
+                        }
                     }
                 };
                 // Presentational attributes
@@ -13278,6 +13366,7 @@
              * Additional options, depending on the actual symbol drawn.
              *
              * @return {Highcharts.SVGElement}
+             * SVG symbol.
              */
             SVGRenderer.prototype.symbol = function (symbol, x, y, width, height, options) {
                 var ren = this,
@@ -13507,8 +13596,8 @@
                             parentVal = element.getAttribute(key);
                         for (var i = 0, tspan = void 0; i < tspans.length; i++) {
                             tspan = tspans[i];
-                            // If the x values are equal, the tspan represents a
-                            // linebreak
+                            // If the x values are equal, the tspan represents a line
+                            // break
                             if (tspan.getAttribute(key) === parentVal) {
                                 tspan.setAttribute(key, value);
                             }
@@ -13572,14 +13661,6 @@
              *
              * @private
              * @function Highcharts.SVGRenderer#rotCorr
-             *
-             * @param {number} baseline
-             *
-             * @param {number} rotation
-             *
-             * @param {boolean} [alterY]
-             *
-             * @param {Highcharts.PositionObject}
              */
             SVGRenderer.prototype.rotCorr = function (baseline, rotation, alterY) {
                 var y = baseline;
@@ -13883,7 +13964,6 @@
              *
              * @private
              * @function Highcharts.SVGRenderer#alignElements
-             * @return {void}
              */
             SVGRenderer.prototype.alignElements = function () {
                 this.alignedObjects.forEach(function (el) { return el.align(); });
@@ -14213,10 +14293,12 @@
                     HTMLElement.composedClasses.push(SVGElementClass);
                     var htmlElementProto = HTMLElement.prototype,
                         svgElementProto = SVGElementClass.prototype;
-                    svgElementProto.getSpanCorrection = htmlElementProto.getSpanCorrection;
+                    svgElementProto.getSpanCorrection = htmlElementProto
+                        .getSpanCorrection;
                     svgElementProto.htmlCss = htmlElementProto.htmlCss;
                     svgElementProto.htmlGetBBox = htmlElementProto.htmlGetBBox;
-                    svgElementProto.htmlUpdateTransform = htmlElementProto.htmlUpdateTransform;
+                    svgElementProto.htmlUpdateTransform = htmlElementProto
+                        .htmlUpdateTransform;
                     svgElementProto.setSpanRotation = htmlElementProto.setSpanRotation;
                 }
                 return SVGElementClass;
@@ -14510,15 +14592,16 @@
              * @function Highcharts.SVGRenderer#html
              *
              * @param {string} str
-             *        The text of (subset) HTML to draw.
+             * The text of (subset) HTML to draw.
              *
              * @param {number} x
-             *        The x position of the text's lower left corner.
+             * The x position of the text's lower left corner.
              *
              * @param {number} y
-             *        The y position of the text's lower left corner.
+             * The y position of the text's lower left corner.
              *
              * @return {Highcharts.HTMLDOMElement}
+             * HTML element.
              */
             HTMLRenderer.prototype.html = function (str, x, y) {
                 var wrapper = this.createElement('span'), element = wrapper.element, renderer = wrapper.renderer, isSVG = renderer.isSVG, addSetters = function (gWrapper, style) {
@@ -14628,8 +14711,7 @@
                                      * @private
                                      * @param {*} value
                                      * @param {string} key
-                                     * @return {void}
-                                     */
+                                                             */
                                     function translateSetter(value, key) {
                                         parentGroup[key] = value;
                                         if (key === 'translateX') {
@@ -14652,7 +14734,9 @@
                                                 display: parentGroup.display,
                                                 opacity: parentGroup.opacity,
                                                 cursor: parentGroupStyles.cursor,
-                                                pointerEvents: parentGroupStyles.pointerEvents,
+                                                pointerEvents: (
+                                                // #5595
+                                                parentGroupStyles.pointerEvents),
                                                 visibility: parentGroup.visibility
                                                 // the top group is appended to container
                                             }, htmlGroup || container);
@@ -17764,7 +17848,7 @@
          * @param {boolean} [noLabel=false]
          * Whether to disable the label or not. Defaults to false.
          *
-         * @param {object} [parameters]
+         * @param {Object} [parameters]
          * Optional parameters for the tick.
          */
         var Tick = /** @class */ (function () {
@@ -18018,7 +18102,7 @@
              * @return {Highcharts.PositionObject}
              * The tick position.
              *
-             * @fires Highcharts.Tick#event:afterGetPosition
+             * @emits Highcharts.Tick#event:afterGetPosition
              */
             Tick.prototype.getPosition = function (horiz, tickPos, tickmarkOffset, old) {
                 var axis = this.axis,
@@ -18058,9 +18142,7 @@
             };
             /**
              * Get the x, y position of the tick label
-             *
              * @private
-             * @return {Highcharts.PositionObject}
              */
             Tick.prototype.getLabelPosition = function (x, y, label, horiz, labelOptions, tickmarkOffset, index, step) {
                 var axis = this.axis,
@@ -18643,7 +18725,6 @@
                 function Axis(chart, userOptions) {
                     this.alternateBands = void 0;
                 this.bottom = void 0;
-                this.categories = void 0;
                 this.chart = void 0;
                 this.closestPointRange = void 0;
                 this.coll = void 0;
@@ -18710,8 +18791,8 @@
              * @param {AxisOptions} userOptions
              * Axis options.
              *
-             * @fires Highcharts.Axis#event:afterInit
-             * @fires Highcharts.Axis#event:init
+             * @emits Highcharts.Axis#event:afterInit
+             * @emits Highcharts.Axis#event:init
              */
             Axis.prototype.init = function (chart, userOptions) {
                 var isXAxis = userOptions.isX,
@@ -18747,7 +18828,8 @@
                  */
                 axis.coll = axis.coll || (isXAxis ? 'xAxis' : 'yAxis');
                 fireEvent(this, 'init', { userOptions: userOptions });
-                axis.opposite = pick(userOptions.opposite, axis.opposite); // needed in setOptions
+                // Needed in setOptions
+                axis.opposite = pick(userOptions.opposite, axis.opposite);
                 /**
                  * The side on which the axis is rendered. 0 is top, 1 is right, 2
                  * is bottom and 3 is left.
@@ -18806,7 +18888,7 @@
                  * @type {Array<string>}
                  * @readonly
                  */
-                axis.categories = options.categories || axis.hasNames;
+                axis.categories = options.categories || (axis.hasNames ? [] : void 0);
                 if (!axis.names) { // Preserve on update (#3830)
                     axis.names = [];
                     axis.names.keys = {};
@@ -18912,7 +18994,7 @@
              * @param {Highcharts.AxisOptions} userOptions
              * Axis options.
              *
-             * @fires Highcharts.Axis#event:afterSetOptions
+             * @emits Highcharts.Axis#event:afterSetOptions
              */
             Axis.prototype.setOptions = function (userOptions) {
                 this.options = merge(AxisDefaults.defaultXAxisOptions, (this.coll === 'yAxis') && AxisDefaults.defaultYAxisOptions, [
@@ -19005,8 +19087,8 @@
              * @private
              * @function Highcharts.Axis#getSeriesExtremes
              *
-             * @fires Highcharts.Axis#event:afterGetSeriesExtremes
-             * @fires Highcharts.Axis#event:getSeriesExtremes
+             * @emits Highcharts.Axis#event:afterGetSeriesExtremes
+             * @emits Highcharts.Axis#event:getSeriesExtremes
              */
             Axis.prototype.getSeriesExtremes = function () {
                 var axis = this,
@@ -19104,26 +19186,6 @@
              *
              * @private
              * @function Highcharts.Axis#translate
-             *
-             * @param {number} val
-             * TO-DO: parameter description
-             *
-             * @param {boolean|null} [backwards]
-             * TO-DO: parameter description
-             *
-             * @param {boolean|null} [cvsCoord]
-             * TO-DO: parameter description
-             *
-             * @param {boolean|null} [old]
-             * TO-DO: parameter description
-             *
-             * @param {boolean} [handleLog]
-             * TO-DO: parameter description
-             *
-             * @param {number} [pointPlacement]
-             * TO-DO: parameter description
-             *
-             * @return {number|undefined}
              */
             Axis.prototype.translate = function (val, backwards, cvsCoord, old, handleLog, pointPlacement) {
                 var axis = (this.linkedParent || this), // #1417
@@ -19165,8 +19227,9 @@
                     if (doPostTranslate) { // log, ordinal and broken axis
                         val = axis.val2lin(val);
                     }
+                    var value = sign * (val - localMin) * localA;
                     returnValue = isNumber(localMin) ?
-                        (sign * (val - localMin) * localA +
+                        ((!axis.isRadial ? correctFloat(value) : value) +
                             cvsOffset +
                             (sign * minPixelPadding) +
                             (isNumber(pointPlacement) ?
@@ -19357,6 +19420,7 @@
              * @function Highcharts.Axis#getMinorTickInterval
              *
              * @return {number|"auto"|null}
+             * Legacy option
              */
             Axis.prototype.getMinorTickInterval = function () {
                 var options = this.options;
@@ -19466,7 +19530,8 @@
                             if (xData.length > 1) {
                                 for (i = loopLength; i > 0; i--) {
                                     distance = xData[i] - xData[i - 1];
-                                    if (!closestDataRange || distance < closestDataRange) {
+                                    if (!closestDataRange ||
+                                        distance < closestDataRange) {
                                         closestDataRange = distance;
                                     }
                                 }
@@ -19521,8 +19586,6 @@
              *
              * @private
              * @function Highcharts.Axis#getClosest
-             *
-             * @return {number}
              */
             Axis.prototype.getClosest = function () {
                 var ret;
@@ -19560,20 +19623,20 @@
              * The X value that the point is given.
              */
             Axis.prototype.nameToX = function (point) {
-                var explicitCategories = isArray(this.categories),
+                var explicitCategories = isArray(this.options.categories),
                     names = explicitCategories ? this.categories : this.names;
                 var nameX = point.options.x,
                     x;
                 point.series.requireSorting = false;
                 if (!defined(nameX)) {
-                    nameX = this.options.uniqueNames ?
+                    nameX = this.options.uniqueNames && names ?
                         (explicitCategories ?
                             names.indexOf(point.name) :
                             pick(names.keys[point.name], -1)) :
                         point.series.autoIncrement();
                 }
                 if (nameX === -1) { // Not found in currenct categories
-                    if (!explicitCategories) {
+                    if (!explicitCategories && names) {
                         x = names.length;
                     }
                 }
@@ -19641,7 +19704,7 @@
              * @private
              * @function Highcharts.Axis#setAxisTranslation
              *
-             * @fires Highcharts.Axis#event:afterSetAxisTranslation
+             * @emits Highcharts.Axis#event:afterSetAxisTranslation
              */
             Axis.prototype.setAxisTranslation = function () {
                 var axis = this,
@@ -19677,7 +19740,9 @@
                             if (!axis.single || hasCategories) {
                                 // TODO: series should internally set x- and y-
                                 // pointPlacement to simplify this logic.
-                                var isPointPlacementAxis = series.is('xrange') ? !isXAxis : isXAxis;
+                                var isPointPlacementAxis = series.is('xrange') ?
+                                        !isXAxis :
+                                        isXAxis;
                                 // minPointOffset is the value padding to the left of
                                 // the axis in order to make room for points with a
                                 // pointRange, typically columns. When the
@@ -19696,7 +19761,7 @@
                         });
                     }
                     // Record minPointOffset and pointRangePadding
-                    ordinalCorrection = axis.ordinal && axis.ordinal.slope && closestPointRange ?
+                    ordinalCorrection = (axis.ordinal && axis.ordinal.slope && closestPointRange) ?
                         axis.ordinal.slope / closestPointRange :
                         1; // #988, #1853
                     axis.minPointOffset = minPointOffset =
@@ -19725,8 +19790,6 @@
             /**
              * @private
              * @function Highcharts.Axis#minFromRange
-             *
-             * @return {number|undefined}
              */
             Axis.prototype.minFromRange = function () {
                 var axis = this;
@@ -19742,7 +19805,7 @@
              * @param {boolean} secondPass
              * TO-DO: parameter description
              *
-             * @fires Highcharts.Axis#event:foundExtremes
+             * @emits Highcharts.Axis#event:foundExtremes
              */
             Axis.prototype.setTickInterval = function (secondPass) {
                 var axis = this,
@@ -19939,12 +20002,13 @@
                     // First process all series assigned to that axis.
                     axis.series.forEach(function (series) {
                         // Allows filtering out points outside the plot area.
-                        series.forceCrop = series.forceCropping && series.forceCropping();
+                        series.forceCrop = (series.forceCropping &&
+                            series.forceCropping());
                         series.processData(hasExtemesChanged_1);
                     });
-                    // Then apply grouping if needed.
-                    // The hasExtemesChanged helps to decide if the data grouping should
-                    // be skipped in the further calculations #16319.
+                    // Then apply grouping if needed. The hasExtemesChanged helps to
+                    // decide if the data grouping should be skipped in the further
+                    // calculations #16319.
                     fireEvent(this, 'postProcessData', { hasExtemesChanged: hasExtemesChanged_1 });
                 }
                 // set the translation factor used in translate function
@@ -19989,7 +20053,7 @@
              * @private
              * @function Highcharts.Axis#setTickPositions
              *
-             * @fires Highcharts.Axis#event:afterSetTickPositions
+             * @emits Highcharts.Axis#event:afterSetTickPositions
              */
             Axis.prototype.setTickPositions = function () {
                 var axis = this,
@@ -19998,8 +20062,8 @@
                     minorTickIntervalOption = this.getMinorTickInterval(),
                     hasVerticalPanning = this.hasVerticalPanning(),
                     isColorAxis = this.coll === 'colorAxis',
-                    startOnTick = (isColorAxis || !hasVerticalPanning) && options.startOnTick,
-                    endOnTick = (isColorAxis || !hasVerticalPanning) && options.endOnTick;
+                    startOnTick = ((isColorAxis || !hasVerticalPanning) && options.startOnTick),
+                    endOnTick = ((isColorAxis || !hasVerticalPanning) && options.endOnTick);
                 var tickPositions,
                     tickPositioner = options.tickPositioner;
                 // Set the tickmarkOffset
@@ -20159,39 +20223,92 @@
              */
             Axis.prototype.alignToOthers = function () {
                 var axis = this,
-                    others = // Whether there is another axis to pair with this one
-                     {},
-                    options = axis.options;
+                    alignedAxes = [this],
+                    options = axis.options,
+                    alignThresholds = (this.coll === 'yAxis' &&
+                        this.chart.options.chart.alignThresholds),
+                    thresholdAlignments = [];
                 var hasOther;
-                if (
-                // Only if alignTicks is true
-                this.chart.options.chart.alignTicks !== false &&
-                    options.alignTicks &&
+                axis.thresholdAlignment = void 0;
+                if ((
+                // Only if alignTicks or alignThresholds is true
+                (this.chart.options.chart.alignTicks !== false &&
+                    options.alignTicks) || (alignThresholds)) &&
                     // Disabled when startOnTick or endOnTick are false (#7604)
                     options.startOnTick !== false &&
                     options.endOnTick !== false &&
                     // Don't try to align ticks on a log axis, they are not evenly
                     // spaced (#6021)
                     !axis.logarithmic) {
-                    this.chart[this.coll].forEach(function (axis) {
-                        var otherOptions = axis.options, horiz = axis.horiz, key = [
-                                horiz ? otherOptions.left : otherOptions.top,
-                                otherOptions.width,
-                                otherOptions.height,
-                                otherOptions.pane
-                            ].join(',');
-                        if (axis.series.length) { // #4442
-                            if (others[key]) {
-                                hasOther = true; // #4201
-                            }
-                            else {
-                                others[key] = 1;
-                            }
+                    // Get a key identifying which pane the axis belongs to
+                    var getKey_1 = function (axis) {
+                            var horiz = axis.horiz,
+                        options = axis.options;
+                        return [
+                            horiz ? options.left : options.top,
+                            options.width,
+                            options.height,
+                            options.pane
+                        ].join(',');
+                    };
+                    var thisKey_1 = getKey_1(this);
+                    this.chart[this.coll].forEach(function (otherAxis) {
+                        var series = otherAxis.series;
+                        if (
+                        // #4442
+                        series.length &&
+                            series.some(function (s) { return s.visible; }) &&
+                            otherAxis !== axis &&
+                            getKey_1(otherAxis) === thisKey_1) {
+                            hasOther = true; // #4201
+                            alignedAxes.push(otherAxis);
+                        }
+                    });
+                }
+                if (hasOther && alignThresholds) {
+                    // Handle alignThresholds. The `thresholdAlignments` array keeps
+                    // records of where each axis in the group wants its threshold, from
+                    // 0 which is on `axis.min`, to 1 which is on `axis.max`.
+                    alignedAxes.forEach(function (otherAxis) {
+                        var threshAlign = otherAxis.getThresholdAlignment(axis);
+                        if (isNumber(threshAlign)) {
+                            thresholdAlignments.push(threshAlign);
                         }
                     });
+                    // For each of the axes in the group, record the average
+                    // `thresholdAlignment`.
+                    var thresholdAlignment_1 = thresholdAlignments.length > 1 ?
+                            thresholdAlignments.reduce(function (sum,
+                        n) { return (sum += n); }, 0) / thresholdAlignments.length :
+                            void 0;
+                    alignedAxes.forEach(function (axis) {
+                        axis.thresholdAlignment = thresholdAlignment_1;
+                    });
                 }
                 return hasOther;
             };
+            /**
+             * Where the axis wants its threshold, from 0 which is on `axis.min`, to 1 which
+             * is on `axis.max`.
+             *
+             * @private
+             * @function Highcharts.Axis#getThresholdAlignment
+             */
+            Axis.prototype.getThresholdAlignment = function (callerAxis) {
+                if (!isNumber(this.dataMin) ||
+                    (this !== callerAxis &&
+                        this.series.some(function (s) { return (s.isDirty || s.isDirtyData); }))) {
+                    this.getSeriesExtremes();
+                }
+                if (isNumber(this.threshold)) {
+                    var thresholdAlignment = clamp(((this.threshold - (this.dataMin || 0)) /
+                            ((this.dataMax || 0) - (this.dataMin || 0))), 0, 1);
+                    if (this.options.reversed) {
+                        thresholdAlignment = 1 - thresholdAlignment;
+                    }
+                    return thresholdAlignment;
+                }
+            };
             /**
              * Find the max ticks of either the x and y axis collection, and record it
              * in `this.tickAmount`.
@@ -20236,40 +20353,101 @@
              */
             Axis.prototype.adjustTickAmount = function () {
                 var axis = this,
-                    axisOptions = axis.options,
-                    tickInterval = axis.tickInterval,
+                    finalTickAmt = axis.finalTickAmt,
+                    max = axis.max,
+                    min = axis.min,
+                    options = axis.options,
                     tickPositions = axis.tickPositions,
                     tickAmount = axis.tickAmount,
-                    finalTickAmt = axis.finalTickAmt,
+                    thresholdAlignment = axis.thresholdAlignment,
                     currentTickAmount = tickPositions && tickPositions.length,
                     threshold = pick(axis.threshold,
                     axis.softThreshold ? 0 : null);
                 var len,
-                    i;
-                if (axis.hasData() && isNumber(axis.min) && isNumber(axis.max)) { // #14769
-                    if (currentTickAmount < tickAmount) {
+                    i,
+                    tickInterval = axis.tickInterval,
+                    thresholdTickIndex;
+                var 
+                    // Extend the tickPositions by appending a position
+                    append = function () { return tickPositions.push(correctFloat(tickPositions[tickPositions.length - 1] +
+                        tickInterval)); }, 
+                    // Extend the tickPositions by prepending a position
+                    prepend = function () { return tickPositions.unshift(correctFloat(tickPositions[0] - tickInterval)); };
+                // If `thresholdAlignment` is a number, it means the `alignThresholds`
+                // option is true. The `thresholdAlignment` is a scalar value between 0
+                // and 1 for where the threshold should be relative to `axis.min` and
+                // `axis.max`. Now that we know the tick amount, convert this to the
+                // tick index. Unless `thresholdAlignment` is exactly 0 or 1, avoid the
+                // first or last tick because that would lead to series being clipped.
+                if (isNumber(thresholdAlignment)) {
+                    thresholdTickIndex = thresholdAlignment < 0.5 ?
+                        Math.ceil(thresholdAlignment * (tickAmount - 1)) :
+                        Math.floor(thresholdAlignment * (tickAmount - 1));
+                    if (options.reversed) {
+                        thresholdTickIndex = tickAmount - 1 - thresholdTickIndex;
+                    }
+                }
+                if (axis.hasData() && isNumber(min) && isNumber(max)) { // #14769
+                    // Adjust extremes and translation to the modified tick positions
+                    var adjustExtremes = function () {
+                            axis.transA *= (currentTickAmount - 1) / (tickAmount - 1);
+                        // Do not crop when ticks are not extremes (#9841)
+                        axis.min = options.startOnTick ?
+                            tickPositions[0] :
+                            Math.min(min, tickPositions[0]);
+                        axis.max = options.endOnTick ?
+                            tickPositions[tickPositions.length - 1] :
+                            Math.max(max, tickPositions[tickPositions.length - 1]);
+                    };
+                    // When the axis is subject to the alignThresholds option. Use
+                    // axis.threshold because the local threshold includes the
+                    // `softThreshold`.
+                    if (isNumber(thresholdTickIndex) && isNumber(axis.threshold)) {
+                        // Throw away the previously computed tickPositions and start
+                        // from scratch with only the threshold itself, then add ticks
+                        // below the threshold first, then fill up above the threshold.
+                        // If we are not able to fill up to axis.max, double the
+                        // tickInterval and run again.
+                        while (tickPositions[thresholdTickIndex] !== threshold ||
+                            tickPositions.length !== tickAmount ||
+                            tickPositions[0] > min ||
+                            tickPositions[tickPositions.length - 1] < max) {
+                            tickPositions.length = 0;
+                            tickPositions.push(axis.threshold);
+                            while (tickPositions.length < tickAmount) {
+                                if (
+                                // Start by prepending positions until the threshold
+                                // is at the required index...
+                                tickPositions[thresholdTickIndex] === void 0 ||
+                                    tickPositions[thresholdTickIndex] > axis.threshold) {
+                                    prepend();
+                                }
+                                else {
+                                    // ... then append positions until we have the
+                                    // required length
+                                    append();
+                                }
+                            }
+                            // Safety vent
+                            if (tickInterval > axis.tickInterval * 8) {
+                                break;
+                            }
+                            tickInterval *= 2;
+                        }
+                        adjustExtremes();
+                    }
+                    else if (currentTickAmount < tickAmount) {
                         while (tickPositions.length < tickAmount) {
                             // Extend evenly for both sides unless we're on the
                             // threshold (#3965)
-                            if (tickPositions.length % 2 ||
-                                axis.min === threshold) {
-                                // to the end
-                                tickPositions.push(correctFloat(tickPositions[tickPositions.length - 1] +
-                                    tickInterval));
+                            if (tickPositions.length % 2 || min === threshold) {
+                                append();
                             }
                             else {
-                                // to the start
-                                tickPositions.unshift(correctFloat(tickPositions[0] - tickInterval));
+                                prepend();
                             }
                         }
-                        axis.transA *= (currentTickAmount - 1) / (tickAmount - 1);
-                        // Do not crop when ticks are not extremes (#9841)
-                        axis.min = axisOptions.startOnTick ?
-                            tickPositions[0] :
-                            Math.min(axis.min, tickPositions[0]);
-                        axis.max = axisOptions.endOnTick ?
-                            tickPositions[tickPositions.length - 1] :
-                            Math.max(axis.max, tickPositions[tickPositions.length - 1]);
+                        adjustExtremes();
                         // We have too many ticks, run second pass to try to reduce ticks
                     }
                     else if (currentTickAmount > tickAmount) {
@@ -20298,7 +20476,7 @@
              * @private
              * @function Highcharts.Axis#setScale
              *
-             * @fires Highcharts.Axis#event:afterSetScale
+             * @emits Highcharts.Axis#event:afterSetScale
              */
             Axis.prototype.setScale = function () {
                 var axis = this;
@@ -20386,7 +20564,7 @@
              * @param {*} [eventArguments]
              * Arguments to be accessed in event handler.
              *
-             * @fires Highcharts.Axis#event:setExtremes
+             * @emits Highcharts.Axis#event:setExtremes
              */
             Axis.prototype.setExtremes = function (newMin, newMax, redraw, animation, eventArguments) {
                 var axis = this,
@@ -20416,14 +20594,6 @@
              *
              * @private
              * @function Highcharts.Axis#zoom
-             *
-             * @param {number} newMin
-             * TO-DO: parameter description
-             *
-             * @param {number} newMax
-             * TO-DO: parameter description
-             *
-             * @return {boolean}
              */
             Axis.prototype.zoom = function (newMin, newMax) {
                 var axis = this,
@@ -20634,8 +20804,6 @@
              *
              * @private
              * @function Highcharts.Axis#labelMetrics
-             *
-             * @return {Highcharts.FontMetricsObject}
              */
             Axis.prototype.labelMetrics = function () {
                 var index = this.tickPositions && this.tickPositions[0] || 0;
@@ -20648,8 +20816,6 @@
              *
              * @private
              * @function Highcharts.Axis#unsquish
-             *
-             * @return {number}
              */
             Axis.prototype.unsquish = function () {
                 var labelOptions = this.options.labels,
@@ -21011,7 +21177,7 @@
              * @private
              * @function Highcharts.Axis#getOffset
              *
-             * @fires Highcharts.Axis#event:afterGetOffset
+             * @emits Highcharts.Axis#event:afterGetOffset
              */
             Axis.prototype.getOffset = function () {
                 var _this = this;
@@ -21338,7 +21504,7 @@
              * @private
              * @function Highcharts.Axis#render
              *
-             * @fires Highcharts.Axis#event:afterRender
+             * @emits Highcharts.Axis#event:afterRender
              */
             Axis.prototype.render = function () {
                 var axis = this,
@@ -21429,7 +21595,8 @@
                         (options.plotLines || [])
                             .concat(options.plotBands || [])
                             .forEach(function (plotLineOptions) {
-                            axis.addPlotBandOrLine(plotLineOptions);
+                            axis
+                                .addPlotBandOrLine(plotLineOptions);
                         });
                     }
                 } // end if hasData
@@ -21529,8 +21696,6 @@
              *
              * @private
              * @function Highcharts.Axis#getKeepProps
-             *
-             * @return {Array<string>}
              */
             Axis.prototype.getKeepProps = function () {
                 return (this.keepProps || Axis.keepProps);
@@ -21596,8 +21761,8 @@
              * @param {Highcharts.Point} [point]
              * The Point object if the crosshair snaps to points.
              *
-             * @fires Highcharts.Axis#event:afterDrawCrosshair
-             * @fires Highcharts.Axis#event:drawCrosshair
+             * @emits Highcharts.Axis#event:afterDrawCrosshair
+             * @emits Highcharts.Axis#event:drawCrosshair
              */
             Axis.prototype.drawCrosshair = function (e, point) {
                 var options = this.crosshair,
@@ -21724,8 +21889,6 @@
              *
              * @private
              * @function Highcharts.Axis#hasVerticalPanning
-             *
-             * @return {boolean}
              */
             Axis.prototype.hasVerticalPanning = function () {
                 var panningOptions = this.chart.options.chart.panning;
@@ -21741,8 +21904,6 @@
             *
             * @param {unknown} value
             * The axis value
-            *
-            * @return {boolean}
             */
             Axis.prototype.validatePositiveValue = function (value) {
                 return isNumber(value) && value > 0;
@@ -21852,7 +22013,14 @@
             Axis.defaultOptions = AxisDefaults.defaultXAxisOptions;
             // Properties to survive after destroy, needed for Axis.update (#4317,
             // #5773, #5881).
-            Axis.keepProps = ['extKey', 'hcEvents', 'names', 'series', 'userMax', 'userMin'];
+            Axis.keepProps = [
+                'extKey',
+                'hcEvents',
+                'names',
+                'series',
+                'userMax',
+                'userMin'
+            ];
             return Axis;
         }());
         /* *
@@ -22153,19 +22321,12 @@
              *
              * @private
              * @function Highcharts.Axis#getTimeTicks
-             *
              * @param {Highcharts.TimeNormalizeObject} normalizedInterval
              * The interval in axis values (ms) and thecount.
-             *
              * @param {number} min
              * The minimum in axis values.
-             *
              * @param {number} max
              * The maximum in axis values.
-             *
-             * @param {number} startOfWeek
-             *
-             * @return {Highcharts.AxisTickPositionsArray}
              */
             function getTimeTicks() {
                 return this.chart.time.getTimeTicks.apply(this.chart.time, arguments);
@@ -22215,8 +22376,10 @@
                  */
                 Additions.prototype.normalizeTimeTickInterval = function (tickInterval, unitsOption) {
                     var units = (unitsOption || [[
+                                // unit name
                                 'millisecond',
-                                [1, 2, 5, 10, 20, 25, 50, 100, 200, 500] // allowed multiples
+                                // allowed multiples
+                                [1, 2, 5, 10, 20, 25, 50, 100, 200, 500]
                             ],
                         [
                                 'second',
@@ -22289,12 +22452,6 @@
                  * point range on the axis.
                  *
                  * @private
-                 *
-                 * @param {number} x
-                 *
-                 * @param {Highcharts.Dictionary<string>} dateTimeLabelFormats
-                 *
-                 * @return {string}
                  */
                 Additions.prototype.getXDateFormat = function (x, dateTimeLabelFormats) {
                     var axis = this.axis;
@@ -22721,13 +22878,8 @@
                  *
                  * @private
                  * @function Highcharts.Axis#addPlotBandOrLine
-                 *
                  * @param {Highcharts.AxisPlotBandsOptions|Highcharts.AxisPlotLinesOptions} options
                  * The plotBand or plotLine configuration object.
-                 *
-                 * @param {"plotBands"|"plotLines"} [coll]
-                 *
-                 * @return {Highcharts.PlotLineOrBand|undefined}
                  */
                 Additions.prototype.addPlotBandOrLine = function (options, coll) {
                     var _this = this;
@@ -23870,8 +24022,6 @@
              *
              * @private
              * @function Highcharts.Tooltip#bodyFormatter
-             * @param {Array<(Highcharts.Point|Highcharts.Series)>} items
-             * @return {Array<string>}
              */
             Tooltip.prototype.bodyFormatter = function (items) {
                 return items.map(function (item) {
@@ -23888,7 +24038,7 @@
              * @function Highcharts.Tooltip#cleanSplit
              *
              * @param {boolean} [force]
-             *        Force destroy all tooltips.
+             * Force destroy all tooltips.
              */
             Tooltip.prototype.cleanSplit = function (force) {
                 this.chart.series.forEach(function (series) {
@@ -23911,7 +24061,9 @@
              *
              * @param {Highcharts.Tooltip} tooltip
              *
-             * @return {Array<string>}
+             * @return {string|Array<string>}
+             * Returns a string (single tooltip and shared)
+             * or an array of strings (split tooltip)
              */
             Tooltip.prototype.defaultFormatter = function (tooltip) {
                 var items = this.points || splat(this);
@@ -23951,12 +24103,6 @@
              *
              * @private
              * @function Highcharts.Tooltip#getAnchor
-             *
-             * @param {Highcharts.Point|Array<Highcharts.Point>} points
-             *
-             * @param {Highcharts.PointerEventObject} [mouseEvent]
-             *
-             * @return {Array<number>}
              */
             Tooltip.prototype.getAnchor = function (points, mouseEvent) {
                 var chart = this.chart,
@@ -24001,8 +24147,8 @@
                                 plotY += yAxis.pos - plotTop;
                             }
                             else { // #14771
-                                plotX += plotTop + chart.plotHeight - xAxis.len - xAxis.pos;
-                                plotY += plotLeft + chart.plotWidth - yAxis.len - yAxis.pos;
+                                plotX += (plotTop + chart.plotHeight - xAxis.len - xAxis.pos);
+                                plotY += (plotLeft + chart.plotWidth - yAxis.len - yAxis.pos);
                             }
                         }
                     });
@@ -24031,6 +24177,7 @@
              * @function Highcharts.Tooltip#getLabel
              *
              * @return {Highcharts.SVGElement}
+             * Tooltip label
              */
             Tooltip.prototype.getLabel = function () {
                 var tooltip = this,
@@ -24041,7 +24188,8 @@
                         ' ' + options.className :
                         '')),
                     pointerEvents = (options.style.pointerEvents ||
-                        (!this.followPointer && options.stickOnContact ? 'auto' : 'none')),
+                        (!this.followPointer &&
+                            options.stickOnContact ? 'auto' : 'none')),
                     onMouseEnter = function () {
                         tooltip.inContact = true;
                 }, onMouseLeave = function (e) {
@@ -24157,14 +24305,6 @@
              *
              * @private
              * @function Highcharts.Tooltip#getPosition
-             *
-             * @param {number} boxWidth
-             *
-             * @param {number} boxHeight
-             *
-             * @param {Highcharts.Point} point
-             *
-             * @return {Highcharts.PositionObject}
              */
             Tooltip.prototype.getPosition = function (boxWidth, boxHeight, point) {
                 var chart = this.chart,
@@ -24526,7 +24666,7 @@
                     shared = tooltip.shared,
                     styledMode = chart.styledMode;
                 var textConfig = {};
-                if (!options.enabled) {
+                if (!options.enabled || !point.series) { // #16820
                     return;
                 }
                 U.clearTimeout(this.hideTimer);
@@ -24536,7 +24676,7 @@
                     pointOrPoints.series &&
                     pointOrPoints.series.noSharedTooltip);
                 // get the reference point coordinates (pie charts use tooltipPos)
-                tooltip.followPointer = !tooltip.split && point.series.tooltipOptions.followPointer;
+                tooltip.followPointer = (!tooltip.split && point.series.tooltipOptions.followPointer);
                 var anchor = tooltip.getAnchor(pointOrPoints,
                     mouseEvent),
                     x = anchor[0],
@@ -24670,9 +24810,10 @@
                     options = tooltip.options,
                     positioner = tooltip.options.positioner;
                 // The area which the tooltip should be limited to. Limit to scrollable
-                // plot area if enabled, otherwise limit to the chart container.
-                // If outside is true it should be the whole viewport
-                var bounds = tooltip.outside && typeof scrollablePixelsX !== 'number' ?
+                // plot area if enabled, otherwise limit to the chart container. If
+                // outside is true it should be the whole viewport
+                var bounds = (tooltip.outside &&
+                        typeof scrollablePixelsX !== 'number') ?
                         doc.documentElement.getBoundingClientRect() : {
                         left: scrollLeft,
                         right: scrollLeft + chartWidth,
@@ -24693,7 +24834,7 @@
                  *
                  * @private
                  * @param {Highcharts.Point} point The point related to the tooltip
-                 * @return {object} Returns an object with anchorX and anchorY
+                 * @return {Object} Returns an object with anchorX and anchorY
                  */
                 function getAnchor(point) {
                     var isHeader = point.isHeader,
@@ -24885,13 +25026,14 @@
                     }
                     return boxes;
                 }, []);
-                // Realign the tooltips towards the right if there is not enough
-                // space to the left and there is space to to the right
+                // Realign the tooltips towards the right if there is not enough space
+                // to the left and there is space to to the right
                 if (!positioner && boxes.some(function (box) {
                     // Always realign if the beginning of a label is outside bounds
                     var outside = tooltip.outside;
                     var boxStart = (outside ? chartLeft : 0) + box.anchorX;
-                    if (boxStart < bounds.left && boxStart + box.boxWidth < bounds.right) {
+                    if (boxStart < bounds.left &&
+                        boxStart + box.boxWidth < bounds.right) {
                         return true;
                     }
                     // Otherwise, check if there is more space available to the right
@@ -24929,7 +25071,9 @@
                         if (tooltip.outside && chartLeft + x < boxExtremes.left) {
                             boxExtremes.left = chartLeft + x;
                         }
-                        if (!isHeader && tooltip.outside && boxExtremes.left + boxWidth > boxExtremes.right) {
+                        if (!isHeader &&
+                            tooltip.outside &&
+                            boxExtremes.left + boxWidth > boxExtremes.right) {
                             boxExtremes.right = chartLeft + x;
                         }
                     }
@@ -25063,9 +25207,6 @@
              *
              * @private
              * @function Highcharts.Tooltip#tooltipFooterHeaderFormatter
-             * @param {Highcharts.PointLabelObject} labelConfig
-             * @param {boolean} [isFooter]
-             * @return {string}
              */
             Tooltip.prototype.tooltipFooterHeaderFormatter = function (labelConfig, isFooter) {
                 var series = labelConfig.series,
@@ -25181,46 +25322,23 @@
          * @callback Highcharts.TooltipFormatterCallbackFunction
          *
          * @param {Highcharts.TooltipFormatterContextObject} this
-         *        Context to format
+         * Context to format
          *
          * @param {Highcharts.Tooltip} tooltip
-         *        The tooltip instance
+         * The tooltip instance
          *
          * @return {false|string|Array<(string|null|undefined)>|null|undefined}
-         *         Formatted text or false
+         * Formatted text or false
          */
         /**
+         * Configuration for the tooltip formatters.
+         *
          * @interface Highcharts.TooltipFormatterContextObject
+         * @extends Highcharts.PointLabelObject
          */ /**
-        * @name Highcharts.TooltipFormatterContextObject#color
-        * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#colorIndex
-        * @type {number|undefined}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#key
-        * @type {number}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#percentage
-        * @type {number|undefined}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#point
-        * @type {Highcharts.Point}
-        */ /**
+        * Array of points in shared tooltips.
         * @name Highcharts.TooltipFormatterContextObject#points
         * @type {Array<Highcharts.TooltipFormatterContextObject>|undefined}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#series
-        * @type {Highcharts.Series}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#total
-        * @type {number|undefined}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#x
-        * @type {number}
-        */ /**
-        * @name Highcharts.TooltipFormatterContextObject#y
-        * @type {number}
         */
         /**
          * A callback function to place the tooltip in a specific position.
@@ -25474,7 +25592,9 @@
                 options = Point.prototype.optionsToObject.call(this, options);
                 // copy options directly to point
                 extend(point, options);
-                point.options = point.options ? extend(point.options, options) : options;
+                point.options = point.options ?
+                    extend(point.options, options) :
+                    options;
                 // Since options are copied into the Point instance, some accidental
                 // options must be shielded (#5681)
                 if (options.group) {
@@ -25616,7 +25736,7 @@
              * @param {Highcharts.EventCallbackFunction<Highcharts.Point>|Function} [defaultFunction]
              *        Default event handler.
              *
-             * @fires Highcharts.Point#event:*
+             * @emits Highcharts.Point#event:*
              */
             Point.prototype.firePointEvent = function (eventType, eventArgs, defaultFunction) {
                 var point = this,
@@ -25667,8 +25787,6 @@
              *
              * @private
              * @function Highcharts.Point#getGraphicalProps
-             * @param {Highcharts.Dictionary<number>} [kinds]
-             * @return {Highcharts.PointGraphicalProps}
              */
             Point.prototype.getGraphicalProps = function (kinds) {
                 var point = this,
@@ -25767,8 +25885,7 @@
             /**
              * Utility to check if point has new shape type. Used in column series and
              * all others that are based on column series.
-             *
-             * @return boolean|undefined
+             * @private
              */
             Point.prototype.hasNewShapeType = function () {
                 var point = this;
@@ -25794,7 +25911,7 @@
              * @return {Highcharts.Point}
              *         The Point instance.
              *
-             * @fires Highcharts.Point#event:afterInit
+             * @emits Highcharts.Point#event:afterInit
              */
             Point.prototype.init = function (series, options, x) {
                 this.series = series;
@@ -25880,7 +25997,6 @@
             /**
              * @private
              * @function Highcharts.Point#resolveColor
-             * @return {void}
              */
             Point.prototype.resolveColor = function () {
                 var series = this.series,
@@ -26015,7 +26131,7 @@
              *        Whether to apply animation, and optionally animation
              *        configuration.
              *
-             * @fires Highcharts.Point#event:update
+             * @emits Highcharts.Point#event:update
              */
             Point.prototype.update = function (options, redraw, animation, runEvent) {
                 var point = this,
@@ -26033,7 +26149,9 @@
                     // Update visuals, #4146
                     // Handle dummy graphic elements for a11y, #12718
                     var hasDummyGraphic = graphic && point.hasDummyGraphic;
-                    var shouldDestroyGraphic = point.y === null ? !hasDummyGraphic : hasDummyGraphic;
+                    var shouldDestroyGraphic = point.y === null ?
+                            !hasDummyGraphic :
+                            hasDummyGraphic;
                     if (graphic && shouldDestroyGraphic) {
                         point.graphic = graphic.destroy();
                         delete point.hasDummyGraphic;
@@ -26136,8 +26254,8 @@
              * is `true`, selected points are accumulated on Control, Shift or Cmd
              * clicking the point.
              *
-             * @fires Highcharts.Point#event:select
-             * @fires Highcharts.Point#event:unselect
+             * @emits Highcharts.Point#event:select
+             * @emits Highcharts.Point#event:unselect
              */
             Point.prototype.select = function (selected, accumulate) {
                 var point = this,
@@ -26206,7 +26324,7 @@
              * events.
              *
              * @function Highcharts.Point#onMouseOut
-             * @fires Highcharts.Point#event:mouseOut
+             * @emits Highcharts.Point#event:mouseOut
              */
             Point.prototype.onMouseOut = function () {
                 var point = this,
@@ -26253,7 +26371,7 @@
              * @param {boolean} [move]
              *        State for animation.
              *
-             * @fires Highcharts.Point#event:afterSetState
+             * @emits Highcharts.Point#event:afterSetState
              */
             Point.prototype.setState = function (state, move) {
                 var point = this,
@@ -26314,8 +26432,9 @@
                         pointAttribs = series.pointAttribs(point, state);
                         pointAttribsAnimation = pick(chart.options.chart.animation, stateOptions.animation);
                         // Some inactive points (e.g. slices in pie) should apply
-                        // oppacity also for it's labels
-                        if (series.options.inactiveOtherPoints && isNumber(pointAttribs.opacity)) {
+                        // opacity also for their labels
+                        if (series.options.inactiveOtherPoints &&
+                            isNumber(pointAttribs.opacity)) {
                             (point.dataLabels || []).forEach(function (label) {
                                 if (label) {
                                     label.animate({
@@ -26475,7 +26594,7 @@
         * @type {Highcharts.Point}
         */
         /**
-         * Configuration hash for the data label and tooltip formatters.
+         * Configuration for the data label and tooltip formatters.
          *
          * @interface Highcharts.PointLabelObject
          */ /**
@@ -26517,7 +26636,7 @@
         */ /**
         * The y value of the point.
         * @name Highcharts.PointLabelObject#y
-        * @type {number|undefined}
+        * @type {number|null|undefined}
         */
         /**
          * Gets fired when the mouse leaves the area close to the point.
@@ -26776,7 +26895,7 @@
                         Pointer.unbindDocumentMouseUp = Pointer.unbindDocumentMouseUp();
                     }
                     if (Pointer.unbindDocumentTouchEnd) {
-                        Pointer.unbindDocumentTouchEnd = Pointer.unbindDocumentTouchEnd();
+                        Pointer.unbindDocumentTouchEnd = (Pointer.unbindDocumentTouchEnd());
                     }
                 }
                 // memory and CPU leak
@@ -27129,6 +27248,7 @@
              * Pointer event, extended with `chartX` and `chartY` properties.
              *
              * @return {Highcharts.PointerAxisCoordinatesObject}
+             * Axis coordinates.
              */
             Pointer.prototype.getCoordinates = function (e) {
                 var coordinates = {
@@ -27167,7 +27287,7 @@
              * @param {Highcharts.PointerEventObject} [e]
              * The triggering event, containing chart coordinates of the pointer.
              *
-             * @return {object}
+             * @return {Object}
              * Object containing resulting hover data: hoverPoint, hoverSeries, and
              * hoverPoints.
              */
@@ -27296,9 +27416,10 @@
              * name.
              */
             Pointer.prototype.inClass = function (element, className) {
-                var elemClassName;
-                while (element) {
-                    elemClassName = attr(element, 'class');
+                var elem = element,
+                    elemClassName;
+                while (elem) {
+                    elemClassName = attr(elem, 'class');
                     if (elemClassName) {
                         if (elemClassName.indexOf(className) !== -1) {
                             return true;
@@ -27307,7 +27428,7 @@
                             return false;
                         }
                     }
-                    element = element.parentNode;
+                    elem = elem.parentElement;
                 }
             };
             /**
@@ -27348,6 +27469,9 @@
              * properties `chartX` and `chartY` in order to work on the internal
              * coordinate system.
              *
+             * On map charts, the properties `lon` and `lat` are added to the event
+             * object given that the chart has projection information.
+             *
              * @function Highcharts.Pointer#normalize
              *
              * @param {global.MouseEvent|global.PointerEvent|global.TouchEvent} e
@@ -27464,9 +27588,8 @@
                     // Also reset the chart position, used in #149 fix
                     chart.pointer.chartPosition = void 0;
                 }
-                if ( // #11635, Firefox wheel scroll does not fire out events consistently
-                tooltip &&
-                    !tooltip.isHidden) {
+                // #11635, Firefox wheel scroll does not fire out events consistently
+                if (tooltip && !tooltip.isHidden) {
                     this.reset();
                 }
             };
@@ -27613,7 +27736,10 @@
                 }
                 // On touch devices, only proceed to trigger click if a handler is
                 // defined
-                if (hasZoom && self.initiated && !fireClickEvent && e.cancelable !== false) {
+                if (hasZoom &&
+                    self.initiated &&
+                    !fireClickEvent &&
+                    e.cancelable !== false) {
                     e.preventDefault();
                 }
                 // Normalize each touch
@@ -27754,7 +27880,8 @@
                     clip[xy] = clipXY - plotLeftTop;
                     clip[wh] = selectionWH;
                 }
-                var scaleKey = inverted ? (horiz ? 'scaleY' : 'scaleX') : 'scale' + XY;
+                var scaleKey = inverted ?
+                        (horiz ? 'scaleY' : 'scaleX') : 'scale' + XY;
                 var transformScale = inverted ? 1 / scale : scale;
                 selectionMarker[wh] = selectionWH;
                 selectionMarker[xy] = selectionXY;
@@ -27857,8 +27984,8 @@
              * @private
              * @function Highcharts.Pointer#runPointActions
              *
-             * @fires Highcharts.Point#event:mouseOut
-             * @fires Highcharts.Point#event:mouseOver
+             * @emits Highcharts.Point#event:mouseOut
+             * @emits Highcharts.Point#event:mouseOver
              */
             Pointer.prototype.runPointActions = function (e, p) {
                 var pointer = this,
@@ -27940,11 +28067,12 @@
                      * The mouseOver event should be triggered when hoverPoint
                      * is correct.
                      */
-                    hoverPoint.firePointEvent('mouseOver');
-                    // Draw tooltip if necessary
-                    if (tooltip) {
-                        tooltip.refresh(useSharedTooltip ? points : hoverPoint, e);
-                    }
+                    hoverPoint.firePointEvent('mouseOver', void 0, function () {
+                        // Draw tooltip if necessary
+                        if (tooltip && hoverPoint) {
+                            tooltip.refresh(useSharedTooltip ? points : hoverPoint, e);
+                        }
+                    });
                     // Update positions (regardless of kdpoint or hoverPoint)
                 }
                 else if (followPointer && tooltip && !tooltip.isHidden) {
@@ -27975,7 +28103,7 @@
                         point = chart.hoverPoint; // #13002
                         if (!point || point.series[axis.coll] !== axis) {
                             point = find(points, function (p) {
-                                return p.series[axis.coll] === axis;
+                                return p.series && p.series[axis.coll] === axis;
                             });
                         }
                     }
@@ -28064,7 +28192,7 @@
                 var hoverChart = H.charts[pick(Pointer.hoverChartIndex, -1)];
                 if (hoverChart &&
                     hoverChart !== chart) {
-                    hoverChart.pointer.onContainerMouseLeave({ relatedTarget: true });
+                    hoverChart.pointer.onContainerMouseLeave({ relatedTarget: chart.container });
                 }
                 if (!hoverChart ||
                     !hoverChart.mouseIsDown) {
@@ -28526,7 +28654,7 @@
                 this.maxItemWidth = 0;
                 this.maxLegendWidth = 0;
                 this.offsetWidth = 0;
-                this.options = {};
+                this.options = void 0;
                 this.padding = 0;
                 this.pages = [];
                 this.proximate = false;
@@ -28611,7 +28739,8 @@
                 this.symbolWidth = pick(options.symbolWidth, 16);
                 this.pages = [];
                 this.proximate = options.layout === 'proximate' && !this.chart.inverted;
-                this.baseline = void 0; // #12705: baseline has to be reset on every update
+                // #12705: baseline has to be reset on every update
+                this.baseline = void 0;
             };
             /**
              * Update the legend with new options. Equivalent to running `chart.update`
@@ -28630,7 +28759,7 @@
              * operations on the chart, it is a good idea to set redraw to false and
              * call {@link Chart#redraw} after. Whether to redraw the chart.
              *
-             * @fires Highcharts.Legends#event:afterUpdate
+             * @emits Highcharts.Legends#event:afterUpdate
              */
             Legend.prototype.update = function (options, redraw) {
                 var chart = this.chart;
@@ -28780,8 +28909,7 @@
                 /**
                  * @private
                  * @param {string} key
-                 * @return {void}
-                 */
+                     */
                 function destroyItems(key) {
                     if (this[key]) {
                         this[key] = this[key].destroy();
@@ -28857,7 +28985,7 @@
                          * @name Highcharts.Legend#title
                          * @type {Highcharts.SVGElement}
                          */
-                        this.title = this.chart.renderer.label(titleOptions.text, padding - 3, padding - 4, null, null, null, options.useHTML, null, 'legend-title')
+                        this.title = this.chart.renderer.label(titleOptions.text, padding - 3, padding - 4, void 0, void 0, void 0, options.useHTML, void 0, 'legend-title')
                             .attr({ zIndex: 1 });
                         if (!this.chart.styledMode) {
                             this.title.css(titleOptions.style);
@@ -28998,13 +29126,16 @@
                 legend.setText(item);
                 // calculate the positions for the next line
                 var bBox = li.getBBox();
+                var fontMetricsH = (legend.fontMetrics && legend.fontMetrics.h) || 0;
                 item.itemWidth = item.checkboxOffset =
                     options.itemWidth ||
                         item.legendItemWidth ||
                         bBox.width + itemExtraWidth;
                 legend.maxItemWidth = Math.max(legend.maxItemWidth, item.itemWidth);
                 legend.totalItemWidth += item.itemWidth;
-                legend.itemHeight = item.itemHeight = Math.round(item.legendItemHeight || bBox.height || legend.symbolHeight);
+                legend.itemHeight = item.itemHeight = Math.round(item.legendItemHeight ||
+                    // use bBox for multiline (#16398)
+                    (bBox.height > fontMetricsH * 1.5 ? bBox.height : fontMetricsH));
             };
             /**
              * Get the position of the item in the layout. We now know the
@@ -29068,7 +29199,7 @@
              * @function Highcharts.Legend#getAllItems
              * @return {Array<(Highcharts.BubbleLegendItem|Highcharts.Point|Highcharts.Series)>}
              * The current items in the legend.
-             * @fires Highcharts.Legend#event:afterGetAllItems
+             * @emits Highcharts.Legend#event:afterGetAllItems
              */
             Legend.prototype.getAllItems = function () {
                 var allItems = [];
@@ -29221,8 +29352,7 @@
                 legend.lastItemY = 0;
                 legend.widthOption = relativeLength(options.width, chart.spacingBox.width - padding);
                 // Compute how wide the legend is allowed to be
-                allowedWidth =
-                    chart.spacingBox.width - 2 * padding - options.x;
+                allowedWidth = chart.spacingBox.width - 2 * padding - options.x;
                 if (['rm', 'lm'].indexOf(legend.getAlignment().substring(0, 2)) > -1) {
                     allowedWidth /= 2;
                 }
@@ -29295,7 +29425,6 @@
                         r: options.borderRadius
                     })
                         .add(legendGroup);
-                    box.isNew = true;
                 }
                 // Presentational
                 if (!chart.styledMode) {
@@ -29308,13 +29437,12 @@
                         .shadow(options.shadow);
                 }
                 if (legendWidth > 0 && legendHeight > 0) {
-                    box[box.isNew ? 'attr' : 'animate'](box.crisp.call({}, {
+                    box[box.placed ? 'animate' : 'attr'](box.crisp.call({}, {
                         x: 0,
                         y: 0,
                         width: legendWidth,
                         height: legendHeight
                     }, box.strokeWidth()));
-                    box.isNew = false;
                 }
                 // hide the border if no items
                 box[display ? 'show' : 'hide']();
@@ -29338,7 +29466,6 @@
              * @private
              * @function Highcharts.align
              * @param {Highcharts.BBoxObject} alignTo
-             * @return {void}
              */
             Legend.prototype.align = function (alignTo) {
                 if (alignTo === void 0) { alignTo = this.chart.spacingBox; }
@@ -29358,6 +29485,11 @@
                 if (y !== alignTo.y) {
                     alignTo = merge(alignTo, { y: y });
                 }
+                if (!chart.hasRendered) {
+                    // Avoid animation when adjusting alignment for responsiveness and
+                    // colorAxis label layout
+                    this.group.placed = false;
+                }
                 this.group.align(merge(options, {
                     width: this.legendWidth,
                     height: this.legendHeight,
@@ -29370,8 +29502,6 @@
              *
              * @private
              * @function Highcharts.Legend#handleOverflow
-             * @param {number} legendHeight
-             * @return {number}
              */
             Legend.prototype.handleOverflow = function (legendHeight) {
                 var legend = this,
@@ -29493,7 +29623,7 @@
                         });
                         this.pager = renderer.text('', 15, 10)
                             .addClass('highcharts-legend-navigation');
-                        if (!chart.styledMode) {
+                        if (!chart.styledMode && navOptions.style) {
                             this.pager.css(navOptions.style);
                         }
                         this.pager.add(nav);
@@ -29532,7 +29662,6 @@
              * @param {boolean|Partial<Highcharts.AnimationOptionsObject>} [animation]
              *        Whether and how to apply animation.
              *
-             * @return {void}
              */
             Legend.prototype.scroll = function (scrollBy, animation) {
                 var _this = this;
@@ -29621,8 +29750,8 @@
              * @param {Highcharts.BubbleLegendItem|Point|Highcharts.Series} item
              * @param {Highcharts.SVGElement} legendItem
              * @param {boolean} [useHTML=false]
-             * @fires Highcharts.Point#event:legendItemClick
-             * @fires Highcharts.Series#event:legendItemClick
+             * @emits Highcharts.Point#event:legendItemClick
+             * @emits Highcharts.Series#event:legendItemClick
              */
             Legend.prototype.setItemEvents = function (item, legendItem, useHTML) {
                 var legend = this,
@@ -29712,7 +29841,7 @@
              * @private
              * @function Highcharts.Legend#createCheckboxForItem
              * @param {Highcharts.BubbleLegendItem|Point|Highcharts.Series} item
-             * @fires Highcharts.Series#event:checkboxClick
+             * @emits Highcharts.Series#event:checkboxClick
              */
             Legend.prototype.createCheckboxForItem = function (item) {
                 var legend = this;
@@ -30141,8 +30270,8 @@
              * @param {...Array<*>} arguments
              * All arguments for the constructor.
              *
-             * @fires Highcharts.Chart#event:init
-             * @fires Highcharts.Chart#event:afterInit
+             * @emits Highcharts.Chart#event:init
+             * @emits Highcharts.Chart#event:afterInit
              */
             Chart.prototype.getArgs = function (a, b, c) {
                 // Remove the optional first argument, renderTo, and
@@ -30168,10 +30297,9 @@
              *        Function to run when the chart has loaded and and all external
              *        images are loaded.
              *
-             * @return {void}
              *
-             * @fires Highcharts.Chart#event:init
-             * @fires Highcharts.Chart#event:afterInit
+             * @emits Highcharts.Chart#event:init
+             * @emits Highcharts.Chart#event:afterInit
              */
             Chart.prototype.init = function (userOptions, callback) {
                 // Handle regular options
@@ -30349,7 +30477,6 @@
              *
              * @private
              * @function Highcharts.Series#getSeriesOrderByLinks
-             * @return {Array<Highcharts.Series>}
              */
             Chart.prototype.getSeriesOrderByLinks = function () {
                 return this.series.concat().sort(function (a, b) {
@@ -30430,7 +30557,8 @@
                             pos: plotLeft,
                             len: Infinity
                         };
-                    var chartX = options.paneCoordinates ? xAxis.pos + x : plotLeft + x;
+                    var chartX = options.paneCoordinates ?
+                            xAxis.pos + x : plotLeft + x;
                     if (!(chartX >= Math.max(scrollLeft + plotLeft, xAxis.pos) &&
                         chartX <= Math.min(scrollLeft + plotLeft + box.width, xAxis.pos + xAxis.len))) {
                         e.isInsidePlot = false;
@@ -30441,7 +30569,8 @@
                             pos: plotTop,
                             len: Infinity
                         };
-                    var chartY = options.paneCoordinates ? yAxis.pos + y : plotTop + y;
+                    var chartY = options.paneCoordinates ?
+                            yAxis.pos + y : plotTop + y;
                     if (!(chartY >= Math.max(scrollTop + plotTop, yAxis.pos) &&
                         chartY <= Math.min(scrollTop + plotTop + box.height, yAxis.pos + yAxis.len))) {
                         e.isInsidePlot = false;
@@ -30464,12 +30593,12 @@
              * @param {boolean|Partial<Highcharts.AnimationOptionsObject>} [animation]
              * If or how to apply animation to the redraw.
              *
-             * @fires Highcharts.Chart#event:afterSetExtremes
-             * @fires Highcharts.Chart#event:beforeRedraw
-             * @fires Highcharts.Chart#event:predraw
-             * @fires Highcharts.Chart#event:redraw
-             * @fires Highcharts.Chart#event:render
-             * @fires Highcharts.Chart#event:updatedData
+             * @emits Highcharts.Chart#event:afterSetExtremes
+             * @emits Highcharts.Chart#event:beforeRedraw
+             * @emits Highcharts.Chart#event:predraw
+             * @emits Highcharts.Chart#event:redraw
+             * @emits Highcharts.Chart#event:render
+             * @emits Highcharts.Chart#event:updatedData
              */
             Chart.prototype.redraw = function (animation) {
                 fireEvent(this, 'beforeRedraw');
@@ -30631,8 +30760,6 @@
                 var series = this.series;
                 /**
                  * @private
-                 * @param {Highcharts.Axis|Highcharts.Series} item
-                 * @return {boolean}
                  */
                 function itemById(item) {
                     return (item.id === id ||
@@ -30656,8 +30783,8 @@
              *
              * @private
              * @function Highcharts.Chart#getAxes
-             * @fires Highcharts.Chart#event:afterGetAxes
-             * @fires Highcharts.Chart#event:getAxes
+             * @emits Highcharts.Chart#event:afterGetAxes
+             * @emits Highcharts.Chart#event:getAxes
              */
             Chart.prototype.getAxes = function () {
                 var chart = this,
@@ -30839,7 +30966,7 @@
              * @function Highcharts.Chart#layOutTitles
              *
              * @param {boolean} [redraw=true]
-             * @fires Highcharts.Chart#event:afterLayOutTitles
+             * @emits Highcharts.Chart#event:afterLayOutTitles
              */
             Chart.prototype.layOutTitles = function (redraw) {
                 var titleOffset = [0, 0, 0],
@@ -30847,7 +30974,7 @@
                     spacingBox = this.spacingBox;
                 // Lay out the title and the subtitle respectively
                 ['title', 'subtitle', 'caption'].forEach(function (key) {
-                    var title = this[key], titleOptions = this.options[key], verticalAlign = titleOptions.verticalAlign || 'top', offset = key === 'title' ?
+                    var title = this[key], titleOptions = (this.options[key]), verticalAlign = titleOptions.verticalAlign || 'top', offset = key === 'title' ?
                             verticalAlign === 'top' ? -3 : 0 :
                             // Floating subtitle (#6574)
                             verticalAlign === 'top' ? titleOffset[0] + 2 : 0;
@@ -30855,7 +30982,8 @@
                         height;
                     if (title) {
                         if (!this.styledMode) {
-                            titleSize = titleOptions.style && titleOptions.style.fontSize;
+                            titleSize = (titleOptions.style &&
+                                titleOptions.style.fontSize);
                         }
                         titleSize = renderer.fontMetrics(titleSize, title).b;
                         title
@@ -31030,7 +31158,7 @@
              *
              * @private
              * @function Highcharts.Chart#afterGetContainer
-             * @fires Highcharts.Chart#event:afterGetContainer
+             * @emits Highcharts.Chart#event:afterGetContainer
              */
             Chart.prototype.getContainer = function () {
                 var chart = this,
@@ -31067,7 +31195,7 @@
                 // Make a reference to the chart from the div
                 attr(renderTo, indexAttrName, chart.index);
                 // remove previous chart
-                renderTo.innerHTML = '';
+                renderTo.innerHTML = AST.emptyHTML;
                 // If the container doesn't have an offsetWidth, it has or is a child of
                 // a node that has display:none. We need to temporarily move it out to a
                 // visible state to determine the size, else the legend and tooltips
@@ -31152,7 +31280,7 @@
              *
              * @private
              * @function Highcharts.Chart#getMargins
-             * @fires Highcharts.Chart#event:getMargins
+             * @emits Highcharts.Chart#event:getMargins
              */
             Chart.prototype.getMargins = function (skipAxes) {
                 var _a = this,
@@ -31318,10 +31446,9 @@
              * @param {boolean|Partial<Highcharts.AnimationOptionsObject>} [animation=true]
              *        Whether and how to apply animation.
              *
-             * @return {void}
              *
-             * @fires Highcharts.Chart#event:endResize
-             * @fires Highcharts.Chart#event:resize
+             * @emits Highcharts.Chart#event:endResize
+             * @emits Highcharts.Chart#event:resize
              */
             Chart.prototype.setSize = function (width, height, animation) {
                 var chart = this,
@@ -31378,7 +31505,7 @@
              *
              * @private
              * @function Highcharts.Chart#setChartSize
-             * @fires Highcharts.Chart#event:afterSetChartSize
+             * @emits Highcharts.Chart#event:afterSetChartSize
              */
             Chart.prototype.setChartSize = function (skipAxes) {
                 var chart = this,
@@ -31501,7 +31628,7 @@
              *
              * @private
              * @function Highcharts.Chart#drawChartBox
-             * @fires Highcharts.Chart#event:afterDrawChartBox
+             * @emits Highcharts.Chart#event:afterDrawChartBox
              */
             Chart.prototype.drawChartBox = function () {
                 var chart = this,
@@ -31635,7 +31762,6 @@
              *
              * @private
              * @function Highcharts.Chart#propFromSeries
-             * @return {void}
              */
             Chart.prototype.propFromSeries = function () {
                 var chart = this,
@@ -31679,7 +31805,7 @@
              *
              * @private
              * @function Highcharts.Chart#linkSeries
-             * @fires Highcharts.Chart#event:afterLinkSeries
+             * @emits Highcharts.Chart#event:afterLinkSeries
              */
             Chart.prototype.linkSeries = function () {
                 var chart = this,
@@ -31907,7 +32033,7 @@
              *
              * @function Highcharts.Chart#destroy
              *
-             * @fires Highcharts.Chart#event:destroy
+             * @emits Highcharts.Chart#event:destroy
              */
             Chart.prototype.destroy = function () {
                 var chart = this,
@@ -31959,7 +32085,7 @@
                 // Remove container and all SVG, check container as it can break in IE
                 // when destroyed before finished loading
                 if (container) {
-                    container.innerHTML = '';
+                    container.innerHTML = AST.emptyHTML;
                     removeEvent(container);
                     if (parentNode) {
                         discardElement(container);
@@ -31975,7 +32101,7 @@
              *
              * @private
              * @function Highcharts.Chart#firstRender
-             * @fires Highcharts.Chart#event:beforeRender
+             * @emits Highcharts.Chart#event:beforeRender
              */
             Chart.prototype.firstRender = function () {
                 var chart = this,
@@ -32039,8 +32165,8 @@
              *
              * @private
              * @function Highcharts.Chart#onload
-             * @fires Highcharts.Chart#event:load
-             * @fires Highcharts.Chart#event:render
+             * @emits Highcharts.Chart#event:load
+             * @emits Highcharts.Chart#event:render
              */
             Chart.prototype.onload = function () {
                 // Run callbacks, first the ones registered by modules, then user's one
@@ -32086,8 +32212,8 @@
              * @return {Highcharts.Series}
              *         The newly created series object.
              *
-             * @fires Highcharts.Chart#event:addSeries
-             * @fires Highcharts.Chart#event:afterAddSeries
+             * @emits Highcharts.Chart#event:addSeries
+             * @emits Highcharts.Chart#event:afterAddSeries
              */
             Chart.prototype.addSeries = function (options, redraw, animation) {
                 var chart = this;
@@ -32346,8 +32472,8 @@
              *        Whether to apply animation, and optionally animation
              *        configuration.
              *
-             * @fires Highcharts.Chart#event:update
-             * @fires Highcharts.Chart#event:afterUpdate
+             * @emits Highcharts.Chart#event:update
+             * @emits Highcharts.Chart#event:afterUpdate
              */
             Chart.prototype.update = function (options, redraw, oneToOne, animation) {
                 var chart = this,
@@ -32615,8 +32741,8 @@
              *
              * @function Highcharts.Chart#showResetZoom
              *
-             * @fires Highcharts.Chart#event:afterShowResetZoom
-             * @fires Highcharts.Chart#event:beforeShowResetZoom
+             * @emits Highcharts.Chart#event:afterShowResetZoom
+             * @emits Highcharts.Chart#event:beforeShowResetZoom
              */
             Chart.prototype.showResetZoom = function () {
                 var chart = this,
@@ -32653,7 +32779,7 @@
              *
              * @function Highcharts.Chart#zoomOut
              *
-             * @fires Highcharts.Chart#event:selection
+             * @emits Highcharts.Chart#event:selection
              */
             Chart.prototype.zoomOut = function () {
                 fireEvent(this, 'selection', { resetSelection: true }, this.zoom);
@@ -32668,7 +32794,8 @@
             Chart.prototype.zoom = function (event) {
                 var chart = this,
                     pointer = chart.pointer,
-                    mouseDownPos = (chart.inverted ? pointer.mouseDownX : pointer.mouseDownY);
+                    mouseDownPos = chart.inverted ?
+                        pointer.mouseDownX : pointer.mouseDownY;
                 var displayButton = false,
                     hasZoomed;
                 // If zoom is called with no arguments, reset the axes
@@ -34433,6 +34560,9 @@
                      * parameter, `event`, is passed to the function, containing common
                      * event information.
                      *
+                     * Returning `false` cancels the default behavior, which is to show a
+                     * tooltip for the point.
+                     *
                      * @sample {highcharts} highcharts/plotoptions/series-point-events-mouseover/
                      *         Show values in the chart's corner on mouse over
                      *
@@ -34769,9 +34899,9 @@
                      */
                     // eslint-disable-next-line valid-jsdoc
                     /**
-                     * Callback JavaScript function to format the data label. Note that
-                     * if a `format` is defined, the format takes precedence and the
-                     * formatter is ignored.
+                     * Callback JavaScript function to format the data label. Note that if a
+                     * `format` is defined, the format takes precedence and the formatter is
+                     * ignored.
                      *
                      * @sample {highmaps} maps/plotoptions/series-datalabels-format/
                      *         Formatted value
@@ -34780,7 +34910,8 @@
                      */
                     formatter: function () {
                         var numberFormatter = this.series.chart.numberFormatter;
-                    return typeof this.y !== 'number' ? '' : numberFormatter(this.y, -1);
+                    return typeof this.y !== 'number' ?
+                        '' : numberFormatter(this.y, -1);
                 },
                 /**
                  * For points with an extent, like columns or map areas, whether to
@@ -35154,7 +35285,7 @@
                      * @deprecated
                      *
                      * @extends   plotOptions.series.marker
-                     * @excluding states
+                     * @excluding states, symbol
                      * @product   highcharts highstock
                      */
                     marker: {
@@ -35861,7 +35992,6 @@
              *
              * @private
              * @function Highcharts.Series#hasData
-             * @return {boolean}
              */
             Series.prototype.hasData = function () {
                 return ((this.visible &&
@@ -35879,7 +36009,6 @@
              *
              * @private
              * @function Highcharts.Series#autoIncrement
-             * @return {number}
              */
             Series.prototype.autoIncrement = function (x) {
                 var options = this.options,
@@ -35940,13 +36069,9 @@
              * not redraw the series. For API usage, use {@link Series#update}.
              * @private
              * @function Highcharts.Series#setOptions
-             *
              * @param {Highcharts.SeriesOptionsType} itemOptions
              * The series options.
-             *
-             * @return {Highcharts.SeriesOptionsType}
-             *
-             * @fires Highcharts.Series#event:afterSetOptions
+             * @emits Highcharts.Series#event:afterSetOptions
              */
             Series.prototype.setOptions = function (itemOptions) {
                 var chart = this.chart,
@@ -36104,7 +36229,6 @@
              *
              * @private
              * @function Highcharts.Series#getPointsCollection
-             * @return {Array<Highcharts.Point>}
              */
             Series.prototype.getPointsCollection = function () {
                 return (this.hasGroupedData ? this.points : this.data) || [];
@@ -36115,7 +36239,6 @@
              *
              * @private
              * @function Highcharts.Series#getSymbol
-             * @return {void}
              */
             Series.prototype.getSymbol = function () {
                 var seriesMarkerOption = this.options.marker;
@@ -36127,14 +36250,13 @@
              *
              * @private
              * @function Highcharts.Series#findPointIndex
-             * @param    {Highcharts.PointOptionsObject} optionsObject
-             *           The options of the point.
-             * @param    {number} fromIndex
-             *           The index to start searching from, used for optimizing
-             *           series with required sorting.
-             * @returns  {number|undefined}
-             *           Returns the index of a matching point, or undefined if no
-             *           match is found.
+             * @param {Highcharts.PointOptionsObject} optionsObject
+             * The options of the point.
+             * @param {number} fromIndex
+             * The index to start searching from, used for optimizing series with
+             * required sorting.
+             * @return {number|undefined}
+             * Returns the index of a matching point, or undefined if no match is found.
              */
             Series.prototype.findPointIndex = function (optionsObject, fromIndex) {
                 var id = optionsObject.id,
@@ -36517,11 +36639,8 @@
              *
              * @private
              * @function Highcharts.Series#sortData
-             *
              * @param {Array<Highcharts.PointOptionsType>} data
              * Force data grouping.
-             *
-             * @return {Array<Highcharts.PointOptionsObject>}
              */
             Series.prototype.sortData = function (data) {
                 var series = this,
@@ -36583,8 +36702,7 @@
              * @private
              * @function Highcharts.Series#getProcessedData
              * @param {boolean} [forceExtremesFromAll]
-             *        Force getting extremes of a total series data range.
-             * @return {Highcharts.SeriesProcessedDataObject}
+             * Force getting extremes of a total series data range.
              */
             Series.prototype.getProcessedData = function (forceExtremesFromAll) {
                 var series = this,
@@ -36617,7 +36735,7 @@
                     xExtremes = xAxis.getExtremes();
                     min = xExtremes.min;
                     max = xExtremes.max;
-                    updatingNames = xAxis.categories && !xAxis.names.length;
+                    updatingNames = !!(xAxis.categories && !xAxis.names.length);
                 }
                 // optionally filter out points outside the plot area
                 if (isCartesian &&
@@ -36680,8 +36798,7 @@
              * @private
              * @function Highcharts.Series#processData
              * @param {boolean} [force]
-             *        Force data grouping.
-             * @return {boolean|undefined}
+             * Force data grouping.
              */
             Series.prototype.processData = function (force) {
                 var series = this,
@@ -36702,7 +36819,7 @@
                 series.cropStart = processedData.cropStart;
                 series.processedXData = processedData.xData;
                 series.processedYData = processedData.yData;
-                series.closestPointRange = series.basePointRange = processedData.closestPointRange;
+                series.closestPointRange = (series.basePointRange = processedData.closestPointRange);
                 fireEvent(series, 'afterProcessData');
             };
             /**
@@ -36712,12 +36829,6 @@
              *
              * @private
              * @function Highcharts.Series#cropData
-             * @param {Array<number>} xData
-             * @param {Array<number>} yData
-             * @param {number} min
-             * @param {number} max
-             * @param {number} [cropShoulder]
-             * @return {Highcharts.SeriesCropDataObject}
              */
             Series.prototype.cropData = function (xData, yData, min, max, cropShoulder) {
                 var dataLength = xData.length;
@@ -36758,7 +36869,7 @@
             Series.prototype.generatePoints = function () {
                 var series = this,
                     options = series.options,
-                    dataOptions = options.data,
+                    dataOptions = (series.processedData || options.data),
                     processedXData = series.processedXData,
                     processedYData = series.processedYData,
                     PointClass = series.pointClass,
@@ -36835,7 +36946,8 @@
                          * @readonly
                          */
                         // For faster access in Point.update
-                        point.index = hasGroupedData ? (groupCropStartIndex + i) : cursor;
+                        point.index = hasGroupedData ?
+                            (groupCropStartIndex + i) : cursor;
                         points[i] = point;
                     }
                 }
@@ -36895,12 +37007,9 @@
              *
              * @private
              * @function Highcharts.Series#getXExtremes
-             *
              * @param {Array<number>} xData
              * The data to inspect. Defaults to the current data within the visible
              * range.
-             *
-             * @return {Highcharts.RangeObject}
              */
             Series.prototype.getXExtremes = function (xData) {
                 return {
@@ -36914,14 +37023,11 @@
              *
              * @private
              * @function Highcharts.Series#getExtremes
-             *
              * @param {Array<number>} [yData]
              * The data to inspect. Defaults to the current data within the visible
              * range.
              * @param {boolean} [forceExtremesFromAll]
              * Force getting extremes of a total series data range.
-             *
-             * @return {Highcharts.DataExtremesObject}
              */
             Series.prototype.getExtremes = function (yData, forceExtremesFromAll) {
                 var xAxis = this.xAxis,
@@ -37021,11 +37127,8 @@
              *
              * @private
              * @function Highcharts.Series.getFirstValidPoint
-             *
              * @param {Array<Highcharts.PointOptionsType>} data
              * Array of options for points
-             *
-             * @return {Highcharts.PointOptionsType}
              */
             Series.prototype.getFirstValidPoint = function (data) {
                 var dataLength = data.length;
@@ -37045,7 +37148,7 @@
              *
              * @function Highcharts.Series#translate
              *
-             * @fires Highcharts.Series#events:translate
+             * @emits Highcharts.Series#events:translate
              */
             Series.prototype.translate = function () {
                 if (!this.processedXData) { // hidden series
@@ -37093,12 +37196,22 @@
                                 (stackThreshold ? 0 : threshold) ?
                             '-' :
                             '') + series.stackKey];
-                    if (yAxis.positiveValuesOnly && !yAxis.validatePositiveValue(yValue) ||
-                        xAxis.positiveValuesOnly && !xAxis.validatePositiveValue(xValue)) {
+                    if (yAxis.positiveValuesOnly &&
+                        !yAxis.validatePositiveValue(yValue) ||
+                        xAxis.positiveValuesOnly &&
+                            !xAxis.validatePositiveValue(xValue)) {
                         point.isNull = true;
                     }
-                    // Get the plotX translation
+                    /**
+                     * The translated X value for the point in terms of pixels. Relative
+                     * to the X axis position if the series has one, otherwise relative
+                     * to the plot area. Depending on the series type this value might
+                     * not be defined.
+                     * @name Highcharts.Point#plotX
+                     * @type {number|undefined}
+                     */
                     point.plotX = plotX = correctFloat(// #5236
+                    // Get the plotX translation
                     limitedRange(xAxis.translate(// #3923
                     xValue, 0, 0, 0, 1, pointPlacement, this.type === 'flags')) // #3923
                     );
@@ -37159,6 +37272,14 @@
                             false,
                             true);
                         if (typeof translated !== 'undefined') {
+                            /**
+                             * The translated Y value for the point in terms of pixels.
+                             * Relative to the Y axis position if the series has one,
+                             * otherwise relative to the plot area. Depending on the
+                             * series type this value might not be defined.
+                             * @name Highcharts.Point#plotY
+                             * @type {number|undefined}
+                             */
                             point.plotY = limitedRange(translated);
                         }
                     }
@@ -37173,10 +37294,7 @@
                         threshold ||
                         0);
                     // some API data
-                    point.category = (categories &&
-                        typeof categories[point.x] !== 'undefined' ?
-                        categories[point.x] :
-                        point.x);
+                    point.category = pick(categories && categories[point.x], point.x);
                     // Determine auto enabling of markers (#3635, #5099)
                     if (!point.isNull && point.visible !== false) {
                         if (typeof lastPlotX !== 'undefined') {
@@ -37229,8 +37347,6 @@
              *
              * @private
              * @function Highcharts.Series#getClip
-             *
-             * @return {Highcharts.Dictionary<number>}
              */
             Series.prototype.getClipBox = function () {
                 var _a = this,
@@ -37380,7 +37496,7 @@
              * @private
              * @function Highcharts.Series#afterAnimate
              *
-             * @fires Highcharts.Series#event:afterAnimate
+             * @emits Highcharts.Series#event:afterAnimate
              */
             Series.prototype.afterAnimate = function () {
                 var _this = this;
@@ -37529,26 +37645,26 @@
                 var seriesStateOptions,
                     pointStateOptions,
                     radius = pick(pointMarkerOptions.radius,
-                    seriesMarkerOptions.radius);
+                    seriesMarkerOptions && seriesMarkerOptions.radius);
                 // Handle hover and select states
                 if (state) {
                     seriesStateOptions = seriesMarkerOptions.states[state];
                     pointStateOptions = pointMarkerOptions.states &&
                         pointMarkerOptions.states[state];
-                    radius = pick(pointStateOptions && pointStateOptions.radius, seriesStateOptions && seriesStateOptions.radius, radius + (seriesStateOptions && seriesStateOptions.radiusPlus ||
+                    radius = pick(pointStateOptions && pointStateOptions.radius, seriesStateOptions && seriesStateOptions.radius, radius && radius + (seriesStateOptions && seriesStateOptions.radiusPlus ||
                         0));
                 }
                 point.hasImage = symbol && symbol.indexOf('url') === 0;
                 if (point.hasImage) {
                     radius = 0; // and subsequently width and height is not set
                 }
-                var attribs = {
+                var attribs = isNumber(radius) ? {
                         // Math.floor for #1843:
                         x: seriesOptions.crisp ?
                             Math.floor(point.plotX - radius) :
                             point.plotX - radius,
                         y: point.plotY - radius
-                    };
+                    } : {};
                 if (radius) {
                     attribs.width = attribs.height = 2 * radius;
                 }
@@ -37601,7 +37717,7 @@
                 // Handle hover and select states
                 state = state || 'normal';
                 if (state) {
-                    seriesStateOptions = seriesMarkerOptions.states[state] || {};
+                    seriesStateOptions = (seriesMarkerOptions.states[state] || {});
                     pointStateOptions = (pointMarkerOptions.states &&
                         pointMarkerOptions.states[state]) || {};
                     strokeWidth = pick(pointStateOptions.lineWidth, seriesStateOptions.lineWidth, strokeWidth + pick(pointStateOptions.lineWidthPlus, seriesStateOptions.lineWidthPlus, 0));
@@ -37626,7 +37742,7 @@
              * @private
              * @function Highcharts.Series#destroy
              *
-             * @fires Highcharts.Series#event:destroy
+             * @emits Highcharts.Series#event:destroy
              */
             Series.prototype.destroy = function (keepEventsForUpdate) {
                 var series = this,
@@ -37638,7 +37754,7 @@
                     point,
                     axis;
                 // add event hook
-                fireEvent(series, 'destroy');
+                fireEvent(series, 'destroy', { keepEventsForUpdate: keepEventsForUpdate });
                 // remove events
                 this.removeEvents(keepEventsForUpdate);
                 // erase from axes
@@ -37921,8 +38037,6 @@
              * Get the translation and scale for the plot area of this series.
              *
              * @function Highcharts.Series#getPlotBox
-             *
-             * @return {Highcharts.SeriesPlotBoxObject}
              */
             Series.prototype.getPlotBox = function () {
                 var chart = this.chart;
@@ -37967,7 +38081,7 @@
              *
              * @function Highcharts.Series#render
              *
-             * @fires Highcharts.Series#event:afterRender
+             * @emits Highcharts.Series#event:afterRender
              */
             Series.prototype.render = function () {
                 var series = this,
@@ -38413,7 +38527,7 @@
              * @param {boolean} [withEvent=true]
              *        Used internally, whether to fire the series `addPoint` event.
              *
-             * @fires Highcharts.Series#event:addPoint
+             * @emits Highcharts.Series#event:addPoint
              */
             Series.prototype.addPoint = function (options, redraw, shift, animation, withEvent) {
                 var series = this,
@@ -38450,7 +38564,10 @@
                     names[x] = point.name;
                 }
                 dataOptions.splice(i, 0, options);
-                if (isInTheMiddle) {
+                if (isInTheMiddle ||
+                    // When processedData is present we need to splice an empty slot
+                    // into series.data, otherwise generatePoints won't pick it up.
+                    series.processedData) {
                     series.data.splice(i, 0, null);
                     series.processData();
                 }
@@ -38505,7 +38622,7 @@
              * @param {boolean|Partial<Highcharts.AnimationOptionsObject>} [animation]
              *        Whether and optionally how the series should be animated.
              *
-             * @fires Highcharts.Point#event:remove
+             * @emits Highcharts.Point#event:remove
              */
             Series.prototype.removePoint = function (i, redraw, animation) {
                 var series = this,
@@ -38559,7 +38676,7 @@
              * @param {boolean} [withEvent=true]
              *        Used internally, whether to fire the series `remove` event.
              *
-             * @fires Highcharts.Series#event:remove
+             * @emits Highcharts.Series#event:remove
              */
             Series.prototype.remove = function (redraw, animation, withEvent, keepEvents) {
                 var series = this,
@@ -38609,8 +38726,8 @@
              *        more operations on the chart, it is a good idea to set redraw to
              *        false and call {@link Chart#redraw} after.
              *
-             * @fires Highcharts.Series#event:update
-             * @fires Highcharts.Series#event:afterUpdate
+             * @emits Highcharts.Series#event:update
+             * @emits Highcharts.Series#event:afterUpdate
              */
             Series.prototype.update = function (options, redraw) {
                 options = cleanRecursively(options, this.userOptions);
@@ -38655,6 +38772,8 @@
                         typeof options.pointStart !== 'undefined' ||
                         typeof options.pointInterval !== 'undefined' ||
                         typeof options.relativeXValue !== 'undefined' ||
+                        options.joinBy ||
+                        options.mapData || // #11636
                         // Changes to data grouping requires new points in new group
                         series.hasOptionChanged('dataGrouping') ||
                         series.hasOptionChanged('pointStart') ||
@@ -38666,6 +38785,8 @@
                     preserve.push('data', 'isDirtyData', 'points', 'processedXData', 'processedYData', 'xIncrement', 'cropped', '_hasPointMarkers', '_hasPointLabels', 'clips', // #15420
                     // Networkgraph (#14397)
                     'nodes', 'layout', 
+                    // Treemap
+                    'level', 
                     // Map specific, consider moving it to series-specific preserve-
                     // properties (#10617)
                     'mapMap', 'mapData', 'minY', 'maxY', 'minX', 'maxX');
@@ -38692,7 +38813,9 @@
                         series.index : oldOptions.index,
                     pointStart: pick(
                     // when updating from blank (#7933)
-                    plotOptions && plotOptions.series && plotOptions.series.pointStart, oldOptions.pointStart, 
+                    (plotOptions &&
+                        plotOptions.series &&
+                        plotOptions.series.pointStart), oldOptions.pointStart, 
                     // when updating after addPoint
                     series.xData[0])
                 }, (!keepPoints && { data: series.options.data }), options);
@@ -38715,15 +38838,12 @@
                     series.remove(false, false, false, true);
                     if (casting) {
                         // Modern browsers including IE11
-                        // @todo slow, consider alternatives mentioned:
-                        // https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/setPrototypeOf
                         if (Object.setPrototypeOf) {
                             Object.setPrototypeOf(series, seriesTypes[newType].prototype);
                             // Legacy (IE < 11)
                         }
                         else {
-                            var ownEvents = Object.hasOwnProperty.call(series, 'hcEvents') &&
-                                    series.hcEvents;
+                            var ownEvents = Object.hasOwnProperty.call(series, 'hcEvents') && series.hcEvents;
                             for (n in initialSeriesProto) { // eslint-disable-line guard-for-in
                                 series[n] = void 0;
                             }
@@ -38821,13 +38941,17 @@
                     return option !== oldOption;
                 }
                 return option !==
-                    pick(plotOptions && plotOptions[this.type] && plotOptions[this.type][optionName], plotOptions && plotOptions.series && plotOptions.series[optionName], option);
+                    pick(plotOptions &&
+                        plotOptions[this.type] &&
+                        plotOptions[this.type][optionName], plotOptions &&
+                        plotOptions.series &&
+                        plotOptions.series[optionName], option);
             };
             /**
              * Runs on mouse over the series graphical items.
              *
              * @function Highcharts.Series#onMouseOver
-             * @fires Highcharts.Series#event:mouseOver
+             * @emits Highcharts.Series#event:mouseOver
              */
             Series.prototype.onMouseOver = function () {
                 var series = this,
@@ -38859,7 +38983,7 @@
              *
              * @function Highcharts.Series#onMouseOut
              *
-             * @fires Highcharts.Series#event:mouseOut
+             * @emits Highcharts.Series#event:mouseOut
              */
             Series.prototype.onMouseOut = function () {
                 // trigger the event only if listeners exist
@@ -39014,8 +39138,8 @@
              * operations on the chart, it is a good idea to set redraw to false and
              * call {@link Chart#redraw|chart.redraw()} after.
              *
-             * @fires Highcharts.Series#event:hide
-             * @fires Highcharts.Series#event:show
+             * @emits Highcharts.Series#event:hide
+             * @emits Highcharts.Series#event:show
              */
             Series.prototype.setVisible = function (vis, redraw) {
                 var series = this,
@@ -39079,7 +39203,7 @@
              *         Toggle visibility from a button
              *
              * @function Highcharts.Series#show
-             * @fires Highcharts.Series#event:show
+             * @emits Highcharts.Series#event:show
              */
             Series.prototype.show = function () {
                 this.setVisible(true);
@@ -39093,7 +39217,7 @@
              *         Toggle visibility from a button
              *
              * @function Highcharts.Series#hide
-             * @fires Highcharts.Series#event:hide
+             * @emits Highcharts.Series#event:hide
              */
             Series.prototype.hide = function () {
                 this.setVisible(false);
@@ -39114,8 +39238,8 @@
              * True to select the series, false to unselect. If undefined, the selection
              * state is toggled.
              *
-             * @fires Highcharts.Series#event:select
-             * @fires Highcharts.Series#event:unselect
+             * @emits Highcharts.Series#event:select
+             * @emits Highcharts.Series#event:unselect
              */
             Series.prototype.select = function (selected) {
                 var series = this;
@@ -39133,10 +39257,6 @@
              * Checks if a tooltip should be shown for a given point.
              *
              * @private
-             * @param {number} plotX
-             * @param {number} plotY
-             * @param {Highcharts.ChartIsInsideOptionsObject} [options]
-             * @return {boolean}
              */
             Series.prototype.shouldShowTooltip = function (plotX, plotY, options) {
                 if (options === void 0) { options = {}; }
@@ -39573,7 +39693,7 @@
                 if (scrollableMinWidth) {
                     this.scrollablePixelsX = scrollablePixelsX = Math.max(0, scrollableMinWidth - this.chartWidth);
                     if (scrollablePixelsX) {
-                        this.scrollablePlotBox = this.renderer.scrollablePlotBox = merge(this.plotBox);
+                        this.scrollablePlotBox = (this.renderer.scrollablePlotBox = merge(this.plotBox));
                         this.plotBox.width = this.plotWidth += scrollablePixelsX;
                         if (this.inverted) {
                             this.clipBox.height += scrollablePixelsX;
@@ -39591,7 +39711,7 @@
                 else if (scrollableMinHeight) {
                     this.scrollablePixelsY = scrollablePixelsY = Math.max(0, scrollableMinHeight - this.chartHeight);
                     if (scrollablePixelsY) {
-                        this.scrollablePlotBox = this.renderer.scrollablePlotBox = merge(this.plotBox);
+                        this.scrollablePlotBox = (this.renderer.scrollablePlotBox = merge(this.plotBox));
                         this.plotBox.height = this.plotHeight += scrollablePixelsY;
                         if (this.inverted) {
                             this.clipBox.width += scrollablePixelsY;
@@ -39776,7 +39896,7 @@
                     .addClass('highcharts-scrollable-mask')
                     .add();
                 addEvent(this, 'afterShowResetZoom', this.moveFixedElements);
-                addEvent(this, 'afterDrilldown', this.moveFixedElements);
+                addEvent(this, 'afterApplyDrilldown', this.moveFixedElements);
                 addEvent(this, 'afterLayOutTitles', this.moveFixedElements);
             }
             else {
@@ -39904,6 +40024,7 @@
          * area will become scrollable.
          *
          * @type      {number}
+         * @since     7.1.2
          * @apioption chart.scrollablePlotArea.minHeight
          */
         /**
@@ -39911,6 +40032,7 @@
          * area will become scrollable.
          *
          * @type      {number}
+         * @since     6.1.0
          * @apioption chart.scrollablePlotArea.minWidth
          */
         /**
@@ -39919,6 +40041,7 @@
          * Typically we would use 1 if the chart has right aligned Y axes.
          *
          * @type      {number}
+         * @since     6.1.0
          * @apioption chart.scrollablePlotArea.scrollPositionX
          */
         /**
@@ -39926,6 +40049,7 @@
          * 1, where 0 aligns the plot area to the top and 1 aligns it to the bottom.
          *
          * @type      {number}
+         * @since     7.1.2
          * @apioption chart.scrollablePlotArea.scrollPositionY
          */
         /**
@@ -40135,7 +40259,8 @@
                         chart = axis.chart,
                         renderer = chart.renderer,
                         stacks = stacking.stacks,
-                        stackLabelsAnim = axis.options.stackLabels && axis.options.stackLabels.animation,
+                        stackLabelsAnim = axis.options.stackLabels &&
+                            axis.options.stackLabels.animation,
                         animationConfig = getDeferredAnimation(chart,
                         stackLabelsAnim || false),
                         stackTotalGroup = stacking.stackTotalGroup = (stacking.stackTotalGroup ||
@@ -40282,6 +40407,7 @@
                         r: options.borderRadius || 0,
                         text: str,
                         rotation: options.rotation,
+                        // set default padding to 5 as it is in datalabels #12308
                         padding: pick(options.padding, 5),
                         visibility: 'hidden' // hidden until setOffset is called
                     };
@@ -40357,7 +40483,8 @@
                         }
                         else {
                             boxOffsetX = chart.inverted ?
-                                (isNegative ? bBox.width + padding : -padding) : bBox.width / 2;
+                                (isNegative ? bBox.width + padding : -padding) :
+                                bBox.width / 2;
                         }
                     }
                     boxOffsetY = chart.inverted ?
@@ -40402,22 +40529,6 @@
             /**
              * @private
              * @function Highcharts.StackItem#getStackBox
-             *
-             * @param {Highcharts.Chart} chart
-             *
-             * @param {Highcharts.StackItem} stackItem
-             *
-             * @param {number} x
-             *
-             * @param {number} y
-             *
-             * @param {number} xWidth
-             *
-             * @param {number} h
-             *
-             * @param {Highcharts.Axis} axis
-             *
-             * @return {Highcharts.BBoxObject}
              */
             StackItem.prototype.getStackBox = function (chart, stackItem, x, y, xWidth, h, axis) {
                 var reversed = stackItem.axis.reversed,
@@ -40427,7 +40538,8 @@
                     neg = (stackItem.isNegative && !reversed) ||
                         (!stackItem.isNegative && reversed); // #4056
                     return {
-                        x: inverted ? (neg ? y - axis.right : y - h + axis.pos - chart.plotLeft) :
+                        x: inverted ?
+                            (neg ? y - axis.right : y - h + axis.pos - chart.plotLeft) :
                             x + chart.xAxis[0].transB - chart.plotLeft,
                         y: inverted ?
                             axis.height - x - xWidth :
@@ -40671,11 +40783,6 @@
          *
          * @private
          * @function Highcharts.Series#getStackIndicator
-         * @param {Highcharts.StackItemIndicatorObject|undefined} stackIndicator
-         * @param {number} x
-         * @param {number} index
-         * @param {string} [key]
-         * @return {Highcharts.StackItemIndicatorObject}
          */
         Series.prototype.getStackIndicator = function (stackIndicator, x, index, key) {
             // Update stack indicator, when:
@@ -40683,11 +40790,12 @@
             // changed:
             if (!defined(stackIndicator) ||
                 stackIndicator.x !== x ||
-                (key && stackIndicator.key !== key)) {
+                (key && stackIndicator.stackKey !== key)) {
                 stackIndicator = {
                     x: x,
                     index: 0,
-                    key: key
+                    key: key,
+                    stackKey: key
                 };
             }
             else {
@@ -41489,7 +41597,9 @@
                     }
                     isNull = points[i].isNull;
                     plotX = pick(points[i].rectPlotX, points[i].plotX);
-                    yBottom = stacking ? pick(points[i].yBottom, translatedThreshold) : translatedThreshold;
+                    yBottom = stacking ?
+                        pick(points[i].yBottom, translatedThreshold) :
+                        translatedThreshold;
                     if (!isNull || connectNulls) {
                         if (!connectNulls) {
                             addDummyPoints(i, i - 1, 'left');
@@ -41593,24 +41703,22 @@
                                         var si = yAxisSeries[i].index;
                                         stackPoint = otherStack.points[si];
                                         if (!stackPoint) {
-                                            // If the next point in this series
-                                            // is missing, mark the point
-                                            // with point.leftNull or
-                                            // point.rightNull = true.
+                                            // If the next point in this series is
+                                            // missing, mark the point with
+                                            // point.leftNull or point.rightNull = true.
                                             if (si === series.index) {
                                                 pointMap[x][nullName] = true;
-                                                // If there are missing points in
-                                                // the next stack in any of the
-                                                // series below this one, we need
-                                                // to substract the missing values
-                                                // and add a hiatus to the left or
+                                                // If there are missing points in the next
+                                                // stack in any of the series below this
+                                                // one, we need to substract the missing
+                                                // values and add a hiatus to the left or
                                                 // right.
                                             }
                                             else if (visibleSeries_1[i]) {
-                                                stackedValues =
-                                                    stack[x].points[si];
+                                                stackedValues = stack[x].points[si];
                                                 if (stackedValues) {
-                                                    cliff -= stackedValues[1] - stackedValues[0];
+                                                    cliff -= (stackedValues[1] -
+                                                        stackedValues[0]);
                                                 }
                                             }
                                         }
@@ -41959,14 +42067,6 @@
              *
              * @private
              * @function Highcharts.seriesTypes.spline#getPointSpline
-             *
-             * @param {Array<Highcharts.Point>}
-             *
-             * @param {Highcharts.Point} point
-             *
-             * @param {number} i
-             *
-             * @return {Highcharts.SVGPathArray}
              */
             SplineSeries.prototype.getPointSpline = function (points, point, i) {
                 var 
@@ -42501,7 +42601,9 @@
                     options = series.options,
                     inverted = this.chart.inverted,
                     attr = {},
-                    translateProp = inverted ? 'translateX' : 'translateY';
+                    translateProp = inverted ?
+                        'translateX' :
+                        'translateY';
                 var translateStart,
                     translatedThreshold;
                 if (init) {
@@ -42562,7 +42664,6 @@
              *
              * @private
              * @function Highcharts.seriesTypes.column#getColumnMetrics
-             * @return {Highcharts.ColumnMetricsObject}
              */
             ColumnSeries.prototype.getColumnMetrics = function () {
                 var series = this,
@@ -42593,7 +42694,8 @@
                                 !series.chart.options.chart.ignoreHiddenSeries) &&
                             yAxis.len === otherYAxis.len &&
                             yAxis.pos === otherYAxis.pos) { // #642, #2086
-                            if (otherOptions.stacking && otherOptions.stacking !== 'group') {
+                            if (otherOptions.stacking &&
+                                otherOptions.stacking !== 'group') {
                                 stackKey = otherSeries.stackKey;
                                 if (typeof stackGroups[stackKey] ===
                                     'undefined') {
@@ -42703,32 +42805,34 @@
                 var _this = this;
                 var stacking = this.options.stacking;
                 if (!point.isNull && metrics.columnCount > 1) {
-                    var indexInCategory_1 = 0;
-                    var totalInCategory_1 = 0;
-                    // Loop over all the stacks on the Y axis. When stacking is
-                    // enabled, these are real point stacks. When stacking is not
-                    // enabled, but `centerInCategory` is true, there is one stack
-                    // handling the grouping of points in each category. This is
-                    // done in the `setGroupedPoints` function.
+                    var reversedStacks_1 = this.yAxis.options.reversedStacks;
+                    var indexInCategory_1 = 0,
+                        totalInCategory_1 = reversedStacks_1 ? 0 : -metrics.columnCount;
+                    // Loop over all the stacks on the Y axis. When stacking is enabled,
+                    // these are real point stacks. When stacking is not enabled, but
+                    // `centerInCategory` is true, there is one stack handling the
+                    // grouping of points in each category. This is done in the
+                    // `setGroupedPoints` function.
                     objectEach(this.yAxis.stacking && this.yAxis.stacking.stacks, function (stack) {
                         if (typeof point.x === 'number') {
                             var stackItem = stack[point.x.toString()];
                             if (stackItem) {
                                 var pointValues = stackItem.points[_this.index],
                                     total = stackItem.total;
-                                // If true `stacking` is enabled, count the
-                                // total number of non-null stacks in the
-                                // category, and note which index this point is
-                                // within those stacks.
+                                // If true `stacking` is enabled, count the total
+                                // number of non-null stacks in the category, and
+                                // note which index this point is within those
+                                // stacks.
                                 if (stacking) {
                                     if (pointValues) {
                                         indexInCategory_1 = totalInCategory_1;
                                     }
                                     if (stackItem.hasValidPoints) {
-                                        totalInCategory_1++;
+                                        reversedStacks_1 ? // #16169
+                                            totalInCategory_1++ : totalInCategory_1--;
                                     }
-                                    // If `stacking` is not enabled, look for the
-                                    // index and total of the `group` stack.
+                                    // If `stacking` is not enabled, look for the index
+                                    // and total of the `group` stack.
                                 }
                                 else if (isArray(pointValues)) {
                                     indexInCategory_1 = pointValues[1];
@@ -43931,8 +44035,10 @@
                         // Merge in series options for the point.
                         // @note dataLabelAttribs (like pointAttribs) would eradicate
                         // the need for dlOptions, and simplify the section below.
-                        pointOptions = splat(mergeArrays(seriesDlOptions, point.dlOptions || // dlOptions is used in treemaps
-                            (point.options && point.options.dataLabels)));
+                        pointOptions = splat(mergeArrays(seriesDlOptions, 
+                        // dlOptions is used in treemaps
+                        (point.dlOptions ||
+                            (point.options && point.options.dataLabels))));
                         // Handle each individual data label for this point
                         pointOptions.forEach(function (labelOptions, i) {
                             // Options for one datalabel
@@ -43950,11 +44056,11 @@
                                 style,
                                 rotation,
                                 attr,
-                                dataLabel = point.dataLabels ? point.dataLabels[i] :
-                                    point.dataLabel;
-                            var labelDistance = pick(labelOptions.distance,
-                                point.labelDistance),
+                                dataLabel = point.dataLabels ?
+                                    point.dataLabels[i] : point.dataLabel,
                                 isNew = !dataLabel;
+                            var labelDistance = pick(labelOptions.distance,
+                                point.labelDistance);
                             if (labelEnabled) {
                                 // Create individual options structure that can be
                                 // extended without affecting others
@@ -44006,8 +44112,18 @@
                             }
                             // If the point is outside the plot area, destroy it. #678,
                             // #820
-                            if (dataLabel && (!labelEnabled || !defined(labelText))) {
-                                point.dataLabel =
+                            if (dataLabel && (!labelEnabled ||
+                                !defined(labelText) ||
+                                !!dataLabel.div !== !!labelOptions.useHTML ||
+                                (
+                                // Change from no rotation to rotation and
+                                // vice versa. Don't use defined() because
+                                // rotation = 0 means also rotation = undefined
+                                (!dataLabel.rotation ||
+                                    !labelOptions.rotation) &&
+                                    dataLabel.rotation !== labelOptions.rotation))) {
+                                isNew = true;
+                                point.dataLabel = dataLabel =
                                     point.dataLabel && point.dataLabel.destroy();
                                 if (point.dataLabels) {
                                     // Remove point.dataLabels if this was the last one
@@ -44034,11 +44150,11 @@
                                         }
                                     }
                                 }
-                                // Individual labels are disabled if the are explicitly
-                                // disabled in the point options, or if they fall outside
-                                // the plot area.
                             }
-                            else if (labelEnabled && defined(labelText)) {
+                            // Individual labels are disabled if the are explicitly
+                            // disabled in the point options, or if they fall outside
+                            // the plot area.
+                            if (labelEnabled && defined(labelText)) {
                                 if (!dataLabel) {
                                     // Create new label element
                                     point.dataLabels = point.dataLabels || [];
@@ -44052,7 +44168,8 @@
                                     if (!i) {
                                         point.dataLabel = dataLabel;
                                     }
-                                    dataLabel.addClass(' highcharts-data-label-color-' + point.colorIndex +
+                                    dataLabel.addClass(' highcharts-data-label-color-' +
+                                        point.colorIndex +
                                         ' ' + (labelOptions.className || '') +
                                         ( // #3398
                                         labelOptions.useHTML ?
@@ -44080,7 +44197,7 @@
                                     if (point.dataLabelPath &&
                                         !labelOptions.textPath.enabled) {
                                         // clean the DOM
-                                        point.dataLabelPath = point.dataLabelPath.destroy();
+                                        point.dataLabelPath = (point.dataLabelPath.destroy());
                                     }
                                 }
                                 // Now the data label is created and placed at 0,0, so
@@ -44759,7 +44876,7 @@
                  *
                  * @type      {boolean}
                  * @default   false
-                 * @product   highcharts highstock
+                 * @product   highcharts highstock highmaps
                  * @apioption plotOptions.scatter.stickyTracking
                  */
                 /**
@@ -45149,12 +45266,19 @@
                 return isNumber(this.y) && this.y >= 0;
             };
             /**
-             * Toggle the visibility of the pie slice.
-             * @private
+             * Toggle the visibility of a pie slice or other data point. Note that this
+             * method is available only for some series, like pie, treemap and sunburst.
+             *
+             * @function Highcharts.Point#setVisible
+             *
+             * @param {boolean} [vis]
+             * True to show the pie slice or other data point, false to hide. If
+             * undefined, the visibility is toggled.
+             *
+             * @param {boolean} [redraw] Whether to redraw the chart after the point is
+             * altered. If doing more operations on the chart, it is a good idea to set
+             * redraw to false and call {@link Chart#redraw|chart.redraw()} after.
              *
-             * @param {boolean} vis
-             * Whether to show the slice or not. If undefined, the visibility is
-             * toggled.
              */
             PiePoint.prototype.setVisible = function (vis, redraw) {
                 var _this = this;
@@ -45200,10 +45324,10 @@
              * @param {boolean} sliced
              * When undefined, the slice state is toggled.
              *
-             * @param {boolean} redraw
+             * @param {boolean} [redraw]
              * Whether to redraw the chart. True by default.
              *
-             * @param {boolean|Partial<Highcharts.AnimationOptionsObject>}
+             * @param {boolean|Partial<Highcharts.AnimationOptionsObject>} [animation]
              * Animation options.
              */
             PiePoint.prototype.slice = function (sliced, redraw, animation) {
@@ -46279,7 +46403,7 @@
                  */
                 borderWidth: 1,
                 /**
-                 * @ignore-options
+                 * @ignore-option
                  * @private
                  */
                 lineWidth: void 0,
@@ -47057,7 +47181,8 @@
                     if (alignValue) {
                         xOffset = +alignValue * boxWidth;
                     }
-                    else if (isNumber(label.x) && Math.round(label.x) !== label.translateX) {
+                    else if (isNumber(label.x) &&
+                        Math.round(label.x) !== label.translateX) {
                         xOffset = label.x - label.translateX;
                     }
                     return {
@@ -47119,10 +47244,11 @@
          * @private
          * @function hideOrShow
          * @param {Highcharts.SVGElement} label
-         *        The label.
+         * The label.
          * @param {Highcharts.Chart} chart
-         *        The chart that contains the label.
+         * The chart that contains the label.
          * @return {boolean}
+         * Whether label is affected
          */
         function hideOrShow(label, chart) {
             var complete,
@@ -47131,13 +47257,15 @@
             if (label) {
                 newOpacity = label.newOpacity;
                 if (label.oldOpacity !== newOpacity) {
-                    // Make sure the label is completely hidden to avoid catching
-                    // clicks (#4362)
+                    // Make sure the label is completely hidden to avoid catching clicks
+                    // (#4362)
                     if (label.alignAttr && label.placed) { // data labels
                         label[newOpacity ? 'removeClass' : 'addClass']('highcharts-data-label-hidden');
                         complete = function () {
                             if (!chart.styledMode) {
-                                label.css({ pointerEvents: newOpacity ? 'auto' : 'none' });
+                                label.css({
+                                    pointerEvents: newOpacity ? 'auto' : 'none'
+                                });
                             }
                         };
                         isLabelAffected = true;
@@ -47299,8 +47427,7 @@
                         fn = condition.callback || function () {
                             return (this.chartWidth <= pick(condition.maxWidth,
                         Number.MAX_VALUE) &&
-                                this.chartHeight <=
-                                    pick(condition.maxHeight,
+                                this.chartHeight <= pick(condition.maxHeight,
                         Number.MAX_VALUE) &&
                                 this.chartWidth >= pick(condition.minWidth, 0) &&
                                 this.chartHeight >= pick(condition.minHeight, 0));
@@ -47343,7 +47470,7 @@
                     mergedOptions.isResponsiveOptions = true;
                     // Stringified key for the rules that currently apply.
                     ruleIds = (ruleIds.toString() || void 0);
-                    var currentRuleIds = currentResponsive && currentResponsive.ruleIds;
+                    var currentRuleIds = (currentResponsive && currentResponsive.ruleIds);
                     // Changes in what rules apply
                     if (ruleIds !== currentRuleIds) {
                         // Undo previous rules. Before we apply a new set of rules, we