highcharts 10.0.0 → 10.2.1

package/es-modules/Core/Chart/Chart3D.js

@@ -12,7 +12,7 @@
 'use strict';
 import Color from '../Color/Color.js';
 var color = Color.parse;
-import Math3D from '../../Extensions/Math3D.js';
+import Math3D from '../Math3D.js';
 var perspective = Math3D.perspective, shapeArea3D = Math3D.shapeArea3D;
 import D from '../DefaultOptions.js';
 var genericDefaultOptions = D.defaultOptions;
@@ -469,7 +469,7 @@ var Chart3D;
              */
             options3d: {
                 /**
-                 * Wether to render the chart using the 3D functionality.
+                 * Whether to render the chart using the 3D functionality.
                  *
                  * @since   4.0
                  * @product highcharts

package/es-modules/Core/Chart/ChartDefaults.js

@@ -447,6 +447,7 @@ var ChartDefaults = {
      * @default    {highstock} x
      * @since      3.0
      * @product    highcharts highstock gantt
+     * @deprecated
      * @validvalue ["x", "y", "xy"]
      * @apioption  chart.pinchType
      */
@@ -484,6 +485,17 @@ var ChartDefaults = {
      * @since      5.0.0
      */
     colorCount: 10,
+    /**
+     * By default, (because of memory and performance reasons) the chart does
+     * not copy the data but keeps it as a reference. In some cases, this might
+     * result in mutating the original data source. In order to prevent that,
+     * set that property to false. Please note that changing that might decrease
+     * performance, especially with bigger sets of data.
+     *
+     * @type       {boolean}
+     * @since 10.1.0
+     */
+    allowMutatingData: true,
     /**
      * Alias of `type`.
      *
@@ -554,6 +566,7 @@ var ChartDefaults = {
     /**
      * The button that appears after a selection zoom, allowing the user
      * to reset zoom.
+     * @deprecated
      */
     resetZoomButton: {
         /**
@@ -567,6 +580,7 @@ var ChartDefaults = {
          *
          * @type       {Highcharts.ButtonRelativeToValue}
          * @default    plot
+         * @deprecated
          * @since      2.2
          * @apioption  chart.resetZoomButton.relativeTo
          */
@@ -583,10 +597,14 @@ var ChartDefaults = {
          *         Theming the button
          *
          * @type {Highcharts.SVGAttributes}
+         * @deprecated
          * @since 2.2
          */
         theme: {
-            /** @internal */
+            /**
+             * @internal
+             * @deprecated
+             */
             zIndex: 6
         },
         /**
@@ -600,26 +618,31 @@ var ChartDefaults = {
          *         Above the plot area
          *
          * @type  {Highcharts.AlignObject}
+         * @deprecated
          * @since 2.2
          */
         position: {
             /**
              * The horizontal alignment of the button.
+             * @deprecated
              */
             align: 'right',
             /**
              * The horizontal offset of the button.
+             * @deprecated
              */
             x: -10,
             /**
              * The vertical alignment of the button.
              *
              * @type       {Highcharts.VerticalAlignValue}
+             * @deprecated
              * @default    top
              * @apioption  chart.resetZoomButton.position.verticalAlign
              */
             /**
              * The vertical offset of the button.
+             * @deprecated
              */
             y: 10
         }
@@ -901,6 +924,7 @@ var ChartDefaults = {
      *
      * @type       {string}
      * @validvalue ["x", "y", "xy"]
+     * @deprecated
      * @apioption  chart.zoomType
      */
     /**
@@ -910,12 +934,148 @@ var ChartDefaults = {
      * However, `zoomBySingleTouch` will interfere with touch-dragging the
      * chart to read the tooltip. And especially when vertical zooming is
      * enabled, it will make it hard to scroll vertically on the page.
-     * @since 9.0.0
+     * @since      9.0.0
      * @sample     highcharts/chart/zoombysingletouch
      *             Zoom by single touch enabled, with buttons to toggle
      * @product    highcharts highstock gantt
+     * @deprecated
      */
     zoomBySingleTouch: false,
+    /**
+     * Chart zooming options.
+     * @since 10.2.1
+     */
+    zooming: {
+        /**
+         * Equivalent to [type](#chart.zooming.type), but for multitouch
+         * gestures only. By default, the `pinchType` is the same as the
+         * `type` setting. However, pinching can be enabled separately in
+         * some cases, for example in stock charts where a mouse drag pans the
+         * chart, while pinching is enabled. When [tooltip.followTouchMove](
+         * #tooltip.followTouchMove) is true, pinchType only applies to
+         * two-finger touches.
+         *
+         * @type       {string}
+         * @default    {highcharts} undefined
+         * @default    {highstock} x
+         * @product    highcharts highstock gantt
+         * @since 10.2.1
+         * @validvalue ["x", "y", "xy"]
+         * @apioption  chart.zooming.pinchType
+         */
+        /**
+         * Decides in what dimensions the user can zoom by dragging the mouse.
+         * Can be one of `x`, `y` or `xy`.
+         *
+         * @type       {string}
+         * @default    {highcharts} undefined
+         * @product    highcharts highstock gantt
+         * @validvalue ["x", "y", "xy"]
+         * @since 10.2.1
+         * @apioption  chart.zooming.type
+         */
+        /**
+        * Set a key to hold when dragging to zoom the chart. This is useful to
+        * avoid zooming while moving points. Should be set different than
+        * [chart.panKey](#chart.panKey).
+        *
+        * @type       {string}
+        * @default    {highcharts} undefined
+        * @since 10.2.1
+        * @validvalue ["alt", "ctrl", "meta", "shift"]
+        * @requires   modules/draggable-points
+        * @apioption  chart.zooming.key
+        */
+        /**
+         * Enables zooming by a single touch, in combination with
+         * [chart.zooming.type](#chart.zooming.type). When enabled, two-finger
+         * pinch will still work as set up by [chart.zooming.pinchType]
+         * (#chart.zooming.pinchType). However, `singleTouch` will interfere
+         * with touch-dragging the chart to read the tooltip. And especially
+         * when vertical zooming is enabled, it will make it hard to scroll
+         * vertically on the page.
+         * @sample     highcharts/chart/zoombysingletouch
+         *             Zoom by single touch enabled, with buttons to toggle
+         * @product    highcharts highstock gantt
+         * @since 10.2.1
+         */
+        singleTouch: false,
+        /**
+         * The button that appears after a selection zoom, allowing the user
+         * to reset zoom.
+         * @since 10.2.1
+         */
+        resetButton: {
+            /**
+             * What frame the button placement should be related to. Can be
+             * either `plotBox` or `spacingBox`.
+             *
+             * @sample {highcharts} highcharts/chart/resetzoombutton-relativeto/
+             *         Relative to the chart
+             * @sample {highstock} highcharts/chart/resetzoombutton-relativeto/
+             *         Relative to the chart
+             *
+             * @type       {Highcharts.ButtonRelativeToValue}
+             * @default    plot
+             * @since 10.2.1
+             * @apioption  chart.zooming.resetButton.relativeTo
+             */
+            /**
+             * A collection of attributes for the button. The object takes SVG
+             * attributes like `fill`, `stroke`, `stroke-width` or `r`, the
+             * border radius. The theme also supports `style`, a collection of
+             * CSS properties for the text. Equivalent attributes for the hover
+             * state are given in `theme.states.hover`.
+             *
+             * @sample {highcharts} highcharts/chart/resetzoombutton-theme/
+             *         Theming the button
+             * @sample {highstock} highcharts/chart/resetzoombutton-theme/
+             *         Theming the button
+             *
+             * @type {Highcharts.SVGAttributes}
+             * @since 10.2.1
+             */
+            theme: {
+                /** @internal */
+                zIndex: 6
+            },
+            /**
+             * The position of the button.
+             *
+             * @sample {highcharts} highcharts/chart/resetzoombutton-position/
+             *         Above the plot area
+             * @sample {highstock} highcharts/chart/resetzoombutton-position/
+             *         Above the plot area
+             * @sample {highmaps} highcharts/chart/resetzoombutton-position/
+             *         Above the plot area
+             *
+             * @type  {Highcharts.AlignObject}
+             * @since 10.2.1
+             */
+            position: {
+                /**
+                 * The horizontal alignment of the button.
+                 */
+                align: 'right',
+                /**
+                 * The horizontal offset of the button.
+                 */
+                x: -10,
+                /**
+                 * The vertical alignment of the button.
+                 *
+                 * @type       {Highcharts.VerticalAlignValue}
+                 * @since 10.2.1
+                 * @default    top
+                 * @apioption  chart.zooming.resetButton.position.verticalAlign
+                 */
+                /**
+                 * The vertical offset of the button.
+                 */
+                y: 10
+            }
+        }
+    },
     /**
      * An explicit width for the chart. By default (when `null`) the width
      * is calculated from the offset width of the containing element.
@@ -968,7 +1128,7 @@ var ChartDefaults = {
      *
      * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
      */
-    borderColor: "#335cad" /* highlightColor80 */,
+    borderColor: "#335cad" /* Palette.highlightColor80 */,
     /**
      * The pixel width of the outer chart border.
      *
@@ -1007,7 +1167,7 @@ var ChartDefaults = {
      *
      * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
      */
-    backgroundColor: "#ffffff" /* backgroundColor */,
+    backgroundColor: "#ffffff" /* Palette.backgroundColor */,
     /**
      * The background color or gradient for the plot area.
      *
@@ -1064,7 +1224,7 @@ var ChartDefaults = {
      *
      * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
      */
-    plotBorderColor: "#cccccc" /* neutralColor20 */
+    plotBorderColor: "#cccccc" /* Palette.neutralColor20 */
 };
 /* *
  *

package/es-modules/Core/Chart/GanttChart.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());

package/es-modules/Core/Chart/MapChart.js

@@ -12,10 +12,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());

package/es-modules/Core/Chart/StockChart.js

@@ -12,10 +12,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
@@ -92,7 +94,9 @@ var StockChart = /** @class */ (function (_super) {
                     enabled: true,
                     type: 'x'
                 },
-                pinchType: 'x'
+                zooming: {
+                    pinchType: 'x'
+                }
             },
             navigator: {
                 enabled: navigatorEnabled
@@ -387,7 +391,7 @@ addEvent(Axis, 'getPlotLinePath', function (e) {
                 uniqueAxes.push(axis2);
             }
         });
-        transVal = pick(translatedValue, axis.translate(value, null, null, e.old));
+        transVal = pick(translatedValue, axis.translate(value, void 0, void 0, e.old));
         if (isNumber(transVal)) {
             if (axis.horiz) {
                 uniqueAxes.forEach(function (axis2) {
@@ -499,7 +503,7 @@ addEvent(Axis, 'afterDrawCrosshair', function (event) {
     if (!crossLabel) {
         crossLabel = this.crossLabel = chart.renderer
             .label('', 0, void 0, options.shape || 'callout')
-            .addClass('highcharts-crosshair-label highcharts-color-' + (point ?
+            .addClass('highcharts-crosshair-label highcharts-color-' + (point && point.series ?
             point.series.colorIndex :
             this.series[0] && this.series[0].colorIndex))
             .attr({
@@ -515,12 +519,12 @@ addEvent(Axis, 'afterDrawCrosshair', function (event) {
                 .attr({
                 fill: options.backgroundColor ||
                     point && point.series && point.series.color || // #14888
-                    "#666666" /* neutralColor60 */,
+                    "#666666" /* Palette.neutralColor60 */,
                 stroke: options.borderColor || '',
                 'stroke-width': options.borderWidth || 0
             })
                 .css(extend({
-                color: "#ffffff" /* backgroundColor */,
+                color: "#ffffff" /* Palette.backgroundColor */,
                 fontWeight: 'normal',
                 fontSize: '11px',
                 textAlign: 'center'
@@ -548,7 +552,7 @@ addEvent(Axis, 'afterDrawCrosshair', function (event) {
         this.toValue(horiz ? e.chartX : e.chartY);
     // Crosshair should be rendered within Axis range (#7219). Also, the point
     // of currentPriceIndicator should be inside the plot area, #14879.
-    var isInside = point ?
+    var isInside = point && point.series ?
         point.series.isPointInside(point) :
         (isNumber(value) && value > min && value < max);
     var text = '';
@@ -562,7 +566,7 @@ addEvent(Axis, 'afterDrawCrosshair', function (event) {
         text: text,
         x: posx,
         y: posy,
-        visibility: isInside ? 'visible' : 'hidden'
+        visibility: isInside ? 'inherit' : 'hidden'
     });
     crossBox = crossLabel.getBBox();
     // now it is placed we can correct its position

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

@@ -162,7 +162,7 @@ var Color = /** @class */ (function () {
                 return 'rgb(' + rgba[0] + ',' + rgba[1] + ',' + rgba[2] + ')';
             }
             if (format === 'a') {
-                return "" + rgba[3];
+                return "".concat(rgba[3]);
             }
             return 'rgba(' + rgba.join(',') + ')';
         }

package/es-modules/Core/DefaultOptions.js

@@ -29,6 +29,7 @@ var merge = U.merge;
  * @type {Highcharts.Options}
  */ /**
 * @optionparent
+* @private
 */
 var defaultOptions = {
     /**
@@ -61,7 +62,7 @@ var defaultOptions = {
      * @sample {highcharts} highcharts/chart/colors/
      *         Assign a global color theme
      *
-     * @type    {Array<Highcharts.ColorString>}
+     * @type    {Array<(Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject)>}
      * @default ["#7cb5ec", "#434348", "#90ed7d", "#f7a35c", "#8085e9",
      *          "#f15c80", "#e4d354", "#2b908f", "#f45b5b", "#91e8e1"]
      */
@@ -882,7 +883,7 @@ var defaultOptions = {
             /**
              * @ignore-option
              */
-            color: "#333333" /* neutralColor80 */
+            color: "#333333" /* Palette.neutralColor80 */
         }
     },
     /**
@@ -1162,7 +1163,7 @@ var defaultOptions = {
          *
          * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
          */
-        borderColor: "#999999" /* neutralColor40 */,
+        borderColor: "#999999" /* Palette.neutralColor40 */,
         /**
          * The border corner radius of the legend.
          *
@@ -1256,7 +1257,7 @@ var defaultOptions = {
              * @type  {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
              * @since 2.2.4
              */
-            activeColor: "#003399" /* highlightColor100 */,
+            activeColor: "#003399" /* Palette.highlightColor100 */,
             /**
              * The color of the inactive up or down arrow in the legend page
              * navigation. .
@@ -1272,7 +1273,7 @@ var defaultOptions = {
              * @type  {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
              * @since 2.2.4
              */
-            inactiveColor: "#cccccc" /* neutralColor20 */
+            inactiveColor: "#cccccc" /* Palette.neutralColor20 */
         },
         /**
          * The inner padding of the legend box.
@@ -1348,7 +1349,7 @@ var defaultOptions = {
             /**
              * @ignore
              */
-            color: "#333333" /* neutralColor80 */,
+            color: "#333333" /* Palette.neutralColor80 */,
             /**
              * @ignore
              */
@@ -1386,7 +1387,7 @@ var defaultOptions = {
             /**
              * @ignore
              */
-            color: "#000000" /* neutralColor100 */
+            color: "#000000" /* Palette.neutralColor100 */
         },
         /**
          * CSS styles for each legend item when the corresponding series or
@@ -1407,7 +1408,7 @@ var defaultOptions = {
             /**
              * @ignore
              */
-            color: "#cccccc" /* neutralColor20 */
+            color: "#cccccc" /* Palette.neutralColor20 */
         },
         /**
          * Whether to apply a drop shadow to the legend. A `backgroundColor`
@@ -1711,7 +1712,7 @@ var defaultOptions = {
             /**
              * @ignore
              */
-            backgroundColor: "#ffffff" /* backgroundColor */,
+            backgroundColor: "#ffffff" /* Palette.backgroundColor */,
             /**
              * @ignore
              */
@@ -1917,18 +1918,20 @@ var defaultOptions = {
          * @apioption tooltip.pointFormatter
          */
         /**
-         * A callback function to place the tooltip in a default position. The
+         * A callback function to place the tooltip in a custom position. The
          * callback receives three parameters: `labelWidth`, `labelHeight` and
          * `point`, where point contains values for `plotX` and `plotY` telling
          * where the reference point is in the plot area. Add `chart.plotLeft`
          * and `chart.plotTop` to get the full coordinates.
          *
+         * To find the actual hovered `Point` instance, use
+         * `this.chart.hoverPoint`. For shared or split tooltips, all the hover
+         * points are available in `this.chart.hoverPoints`.
+         *
          * Since v7, when [tooltip.split](#tooltip.split) option is enabled,
          * positioner is called for each of the boxes separately, including
          * xAxis header. xAxis header is not a point, instead `point` argument
-         * contains info:
-         * `{ plotX: Number, plotY: Number, isHeader: Boolean }`
-         *
+         * contains info: `{ plotX: Number, plotY: Number, isHeader: Boolean }`
          *
          * The return should be an object containing x and y values, for example
          * `{ x: 100, y: 100 }`.
@@ -2304,7 +2307,7 @@ var defaultOptions = {
          *
          * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
          */
-        backgroundColor: color("#f7f7f7" /* neutralColor3 */)
+        backgroundColor: color("#f7f7f7" /* Palette.neutralColor3 */)
             // @todo: Disallow undefined as input for colors
             .setOpacity(0.85).get(),
         /**
@@ -2367,7 +2370,7 @@ var defaultOptions = {
          */
         style: {
             /** @internal */
-            color: "#333333" /* neutralColor80 */,
+            color: "#333333" /* Palette.neutralColor80 */,
             /** @internal */
             cursor: 'default',
             /** @internal */
@@ -2482,7 +2485,7 @@ var defaultOptions = {
             /** @internal */
             cursor: 'pointer',
             /** @internal */
-            color: "#999999" /* neutralColor40 */,
+            color: "#999999" /* Palette.neutralColor40 */,
             /** @internal */
             fontSize: '9px'
         },

package/es-modules/Core/Geometry/CircleUtilities.js

@@ -185,7 +185,7 @@ var CircleUtilities;
     }
     CircleUtilities.getCirclesIntersectionPoints = getCirclesIntersectionPoints;
     /**
-     * Tests wether the first circle is completely overlapping the second
+     * Tests whether the first circle is completely overlapping the second
      * circle.
      *
      * @private
@@ -204,7 +204,7 @@ var CircleUtilities;
     }
     CircleUtilities.isCircle1CompletelyOverlappingCircle2 = isCircle1CompletelyOverlappingCircle2;
     /**
-     * Tests wether a point lies within a given circle.
+     * Tests whether a point lies within a given circle.
      * @private
      * @param {Highcharts.PositionObject} point
      * The point to test for.
@@ -220,7 +220,7 @@ var CircleUtilities;
     }
     CircleUtilities.isPointInsideCircle = isPointInsideCircle;
     /**
-     * Tests wether a point lies within a set of circles.
+     * Tests whether a point lies within a set of circles.
      *
      * @private
      *
@@ -240,7 +240,7 @@ var CircleUtilities;
     }
     CircleUtilities.isPointInsideAllCircles = isPointInsideAllCircles;
     /**
-     * Tests wether a point lies outside a set of circles.
+     * Tests whether a point lies outside a set of circles.
      *
      * TODO: add unit tests.
      *

package/es-modules/Core/Globals.js

@@ -15,6 +15,7 @@
  * */
 /**
  * Shared Highcharts properties.
+ * @private
  */
 var Globals;
 (function (Globals) {
@@ -23,7 +24,7 @@ var Globals;
      *  Constants
      *
      * */
-    Globals.SVG_NS = 'http://www.w3.org/2000/svg', Globals.product = 'Highcharts', Globals.version = '10.0.0', Globals.win = (typeof window !== 'undefined' ?
+    Globals.SVG_NS = 'http://www.w3.org/2000/svg', Globals.product = 'Highcharts', Globals.version = '10.2.1', Globals.win = (typeof window !== 'undefined' ?
         window :
         {}), // eslint-disable-line node/no-unsupported-features/es-builtins
     Globals.doc = Globals.win.document, Globals.svg = (Globals.doc &&