highcharts 9.3.1 → 9.3.2

package/modules/gantt.src.js

@@ -1,5 +1,5 @@
 /**
- * @license Highcharts Gantt JS v9.3.1 (2021-11-05)
+ * @license Highcharts Gantt JS v9.3.2 (2021-11-29)
  *
  * Gantt series
  *
@@ -89,14 +89,14 @@
              * @private
              * @function getColorByCategory
              *
-             * @param {object} series
-             *        The series which the point belongs to.
+             * @param {Object} series
+             * The series which the point belongs to.
              *
-             * @param {object} point
-             *        The point to calculate its color for.
+             * @param {Object} point
+             * The point to calculate its color for.
              *
-             * @return {object}
-             *         Returns an object containing the properties color and colorIndex.
+             * @return {Object}
+             * Returns an object containing the properties color and colorIndex.
              */
             XRangePoint.getColorByCategory = function (series, point) {
                 var colors = series.options.colors || series.chart.options.colors,
@@ -155,8 +155,6 @@
              *
              * @private
              * @function Highcharts.Point#init
-             *
-             * @return {Highcharts.Point}
              */
             XRangePoint.prototype.init = function () {
                 Point.prototype.init.apply(this, arguments);
@@ -176,8 +174,6 @@
             /**
              * @private
              * @function Highcharts.Point#getLabelConfig
-             *
-             * @return {Highcharts.PointLabelObject}
              */
             // Add x2 and yCategory to the available properties for tooltip formats
             XRangePoint.prototype.getLabelConfig = function () {
@@ -191,8 +187,6 @@
             /**
              * @private
              * @function Highcharts.Point#isValid
-             *
-             * @return {boolean}
              */
             XRangePoint.prototype.isValid = function () {
                 return typeof this.x === 'number' &&
@@ -356,7 +350,6 @@
             /**
              * @private
              * @function Highcarts.seriesTypes.xrange#init
-             * @return {void}
              */
             XRangeSeries.prototype.init = function () {
                 ColumnSeries.prototype.init.apply(this, arguments);
@@ -368,8 +361,6 @@
              *
              * @private
              * @function Highcharts.Series#getColumnMetrics
-             *
-             * @return {Highcharts.ColumnMetricsObject}
              */
             XRangeSeries.prototype.getColumnMetrics = function () {
                 var metrics,
@@ -395,18 +386,6 @@
              *
              * @private
              * @function Highcharts.Series#cropData
-             *
-             * @param {Array<number>} xData
-             *
-             * @param {Array<number>} yData
-             *
-             * @param {number} min
-             *
-             * @param {number} max
-             *
-             * @param {number} [cropShoulder]
-             *
-             * @return {*}
              */
             XRangeSeries.prototype.cropData = function (xData, yData, min, max) {
                 // Replace xData with x2Data to find the appropriate cropStart
@@ -426,9 +405,10 @@
              *
              * @private
              * @function Highcharts.Series#findPointIndex
-             * @param {object} options The options of the point.
-             * @returns {number|undefined} Returns index of a matching point,
-             * returns undefined if no match is found.
+             * @param {Object} options
+             * The options of the point.
+             * @return {number|undefined}
+             * Returns index of a matching point, or undefined if no match is found.
              */
             XRangeSeries.prototype.findPointIndex = function (options) {
                 var _a = this,
@@ -714,8 +694,6 @@
              *
              * @private
              * @function Highcharts.Series#getAnimationVerb
-             *
-             * @return {string}
              */
             XRangeSeries.prototype.getAnimationVerb = function () {
                 return (this.chart.pointCount < (this.options.animationLimit || 250) ?
@@ -1036,7 +1014,7 @@
              * @private
              * @function Highcharts.Point#applyOptions
              *
-             * @param {object} options
+             * @param {Object} options
              *        The point options
              *
              * @param {number} x
@@ -1252,8 +1230,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) {
@@ -1372,12 +1353,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;
                             }
                         }
@@ -1614,10 +1592,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));
                                         }
                                     }
                                 });
@@ -1665,13 +1645,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');
@@ -1877,7 +1861,8 @@
                     this.treeGrid &&
                     this.treeGrid.mapOfPosToGridNode) {
                     var treeDepth = this.treeGrid.mapOfPosToGridNode[-1].height || 0;
-                    dimensions.width += this.options.labels.indentation * (treeDepth - 1);
+                    dimensions.width += (this.options.labels.indentation *
+                        (treeDepth - 1));
                 }
                 return dimensions;
             }
@@ -2043,8 +2028,10 @@
                                         axis.left,
                                         startPoint[2] || 0
                                     ],
-                                    upperBorderPath = [upperBorderStartPoint,
-                                    upperBorderEndPoint],
+                                    upperBorderPath = [
+                                        upperBorderStartPoint,
+                                        upperBorderEndPoint
+                                    ],
                                     lowerBorderEndPoint = [
                                         'L',
                                         axis.chart.chartWidth - axis.chart.marginRight,
@@ -2055,8 +2042,10 @@
                                         endPoint[1] || 0,
                                         axis.toPixels(max + axis.tickmarkOffset)
                                     ],
-                                    lowerBorderPath = [lowerBorderStartPoint,
-                                    lowerBorderEndPoint];
+                                    lowerBorderPath = [
+                                        lowerBorderStartPoint,
+                                        lowerBorderEndPoint
+                                    ];
                                 if (!axis.grid.upperBorder && min % 1 !== 0) {
                                     axis.grid.upperBorder = axis.grid.renderBorder(upperBorderPath);
                                 }
@@ -2082,8 +2071,8 @@
                                     });
                                 }
                             }
-                            // Render an extra line parallel to the existing axes,
-                            // to close the grid.
+                            // Render an extra line parallel to the existing axes, to
+                            // close the grid.
                             if (!axis.grid.axisLineExtra) {
                                 axis.grid.axisLineExtra = axis.grid.renderBorder(linePath);
                             }
@@ -2096,8 +2085,7 @@
                                     d: linePath
                                 });
                             }
-                            // show or hide the line depending on
-                            // options.showEmpty
+                            // show or hide the line depending on options.showEmpty
                             axis.axisLine[axis.showAxis ? 'show' : 'hide'](true);
                         }
                     }
@@ -2139,7 +2127,8 @@
                         }
                         var mark = axis.ticks[lastTick].mark;
                         if (mark) {
-                            if (lastTick - max < tickmarkOffset && lastTick - max > 0 && axis.ticks[lastTick].isLast) {
+                            if (lastTick - max < tickmarkOffset &&
+                                lastTick - max > 0 && axis.ticks[lastTick].isLast) {
                                 mark.hide();
                             }
                             else if (axis.ticks[lastTick - 1]) {
@@ -2172,7 +2161,8 @@
                             options.dateTimeLabelFormats &&
                             options.labels &&
                             !defined(userLabels.align) &&
-                            (options.dateTimeLabelFormats[tickInfo.unitName].range === false ||
+                            (options.dateTimeLabelFormats[tickInfo.unitName]
+                                .range === false ||
                                 tickInfo.count > 1 // years
                             )) {
                             options.labels.align = 'left';
@@ -2386,7 +2376,8 @@
                 if (gridOptions.enabled && maxLabelDimensions) {
                     var labelPadding = (Math.abs(defaultLeftAxisOptions.labels.x) * 2);
                     var distance = horiz ?
-                            gridOptions.cellHeight || labelPadding + maxLabelDimensions.height :
+                            (gridOptions.cellHeight ||
+                                labelPadding + maxLabelDimensions.height) :
                             labelPadding + maxLabelDimensions.width;
                     if (isArray(e.tickSize)) {
                         e.tickSize[0] = distance;
@@ -2426,7 +2417,7 @@
                 var userOptions = e.userOptions || {};
                 var gridOptions = userOptions.grid || {};
                 if (gridOptions.enabled && defined(gridOptions.borderColor)) {
-                    userOptions.tickColor = userOptions.lineColor = gridOptions.borderColor;
+                    userOptions.tickColor = userOptions.lineColor = (gridOptions.borderColor);
                 }
                 if (!axis.grid) {
                     axis.grid = new Additions(axis);
@@ -2673,7 +2664,8 @@
                     var thisIndex = -1,
                         lastIndex = 0;
                     chart[axis.coll].forEach(function (otherAxis, index) {
-                        if (otherAxis.side === axis.side && !otherAxis.options.isInternal) {
+                        if (otherAxis.side === axis.side &&
+                            !otherAxis.options.isInternal) {
                             lastIndex = index;
                             if (otherAxis === parentAxis) {
                                 // Get the index of the axis in question
@@ -2682,17 +2674,17 @@
                         }
                     });
                     return (lastIndex === thisIndex &&
-                        (isNumber(columnIndex) ? columns.length === columnIndex : true));
+                        (isNumber(columnIndex) ?
+                            columns.length === columnIndex :
+                            true));
                 };
                 /**
                  * Add extra border based on the provided path.
-                 *  *
                  * @private
-                 *
                  * @param {SVGPath} path
                  * The path of the border.
-                 *
                  * @return {Highcharts.SVGElement}
+                 * Border
                  */
                 Additions.prototype.renderBorder = function (path) {
                     var axis = this.axis,
@@ -3161,7 +3153,10 @@
                     node.descendants > 0) {
                     collapsed = axis.treeGrid.isCollapsed(node);
                     renderLabelIcon(tick, {
-                        color: !styledMode && label.styles && label.styles.color || '',
+                        color: (!styledMode &&
+                            label.styles &&
+                            label.styles.color ||
+                            ''),
                         collapsed: collapsed,
                         group: label.parentGroup,
                         options: symbolOptions,
@@ -3390,7 +3385,7 @@
          *
          * @private
          *
-         * @param {object} params
+         * @param {Object} params
          * Object containing parameters.
          * - `defaults` Object containing default options. The default options are
          *   merged with the userOptions to get the final options for a specific
@@ -3500,7 +3495,7 @@
          *
          * @private
          *
-         * @param {object} series
+         * @param {Object} series
          * The series to operate on.
          *
          * @return {string}
@@ -3636,7 +3631,7 @@
              *
              * @param {number} numberOfSeries
              *
-             * @return {object}
+             * @return {Object}
              * Returns an object containing categories, mapOfIdToNode,
              * mapOfPosToGridNode, and tree.
              *
@@ -3649,7 +3644,8 @@
                 var categories = [],
                     collapsedNodes = [],
                     mapOfIdToNode = {},
-                    uniqueNamesEnabled = typeof uniqueNames === 'boolean' ? uniqueNames : false;
+                    uniqueNamesEnabled = typeof uniqueNames === 'boolean' ?
+                        uniqueNames : false;
                 var mapOfPosToGridNode = {},
                     posIterator = -1;
                 // Build the tree from the series data.
@@ -3672,7 +3668,9 @@
                     // Before the children has been created.
                     before: function (node) {
                         var data = isObject(node.data,
-                            true) ? node.data : {},
+                            true) ?
+                                node.data :
+                                {},
                             name = isString(data.name) ? data.name : '',
                             parentNode = mapOfIdToNode[node.parent],
                             parentGridNode = (isObject(parentNode,
@@ -3781,8 +3779,8 @@
             /**
              * Builds the tree of categories and calculates its positions.
              * @private
-             * @param {object} e Event object
-             * @param {object} e.target The chart instance which the event was fired on.
+             * @param {Object} e Event object
+             * @param {Object} e.target The chart instance which the event was fired on.
              * @param {object[]} e.target.axes The axes of the chart.
              */
             function onBeforeRender(e) {
@@ -3797,8 +3795,8 @@
                         max = options.max, 
                         // Check whether any of series is rendering for the first
                         // time, visibility has changed, or its data is dirty, and
-                        // only then update. #10570, #10580
-                        // Also check if mapOfPosToGridNode exists. #10887
+                        // only then update. #10570, #10580. Also check if
+                        // mapOfPosToGridNode exists. #10887
                         isDirty = (!axis.treeGrid.mapOfPosToGridNode ||
                             axis.series.some(function (series) {
                                 return !series.hasRendered ||
@@ -3816,13 +3814,15 @@
                                 (s.options.data || []).forEach(function (data) {
                                     // For using keys - rebuild the data structure
                                     if (s.options.keys && s.options.keys.length) {
-                                        data = s.pointClass.prototype.optionsToObject.call({ series: s }, data);
+                                        data = s.pointClass.prototype
+                                            .optionsToObject
+                                            .call({ series: s }, data);
                                         s.pointClass.setGanttPointAliases(data);
                                     }
                                     if (isObject(data, true)) {
                                         // Set series index on data. Removed again
                                         // after use.
-                                        data.seriesIndex = numberOfSeries;
+                                        data.seriesIndex = (numberOfSeries);
                                         arr.push(data);
                                     }
                                 });
@@ -3849,17 +3849,20 @@
                         treeGrid = getTreeGridFromData(data, uniqueNames || false, (uniqueNames === true) ? numberOfSeries : 1);
                         // Assign values to the axis.
                         axis.categories = treeGrid.categories;
-                        axis.treeGrid.mapOfPosToGridNode = treeGrid.mapOfPosToGridNode;
+                        axis.treeGrid.mapOfPosToGridNode = (treeGrid.mapOfPosToGridNode);
                         axis.hasNames = true;
                         axis.treeGrid.tree = treeGrid.tree;
                         // Update yData now that we have calculated the y values
                         axis.series.forEach(function (series) {
                             var axisData = (series.options.data || []).map(function (d) {
-                                    if (isArray(d) && series.options.keys && series.options.keys.length) {
+                                    if (isArray(d) &&
+                                        series.options.keys &&
+                                        series.options.keys.length) {
                                         // Get the axisData from the data array used to
                                         // build the treeGrid where has been modified
                                         data.forEach(function (point) {
-                                            if (d.indexOf(point.x) >= 0 && d.indexOf(point.x2) >= 0) {
+                                            if (d.indexOf(point.x) >= 0 &&
+                                                d.indexOf(point.x2) >= 0) {
                                                 d = point;
                                         }
                                     });
@@ -3969,10 +3972,11 @@
                                     axis.brokenAxis.setBreaks(breaks, false);
                                     // remove the node from the axis collapsedNodes
                                     if (axis.treeGrid.collapsedNodes) {
-                                        axis.treeGrid.collapsedNodes = axis.treeGrid.collapsedNodes.filter(function (n) {
-                                            return node.collapseStart !== n.collapseStart ||
-                                                node.collapseEnd !== n.collapseEnd;
-                                        });
+                                        axis.treeGrid.collapsedNodes = axis.treeGrid
+                                            .collapsedNodes
+                                            .filter(function (n) { return ((node.collapseStart !==
+                                            n.collapseStart) ||
+                                            node.collapseEnd !== n.collapseEnd); });
                                     }
                                 }
                             });
@@ -4253,7 +4257,7 @@
                  * @param {Highcharts.Axis} axis
                  * The axis to check against.
                  *
-                 * @param {object} node
+                 * @param {Object} node
                  * The node to check if is collapsed.
                  *
                  * @param {number} pos
@@ -5461,11 +5465,11 @@
              *        The radius of the marker, to calculate the additional distance to
              *        the center of the marker.
              *
-             * @param {object} anchor
+             * @param {Object} anchor
              *        The anchor point of the path and marker as an object with x/y
              *        properties.
              *
-             * @return {object}
+             * @return {Object}
              *         The marker vector as an object with x/y properties.
              */
             getMarkerVector: function (radians, markerRadius, anchor) {
@@ -5618,7 +5622,7 @@
          * @private
          * @function pointWithinObstacle
          *
-         * @param {object} obstacle
+         * @param {Object} obstacle
          *        Obstacle to test.
          *
          * @param {Highcharts.Point} point
@@ -5690,10 +5694,10 @@
          * @private
          * @function limitObstacleToBounds
          *
-         * @param {object} obstacle
+         * @param {Object} obstacle
          *        Obstacle to limit.
          *
-         * @param {object} bounds
+         * @param {Object} bounds
          *        Bounds to use as limit.
          *
          * @return {void}
@@ -5716,7 +5720,7 @@
          * @param {Highcharts.PositionObject} end
          *        Ending coordinate, object with x/y props.
          *
-         * @return {object}
+         * @return {Object}
          *         An object with the SVG path in Array form as accepted by the SVG
          *         renderer, as well as an array of new obstacles making up this
          *         path.
@@ -5743,14 +5747,14 @@
          * @param {Highcharts.PositionObject} end
          *        Ending coordinate, object with x/y props.
          *
-         * @param {object} options
+         * @param {Object} options
          *        Options for the algorithm:
          *        - chartObstacles: Array of chart obstacles to avoid
          *        - startDirectionX: Optional. True if starting in the X direction.
          *          If not provided, the algorithm starts in the direction that is
          *          the furthest between start/end.
          *
-         * @return {object}
+         * @return {Object}
          *         An object with the SVG path in Array form as accepted by the SVG
          *         renderer, as well as an array of new obstacles making up this
          *         path.
@@ -5875,7 +5879,7 @@
          * @param {Highcharts.PositionObject} end
          *        Ending coordinate, object with x/y props.
          *
-         * @param {object} options
+         * @param {Object} options
          *        Options for the algorithm.
          *        - chartObstacles:  Array of chart obstacles to avoid
          *        - lineObstacles:   Array of line obstacles to jump over
@@ -5887,7 +5891,7 @@
          *                           direction that is the furthest between
          *                           start/end.
          *
-         * @return {object}
+         * @return {Object}
          *         An object with the SVG path in Array form as accepted by the SVG
          *         renderer, as well as an array of new obstacles making up this
          *         path.
@@ -6022,19 +6026,19 @@
              * @private
              * @function
              *
-             * @param {object} obstacle
+             * @param {Object} obstacle
              *        Obstacle to dodge/escape.
              *
-             * @param {object} fromPoint
+             * @param {Object} fromPoint
              *        Point with x/y props that's dodging/escaping.
              *
-             * @param {object} toPoint
+             * @param {Object} toPoint
              *        Goal point.
              *
              * @param {boolean} dirIsX
              *        Dodge in X dimension.
              *
-             * @param {object} bounds
+             * @param {Object} bounds
              *        Hard and soft boundaries.
              *
              * @return {boolean}
@@ -6746,7 +6750,8 @@
                             // For Gantt series the connect could be
                             // defined as a dependency
                             if (ganttPointOptions && ganttPointOptions.dependency) {
-                                ganttPointOptions.connect = ganttPointOptions.dependency;
+                                ganttPointOptions.connect = ganttPointOptions
+                                    .dependency;
                             }
                             var to,
                                 connects = (point.options &&
@@ -6848,7 +6853,7 @@
              *
              * @function Highcharts.Pathfinder#getChartObstacles
              *
-             * @param {object} options
+             * @param {Object} options
              *        Options for the calculation. Currenlty only
              *        options.algorithmMargin.
              *
@@ -6907,7 +6912,7 @@
              * @param {Array<object>} obstacles
              *        An array of obstacles to inspect.
              *
-             * @return {object}
+             * @return {Object}
              *         The calculated metrics, as an object with maxHeight and maxWidth
              *         properties.
              */
@@ -7037,11 +7042,11 @@
              *        The radius of the marker, to calculate the additional distance to
              *        the center of the marker.
              *
-             * @param {object} anchor
+             * @param {Object} anchor
              *        The anchor point of the path and marker as an object with x/y
              *        properties.
              *
-             * @return {object}
+             * @return {Object}
              *         The marker vector as an object with x/y properties.
              */
             getMarkerVector: function (radians, markerRadius, anchor) {
@@ -7238,7 +7243,9 @@
                     cutOff = seriesOpts.stacking && !seriesOpts.borderRadius,
                     diamondShape;
                 if (point.options.milestone) {
-                    if (isNumber(plotY) && point.y !== null && point.visible !== false) {
+                    if (isNumber(plotY) &&
+                        point.y !== null &&
+                        point.visible !== false) {
                         diamondShape = renderer.symbols.diamond(shapeArgs.x || 0, shapeArgs.y || 0, shapeArgs.width || 0, shapeArgs.height || 0);
                         if (graphic) {
                             graphic[verb]({
@@ -7575,10 +7582,9 @@
              *        Function to run when the chart has loaded and and all external
              *        images are loaded.
              *
-             * @return {void}
              *
-             * @fires Highcharts.GanttChart#event:init
-             * @fires Highcharts.GanttChart#event:afterInit
+             * @emits Highcharts.GanttChart#event:init
+             * @emits Highcharts.GanttChart#event:afterInit
              */
             GanttChart.prototype.init = function (userOptions, callback) {
                 var defaultOptions = getOptions(),
@@ -7643,7 +7649,8 @@
                         reversed: true,
                         // Set default type treegrid, but only if 'categories' is
                         // undefined
-                        type: yAxisOptions.categories ? yAxisOptions.type : 'treegrid'
+                        type: yAxisOptions.categories ?
+                            yAxisOptions.type : 'treegrid'
                     }, yAxisOptions // user options
                     );
                 });
@@ -7787,7 +7794,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
@@ -7804,7 +7812,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,
@@ -7816,8 +7824,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;
@@ -7834,7 +7845,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);
@@ -7858,10 +7872,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);
@@ -7880,7 +7894,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;
                     }
@@ -8247,10 +8262,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',
@@ -8272,7 +8293,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,
@@ -8325,7 +8347,6 @@
              *
              * @private
              * @function Highcharts.Scrollbar#destroy
-             * @return {void}
              */
             Scrollbar.prototype.destroy = function () {
                 var scroller = this,
@@ -8358,7 +8379,6 @@
              * @function Highcharts.Scrollbar#drawScrollbarButton
              * @param {number} index
              *        0 is left, 1 is right
-             * @return {void}
              */
             Scrollbar.prototype.drawScrollbarButton = function (index) {
                 var scroller = this,
@@ -8451,7 +8471,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,
@@ -8512,7 +8533,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,
@@ -8561,7 +8581,6 @@
              *
              * @private
              * @function Highcharts.Scrollbar#removeEvents
-             * @return {void}
              */
             Scrollbar.prototype.removeEvents = function () {
                 this._events.forEach(function (args) {
@@ -8653,7 +8672,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,
@@ -8732,8 +8750,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) ||
@@ -8783,7 +8799,6 @@
              * @function Highcharts.Scrollbar#updatePosition
              * @param  {number} from
              * @param  {number} to
-             * @return {void}
              */
             Scrollbar.prototype.updatePosition = function (from, to) {
                 if (to > 1) {
@@ -9409,7 +9424,6 @@
              * @param {number} i
              *        The index of the button
              * @param {boolean} [redraw]
-             * @return {void}
              */
             RangeSelector.prototype.clickButton = function (i, redraw) {
                 var rangeSelector = this,
@@ -9507,7 +9521,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;
@@ -9552,7 +9567,6 @@
              * @private
              * @function Highcharts.RangeSelector#setSelected
              * @param {number} [selected]
-             * @return {void}
              */
             RangeSelector.prototype.setSelected = function (selected) {
                 this.selected = this.options.selected = selected;
@@ -9563,12 +9577,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,
@@ -9618,7 +9631,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#updateButtonStates
-             * @return {void}
              */
             RangeSelector.prototype.updateButtonStates = function () {
                 var rangeSelector = this,
@@ -9724,7 +9736,6 @@
              * @private
              * @function Highcharts.RangeSelector#computeButtonRange
              * @param {Highcharts.RangeSelectorButtonsOptions} rangeOptions
-             * @return {void}
              */
             RangeSelector.prototype.computeButtonRange = function (rangeOptions) {
                 var type = rangeOptions.type,
@@ -9759,12 +9770,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) ||
@@ -9777,9 +9787,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;
@@ -9794,7 +9801,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)
@@ -9807,10 +9815,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;
@@ -9835,7 +9839,6 @@
              * @private
              * @function Highcharts.RangeSelector#showInput
              * @param {string} name
-             * @return {void}
              */
             RangeSelector.prototype.showInput = function (name) {
                 var dateBox = name === 'min' ? this.minDateBox : this.maxDateBox;
@@ -9847,7 +9850,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'
                     });
@@ -9873,7 +9878,6 @@
              * @private
              * @function Highcharts.RangeSelector#hideInput
              * @param {string} name
-             * @return {void}
              */
             RangeSelector.prototype.hideInput = function (name) {
                 var input = name === 'min' ? this.minInput : this.maxInput;
@@ -9925,8 +9929,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#drawInput
-             * @param {string} name
-             * @return {RangeSelectorInputElements}
              */
             RangeSelector.prototype.drawInput = function (name) {
                 var _a = this,
@@ -10095,8 +10097,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#getPosition
-             *
-             * @return {Highcharts.Dictionary<number>}
              */
             RangeSelector.prototype.getPosition = function () {
                 var chart = this.chart,
@@ -10116,13 +10116,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,
@@ -10151,7 +10146,6 @@
              *        X axis minimum
              * @param {number} [max]
              *        X axis maximum
-             * @return {void}
              */
             RangeSelector.prototype.render = function (min, max) {
                 var chart = this.chart,
@@ -10205,7 +10199,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);
@@ -10238,7 +10233,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#renderButtons
-             * @return {void}
              */
             RangeSelector.prototype.renderButtons = function () {
                 var _this = this;
@@ -10339,7 +10333,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#alignElements
-             * @return {void}
              */
             RangeSelector.prototype.alignElements = function () {
                 var _this = this;
@@ -10495,7 +10488,6 @@
              * @function Highcharts.RangeSelector#alignButtonGroup
              * @param {number} xOffsetForExportButton
              * @param {number} [width]
-             * @return {void}
              */
             RangeSelector.prototype.alignButtonGroup = function (xOffsetForExportButton, width) {
                 var _a = this,
@@ -10525,7 +10517,6 @@
             /**
              * @private
              * @function Highcharts.RangeSelector#positionButtons
-             * @return {void}
              */
             RangeSelector.prototype.positionButtons = function () {
                 var _a = this,
@@ -10566,7 +10557,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;
@@ -10667,7 +10657,6 @@
              * @private
              * @function Highcharts.RangeSelector#collapseButtons
              * @param {number} xOffsetForExportButton
-             * @return {void}
              */
             RangeSelector.prototype.collapseButtons = function (xOffsetForExportButton) {
                 var _a = this,
@@ -10721,7 +10710,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#expandButtons
-             * @return {void}
              */
             RangeSelector.prototype.expandButtons = function () {
                 var _a = this,
@@ -10753,7 +10741,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#currentButtonIndex
-             * @return {number}
              */
             RangeSelector.prototype.currentButtonIndex = function () {
                 var dropdown = this.dropdown;
@@ -10767,7 +10754,6 @@
              *
              * @private
              * @function Highcharts.RangeSelector#showDropdown
-             * @return {void}
              */
             RangeSelector.prototype.showDropdown = function () {
                 var _a = this,
@@ -10791,7 +10777,6 @@
             /**
              * @private
              * @function Highcharts.RangeSelector#hideDropdown
-             * @return {void}
              */
             RangeSelector.prototype.hideDropdown = function () {
                 var dropdown = this.dropdown;
@@ -10810,7 +10795,7 @@
              * @private
              * @function Highcharts.RangeSelector#getHeight
              * @return {number}
-             *         Returns rangeSelector height
+             * Returns rangeSelector height
              */
             RangeSelector.prototype.getHeight = function () {
                 var rangeSelector = this,
@@ -10846,11 +10831,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 ||
@@ -10862,7 +10844,6 @@
              * @private
              * @function Highcharts.RangeSelector#update
              * @param {Highcharts.RangeSelectorOptions} options
-             * @return {void}
              */
             RangeSelector.prototype.update = function (options) {
                 var chart = this.chart;
@@ -10958,17 +10939,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;
             });
@@ -11005,7 +10983,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);
@@ -11259,11 +11238,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;
@@ -12014,17 +11988,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 {
@@ -12032,17 +12021,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]({
@@ -12228,7 +12225,6 @@
              *        Pixel value minimum
              * @param {number} [pxMax]
              *        Pixel value maximum
-             * @return {void}
              */
             Navigator.prototype.render = function (min, max, pxMin, pxMax) {
                 var navigator = this,
@@ -12505,7 +12501,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);
@@ -12601,7 +12596,6 @@
              * @function Highcharts.Navigator#onMouseUp
              * @param {Highcharts.PointerEventObject} e
              *        Mouse event
-             * @return {void}
              */
             Navigator.prototype.onMouseUp = function (e) {
                 var navigator = this,
@@ -12688,7 +12682,6 @@
              *
              * @private
              * @function Highcharts.Navigator#removeEvents
-             * @return {void}
              */
             Navigator.prototype.removeEvents = function () {
                 if (this.eventsToUnbind) {
@@ -12704,7 +12697,6 @@
              *
              * @private
              * @function Highcharts.Navigator#removeBaseSeriesEvents
-             * @return {void}
              */
             Navigator.prototype.removeBaseSeriesEvents = function () {
                 var baseSeries = this.baseSeries || [];
@@ -12790,7 +12782,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
@@ -12872,9 +12865,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],
@@ -12902,7 +12892,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,
@@ -12941,7 +12930,6 @@
              * @function Highcharts.Navigator.updateNavigatorSeries
              * @param {boolean} addEvents
              * @param {boolean} [redraw]
-             * @return {void}
              */
             Navigator.prototype.updateNavigatorSeries = function (addEvents, redraw) {
                 var navigator = this,
@@ -13082,7 +13070,6 @@
              *
              * @private
              * @function Highcharts.Navigator#addBaseSeriesEvent
-             * @return {void}
              */
             Navigator.prototype.addBaseSeriesEvents = function () {
                 var navigator = this,
@@ -13276,7 +13263,6 @@
              *
              * @private
              * @function Highcharts.Navigator#addChartEvents
-             * @return {void}
              */
             Navigator.prototype.addChartEvents = function () {
                 if (!this.eventsToUnbind) {