highcharts 9.3.1 → 10.0.0

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

@@ -68,7 +68,7 @@ var Legend = /** @class */ (function () {
         this.maxItemWidth = 0;
         this.maxLegendWidth = 0;
         this.offsetWidth = 0;
-        this.options = {};
+        this.options = void 0;
         this.padding = 0;
         this.pages = [];
         this.proximate = false;
@@ -153,7 +153,8 @@ var Legend = /** @class */ (function () {
         this.symbolWidth = pick(options.symbolWidth, 16);
         this.pages = [];
         this.proximate = options.layout === 'proximate' && !this.chart.inverted;
-        this.baseline = void 0; // #12705: baseline has to be reset on every update
+        // #12705: baseline has to be reset on every update
+        this.baseline = void 0;
     };
     /**
      * Update the legend with new options. Equivalent to running `chart.update`
@@ -172,7 +173,7 @@ var Legend = /** @class */ (function () {
      * operations on the chart, it is a good idea to set redraw to false and
      * call {@link Chart#redraw} after. Whether to redraw the chart.
      *
-     * @fires Highcharts.Legends#event:afterUpdate
+     * @emits Highcharts.Legends#event:afterUpdate
      */
     Legend.prototype.update = function (options, redraw) {
         var chart = this.chart;
@@ -306,8 +307,7 @@ var Legend = /** @class */ (function () {
         /**
          * @private
          * @param {string} key
-         * @return {void}
-         */
+             */
         function destroyItems(key) {
             if (this[key]) {
                 this[key] = this[key].destroy();
@@ -378,7 +378,7 @@ var Legend = /** @class */ (function () {
                  * @name Highcharts.Legend#title
                  * @type {Highcharts.SVGElement}
                  */
-                this.title = this.chart.renderer.label(titleOptions.text, padding - 3, padding - 4, null, null, null, options.useHTML, null, 'legend-title')
+                this.title = this.chart.renderer.label(titleOptions.text, padding - 3, padding - 4, void 0, void 0, void 0, options.useHTML, void 0, 'legend-title')
                     .attr({ zIndex: 1 });
                 if (!this.chart.styledMode) {
                     this.title.css(titleOptions.style);
@@ -503,13 +503,16 @@ var Legend = /** @class */ (function () {
         legend.setText(item);
         // calculate the positions for the next line
         var bBox = li.getBBox();
+        var fontMetricsH = (legend.fontMetrics && legend.fontMetrics.h) || 0;
         item.itemWidth = item.checkboxOffset =
             options.itemWidth ||
                 item.legendItemWidth ||
                 bBox.width + itemExtraWidth;
         legend.maxItemWidth = Math.max(legend.maxItemWidth, item.itemWidth);
         legend.totalItemWidth += item.itemWidth;
-        legend.itemHeight = item.itemHeight = Math.round(item.legendItemHeight || bBox.height || legend.symbolHeight);
+        legend.itemHeight = item.itemHeight = Math.round(item.legendItemHeight ||
+            // use bBox for multiline (#16398)
+            (bBox.height > fontMetricsH * 1.5 ? bBox.height : fontMetricsH));
     };
     /**
      * Get the position of the item in the layout. We now know the
@@ -565,7 +568,7 @@ var Legend = /** @class */ (function () {
      * @function Highcharts.Legend#getAllItems
      * @return {Array<(Highcharts.BubbleLegendItem|Highcharts.Point|Highcharts.Series)>}
      * The current items in the legend.
-     * @fires Highcharts.Legend#event:afterGetAllItems
+     * @emits Highcharts.Legend#event:afterGetAllItems
      */
     Legend.prototype.getAllItems = function () {
         var allItems = [];
@@ -701,8 +704,7 @@ var Legend = /** @class */ (function () {
         legend.lastItemY = 0;
         legend.widthOption = relativeLength(options.width, chart.spacingBox.width - padding);
         // Compute how wide the legend is allowed to be
-        allowedWidth =
-            chart.spacingBox.width - 2 * padding - options.x;
+        allowedWidth = chart.spacingBox.width - 2 * padding - options.x;
         if (['rm', 'lm'].indexOf(legend.getAlignment().substring(0, 2)) > -1) {
             allowedWidth /= 2;
         }
@@ -775,7 +777,6 @@ var Legend = /** @class */ (function () {
                 r: options.borderRadius
             })
                 .add(legendGroup);
-            box.isNew = true;
         }
         // Presentational
         if (!chart.styledMode) {
@@ -788,13 +789,12 @@ var Legend = /** @class */ (function () {
                 .shadow(options.shadow);
         }
         if (legendWidth > 0 && legendHeight > 0) {
-            box[box.isNew ? 'attr' : 'animate'](box.crisp.call({}, {
+            box[box.placed ? 'animate' : 'attr'](box.crisp.call({}, {
                 x: 0,
                 y: 0,
                 width: legendWidth,
                 height: legendHeight
             }, box.strokeWidth()));
-            box.isNew = false;
         }
         // hide the border if no items
         box[display ? 'show' : 'hide']();
@@ -818,7 +818,6 @@ var Legend = /** @class */ (function () {
      * @private
      * @function Highcharts.align
      * @param {Highcharts.BBoxObject} alignTo
-     * @return {void}
      */
     Legend.prototype.align = function (alignTo) {
         if (alignTo === void 0) { alignTo = this.chart.spacingBox; }
@@ -837,6 +836,11 @@ var Legend = /** @class */ (function () {
         if (y !== alignTo.y) {
             alignTo = merge(alignTo, { y: y });
         }
+        if (!chart.hasRendered) {
+            // Avoid animation when adjusting alignment for responsiveness and
+            // colorAxis label layout
+            this.group.placed = false;
+        }
         this.group.align(merge(options, {
             width: this.legendWidth,
             height: this.legendHeight,
@@ -849,8 +853,6 @@ var Legend = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Legend#handleOverflow
-     * @param {number} legendHeight
-     * @return {number}
      */
     Legend.prototype.handleOverflow = function (legendHeight) {
         var legend = this, chart = this.chart, renderer = chart.renderer, options = this.options, optionsY = options.y, alignTop = options.verticalAlign === 'top', padding = this.padding, maxHeight = options.maxHeight, navOptions = options.navigation, animation = pick(navOptions.animation, true), arrowSize = navOptions.arrowSize || 12, pages = this.pages, allItems = this.allItems, clipToHeight = function (height) {
@@ -953,7 +955,7 @@ var Legend = /** @class */ (function () {
                 });
                 this.pager = renderer.text('', 15, 10)
                     .addClass('highcharts-legend-navigation');
-                if (!chart.styledMode) {
+                if (!chart.styledMode && navOptions.style) {
                     this.pager.css(navOptions.style);
                 }
                 this.pager.add(nav);
@@ -992,7 +994,6 @@ var Legend = /** @class */ (function () {
      * @param {boolean|Partial<Highcharts.AnimationOptionsObject>} [animation]
      *        Whether and how to apply animation.
      *
-     * @return {void}
      */
     Legend.prototype.scroll = function (scrollBy, animation) {
         var _this = this;
@@ -1073,8 +1074,8 @@ var Legend = /** @class */ (function () {
      * @param {Highcharts.BubbleLegendItem|Point|Highcharts.Series} item
      * @param {Highcharts.SVGElement} legendItem
      * @param {boolean} [useHTML=false]
-     * @fires Highcharts.Point#event:legendItemClick
-     * @fires Highcharts.Series#event:legendItemClick
+     * @emits Highcharts.Point#event:legendItemClick
+     * @emits Highcharts.Series#event:legendItemClick
      */
     Legend.prototype.setItemEvents = function (item, legendItem, useHTML) {
         var legend = this, boxWrapper = legend.chart.renderer.boxWrapper, isPoint = item instanceof Point, activeClass = 'highcharts-legend-' +
@@ -1158,7 +1159,7 @@ var Legend = /** @class */ (function () {
      * @private
      * @function Highcharts.Legend#createCheckboxForItem
      * @param {Highcharts.BubbleLegendItem|Point|Highcharts.Series} item
-     * @fires Highcharts.Series#event:checkboxClick
+     * @emits Highcharts.Series#event:checkboxClick
      */
     Legend.prototype.createCheckboxForItem = function (item) {
         var legend = this;

package/es-modules/Core/Navigator.js

@@ -607,17 +607,32 @@ var Navigator = /** @class */ (function () {
             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 {
@@ -625,17 +640,25 @@ var Navigator = /** @class */ (function () {
             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]({
@@ -724,19 +747,21 @@ var Navigator = /** @class */ (function () {
             maskInside,
             !maskInside
         ].forEach(function (hasMask, index) {
-            navigator.shades[index] = renderer.rect()
+            var shade = renderer.rect()
                 .addClass('highcharts-navigator-mask' +
                 (index === 1 ? '-inside' : '-outside'))
                 .add(navigatorGroup);
             if (!chart.styledMode) {
-                navigator.shades[index]
-                    .attr({
+                shade.attr({
                     fill: hasMask ?
                         navigatorOptions.maskFill :
                         'rgba(0,0,0,0)'
-                })
-                    .css((index === 1) && mouseCursor);
+                });
+                if (index === 1) {
+                    shade.css(mouseCursor);
+                }
             }
+            navigator.shades[index] = shade;
         });
         // Create the outline:
         navigator.outline = renderer.path()
@@ -807,7 +832,6 @@ var Navigator = /** @class */ (function () {
      *        Pixel value minimum
      * @param {number} [pxMax]
      *        Pixel value maximum
-     * @return {void}
      */
     Navigator.prototype.render = function (min, max, pxMin, pxMax) {
         var navigator = this, chart = navigator.chart, navigatorWidth, scrollbarLeft, scrollbarTop, scrollbarHeight = navigator.scrollbarHeight, navigatorSize, xAxis = navigator.xAxis, pointRange = xAxis.pointRange || 0, scrollbarXAxis = xAxis.navigatorAxis.fake ? chart.xAxis[0] : xAxis, navigatorEnabled = navigator.navigatorEnabled, zoomedMin, zoomedMax, rendered = navigator.rendered, inverted = chart.inverted, verb, newMin, newMax, currentRange, minRange = chart.xAxis[0].minRange, maxRange = chart.xAxis[0].options.maxRange;
@@ -1047,7 +1071,6 @@ var Navigator = /** @class */ (function () {
      *        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);
@@ -1134,7 +1157,6 @@ var Navigator = /** @class */ (function () {
      * @function Highcharts.Navigator#onMouseUp
      * @param {Highcharts.PointerEventObject} e
      *        Mouse event
-     * @return {void}
      */
     Navigator.prototype.onMouseUp = function (e) {
         var navigator = this, chart = navigator.chart, xAxis = navigator.xAxis, scrollbar = navigator.scrollbar, DOMEvent = e.DOMEvent || e, inverted = chart.inverted, verb = navigator.rendered && !navigator.hasDragged ?
@@ -1209,7 +1231,6 @@ var Navigator = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Navigator#removeEvents
-     * @return {void}
      */
     Navigator.prototype.removeEvents = function () {
         if (this.eventsToUnbind) {
@@ -1225,7 +1246,6 @@ var Navigator = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Navigator#removeBaseSeriesEvents
-     * @return {void}
      */
     Navigator.prototype.removeBaseSeriesEvents = function () {
         var baseSeries = this.baseSeries || [];
@@ -1301,7 +1321,8 @@ var Navigator = /** @class */ (function () {
                 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
@@ -1381,9 +1402,6 @@ var Navigator = /** @class */ (function () {
      *
      * @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], navAxis = this.xAxis, navAxisOptions = navAxis.options, baseAxisOptions = baseAxis.options, ret;
@@ -1407,7 +1425,6 @@ var Navigator = /** @class */ (function () {
      *        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, baseSeries = this.baseSeries = [];
@@ -1445,7 +1462,6 @@ var Navigator = /** @class */ (function () {
      * @function Highcharts.Navigator.updateNavigatorSeries
      * @param {boolean} addEvents
      * @param {boolean} [redraw]
-     * @return {void}
      */
     Navigator.prototype.updateNavigatorSeries = function (addEvents, redraw) {
         var navigator = this, chart = navigator.chart, baseSeries = navigator.baseSeries, baseOptions, mergedNavSeriesOptions, chartNavigatorSeriesOptions = navigator.navigatorOptions.series, baseNavigatorOptions, navSeriesMixin = {
@@ -1578,7 +1594,6 @@ var Navigator = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Navigator#addBaseSeriesEvent
-     * @return {void}
      */
     Navigator.prototype.addBaseSeriesEvents = function () {
         var navigator = this, baseSeries = navigator.baseSeries || [];
@@ -1630,7 +1645,8 @@ var Navigator = /** @class */ (function () {
     Navigator.prototype.getBaseSeriesMin = function (currentSeriesMin) {
         return this.baseSeries.reduce(function (min, series) {
             // (#10193)
-            return Math.min(min, series.xData ? series.xData[0] : min);
+            return Math.min(min, series.xData && series.xData.length ?
+                series.xData[0] : min);
         }, currentSeriesMin);
     };
     /**
@@ -1750,7 +1766,6 @@ var Navigator = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Navigator#addChartEvents
-     * @return {void}
      */
     Navigator.prototype.addChartEvents = function () {
         if (!this.eventsToUnbind) {

package/es-modules/Core/Pointer.js

@@ -114,7 +114,7 @@ var Pointer = /** @class */ (function () {
                 Pointer.unbindDocumentMouseUp = Pointer.unbindDocumentMouseUp();
             }
             if (Pointer.unbindDocumentTouchEnd) {
-                Pointer.unbindDocumentTouchEnd = Pointer.unbindDocumentTouchEnd();
+                Pointer.unbindDocumentTouchEnd = (Pointer.unbindDocumentTouchEnd());
             }
         }
         // memory and CPU leak
@@ -439,6 +439,7 @@ var Pointer = /** @class */ (function () {
      * Pointer event, extended with `chartX` and `chartY` properties.
      *
      * @return {Highcharts.PointerAxisCoordinatesObject}
+     * Axis coordinates.
      */
     Pointer.prototype.getCoordinates = function (e) {
         var coordinates = {
@@ -477,7 +478,7 @@ var Pointer = /** @class */ (function () {
      * @param {Highcharts.PointerEventObject} [e]
      * The triggering event, containing chart coordinates of the pointer.
      *
-     * @return {object}
+     * @return {Object}
      * Object containing resulting hover data: hoverPoint, hoverSeries, and
      * hoverPoints.
      */
@@ -599,9 +600,9 @@ var Pointer = /** @class */ (function () {
      * name.
      */
     Pointer.prototype.inClass = function (element, className) {
-        var elemClassName;
-        while (element) {
-            elemClassName = attr(element, 'class');
+        var elem = element, elemClassName;
+        while (elem) {
+            elemClassName = attr(elem, 'class');
             if (elemClassName) {
                 if (elemClassName.indexOf(className) !== -1) {
                     return true;
@@ -610,7 +611,7 @@ var Pointer = /** @class */ (function () {
                     return false;
                 }
             }
-            element = element.parentNode;
+            elem = elem.parentElement;
         }
     };
     /**
@@ -651,6 +652,9 @@ var Pointer = /** @class */ (function () {
      * properties `chartX` and `chartY` in order to work on the internal
      * coordinate system.
      *
+     * On map charts, the properties `lon` and `lat` are added to the event
+     * object given that the chart has projection information.
+     *
      * @function Highcharts.Pointer#normalize
      *
      * @param {global.MouseEvent|global.PointerEvent|global.TouchEvent} e
@@ -765,9 +769,8 @@ var Pointer = /** @class */ (function () {
             // Also reset the chart position, used in #149 fix
             chart.pointer.chartPosition = void 0;
         }
-        if ( // #11635, Firefox wheel scroll does not fire out events consistently
-        tooltip &&
-            !tooltip.isHidden) {
+        // #11635, Firefox wheel scroll does not fire out events consistently
+        if (tooltip && !tooltip.isHidden) {
             this.reset();
         }
     };
@@ -904,7 +907,10 @@ var Pointer = /** @class */ (function () {
         }
         // On touch devices, only proceed to trigger click if a handler is
         // defined
-        if (hasZoom && self.initiated && !fireClickEvent && e.cancelable !== false) {
+        if (hasZoom &&
+            self.initiated &&
+            !fireClickEvent &&
+            e.cancelable !== false) {
             e.preventDefault();
         }
         // Normalize each touch
@@ -1028,7 +1034,8 @@ var Pointer = /** @class */ (function () {
             clip[xy] = clipXY - plotLeftTop;
             clip[wh] = selectionWH;
         }
-        var scaleKey = inverted ? (horiz ? 'scaleY' : 'scaleX') : 'scale' + XY;
+        var scaleKey = inverted ?
+            (horiz ? 'scaleY' : 'scaleX') : 'scale' + XY;
         var transformScale = inverted ? 1 / scale : scale;
         selectionMarker[wh] = selectionWH;
         selectionMarker[xy] = selectionXY;
@@ -1125,8 +1132,8 @@ var Pointer = /** @class */ (function () {
      * @private
      * @function Highcharts.Pointer#runPointActions
      *
-     * @fires Highcharts.Point#event:mouseOut
-     * @fires Highcharts.Point#event:mouseOver
+     * @emits Highcharts.Point#event:mouseOut
+     * @emits Highcharts.Point#event:mouseOver
      */
     Pointer.prototype.runPointActions = function (e, p) {
         var pointer = this, chart = pointer.chart, series = chart.series, tooltip = (chart.tooltip && chart.tooltip.options.enabled ?
@@ -1195,11 +1202,12 @@ var Pointer = /** @class */ (function () {
              * The mouseOver event should be triggered when hoverPoint
              * is correct.
              */
-            hoverPoint.firePointEvent('mouseOver');
-            // Draw tooltip if necessary
-            if (tooltip) {
-                tooltip.refresh(useSharedTooltip ? points : hoverPoint, e);
-            }
+            hoverPoint.firePointEvent('mouseOver', void 0, function () {
+                // Draw tooltip if necessary
+                if (tooltip && hoverPoint) {
+                    tooltip.refresh(useSharedTooltip ? points : hoverPoint, e);
+                }
+            });
             // Update positions (regardless of kdpoint or hoverPoint)
         }
         else if (followPointer && tooltip && !tooltip.isHidden) {
@@ -1228,7 +1236,7 @@ var Pointer = /** @class */ (function () {
                 point = chart.hoverPoint; // #13002
                 if (!point || point.series[axis.coll] !== axis) {
                     point = find(points, function (p) {
-                        return p.series[axis.coll] === axis;
+                        return p.series && p.series[axis.coll] === axis;
                     });
                 }
             }
@@ -1316,7 +1324,7 @@ var Pointer = /** @class */ (function () {
         var hoverChart = H.charts[pick(Pointer.hoverChartIndex, -1)];
         if (hoverChart &&
             hoverChart !== chart) {
-            hoverChart.pointer.onContainerMouseLeave({ relatedTarget: true });
+            hoverChart.pointer.onContainerMouseLeave({ relatedTarget: chart.container });
         }
         if (!hoverChart ||
             !hoverChart.mouseIsDown) {