highcharts 9.3.1 → 9.3.2

package/highstock.src.js

@@ -1,5 +1,5 @@
 /**
- * @license Highstock JS v9.3.1 (2021-11-05)
+ * @license Highstock JS v9.3.2 (2021-11-29)
  *
  * (c) 2009-2021 Torstein Honsi
  *
@@ -71,7 +71,7 @@
              *  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 = '9.3.2', Globals.win = w, 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
@@ -761,7 +761,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 +1030,7 @@
             });
         }
         /**
-         * Discard a HTML element by moving it to the bin and delete.
+         * Discard a HTML element
          *
          * @function Highcharts.discardElement
          *
@@ -1038,17 +1038,10 @@
          *        The HTML node to discard.
          */
         function discardElement(element) {
-            // create a garbage bin element, not part of the DOM
-            if (!garbageBin) {
-                garbageBin = createElement('div');
+            if (element && element.parentElement) {
+                element.parentElement.removeChild(element);
             }
-            // move the node and empty bin
-            if (element) {
-                garbageBin.appendChild(element);
-            }
-            garbageBin.innerHTML = '';
         }
-        var garbageBin;
         /**
          * Fix JS round off float errors.
          *
@@ -1247,7 +1240,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 +1512,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 +1521,6 @@
             }
             /**
              * @private
-             * @param {any} eventCollection - collection
-             * @return {void}
              */
             function removeAllEvents(eventCollection) {
                 var types,
@@ -3882,7 +3870,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 +3888,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 +3905,6 @@
              *
              * @param {Highcharts.TimeOptions} options
              *
-             * @return {void}
              */
             Time.prototype.update = function (options) {
                 var useUTC = pick(options && options.useUTC,
@@ -4005,6 +3993,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 +4013,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 +4149,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 +4184,7 @@
              * @param {number} [startOfWeek=1]
              *
              * @return {Highcharts.AxisTickPositionsArray}
+             * Time positions
              */
             Time.prototype.getTimeTicks = function (normalizedInterval, min, max, startOfWeek) {
                 var time = this,
@@ -4462,8 +4454,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
@@ -6982,6 +6974,7 @@
          * @function Highcharts.getOptions
          *
          * @return {Highcharts.Options}
+         * Default options.
          */
         function getOptions() {
             return defaultOptions;
@@ -6996,10 +6989,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 +7267,6 @@
              *
              * @function Highcharts.Fx#dSetter
              *
-             * @return {void}
              */
             Fx.prototype.dSetter = function () {
                 var paths = this.paths,
@@ -7323,7 +7315,6 @@
              *
              * @function Highcharts.Fx#update
              *
-             * @return {void}
              */
             Fx.prototype.update = function () {
                 var elem = this.elem,
@@ -7362,7 +7353,6 @@
              * @param {string} unit
              *        The property unit, for example `px`.
              *
-             * @return {void}
              */
             Fx.prototype.run = function (from, to, unit) {
                 var self = this,
@@ -7384,7 +7374,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 +7434,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 +7477,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 +7512,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 +7583,6 @@
              *
              * @function Highcharts.Fx#fillSetter
              *
-             * @return {void}
              */
             Fx.prototype.fillSetter = function () {
                 Fx.prototype.strokeSetter.apply(this, arguments);
@@ -7607,10 +7592,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 +7837,34 @@
          *  !!!!!!! 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,
             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;
@@ -7952,7 +7947,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 +7972,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;
@@ -8020,7 +8018,8 @@
                                 node = element;
                             }
                             else {
-                                error("Highcharts warning: Invalid tagName '" + tagName + "' in config");
+                                error('Highcharts warning: Invalid tagName ' +
+                                    tagName + ' in config');
                             }
                         }
                         // Add to the tree
@@ -8050,12 +8049,13 @@
                 var nodes = [];
                 markup = markup.trim();
                 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 };
                 }
@@ -8091,9 +8091,6 @@
                     addTo.push(astNode);
                 };
                 [].forEach.call(doc.body.childNodes, function (childNode) { return appendChildNodes(childNode, nodes); });
-                if (body) {
-                    discardElement(body);
-                }
                 return nodes;
             };
             /* *
@@ -8280,6 +8277,7 @@
                 'ul',
                 '#text'
             ];
+            AST.emptyHTML = emptyHTML;
             return AST;
         }());
         /* *
@@ -8615,7 +8613,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 +8869,6 @@
              *
              * @param {Highcharts.SVGDOMElement} element
              *
-             * @return {void}
              */
             SVGElement.prototype._defaultSetter = function (value, key, element) {
                 element.setAttribute(key, value);
@@ -9023,7 +9021,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;
@@ -9319,7 +9318,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);
                             }
                         }
@@ -9708,7 +9708,6 @@
              * @private
              * @function Highcharts.SVGElement#destroyShadows
              *
-             * @return {void}
              */
             SVGElement.prototype.destroyShadows = function () {
                 (this.shadows || []).forEach(function (shadow) {
@@ -9948,8 +9947,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 +10626,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 +10726,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 +10741,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 +10756,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 +11240,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 +11411,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 +11442,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 +11470,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 +11493,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.
              *
@@ -11861,7 +11861,6 @@
              *
              * @private
              *
-             * @return {void}
              */
             TextBuilder.prototype.modifyDOM = function () {
                 var _this = this;
@@ -12005,7 +12004,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,22 +12026,23 @@
              *
              * @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,
+                    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
                         }
                         else {
-                            attributes.style = 'font-weight:bold;' + (attributes.style || '');
+                            attributes.style = ('font-weight:bold;' + (attributes.style || ''));
                         }
                     }
                     else if (tagName === 'i' || tagName === 'em') {
@@ -12050,13 +12050,14 @@
                             attributes['class'] = 'highcharts-emphasized'; // eslint-disable-line dot-notation
                         }
                         else {
-                            attributes.style = 'font-style:italic;' + (attributes.style || '');
+                            attributes.style = ('font-style:italic;' + (attributes.style || ''));
                         }
                     }
                     // Modify attributes
                     if (isString(attributes.style)) {
                         attributes.style = attributes.style.replace(/(;| |^)color([ :])/, '$1fill$2');
                     }
+                    // Handle breaks
                     if (tagName === 'br') {
                         attributes['class'] = 'highcharts-br'; // eslint-disable-line dot-notation
                         node.textContent = '\u200B'; // zero-width space
@@ -12066,14 +12067,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;
                     // Recurse
-                    if (node.children) {
-                        node.children
+                    if (children) {
+                        children
                             .filter(function (c) { return c.tagName !== '#text'; })
                             .forEach(modifyChild);
                     }
@@ -12410,7 +12420,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 9.3.2'));
                 renderer.defs = this.createElement('defs').add();
                 renderer.allowHTML = allowHTML;
                 renderer.forExport = forExport;
@@ -12602,6 +12612,7 @@
              * @function Highcharts.SVGRenderer#destroy
              *
              * @return {null}
+             * Pass through value.
              */
             SVGRenderer.prototype.destroy = function () {
                 var renderer = this,
@@ -13278,6 +13289,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 +13519,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 +13584,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 +13887,6 @@
              *
              * @private
              * @function Highcharts.SVGRenderer#alignElements
-             * @return {void}
              */
             SVGRenderer.prototype.alignElements = function () {
                 this.alignedObjects.forEach(function (el) { return el.align(); });
@@ -14213,10 +14216,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 +14515,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 +14634,7 @@
                                      * @private
                                      * @param {*} value
                                      * @param {string} key
-                                     * @return {void}
-                                     */
+                                                             */
                                     function translateSetter(value, key) {
                                         parentGroup[key] = value;
                                         if (key === 'translateX') {
@@ -14652,7 +14657,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 +17771,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 +18025,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 +18065,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,
@@ -18710,8 +18715,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 +18752,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.
@@ -18912,7 +18918,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 +19011,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 +19110,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
@@ -19357,6 +19343,7 @@
              * @function Highcharts.Axis#getMinorTickInterval
              *
              * @return {number|"auto"|null}
+             * Legacy option
              */
             Axis.prototype.getMinorTickInterval = function () {
                 var options = this.options;
@@ -19466,7 +19453,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 +19509,6 @@
              *
              * @private
              * @function Highcharts.Axis#getClosest
-             *
-             * @return {number}
              */
             Axis.prototype.getClosest = function () {
                 var ret;
@@ -19641,7 +19627,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 +19663,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 +19684,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 +19713,6 @@
             /**
              * @private
              * @function Highcharts.Axis#minFromRange
-             *
-             * @return {number|undefined}
              */
             Axis.prototype.minFromRange = function () {
                 var axis = this;
@@ -19742,7 +19728,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 +19925,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 +19976,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 +19985,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
@@ -20246,7 +20233,9 @@
                     axis.softThreshold ? 0 : null);
                 var len,
                     i;
-                if (axis.hasData() && isNumber(axis.min) && isNumber(axis.max)) { // #14769
+                if (axis.hasData() &&
+                    isNumber(axis.min) &&
+                    isNumber(axis.max)) { // #14769
                     if (currentTickAmount < tickAmount) {
                         while (tickPositions.length < tickAmount) {
                             // Extend evenly for both sides unless we're on the
@@ -20298,7 +20287,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 +20375,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 +20405,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 +20615,6 @@
              *
              * @private
              * @function Highcharts.Axis#labelMetrics
-             *
-             * @return {Highcharts.FontMetricsObject}
              */
             Axis.prototype.labelMetrics = function () {
                 var index = this.tickPositions && this.tickPositions[0] || 0;
@@ -20648,8 +20627,6 @@
              *
              * @private
              * @function Highcharts.Axis#unsquish
-             *
-             * @return {number}
              */
             Axis.prototype.unsquish = function () {
                 var labelOptions = this.options.labels,
@@ -21011,7 +20988,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 +21315,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 +21406,8 @@
                         (options.plotLines || [])
                             .concat(options.plotBands || [])
                             .forEach(function (plotLineOptions) {
-                            axis.addPlotBandOrLine(plotLineOptions);
+                            axis
+                                .addPlotBandOrLine(plotLineOptions);
                         });
                     }
                 } // end if hasData
@@ -21529,8 +21507,6 @@
              *
              * @private
              * @function Highcharts.Axis#getKeepProps
-             *
-             * @return {Array<string>}
              */
             Axis.prototype.getKeepProps = function () {
                 return (this.keepProps || Axis.keepProps);
@@ -21596,8 +21572,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 +21700,6 @@
              *
              * @private
              * @function Highcharts.Axis#hasVerticalPanning
-             *
-             * @return {boolean}
              */
             Axis.prototype.hasVerticalPanning = function () {
                 var panningOptions = this.chart.options.chart.panning;
@@ -21741,8 +21715,6 @@
             *
             * @param {unknown} value
             * The axis value
-            *
-            * @return {boolean}
             */
             Axis.prototype.validatePositiveValue = function (value) {
                 return isNumber(value) && value > 0;
@@ -21852,7 +21824,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 +22132,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 +22187,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 +22263,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 +22689,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 +23833,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 +23849,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) {
@@ -23908,10 +23869,6 @@
              * the context here is an object holding point, series, x, y etc.
              *
              * @function Highcharts.Tooltip#defaultFormatter
-             *
-             * @param {Highcharts.Tooltip} tooltip
-             *
-             * @return {Array<string>}
              */
             Tooltip.prototype.defaultFormatter = function (tooltip) {
                 var items = this.points || splat(this);
@@ -23951,12 +23908,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 +23952,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 +23982,7 @@
              * @function Highcharts.Tooltip#getLabel
              *
              * @return {Highcharts.SVGElement}
+             * Tooltip label
              */
             Tooltip.prototype.getLabel = function () {
                 var tooltip = this,
@@ -24041,7 +23993,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 +24110,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,
@@ -24536,7 +24481,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 +24615,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 +24639,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 +24831,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 +24876,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 +25012,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,
@@ -25474,7 +25420,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 +25564,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 +25615,6 @@
              *
              * @private
              * @function Highcharts.Point#getGraphicalProps
-             * @param {Highcharts.Dictionary<number>} [kinds]
-             * @return {Highcharts.PointGraphicalProps}
              */
             Point.prototype.getGraphicalProps = function (kinds) {
                 var point = this,
@@ -25767,8 +25713,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 +25739,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 +25825,6 @@
             /**
              * @private
              * @function Highcharts.Point#resolveColor
-             * @return {void}
              */
             Point.prototype.resolveColor = function () {
                 var series = this.series,
@@ -26015,7 +25959,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 +25977,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 +26082,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 +26152,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 +26199,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 +26260,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({
@@ -26776,7 +26723,7 @@
                         Pointer.unbindDocumentMouseUp = Pointer.unbindDocumentMouseUp();
                     }
                     if (Pointer.unbindDocumentTouchEnd) {
-                        Pointer.unbindDocumentTouchEnd = Pointer.unbindDocumentTouchEnd();
+                        Pointer.unbindDocumentTouchEnd = (Pointer.unbindDocumentTouchEnd());
                     }
                 }
                 // memory and CPU leak
@@ -27129,6 +27076,7 @@
              * Pointer event, extended with `chartX` and `chartY` properties.
              *
              * @return {Highcharts.PointerAxisCoordinatesObject}
+             * Axis coordinates.
              */
             Pointer.prototype.getCoordinates = function (e) {
                 var coordinates = {
@@ -27167,7 +27115,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.
              */
@@ -27464,9 +27412,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 +27560,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 +27704,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 +27808,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,
@@ -28611,7 +28562,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 +28582,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 +28732,7 @@
                 /**
                  * @private
                  * @param {string} key
-                 * @return {void}
-                 */
+                     */
                 function destroyItems(key) {
                     if (this[key]) {
                         this[key] = this[key].destroy();
@@ -28998,13 +28949,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 +29022,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 = [];
@@ -29338,7 +29292,6 @@
              * @private
              * @function Highcharts.align
              * @param {Highcharts.BBoxObject} alignTo
-             * @return {void}
              */
             Legend.prototype.align = function (alignTo) {
                 if (alignTo === void 0) { alignTo = this.chart.spacingBox; }
@@ -29370,8 +29323,6 @@
              *
              * @private
              * @function Highcharts.Legend#handleOverflow
-             * @param {number} legendHeight
-             * @return {number}
              */
             Legend.prototype.handleOverflow = function (legendHeight) {
                 var legend = this,
@@ -29532,7 +29483,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 +29571,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 +29662,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 +30091,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 +30118,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 +30298,6 @@
              *
              * @private
              * @function Highcharts.Series#getSeriesOrderByLinks
-             * @return {Array<Highcharts.Series>}
              */
             Chart.prototype.getSeriesOrderByLinks = function () {
                 return this.series.concat().sort(function (a, b) {
@@ -30430,7 +30378,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 +30390,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 +30414,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 +30581,6 @@
                 var series = this.series;
                 /**
                  * @private
-                 * @param {Highcharts.Axis|Highcharts.Series} item
-                 * @return {boolean}
                  */
                 function itemById(item) {
                     return (item.id === id ||
@@ -30656,8 +30604,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 +30787,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 +30795,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 +30803,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 +30979,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 +31016,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 +31101,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 +31267,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 +31326,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 +31449,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 +31583,6 @@
              *
              * @private
              * @function Highcharts.Chart#propFromSeries
-             * @return {void}
              */
             Chart.prototype.propFromSeries = function () {
                 var chart = this,
@@ -31679,7 +31626,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 +31854,7 @@
              *
              * @function Highcharts.Chart#destroy
              *
-             * @fires Highcharts.Chart#event:destroy
+             * @emits Highcharts.Chart#event:destroy
              */
             Chart.prototype.destroy = function () {
                 var chart = this,
@@ -31959,7 +31906,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 +31922,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 +31986,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 +32033,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 +32293,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 +32562,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 +32600,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 +32615,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
@@ -34769,9 +34717,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 +34728,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
@@ -35861,7 +35810,6 @@
              *
              * @private
              * @function Highcharts.Series#hasData
-             * @return {boolean}
              */
             Series.prototype.hasData = function () {
                 return ((this.visible &&
@@ -35879,7 +35827,6 @@
              *
              * @private
              * @function Highcharts.Series#autoIncrement
-             * @return {number}
              */
             Series.prototype.autoIncrement = function (x) {
                 var options = this.options,
@@ -35940,13 +35887,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 +36047,6 @@
              *
              * @private
              * @function Highcharts.Series#getPointsCollection
-             * @return {Array<Highcharts.Point>}
              */
             Series.prototype.getPointsCollection = function () {
                 return (this.hasGroupedData ? this.points : this.data) || [];
@@ -36115,7 +36057,6 @@
              *
              * @private
              * @function Highcharts.Series#getSymbol
-             * @return {void}
              */
             Series.prototype.getSymbol = function () {
                 var seriesMarkerOption = this.options.marker;
@@ -36127,14 +36068,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 +36457,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 +36520,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,
@@ -36680,8 +36616,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 +36637,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 +36647,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;
@@ -36835,7 +36764,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 +36825,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 +36841,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 +36945,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 +36966,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,8 +37014,10 @@
                                 (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
@@ -37229,8 +37152,6 @@
              *
              * @private
              * @function Highcharts.Series#getClip
-             *
-             * @return {Highcharts.Dictionary<number>}
              */
             Series.prototype.getClipBox = function () {
                 var _a = this,
@@ -37380,7 +37301,7 @@
              * @private
              * @function Highcharts.Series#afterAnimate
              *
-             * @fires Highcharts.Series#event:afterAnimate
+             * @emits Highcharts.Series#event:afterAnimate
              */
             Series.prototype.afterAnimate = function () {
                 var _this = this;
@@ -37601,7 +37522,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 +37547,7 @@
              * @private
              * @function Highcharts.Series#destroy
              *
-             * @fires Highcharts.Series#event:destroy
+             * @emits Highcharts.Series#event:destroy
              */
             Series.prototype.destroy = function (keepEventsForUpdate) {
                 var series = this,
@@ -37921,8 +37842,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 +37886,7 @@
              *
              * @function Highcharts.Series#render
              *
-             * @fires Highcharts.Series#event:afterRender
+             * @emits Highcharts.Series#event:afterRender
              */
             Series.prototype.render = function () {
                 var series = this,
@@ -38413,7 +38332,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,
@@ -38505,7 +38424,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 +38478,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 +38528,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);
@@ -38692,7 +38611,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);
@@ -38722,8 +38643,7 @@
                             // 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 +38741,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 +38783,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 +38938,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 +39003,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 +39017,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 +39038,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 +39057,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 +39493,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 +39511,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;
@@ -40135,7 +40055,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 +40203,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 +40279,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 +40325,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 +40334,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 +40579,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:
@@ -41489,7 +41392,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 +41498,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 +41862,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 +42396,9 @@
                     options = series.options,
                     inverted = this.chart.inverted,
                     attr = {},
-                    translateProp = inverted ? 'translateX' : 'translateY';
+                    translateProp = inverted ?
+                        'translateX' :
+                        'translateY';
                 var translateStart,
                     translatedThreshold;
                 if (init) {
@@ -42562,7 +42459,6 @@
              *
              * @private
              * @function Highcharts.seriesTypes.column#getColumnMetrics
-             * @return {Highcharts.ColumnMetricsObject}
              */
             ColumnSeries.prototype.getColumnMetrics = function () {
                 var series = this,
@@ -42593,7 +42489,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') {
@@ -42705,21 +42602,21 @@
                 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.
+                    // 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;
@@ -42727,8 +42624,8 @@
                                     if (stackItem.hasValidPoints) {
                                         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 +43828,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,8 +43849,8 @@
                                 style,
                                 rotation,
                                 attr,
-                                dataLabel = point.dataLabels ? point.dataLabels[i] :
-                                    point.dataLabel;
+                                dataLabel = point.dataLabels ?
+                                    point.dataLabels[i] : point.dataLabel;
                             var labelDistance = pick(labelOptions.distance,
                                 point.labelDistance),
                                 isNew = !dataLabel;
@@ -44006,8 +43905,10 @@
                             }
                             // 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)) {
+                                point.dataLabel = dataLabel =
                                     point.dataLabel && point.dataLabel.destroy();
                                 if (point.dataLabels) {
                                     // Remove point.dataLabels if this was the last one
@@ -44034,11 +43935,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 +43953,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 +43982,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
@@ -45200,10 +45102,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 +46181,7 @@
                  */
                 borderWidth: 1,
                 /**
-                 * @ignore-options
+                 * @ignore-option
                  * @private
                  */
                 lineWidth: void 0,
@@ -47057,7 +46959,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 +47022,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 +47035,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 +47205,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 +47248,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
@@ -47831,12 +47736,12 @@
                     while (i--) {
                         translated = translatedArr[i];
                         distance = Math.abs(lastTranslated - translated);
-                        // #4175 - when axis is reversed, the distance, is negative
-                        // but tickPixelIntervalOption positive, so we need to
-                        // compare the same values
+                        // #4175 - when axis is reversed, the distance, is negative but
+                        // tickPixelIntervalOption positive, so we need to compare the
+                        // same values
                         // Remove ticks that are closer than 0.6 times the pixel
-                        // interval from the one to the right, but not if it is
-                        // close to the median distance (#748).
+                        // interval from the one to the right, but not if it is close to
+                        // the median distance (#748).
                         if (lastTranslated &&
                             distance < tickPixelIntervalOption * 0.8 &&
                             (medianDistance === null || distance < medianDistance * 0.8)) {
@@ -47868,11 +47773,8 @@
              *
              * @private
              * @function Highcharts.Axis#index2val
-             *
              * @param {number} index
-             *        The index value of searched point
-             *
-             * @return {number}
+             * The index value of searched point
              */
             function index2val(index) {
                 var axis = this,
@@ -47909,11 +47811,8 @@
              *
              * @private
              * @function Highcharts.Axis#lin2val
-             *
              * @param {number} val
-             *        The linear abstracted value.
-             *
-             * @return {number}
+             * The linear abstracted value.
              */
             function lin2val(val) {
                 var axis = this,
@@ -47926,37 +47825,37 @@
                         return val;
                 }
                 // Convert back from modivied value to pixels. // #15970
-                var pixelVal = (val - localMin) * localA + axis.minPixelPadding,
+                var pixelVal = (val - localMin) * localA +
+                        axis.minPixelPadding,
                     isInside = pixelVal > 0 && pixelVal < axis.left + axis.len;
-                // If the value is not inside the plot area,
-                // use the extended positions.
+                // If the value is not inside the plot area, use the extended positions.
                 // (array contains also points that are outside of the plotArea).
                 if (!isInside) {
                     // When iterating for the first time,
                     // get the extended ordinal positional and assign them.
                     if (!ordinal.extendedOrdinalPositions) {
-                        ordinal.extendedOrdinalPositions = ordinal.getExtendedPositions();
+                        ordinal.extendedOrdinalPositions = (ordinal.getExtendedPositions());
                     }
                     positions = ordinal.extendedOrdinalPositions;
                 }
-                // In some cases (especially in early stages of the chart creation)
-                // the getExtendedPositions might return undefined.
+                // In some cases (especially in early stages of the chart creation) the
+                // getExtendedPositions might return undefined.
                 if (positions && positions.length) {
                     var index = ordinal.getIndexOfPoint(pixelVal,
                         positions),
                         mantissa = correctFloat(index % 1);
-                    // Check if the index is inside position array.
-                    // If true, read/approximate value for that exact index.
+                    // Check if the index is inside position array. If true,
+                    // read/approximate value for that exact index.
                     if (index >= 0 && index < positions.length - 1) {
                         var leftNeighbour = positions[Math.floor(index)],
                             rightNeighbour = positions[Math.ceil(index)],
                             distance = rightNeighbour - leftNeighbour;
                         return positions[Math.floor(index)] + mantissa * distance;
                     }
-                    // For cases when the index is not in the extended ordinal
-                    // position array, like when the value we are looking
-                    // for exceed the available data,
-                    // approximate that value based on the calculated slope.
+                    // For cases when the index is not in the extended ordinal position
+                    // array, like when the value we are looking for exceed the
+                    // available data, approximate that value based on the calculated
+                    // slope.
                     var positionsLength = positions.length,
                         firstPositionsValue = positions[0],
                         lastPositionsValue = positions[positionsLength - 1],
@@ -47969,8 +47868,8 @@
                 return val;
             }
             /**
-             * Internal function to calculate the precise index
-             * in ordinalPositions array.
+             * Internal function to calculate the precise index in ordinalPositions
+             * array.
              * @private
              */
             function getIndexInArray(ordinalPositions, val) {
@@ -48068,7 +47967,11 @@
                         // how many ordinal units did we move?
                         movedUnits = (mouseDownX - chartX) / pointPixelWidth, 
                         // get index of all the chart's points
-                        extendedAxis = { ordinal: { positions: xAxis.ordinal.getExtendedPositions() } },
+                        extendedAxis = {
+                            ordinal: {
+                                positions: xAxis.ordinal.getExtendedPositions()
+                            }
+                        },
                         index2val_1 = xAxis.index2val,
                         val2lin_1 = xAxis.val2lin;
                     var trimmedRange = void 0,
@@ -48088,37 +47991,41 @@
                         }
                         if (movedUnits < 0) {
                             searchAxisLeft = extendedAxis;
-                            searchAxisRight = xAxis.ordinal.positions ? xAxis : extendedAxis;
+                            searchAxisRight = xAxis.ordinal.positions ?
+                                xAxis : extendedAxis;
                         }
                         else {
-                            searchAxisLeft = xAxis.ordinal.positions ? xAxis : extendedAxis;
+                            searchAxisLeft = xAxis.ordinal.positions ?
+                                xAxis : extendedAxis;
                             searchAxisRight = extendedAxis;
                         }
-                        // In grouped data series, the last ordinal position
-                        // represents the grouped data, which is to the left of the
-                        // real data max. If we don't compensate for this, we will
-                        // be allowed to pan grouped data series passed the right of
-                        // the plot area.
+                        // In grouped data series, the last ordinal position represents
+                        // the grouped data, which is to the left of the real data max.
+                        // If we don't compensate for this, we will be allowed to pan
+                        // grouped data series passed the right of the plot area.
                         ordinalPositions = searchAxisRight.ordinal.positions;
                         if (dataMax >
                             ordinalPositions[ordinalPositions.length - 1]) {
                             ordinalPositions.push(dataMax);
                         }
-                        // Get the new min and max values by getting the ordinal
-                        // index for the current extreme, then add the moved units
-                        // and translate back to values. This happens on the
-                        // extended ordinal positions if the new position is out of
-                        // range, else it happens on the current x axis which is
-                        // smaller and faster.
+                        // Get the new min and max values by getting the ordinal index
+                        // for the current extreme, then add the moved units and
+                        // translate back to values. This happens on the extended
+                        // ordinal positions if the new position is out of range, else
+                        // it happens on the current x axis which is smaller and faster.
                         chart.fixedRange = max - min;
-                        trimmedRange = xAxis.navigatorAxis.toFixedRange(null, null, index2val_1.apply(searchAxisLeft, [
-                            val2lin_1.apply(searchAxisLeft, [min, true]) + movedUnits
+                        trimmedRange = xAxis.navigatorAxis
+                            .toFixedRange(void 0, void 0, index2val_1.apply(searchAxisLeft, [
+                            val2lin_1.apply(searchAxisLeft, [min, true]) +
+                                movedUnits
                         ]), index2val_1.apply(searchAxisRight, [
-                            val2lin_1.apply(searchAxisRight, [max, true]) + movedUnits
+                            val2lin_1.apply(searchAxisRight, [max, true]) +
+                                movedUnits
                         ]));
                         // Apply it if it is within the available data range
                         if (trimmedRange.min >= Math.min(extremes.dataMin, min) &&
-                            trimmedRange.max <= Math.max(dataMax, max) + overscroll) {
+                            trimmedRange.max <= Math.max(dataMax, max) +
+                                overscroll) {
                             xAxis.setExtremes(trimmedRange.min, trimmedRange.max, true, false, { trigger: 'pan' });
                         }
                         chart.mouseDownX = chartX; // set new reference for next run
@@ -48158,14 +48065,10 @@
              *
              * @private
              * @function Highcharts.Axis#val2lin
-             *
              * @param {number} val
              * The axis value.
-             *
              * @param {boolean} [toIndex]
              * Whether to return the index in the ordinalPositions or the new value.
-             *
-             * @return {number}
              */
             function val2lin(val, toIndex) {
                 var axis = this,
@@ -48212,7 +48115,8 @@
                         val <=
                             extendedOrdinalPositions[length_2 - 1]) {
                         // Return Value
-                        ordinalIndex = getIndexInArray(extendedOrdinalPositions, val) - originalPositionsReference;
+                        ordinalIndex = getIndexInArray(extendedOrdinalPositions, val) -
+                            originalPositionsReference;
                     }
                     else {
                         // Since ordinal.slope is the average distance between 2
@@ -48294,7 +48198,9 @@
                         axis.series.forEach(function (series, i) {
                             uniqueOrdinalPositions = [];
                             if ((!ignoreHiddenSeries || series.visible !== false) &&
-                                (series.takeOrdinalPosition !== false || hasBreaks)) {
+                                (series
+                                    .takeOrdinalPosition !== false ||
+                                    hasBreaks)) {
                                 // concatenate the processed X data into the existing
                                 // positions, or the empty array
                                 ordinalPositions = ordinalPositions.concat(series.processedXData);
@@ -48310,13 +48216,15 @@
                                 if (len) {
                                     i = 0;
                                     while (i < len - 1) {
-                                        if (ordinalPositions[i] !== ordinalPositions[i + 1]) {
+                                        if (ordinalPositions[i] !==
+                                            ordinalPositions[i + 1]) {
                                             uniqueOrdinalPositions.push(ordinalPositions[i + 1]);
                                         }
                                         i++;
                                     }
                                     // Check first item:
-                                    if (uniqueOrdinalPositions[0] !== ordinalPositions[0]) {
+                                    if (uniqueOrdinalPositions[0] !==
+                                        ordinalPositions[0]) {
                                         uniqueOrdinalPositions.unshift(ordinalPositions[0]);
                                     }
                                     ordinalPositions = uniqueOrdinalPositions;
@@ -48332,7 +48240,8 @@
                             dist = ordinalPositions[1] - ordinalPositions[0];
                             i = len - 1;
                             while (i-- && !useOrdinal) {
-                                if (ordinalPositions[i + 1] - ordinalPositions[i] !== dist) {
+                                if (ordinalPositions[i + 1] - ordinalPositions[i] !==
+                                    dist) {
                                     useOrdinal = true;
                                 }
                             }
@@ -48341,8 +48250,8 @@
                             // spaced.
                             if (!axis.options.keepOrdinalPadding &&
                                 (ordinalPositions[0] - min > dist ||
-                                    max - ordinalPositions[ordinalPositions.length - 1] >
-                                        dist)) {
+                                    (max -
+                                        ordinalPositions[ordinalPositions.length - 1]) > dist)) {
                                 useOrdinal = true;
                             }
                         }
@@ -48520,9 +48429,10 @@
                             fakeAxis.series.push(fakeSeries);
                             series.processData.apply(fakeSeries);
                         });
-                        // Force to use the ordinal when points are evenly spaced
-                        // (e.g. weeks), #3825.
-                        if (fakeSeries.closestPointRange !== fakeSeries.basePointRange &&
+                        // Force to use the ordinal when points are evenly spaced (e.g.
+                        // weeks), #3825.
+                        if ((fakeSeries.closestPointRange !==
+                            fakeSeries.basePointRange) &&
                             fakeSeries.currentDataGrouping) {
                             fakeAxis.forceOrdinal = true;
                         }
@@ -48570,8 +48480,8 @@
                     if (!groupIntervalFactor) {
                         // Register all the distances in an array
                         for (i = 0; i < len - 1; i++) {
-                            distances[i] =
-                                processedXData[i + 1] - processedXData[i];
+                            distances[i] = (processedXData[i + 1] -
+                                processedXData[i]);
                         }
                         // Sort them and find the median
                         distances.sort(function (a, b) {
@@ -48593,15 +48503,12 @@
                  *
                  * @private
                  * @param {number} val
-                 *        The pixel value of a point.
+                 * The pixel value of a point.
                  *
                  * @param {Array<number>} [ordinallArray]
-                 *        An array of all points available on the axis
-                 *        for the given data set.
-                 *        Either ordinalPositions if the value is inside the plotArea
-                 *        or extendedOrdinalPositions if not.
-                 *
-                 * @return {number}
+                 * An array of all points available on the axis for the given data set.
+                 * Either ordinalPositions if the value is inside the plotArea or
+                 * extendedOrdinalPositions if not.
                  */
                 Additions.prototype.getIndexOfPoint = function (val, ordinalArray) {
                     var ordinal = this,
@@ -48622,10 +48529,11 @@
                             }
                         });
                     }
-                    // Distance in pixels between two points
-                    // on the ordinal axis in the current zoom.
-                    var ordinalPointPixelInterval = axis.translationSlope *
-                            (ordinal.slope || axis.closestPointRange || ordinal.overscrollPointsRange), 
+                    // Distance in pixels between two points on the ordinal axis in the
+                    // current zoom.
+                    var ordinalPointPixelInterval = axis.translationSlope * (ordinal.slope ||
+                            axis.closestPointRange ||
+                            ordinal.overscrollPointsRange), 
                         // toValue for the first point.
                         shiftIndex = (val - firstPointX) / ordinalPointPixelInterval;
                     return Additions.findIndexOf(ordinalArray, firstPointVal) + shiftIndex;
@@ -48661,19 +48569,20 @@
                  * @private
                  */
                 Additions.prototype.postProcessTickInterval = function (tickInterval) {
-                    // Problem: https://jsfiddle.net/highcharts/FQm4E/1/
-                    // This is a case where this algorithm doesn't work optimally. In
-                    // this case, the tick labels are spread out per week, but all the
-                    // gaps reside within weeks. So we have a situation where the labels
-                    // are courser than the ordinal gaps, and thus the tick interval
-                    // should not be altered.
+                    // Problem: https://jsfiddle.net/highcharts/FQm4E/1/. This is a case
+                    // where this algorithm doesn't work optimally. In this case, the
+                    // tick labels are spread out per week, but all the gaps reside
+                    // within weeks. So we have a situation where the labels are courser
+                    // than the ordinal gaps, and thus the tick interval should not be
+                    // altered.
                     var ordinal = this,
                         axis = ordinal.axis,
                         ordinalSlope = ordinal.slope;
                     var ret;
                     if (ordinalSlope) {
                         if (!axis.options.breaks) {
-                            ret = tickInterval / (ordinalSlope / axis.closestPointRange);
+                            ret = (tickInterval /
+                                (ordinalSlope / axis.closestPointRange));
                         }
                         else {
                             ret = axis.closestPointRange || tickInterval; // #7275
@@ -49430,8 +49339,11 @@
                                         (threshold > brk.from && y < brk.from)) {
                                         eventName = 'pointBreak';
                                     }
-                                    else if ((threshold < brk.from && y > brk.from && y < brk.to) ||
-                                        (threshold > brk.from && y > brk.to && y < brk.from)) {
+                                    else if ((threshold < brk.from &&
+                                        y > brk.from &&
+                                        y < brk.to) || (threshold > brk.from &&
+                                        y > brk.to &&
+                                        y < brk.from)) {
                                         eventName = 'pointInBreak';
                                     }
                                     if (eventName) {
@@ -49550,12 +49462,9 @@
                                 isNull: true,
                                 x: xRange
                             });
-                            // For stacked chart generate empty stack items,
-                            // #6546
+                            // For stacked chart generate empty stack items, #6546
                             if (yAxis.stacking && this.options.stacking) {
-                                stack = yAxis.stacking.stacks[this.stackKey][xRange] =
-                                    new StackItem(yAxis, yAxis.options
-                                        .stackLabels, false, xRange, this.stack);
+                                stack = yAxis.stacking.stacks[this.stackKey][xRange] = new StackItem(yAxis, yAxis.options.stackLabels, false, xRange, this.stack);
                                 stack.total = 0;
                             }
                         }
@@ -49792,10 +49701,12 @@
                                     repeat_1 = brk.repeat || Infinity;
                                     if (isNumber(min_1) && isNumber(max_1)) {
                                         if (Additions.isInBreak(brk, min_1)) {
-                                            min_1 += (brk.to % repeat_1) - (min_1 % repeat_1);
+                                            min_1 += ((brk.to % repeat_1) -
+                                                (min_1 % repeat_1));
                                         }
                                         if (Additions.isInBreak(brk, max_1)) {
-                                            max_1 -= (max_1 % repeat_1) - (brk.from % repeat_1);
+                                            max_1 -= ((max_1 % repeat_1) -
+                                                (brk.from % repeat_1));
                                         }
                                     }
                                 });
@@ -49843,13 +49754,17 @@
                                             to: brk.value,
                                             len: brk.value - start_1 - (brk.size || 0)
                                         });
-                                        length_1 += brk.value - start_1 - (brk.size || 0);
+                                        length_1 += (brk.value -
+                                            start_1 -
+                                            (brk.size || 0));
                                     }
                                 });
                                 brokenAxis.breakArray = breakArray_1;
                                 // Used with staticScale, and below the actual axis
                                 // length, when breaks are substracted.
-                                if (isNumber(min_1) && isNumber(max_1) && isNumber(axis.min)) {
+                                if (isNumber(min_1) &&
+                                    isNumber(max_1) &&
+                                    isNumber(axis.min)) {
                                     brokenAxis.unitLength = max_1 - min_1 - length_1 +
                                         pointRangePadding;
                                     fireEvent(axis, 'afterBreaks');
@@ -50132,13 +50047,17 @@
                         groupedXData = groupedData.groupedXData,
                         groupedYData = groupedData.groupedYData,
                         gapSize = 0;
-                    // The smoothed option is deprecated, instead,
-                    // there is a fallback to the new anchoring mechanism. #12455.
-                    if (dataGroupingOptions && dataGroupingOptions.smoothed && groupedXData.length) {
+                    // The smoothed option is deprecated, instead, there is a fallback
+                    // to the new anchoring mechanism. #12455.
+                    if (dataGroupingOptions &&
+                        dataGroupingOptions.smoothed &&
+                        groupedXData.length) {
                         dataGroupingOptions.firstAnchor = 'firstPoint';
                         dataGroupingOptions.anchor = 'middle';
                         dataGroupingOptions.lastAnchor = 'lastPoint';
-                        error(32, false, chart, { 'dataGrouping.smoothed': 'use dataGrouping.anchor' });
+                        error(32, false, chart, {
+                            'dataGrouping.smoothed': 'use dataGrouping.anchor'
+                        });
                     }
                     anchorPoints(series, groupedXData, xMax);
                     // Record what data grouping values were used
@@ -50215,7 +50134,8 @@
             pointArrayMap = series.pointArrayMap,
             pointArrayMapLength = pointArrayMap && pointArrayMap.length,
             extendedPointArrayMap = ['x'].concat(pointArrayMap || ['y']),
-            groupAll = this.options.dataGrouping && this.options.dataGrouping.groupAll,
+            groupAll = (this.options.dataGrouping &&
+                    this.options.dataGrouping.groupAll),
             pos = 0,
             start = 0,
             valuesLen,
@@ -50345,7 +50265,7 @@
             xMax) {
                 var options = series.options,
             dataGroupingOptions = options.dataGrouping,
-            totalRange = series.currentDataGrouping && series.currentDataGrouping.gapSize;
+            totalRange = (series.currentDataGrouping && series.currentDataGrouping.gapSize);
             var i;
             // DataGrouping x-coordinates.
             if (dataGroupingOptions && series.xData && totalRange && series.groupMap) {
@@ -50357,9 +50277,9 @@
                     anchor);
                 // Anchor points that are not extremes.
                 if (anchor && anchor !== 'start') {
-                    var shiftInterval = totalRange *
+                    var shiftInterval = (totalRange *
                             { middle: 0.5,
-                        end: 1 }[anchor];
+                        end: 1 }[anchor]);
                     i = groupedXData.length - 1;
                     while (i-- && i > 0) {
                         groupedXData[i] += shiftInterval;
@@ -50625,7 +50545,8 @@
             series.forEach(function (series) {
                 // Reset the groupPixelWidth, then calculate if needed.
                 series.groupPixelWidth = void 0; // #2110
-                series.groupPixelWidth = axis.getGroupPixelWidth && axis.getGroupPixelWidth();
+                series.groupPixelWidth = (axis.getGroupPixelWidth &&
+                    axis.getGroupPixelWidth());
                 if (series.groupPixelWidth) {
                     series.hasProcessed = true; // #2692
                 }
@@ -50664,7 +50585,8 @@
                     // Execute grouping if the amount of points is greater than the
                     // limit defined in groupPixelWidth
                     if (series[i].groupPixelWidth ||
-                        dataLength > (this.chart.plotSizeX / groupPixelWidth) ||
+                        (dataLength >
+                            (this.chart.plotSizeX / groupPixelWidth)) ||
                         (dataLength && dgOptions.forced)) {
                         doGrouping = true;
                     }
@@ -50805,10 +50727,10 @@
                 type = this.type,
                 plotOptions = this.chart.options.plotOptions,
                 defaultOptions = D.defaultOptions.plotOptions[type].dataGrouping, 
-                // External series, for example technical indicators should also
-                // inherit commonOptions which are not available outside this module
-                baseOptions = this.useCommonDataGrouping && commonOptions;
-            if (specificOptions[type] || baseOptions) { // #1284
+                // External series, for example technical indicators should also inherit
+                // commonOptions which are not available outside this module
+                baseOptions = (this.useCommonDataGrouping && commonOptions);
+            if (plotOptions && (specificOptions[type] || baseOptions)) { // #1284
                 if (!defaultOptions) {
                     defaultOptions = merge(commonOptions, specificOptions[type]);
                 }
@@ -50941,7 +50863,7 @@
          * to two weeks, the second and third item of the week array are used,
          *  and applied to the start and end date of the time span.
          *
-         * @type      {object}
+         * @type      {Object}
          * @apioption plotOptions.series.dataGrouping.dateTimeLabelFormats
          */
         /**
@@ -51279,10 +51201,7 @@
             /**
              * Function to create SVGPath of the point based on the
              * plot positions of this point.
-             *
-             * @param {SVGPath} point
-             * @param {SVGElement} graphic
-             * @returns {SVGPath}
+             * @private
              */
             HLCSeries.prototype.getPointPath = function (point, graphic) {
                 // crisp vector coordinates
@@ -51342,7 +51261,6 @@
             /**
              * @private
              * @function Highcharts.seriesTypes.hlc#init
-             * @return {void}
              */
             HLCSeries.prototype.init = function () {
                 _super.prototype.init.apply(this, arguments);
@@ -51368,7 +51286,6 @@
              *
              * @private
              * @function Highcharts.seriesTypes.hlc#translate
-             * @return {void}
              */
             HLCSeries.prototype.translate = function () {
                 var series = this,
@@ -51644,7 +51561,6 @@
              * Extend the parent method by adding up or down to the class name.
              * @private
              * @function Highcharts.seriesTypes.ohlc#getClassName
-             * @return {string}
              */
             OHLCPoint.prototype.getClassName = function () {
                 return _super.prototype.getClassName.call(this) +
@@ -51819,7 +51735,7 @@
              * @sample stock/demo/ohlc/
              *         OHLC chart
              *
-             * @extends      plotOptions.ohlc
+             * @extends      plotOptions.hlc
              * @product      highstock
              * @optionparent plotOptions.ohlc
              */
@@ -52084,7 +52000,6 @@
              *
              * @private
              * @function Highcharts.seriesTypes.candlestick#drawPoints
-             * @return {void}
              */
             CandlestickSeries.prototype.drawPoints = function () {
                 var series = this,
@@ -52629,8 +52544,8 @@
         /**
          * Create the circlepin and squarepin icons with anchor.
          * @private
-         * @param {string} shape - circle or square
-         * @return {void}
+         * @param {string} shape
+         * circle or square
          */
         function createPinSymbol(shape) {
             symbols[(shape + 'pin')] = function (x, y, w, h, options) {
@@ -53433,7 +53348,8 @@
                                 from = unitedMin + range * (1 - this.to);
                             }
                             if (this.shouldUpdateExtremes(e.DOMType)) {
-                                axis.setExtremes(from, to, true, e.DOMType !== 'mousemove' && e.DOMType !== 'touchmove', e);
+                                axis.setExtremes(from, to, true, (e.DOMType !== 'mousemove' &&
+                                    e.DOMType !== 'touchmove'), e);
                             }
                             else {
                                 // When live redraw is disabled, don't change extremes
@@ -53450,7 +53366,7 @@
                         scrollMin = _a.scrollMin,
                         scrollMax = _a.scrollMax,
                         scrollbar = axis.scrollbar,
-                        offset = axis.axisTitleMargin + (axis.titleOffset || 0),
+                        offset = (axis.axisTitleMargin + (axis.titleOffset || 0)),
                         scrollbarsOffsets = axis.chart.scrollbarsOffsets,
                         axisMargin = axis.options.margin || 0,
                         offsetsIndex,
@@ -53462,8 +53378,11 @@
                             if (!axis.opposite) {
                                 scrollbarsOffsets[1] += offset;
                             }
-                            scrollbar.position(axis.left, axis.top + axis.height + 2 + scrollbarsOffsets[1] -
-                                (axis.opposite ? axisMargin : 0), axis.width, axis.height);
+                            scrollbar.position(axis.left, (axis.top +
+                                axis.height +
+                                2 +
+                                scrollbarsOffsets[1] -
+                                (axis.opposite ? axisMargin : 0)), axis.width, axis.height);
                             // Next scrollbar should reserve space for margin (if set)
                             if (!axis.opposite) {
                                 scrollbarsOffsets[1] += axisMargin;
@@ -53480,7 +53399,10 @@
                                 xPosition = axis.opposite ? 0 : axisMargin;
                             }
                             else {
-                                xPosition = axis.left + axis.width + 2 + scrollbarsOffsets[0] -
+                                xPosition = axis.left +
+                                    axis.width +
+                                    2 +
+                                    scrollbarsOffsets[0] -
                                     (axis.opposite ? 0 : axisMargin);
                             }
                             scrollbar.position(xPosition, axis.top, axis.width, axis.height);
@@ -53504,10 +53426,10 @@
                             scrollbar.setRange(0, 1);
                         }
                         else {
-                            from =
-                                (axis.min - scrollMin) / (scrollMax - scrollMin);
-                            to =
-                                (axis.max - scrollMin) / (scrollMax - scrollMin);
+                            from = ((axis.min - scrollMin) /
+                                (scrollMax - scrollMin));
+                            to = ((axis.max - scrollMin) /
+                                (scrollMax - scrollMin));
                             if ((axis.horiz && !axis.reversed) ||
                                 (!axis.horiz && axis.reversed)) {
                                 scrollbar.setRange(from, to);
@@ -53526,7 +53448,8 @@
                         index = axis.horiz ? 2 : opposite ? 3 : 1,
                         scrollbar = axis.scrollbar;
                     if (scrollbar) {
-                        axis.chart.scrollbarsOffsets = [0, 0]; // reset scrollbars offsets
+                        // reset scrollbars offsets
+                        axis.chart.scrollbarsOffsets = [0, 0];
                         axis.chart.axisOffset[index] +=
                             scrollbar.size + scrollbar.options.margin;
                     }
@@ -53893,10 +53816,16 @@
                     mouseUpHandler = this.mouseUpHandler.bind(this);
                 // Mouse events
                 var _events = [
-                        [buttons[buttonsOrder[0]].element, 'click',
-                    this.buttonToMinClick.bind(this)],
-                        [buttons[buttonsOrder[1]].element, 'click',
-                    this.buttonToMaxClick.bind(this)],
+                        [
+                            buttons[buttonsOrder[0]].element,
+                            'click',
+                            this.buttonToMinClick.bind(this)
+                        ],
+                        [
+                            buttons[buttonsOrder[1]].element,
+                            'click',
+                            this.buttonToMaxClick.bind(this)
+                        ],
                         [track, 'click',
                     this.trackClick.bind(this)],
                         [bar, 'mousedown',
@@ -53918,7 +53847,8 @@
             };
             Scrollbar.prototype.buttonToMaxClick = function (e) {
                 var scroller = this;
-                var range = (scroller.to - scroller.from) * pick(scroller.options.step, 0.2);
+                var range = ((scroller.to - scroller.from) *
+                        pick(scroller.options.step, 0.2));
                 scroller.updatePosition(scroller.from + range, scroller.to + range);
                 fireEvent(scroller, 'changed', {
                     from: scroller.from,
@@ -53971,7 +53901,6 @@
              *
              * @private
              * @function Highcharts.Scrollbar#destroy
-             * @return {void}
              */
             Scrollbar.prototype.destroy = function () {
                 var scroller = this,
@@ -54004,7 +53933,6 @@
              * @function Highcharts.Scrollbar#drawScrollbarButton
              * @param {number} index
              *        0 is left, 1 is right
-             * @return {void}
              */
             Scrollbar.prototype.drawScrollbarButton = function (index) {
                 var scroller = this,
@@ -54097,7 +54025,8 @@
                 var scroller = this,
                     normalizedEvent = scroller.chart.pointer.normalize(e),
                     options = scroller.options,
-                    direction = options.vertical ? 'chartY' : 'chartX',
+                    direction = options.vertical ?
+                        'chartY' : 'chartX',
                     initPositions = scroller.initPositions || [];
                 var scrollPosition,
                     chartPosition,
@@ -54158,7 +54087,6 @@
              *        width of the scrollbar
              * @param {number} height
              *        height of the scorllbar
-             * @return {void}
              */
             Scrollbar.prototype.position = function (x, y, width, height) {
                 var scroller = this,
@@ -54207,7 +54135,6 @@
              *
              * @private
              * @function Highcharts.Scrollbar#removeEvents
-             * @return {void}
              */
             Scrollbar.prototype.removeEvents = function () {
                 this._events.forEach(function (args) {
@@ -54299,7 +54226,6 @@
              *        scale (0-1) where bar should start
              * @param {number} to
              *        scale (0-1) where bar should end
-             * @return {void}
              */
             Scrollbar.prototype.setRange = function (from, to) {
                 var scroller = this,
@@ -54378,8 +54304,6 @@
              *
              * @private
              * @function Highcharts.Scrollbar#shouldUpdateExtremes
-             * @param {string} [eventType]
-             * @return {boolean}
              */
             Scrollbar.prototype.shouldUpdateExtremes = function (eventType) {
                 return (pick(this.options.liveRedraw, H.svg && !H.isTouchDevice && !this.chart.isBoosting) ||
@@ -54429,7 +54353,6 @@
              * @function Highcharts.Scrollbar#updatePosition
              * @param  {number} from
              * @param  {number} to
-             * @return {void}
              */
             Scrollbar.prototype.updatePosition = function (from, to) {
                 if (to > 1) {
@@ -54512,11 +54435,6 @@
              *
              * @private
              * @function Highcharts.Axis#toFixedRange
-             * @param {number} [pxMin]
-             * @param {number} [pxMax]
-             * @param {number} [fixedMin]
-             * @param {number} [fixedMax]
-             * @return {*}
              */
             NavigatorAxisAdditions.prototype.toFixedRange = function (pxMin, pxMax, fixedMin, fixedMax) {
                 var navigator = this;
@@ -55267,17 +55185,32 @@
                     verticalMin = navigatorTop + zoomedMax + outlineCorrection;
                     zoomedMax = navigatorTop + zoomedMin + outlineCorrection;
                     path = [
-                        ['M', left + outlineHeight, navigatorTop - scrollbarHeight - outlineCorrection],
+                        [
+                            'M',
+                            left + outlineHeight,
+                            navigatorTop - scrollbarHeight - outlineCorrection
+                        ],
+                        // top right of zoomed range
                         ['L', left + outlineHeight, verticalMin],
                         ['L', left, verticalMin],
                         ['L', left, zoomedMax],
                         ['L', left + outlineHeight, zoomedMax],
-                        ['L', left + outlineHeight, navigatorTop + navigatorSize + scrollbarHeight]
+                        [
+                            'L',
+                            left + outlineHeight,
+                            navigatorTop + navigatorSize + scrollbarHeight
+                        ]
                     ];
                     if (maskInside) {
-                        path.push(['M', left + outlineHeight, verticalMin - halfOutline], // upper left of zoomed range
-                        ['L', left + outlineHeight, zoomedMax + halfOutline] // upper right of z.r.
-                        );
+                        path.push(
+                        // upper left of zoomed range
+                        ['M', left + outlineHeight, verticalMin - halfOutline], 
+                        // upper right of z.r.
+                        [
+                            'L',
+                            left + outlineHeight,
+                            zoomedMax + halfOutline
+                        ]);
                     }
                 }
                 else {
@@ -55285,17 +55218,25 @@
                     zoomedMax += left + scrollbarHeight - outlineCorrection;
                     navigatorTop += halfOutline;
                     path = [
+                        // left
                         ['M', left, navigatorTop],
+                        // upper left of zoomed range
                         ['L', zoomedMin, navigatorTop],
+                        // lower left of z.r.
                         ['L', zoomedMin, navigatorTop + outlineHeight],
+                        // lower right of z.r.
                         ['L', zoomedMax, navigatorTop + outlineHeight],
+                        // upper right of z.r.
                         ['L', zoomedMax, navigatorTop],
-                        ['L', left + navigatorSize + scrollbarHeight * 2, navigatorTop] // right
+                        // right
+                        ['L', left + navigatorSize + scrollbarHeight * 2, navigatorTop]
                     ];
                     if (maskInside) {
-                        path.push(['M', zoomedMin - halfOutline, navigatorTop], // upper left of zoomed range
-                        ['L', zoomedMax + halfOutline, navigatorTop] // upper right of z.r.
-                        );
+                        path.push(
+                        // upper left of zoomed range
+                        ['M', zoomedMin - halfOutline, navigatorTop], 
+                        // upper right of z.r.
+                        ['L', zoomedMax + halfOutline, navigatorTop]);
                     }
                 }
                 navigator.outline[verb]({
@@ -55481,7 +55422,6 @@
              *        Pixel value minimum
              * @param {number} [pxMax]
              *        Pixel value maximum
-             * @return {void}
              */
             Navigator.prototype.render = function (min, max, pxMin, pxMax) {
                 var navigator = this,
@@ -55758,7 +55698,6 @@
              *        Mouse event
              * @param {number} index
              *        Index of a handle in Navigator.handles array
-             * @return {void}
              */
             Navigator.prototype.handlesMousedown = function (e, index) {
                 e = this.chart.pointer.normalize(e);
@@ -55854,7 +55793,6 @@
              * @function Highcharts.Navigator#onMouseUp
              * @param {Highcharts.PointerEventObject} e
              *        Mouse event
-             * @return {void}
              */
             Navigator.prototype.onMouseUp = function (e) {
                 var navigator = this,
@@ -55941,7 +55879,6 @@
              *
              * @private
              * @function Highcharts.Navigator#removeEvents
-             * @return {void}
              */
             Navigator.prototype.removeEvents = function () {
                 if (this.eventsToUnbind) {
@@ -55957,7 +55894,6 @@
              *
              * @private
              * @function Highcharts.Navigator#removeBaseSeriesEvents
-             * @return {void}
              */
             Navigator.prototype.removeBaseSeriesEvents = function () {
                 var baseSeries = this.baseSeries || [];
@@ -56043,7 +55979,8 @@
                         offset: 0,
                         index: yAxisIndex,
                         isInternal: true,
-                        reversed: pick((navigatorOptions.yAxis && navigatorOptions.yAxis.reversed), (chart.yAxis[0] && chart.yAxis[0].reversed), false),
+                        reversed: pick((navigatorOptions.yAxis &&
+                            navigatorOptions.yAxis.reversed), (chart.yAxis[0] && chart.yAxis[0].reversed), false),
                         zoomEnabled: false
                     }, chart.inverted ? {
                         width: height
@@ -56125,9 +56062,6 @@
              *
              * @private
              * @function Highcharts.Navigator#getUnionExtremes
-             * @param {boolean} [returnFalseOnNoBaseSeries]
-             *        as the param says.
-             * @return {Highcharts.Dictionary<(number|undefined)>|undefined}
              */
             Navigator.prototype.getUnionExtremes = function (returnFalseOnNoBaseSeries) {
                 var baseAxis = this.chart.xAxis[0],
@@ -56155,7 +56089,6 @@
              *        Additional series options for a navigator
              * @param {boolean} [redraw]
              *        Whether to redraw after update.
-             * @return {void}
              */
             Navigator.prototype.setBaseSeries = function (baseSeriesOptions, redraw) {
                 var chart = this.chart,
@@ -56194,7 +56127,6 @@
              * @function Highcharts.Navigator.updateNavigatorSeries
              * @param {boolean} addEvents
              * @param {boolean} [redraw]
-             * @return {void}
              */
             Navigator.prototype.updateNavigatorSeries = function (addEvents, redraw) {
                 var navigator = this,
@@ -56335,7 +56267,6 @@
              *
              * @private
              * @function Highcharts.Navigator#addBaseSeriesEvent
-             * @return {void}
              */
             Navigator.prototype.addBaseSeriesEvents = function () {
                 var navigator = this,
@@ -56529,7 +56460,6 @@
              *
              * @private
              * @function Highcharts.Navigator#addChartEvents
-             * @return {void}
              */
             Navigator.prototype.addChartEvents = function () {
                 if (!this.eventsToUnbind) {
@@ -57328,7 +57258,6 @@
              * @param {number} i
              *        The index of the button
              * @param {boolean} [redraw]
-             * @return {void}
              */
             RangeSelector.prototype.clickButton = function (i, redraw) {
                 var rangeSelector = this,
@@ -57426,7 +57355,8 @@
                     // If the navigator exist and the axis range is declared reset that
                     // range and from now on only use the range set by a user, #14742.
                     if (chart.navigator && chart.navigator.baseSeries[0]) {
-                        chart.navigator.baseSeries[0].xAxis.options.range = void 0;
+                        chart.navigator.baseSeries[0].xAxis.options
+                            .range = void 0;
                     }
                     newMin = dataMin;
                     newMax = dataMax;
@@ -57471,7 +57401,6 @@
              * @private
              * @function Highcharts.RangeSelector#setSelected
              * @param {number} [selected]
-             * @return {void}
              */
             RangeSelector.prototype.setSelected = function (selected) {
                 this.selected = this.options.selected = selected;
@@ -57482,12 +57411,11 @@
              * @private
              * @function Highcharts.RangeSelector#init
              * @param {Highcharts.Chart} chart
-             * @return {void}
              */
             RangeSelector.prototype.init = function (chart) {
                 var rangeSelector = this,
                     options = chart.options.rangeSelector,
-                    buttonOptions = options.buttons || rangeSelector.defaultButtons.slice(),
+                    buttonOptions = (options.buttons || rangeSelector.defaultButtons.slice()),
                     selectedOption = options.selected,
                     blurInputs = function () {
                         var minInput = rangeSelector.minInput,
@@ -57537,7 +57465,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#updateButtonStates
-             * @return {void}
              */
             RangeSelector.prototype.updateButtonStates = function () {
                 var rangeSelector = this,
@@ -57643,7 +57570,6 @@
              * @private
              * @function Highcharts.RangeSelector#computeButtonRange
              * @param {Highcharts.RangeSelectorButtonsOptions} rangeOptions
-             * @return {void}
              */
             RangeSelector.prototype.computeButtonRange = function (rangeOptions) {
                 var type = rangeOptions.type,
@@ -57678,12 +57604,11 @@
              *
              * @private
              * @function Highcharts.RangeSelector#getInputValue
-             * @param {string} name
-             * @return {number}
              */
             RangeSelector.prototype.getInputValue = function (name) {
                 var input = name === 'min' ? this.minInput : this.maxInput;
-                var options = this.chart.options.rangeSelector;
+                var options = this.chart.options
+                        .rangeSelector;
                 var time = this.chart.time;
                 if (input) {
                     return ((input.type === 'text' && options.inputDateParser) ||
@@ -57696,9 +57621,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#setInputValue
-             * @param {string} name
-             * @param {number} [inputTime]
-             * @return {void}
              */
             RangeSelector.prototype.setInputValue = function (name, inputTime) {
                 var options = this.options, time = this.chart.time, input = name === 'min' ? this.minInput : this.maxInput, dateBox = name === 'min' ? this.minDateBox : this.maxDateBox;
@@ -57713,7 +57635,8 @@
                         input.setAttribute('data-hc-time', inputTime);
                         updatedTime = inputTime;
                     }
-                    input.value = time.dateFormat(this.inputTypeFormats[input.type] || options.inputEditDateFormat, updatedTime);
+                    input.value = time.dateFormat((this.inputTypeFormats[input.type] ||
+                        options.inputEditDateFormat), updatedTime);
                     if (dateBox) {
                         dateBox.attr({
                             text: time.dateFormat(options.inputDateFormat, updatedTime)
@@ -57726,10 +57649,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#setInputExtremes
-             * @param {string} name
-             * @param {number} min
-             * @param {number} max
-             * @return {void}
              */
             RangeSelector.prototype.setInputExtremes = function (name, min, max) {
                 var input = name === 'min' ? this.minInput : this.maxInput;
@@ -57754,7 +57673,6 @@
              * @private
              * @function Highcharts.RangeSelector#showInput
              * @param {string} name
-             * @return {void}
              */
             RangeSelector.prototype.showInput = function (name) {
                 var dateBox = name === 'min' ? this.minDateBox : this.maxDateBox;
@@ -57766,7 +57684,9 @@
                         translateY = _a.translateY;
                     var inputBoxWidth = this.options.inputBoxWidth;
                     css(input, {
-                        width: isTextInput ? ((dateBox.width + (inputBoxWidth ? -2 : 20)) + 'px') : 'auto',
+                        width: isTextInput ?
+                            ((dateBox.width + (inputBoxWidth ? -2 : 20)) + 'px') :
+                            'auto',
                         height: isTextInput ? ((dateBox.height - 2) + 'px') : 'auto',
                         border: '2px solid silver'
                     });
@@ -57792,7 +57712,6 @@
              * @private
              * @function Highcharts.RangeSelector#hideInput
              * @param {string} name
-             * @return {void}
              */
             RangeSelector.prototype.hideInput = function (name) {
                 var input = name === 'min' ? this.minInput : this.maxInput;
@@ -57844,8 +57763,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#drawInput
-             * @param {string} name
-             * @return {RangeSelectorInputElements}
              */
             RangeSelector.prototype.drawInput = function (name) {
                 var _a = this,
@@ -58014,8 +57931,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#getPosition
-             *
-             * @return {Highcharts.Dictionary<number>}
              */
             RangeSelector.prototype.getPosition = function () {
                 var chart = this.chart,
@@ -58035,13 +57950,8 @@
              *
              * @private
              * @function Highcharts.RangeSelector#getYTDExtremes
-             *
-             * @param {number} dataMax
-             *
-             * @param {number} dataMin
-             *
              * @return {*}
-             *         Returns min and max for the YTD
+             * Returns min and max for the YTD
              */
             RangeSelector.prototype.getYTDExtremes = function (dataMax, dataMin, useUTC) {
                 var time = this.chart.time,
@@ -58070,7 +57980,6 @@
              *        X axis minimum
              * @param {number} [max]
              *        X axis maximum
-             * @return {void}
              */
             RangeSelector.prototype.render = function (min, max) {
                 var chart = this.chart,
@@ -58124,7 +58033,8 @@
                     this.setInputValue('min', min);
                     this.setInputValue('max', max);
                     var unionExtremes = (chart.scroller && chart.scroller.getUnionExtremes()) || chart.xAxis[0] || {};
-                    if (defined(unionExtremes.dataMin) && defined(unionExtremes.dataMax)) {
+                    if (defined(unionExtremes.dataMin) &&
+                        defined(unionExtremes.dataMax)) {
                         var minRange = chart.xAxis[0].minRange || 0;
                         this.setInputExtremes('min', unionExtremes.dataMin, Math.min(unionExtremes.dataMax, this.getInputValue('max')) - minRange);
                         this.setInputExtremes('max', Math.max(unionExtremes.dataMin, this.getInputValue('min')) + minRange, unionExtremes.dataMax);
@@ -58157,7 +58067,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#renderButtons
-             * @return {void}
              */
             RangeSelector.prototype.renderButtons = function () {
                 var _this = this;
@@ -58258,7 +58167,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#alignElements
-             * @return {void}
              */
             RangeSelector.prototype.alignElements = function () {
                 var _this = this;
@@ -58414,7 +58322,6 @@
              * @function Highcharts.RangeSelector#alignButtonGroup
              * @param {number} xOffsetForExportButton
              * @param {number} [width]
-             * @return {void}
              */
             RangeSelector.prototype.alignButtonGroup = function (xOffsetForExportButton, width) {
                 var _a = this,
@@ -58444,7 +58351,6 @@
             /**
              * @private
              * @function Highcharts.RangeSelector#positionButtons
-             * @return {void}
              */
             RangeSelector.prototype.positionButtons = function () {
                 var _a = this,
@@ -58485,7 +58391,6 @@
              * @param  {number} xOffsetForExportButton
              *                  The X offset of the group required to make room for the
              *                  exporting button
-             * @return {void}
              */
             RangeSelector.prototype.handleCollision = function (xOffsetForExportButton) {
                 var _this = this;
@@ -58586,7 +58491,6 @@
              * @private
              * @function Highcharts.RangeSelector#collapseButtons
              * @param {number} xOffsetForExportButton
-             * @return {void}
              */
             RangeSelector.prototype.collapseButtons = function (xOffsetForExportButton) {
                 var _a = this,
@@ -58640,7 +58544,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#expandButtons
-             * @return {void}
              */
             RangeSelector.prototype.expandButtons = function () {
                 var _a = this,
@@ -58672,7 +58575,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#currentButtonIndex
-             * @return {number}
              */
             RangeSelector.prototype.currentButtonIndex = function () {
                 var dropdown = this.dropdown;
@@ -58686,7 +58588,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#showDropdown
-             * @return {void}
              */
             RangeSelector.prototype.showDropdown = function () {
                 var _a = this,
@@ -58710,7 +58611,6 @@
             /**
              * @private
              * @function Highcharts.RangeSelector#hideDropdown
-             * @return {void}
              */
             RangeSelector.prototype.hideDropdown = function () {
                 var dropdown = this.dropdown;
@@ -58729,7 +58629,7 @@
              * @private
              * @function Highcharts.RangeSelector#getHeight
              * @return {number}
-             *         Returns rangeSelector height
+             * Returns rangeSelector height
              */
             RangeSelector.prototype.getHeight = function () {
                 var rangeSelector = this,
@@ -58765,11 +58665,8 @@
              *
              * @private
              * @function Highcharts.RangeSelector#titleCollision
-             *
-             * @param {Highcharts.Chart} chart
-             *
              * @return {boolean}
-             *         Returns collision status
+             * Returns collision status
              */
             RangeSelector.prototype.titleCollision = function (chart) {
                 return !(chart.options.title.text ||
@@ -58781,7 +58678,6 @@
              * @private
              * @function Highcharts.RangeSelector#update
              * @param {Highcharts.RangeSelectorOptions} options
-             * @return {void}
              */
             RangeSelector.prototype.update = function (options) {
                 var chart = this.chart;
@@ -58877,17 +58773,14 @@
          *
          * @private
          * @function preferredInputType
-         * @param {string} format
-         * @return {string}
          */
         function preferredInputType(format) {
             var ms = format.indexOf('%L') !== -1;
             if (ms) {
                 return 'text';
             }
-            var date = ['a', 'A', 'd', 'e', 'w', 'b', 'B', 'm', 'o', 'y', 'Y'].some(function (char) {
-                    return format.indexOf('%' + char) !== -1;
-            });
+            var date = ['a', 'A', 'd', 'e', 'w', 'b', 'B', 'm', 'o', 'y', 'Y']
+                    .some(function (char) { return format.indexOf('%' + char) !== -1; });
             var time = ['H', 'k', 'I', 'l', 'M', 'S'].some(function (char) {
                     return format.indexOf('%' + char) !== -1;
             });
@@ -58924,7 +58817,8 @@
                 // Get the true range from a start date
                 getTrueRange = function (base,
                 count) {
-                    var timeName = type === 'year' ? 'FullYear' : 'Month';
+                    var timeName = type === 'year' ?
+                        'FullYear' : 'Month';
                 var date = new time.Date(base);
                 var basePeriod = time.get(timeName,
                     date);
@@ -59208,10 +59102,9 @@
              *        Function to run when the chart has loaded and and all external
              *        images are loaded.
              *
-             * @return {void}
              *
-             * @fires Highcharts.StockChart#event:init
-             * @fires Highcharts.StockChart#event:afterInit
+             * @emits Highcharts.StockChart#event:init
+             * @emits Highcharts.StockChart#event:afterInit
              */
             StockChart.prototype.init = function (userOptions, callback) {
                 var defaultOptions = getOptions(),
@@ -59237,7 +59130,8 @@
                         },
                         scrollbar: {
                             // #4988 - check if setOptions was called
-                            enabled: pick(defaultOptions.scrollbar && defaultOptions.scrollbar.enabled,
+                            enabled: pick((defaultOptions.scrollbar &&
+                                defaultOptions.scrollbar.enabled),
                     true)
                         },
                         rangeSelector: {
@@ -59266,15 +59160,15 @@
                 // apply X axis options to both single and multi y axes
                 options.xAxis = splat(userOptions.xAxis || {}).map(function (xAxisOptions, i) {
                     return merge(getDefaultAxisOptions('xAxis', xAxisOptions), defaultOptions.xAxis, // #3802
-                    defaultOptions.xAxis && defaultOptions.xAxis[i], // #7690
-                    xAxisOptions, // user options
+                    // #7690
+                    defaultOptions.xAxis && defaultOptions.xAxis[i], xAxisOptions, // user options
                     getForcedAxisOptions('xAxis', userOptions));
                 });
                 // apply Y axis options to both single and multi y axes
                 options.yAxis = splat(userOptions.yAxis || {}).map(function (yAxisOptions, i) {
                     return merge(getDefaultAxisOptions('yAxis', yAxisOptions), defaultOptions.yAxis, // #3802
-                    defaultOptions.yAxis && defaultOptions.yAxis[i], // #7690
-                    yAxisOptions // user options
+                    // #7690
+                    defaultOptions.yAxis && defaultOptions.yAxis[i], yAxisOptions // user options
                     );
                 });
                 _super.prototype.init.call(this, options, callback);
@@ -59285,14 +59179,10 @@
              *
              * @private
              * @function Highcharts.StockChart#createAxis
-             *
              * @param {string} type
-             *        An axis type.
-             *
+             * An axis type.
              * @param {Chart.CreateAxisOptionsObject} options
-             *        The axis creation options.
-             *
-             * @return {Highcharts.Axis | Highcharts.ColorAxis}
+             * The axis creation options.
              */
             StockChart.prototype.createAxis = function (type, options) {
                 options.axis = merge(getDefaultAxisOptions(type, options.axis), options.axis, getForcedAxisOptions(type, this.userOptions));
@@ -59348,9 +59238,6 @@
          *
          * @private
          * @function getDefaultAxisOptions
-         * @param {string} type
-         * @param {Highcharts.AxisOptions} options
-         * @return {Highcharts.AxisOptions}
          */
         function getDefaultAxisOptions(type, options) {
             if (type === 'xAxis') {
@@ -59397,9 +59284,6 @@
          *
          * @private
          * @function getForcedAxisOptions
-         * @param {string} type
-         * @param {Highcharts.Options} chartOptions
-         * @return {Highcharts.AxisOptions}
          */
         function getForcedAxisOptions(type, chartOptions) {
             if (type === 'xAxis') {
@@ -59618,9 +59502,6 @@
          *
          * @private
          * @function Highcharts.SVGRenderer#crispPolyLine
-         * @param {Highcharts.SVGPathArray} points
-         * @param {number} width
-         * @return {Highcharts.SVGPathArray}
          */
         SVGRenderer.prototype.crispPolyLine = function (points, width) {
             // points format: [['M', 0, 0], ['L', 100, 0]]