highcharts 9.3.1 → 9.3.2

package/es-modules/Core/Series/DataLabel.js

@@ -245,8 +245,10 @@ var DataLabel;
                 // 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
@@ -256,8 +258,8 @@ var DataLabel;
                         applyFilter(point, labelOptions)), connector = point.connectors ?
                         point.connectors[i] :
                         point.connector;
-                    var labelConfig, formatString, labelText, style, rotation, attr, dataLabel = point.dataLabels ? point.dataLabels[i] :
-                        point.dataLabel;
+                    var labelConfig, formatString, labelText, style, rotation, attr, dataLabel = point.dataLabels ?
+                        point.dataLabels[i] : point.dataLabel;
                     var labelDistance = pick(labelOptions.distance, point.labelDistance), isNew = !dataLabel;
                     if (labelEnabled) {
                         // Create individual options structure that can be
@@ -310,8 +312,10 @@ var DataLabel;
                     }
                     // 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
@@ -338,11 +342,11 @@ var DataLabel;
                                 }
                             }
                         }
-                        // 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 || [];
@@ -356,7 +360,8 @@ var DataLabel;
                             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 ?
@@ -384,7 +389,7 @@ var DataLabel;
                             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

package/es-modules/Core/Series/Point.js

@@ -186,7 +186,9 @@ var Point = /** @class */ (function () {
         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) {
@@ -321,7 +323,7 @@ var Point = /** @class */ (function () {
      * @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, series = this.series, seriesOptions = series.options;
@@ -370,8 +372,6 @@ var Point = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Point#getGraphicalProps
-     * @param {Highcharts.Dictionary<number>} [kinds]
-     * @return {Highcharts.PointGraphicalProps}
      */
     Point.prototype.getGraphicalProps = function (kinds) {
         var point = this, props = [], graphicalProps = { singular: [], plural: [] };
@@ -463,8 +463,7 @@ var Point = /** @class */ (function () {
     /**
      * 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;
@@ -490,7 +489,7 @@ var Point = /** @class */ (function () {
      * @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;
@@ -570,7 +569,6 @@ var Point = /** @class */ (function () {
     /**
      * @private
      * @function Highcharts.Point#resolveColor
-     * @return {void}
      */
     Point.prototype.resolveColor = function () {
         var series = this.series, optionsChart = series.chart.options.chart, styledMode = series.chart.styledMode;
@@ -700,7 +698,7 @@ var Point = /** @class */ (function () {
      *        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, series = point.series, graphic = point.graphic, chart = series.chart, seriesOptions = series.options;
@@ -714,7 +712,9 @@ var Point = /** @class */ (function () {
             // 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;
@@ -817,8 +817,8 @@ var Point = /** @class */ (function () {
      * 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, series = point.series, chart = series.chart;
@@ -882,7 +882,7 @@ var Point = /** @class */ (function () {
      * events.
      *
      * @function Highcharts.Point#onMouseOut
-     * @fires Highcharts.Point#event:mouseOut
+     * @emits Highcharts.Point#event:mouseOut
      */
     Point.prototype.onMouseOut = function () {
         var point = this, chart = point.series.chart;
@@ -925,7 +925,7 @@ var Point = /** @class */ (function () {
      * @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, series = point.series, previousState = point.state, stateOptions = (series.options.states[state || 'normal'] ||
@@ -971,8 +971,9 @@ var Point = /** @class */ (function () {
                 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({

package/es-modules/Core/Series/Series.js

@@ -365,7 +365,6 @@ var Series = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Series#hasData
-     * @return {boolean}
      */
     Series.prototype.hasData = function () {
         return ((this.visible &&
@@ -383,7 +382,6 @@ var Series = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Series#autoIncrement
-     * @return {number}
      */
     Series.prototype.autoIncrement = function (x) {
         var options = this.options, pointIntervalUnit = options.pointIntervalUnit, relativeXValue = options.relativeXValue, time = this.chart.time;
@@ -439,13 +437,9 @@ var Series = /** @class */ (function () {
      * 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, chartOptions = chart.options, plotOptions = chartOptions.plotOptions, userOptions = chart.userOptions || {}, seriesUserOptions = merge(itemOptions), styledMode = chart.styledMode, e = {
@@ -593,7 +587,6 @@ var Series = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Series#getPointsCollection
-     * @return {Array<Highcharts.Point>}
      */
     Series.prototype.getPointsCollection = function () {
         return (this.hasGroupedData ? this.points : this.data) || [];
@@ -604,7 +597,6 @@ var Series = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Series#getSymbol
-     * @return {void}
      */
     Series.prototype.getSymbol = function () {
         var seriesMarkerOption = this.options.marker;
@@ -616,14 +608,13 @@ var Series = /** @class */ (function () {
      *
      * @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, x = optionsObject.x, oldData = this.points, dataSorting = this.options.dataSorting;
@@ -973,11 +964,8 @@ var Series = /** @class */ (function () {
      *
      * @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, options = series.options, dataSorting = options.dataSorting, sortKey = dataSorting.sortKey || 'y', getPointOptionsObject = function (series, pointOptions) {
@@ -1029,8 +1017,7 @@ var Series = /** @class */ (function () {
      * @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, xAxis = series.xAxis, options = series.options, cropThreshold = options.cropThreshold, getExtremesFromAll = forceExtremesFromAll ||
@@ -1110,8 +1097,7 @@ var Series = /** @class */ (function () {
      * @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, xAxis = series.xAxis;
@@ -1131,7 +1117,7 @@ var Series = /** @class */ (function () {
         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');
     };
     /**
@@ -1141,12 +1127,6 @@ var Series = /** @class */ (function () {
      *
      * @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;
@@ -1246,7 +1226,8 @@ var Series = /** @class */ (function () {
                  * @readonly
                  */
                 // For faster access in Point.update
-                point.index = hasGroupedData ? (groupCropStartIndex + i) : cursor;
+                point.index = hasGroupedData ?
+                    (groupCropStartIndex + i) : cursor;
                 points[i] = point;
             }
         }
@@ -1306,12 +1287,9 @@ var Series = /** @class */ (function () {
      *
      * @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 {
@@ -1325,14 +1303,11 @@ var Series = /** @class */ (function () {
      *
      * @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, yAxis = this.yAxis, xData = this.processedXData || this.xData, activeYData = [], 
@@ -1419,11 +1394,8 @@ var Series = /** @class */ (function () {
      *
      * @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;
@@ -1442,7 +1414,7 @@ var Series = /** @class */ (function () {
      *
      * @function Highcharts.Series#translate
      *
-     * @fires Highcharts.Series#events:translate
+     * @emits Highcharts.Series#events:translate
      */
     Series.prototype.translate = function () {
         if (!this.processedXData) { // hidden series
@@ -1470,8 +1442,10 @@ var Series = /** @class */ (function () {
                     (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
@@ -1602,8 +1576,6 @@ var Series = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Series#getClip
-     *
-     * @return {Highcharts.Dictionary<number>}
      */
     Series.prototype.getClipBox = function () {
         var _a = this, chart = _a.chart, xAxis = _a.xAxis, yAxis = _a.yAxis;
@@ -1741,7 +1713,7 @@ var Series = /** @class */ (function () {
      * @private
      * @function Highcharts.Series#afterAnimate
      *
-     * @fires Highcharts.Series#event:afterAnimate
+     * @emits Highcharts.Series#event:afterAnimate
      */
     Series.prototype.afterAnimate = function () {
         var _this = this;
@@ -1930,7 +1902,7 @@ var Series = /** @class */ (function () {
         // 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));
@@ -1955,7 +1927,7 @@ var Series = /** @class */ (function () {
      * @private
      * @function Highcharts.Series#destroy
      *
-     * @fires Highcharts.Series#event:destroy
+     * @emits Highcharts.Series#event:destroy
      */
     Series.prototype.destroy = function (keepEventsForUpdate) {
         var series = this, chart = series.chart, issue134 = /AppleWebKit\/533/.test(win.navigator.userAgent), data = series.data || [];
@@ -2221,8 +2193,6 @@ var Series = /** @class */ (function () {
      * 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;
@@ -2266,7 +2236,7 @@ var Series = /** @class */ (function () {
      *
      * @function Highcharts.Series#render
      *
-     * @fires Highcharts.Series#event:afterRender
+     * @emits Highcharts.Series#event:afterRender
      */
     Series.prototype.render = function () {
         var series = this, chart = series.chart, options = series.options, animOptions = animObject(options.animation), visibility = series.visible ?
@@ -2671,7 +2641,7 @@ var Series = /** @class */ (function () {
      * @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, seriesOptions = series.options, data = series.data, chart = series.chart, xAxis = series.xAxis, names = xAxis && xAxis.hasNames && xAxis.names, dataOptions = seriesOptions.data, xData = series.xData;
@@ -2755,7 +2725,7 @@ var Series = /** @class */ (function () {
      * @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, data = series.data, point = data[i], points = series.points, chart = series.chart, remove = function () {
@@ -2804,7 +2774,7 @@ var Series = /** @class */ (function () {
      * @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, chart = series.chart;
@@ -2853,8 +2823,8 @@ var Series = /** @class */ (function () {
      *        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);
@@ -2927,7 +2897,9 @@ var Series = /** @class */ (function () {
                 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);
@@ -2957,8 +2929,7 @@ var Series = /** @class */ (function () {
                     // 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;
                     }
@@ -3052,13 +3023,17 @@ var Series = /** @class */ (function () {
             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, chart = series.chart, hoverSeries = chart.hoverSeries, pointer = chart.pointer;
@@ -3087,7 +3062,7 @@ var Series = /** @class */ (function () {
      *
      * @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
@@ -3230,8 +3205,8 @@ var Series = /** @class */ (function () {
      * 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, chart = series.chart, legendItem = series.legendItem, ignoreHiddenSeries = chart.options.chart.ignoreHiddenSeries, oldVisibility = series.visible;
@@ -3291,7 +3266,7 @@ var Series = /** @class */ (function () {
      *         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);
@@ -3305,7 +3280,7 @@ var Series = /** @class */ (function () {
      *         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);
@@ -3326,8 +3301,8 @@ var Series = /** @class */ (function () {
      * 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;
@@ -3345,10 +3320,6 @@ var Series = /** @class */ (function () {
      * 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 = {}; }

package/es-modules/Core/Series/SeriesDefaults.js

@@ -1586,9 +1586,9 @@ var seriesDefaults = {
          */
         // 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
@@ -1597,7 +1597,8 @@ var seriesDefaults = {
          */
         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

package/es-modules/Core/Time.js

@@ -166,7 +166,8 @@ var Time = /** @class */ (function () {
             // 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);
             }
@@ -183,8 +184,8 @@ var Time = /** @class */ (function () {
         }
         // 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
@@ -200,7 +201,6 @@ var Time = /** @class */ (function () {
      *
      * @param {Highcharts.TimeOptions} options
      *
-     * @return {void}
      */
     Time.prototype.update = function (options) {
         var useUTC = pick(options && options.useUTC, true), time = this;
@@ -283,7 +283,7 @@ var Time = /** @class */ (function () {
      *         A getTimezoneOffset function
      */
     Time.prototype.timezoneOffsetFunction = function () {
-        var time = this, options = this.options, moment = options.moment || win.moment;
+        var time = this, options = this.options, getTimezoneOffset = options.getTimezoneOffset, moment = options.moment || win.moment;
         if (!this.useUTC) {
             return function (timestamp) {
                 return new Date(timestamp.toString()).getTimezoneOffset() * 60000;
@@ -302,9 +302,9 @@ var Time = /** @class */ (function () {
             }
         }
         // 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
@@ -438,8 +438,10 @@ var Time = /** @class */ (function () {
      * 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
@@ -471,6 +473,7 @@ var Time = /** @class */ (function () {
      * @param {number} [startOfWeek=1]
      *
      * @return {Highcharts.AxisTickPositionsArray}
+     * Time positions
      */
     Time.prototype.getTimeTicks = function (normalizedInterval, min, max, startOfWeek) {
         var time = this, Date = time.Date, tickPositions = [], higherRanks = {}, 
@@ -731,8 +734,8 @@ export default Time;
  * 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