highcharts 10.2.0 → 10.2.1

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
      */
@@ -565,6 +566,7 @@ var ChartDefaults = {
     /**
      * The button that appears after a selection zoom, allowing the user
      * to reset zoom.
+     * @deprecated
      */
     resetZoomButton: {
         /**
@@ -578,6 +580,7 @@ var ChartDefaults = {
          *
          * @type       {Highcharts.ButtonRelativeToValue}
          * @default    plot
+         * @deprecated
          * @since      2.2
          * @apioption  chart.resetZoomButton.relativeTo
          */
@@ -594,10 +597,14 @@ var ChartDefaults = {
          *         Theming the button
          *
          * @type {Highcharts.SVGAttributes}
+         * @deprecated
          * @since 2.2
          */
         theme: {
-            /** @internal */
+            /**
+             * @internal
+             * @deprecated
+             */
             zIndex: 6
         },
         /**
@@ -611,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
         }
@@ -912,6 +924,7 @@ var ChartDefaults = {
      *
      * @type       {string}
      * @validvalue ["x", "y", "xy"]
+     * @deprecated
      * @apioption  chart.zoomType
      */
     /**
@@ -921,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.

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

@@ -94,7 +94,9 @@ var StockChart = /** @class */ (function (_super) {
                     enabled: true,
                     type: 'x'
                 },
-                pinchType: 'x'
+                zooming: {
+                    pinchType: 'x'
+                }
             },
             navigator: {
                 enabled: navigatorEnabled
@@ -501,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({
@@ -550,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 = '';

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"]
      */

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.2.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 &&

package/es-modules/{Extensions → Core}/Math3D.js

@@ -8,11 +8,15 @@
  *
  * */
 'use strict';
-import H from '../Core/Globals.js';
-import U from '../Core/Utilities.js';
-var pick = U.pick;
-// Mathematical Functionility
+import H from './Globals.js';
 var deg2rad = H.deg2rad;
+import U from './Utilities.js';
+var pick = U.pick;
+/* *
+ *
+ *  Functions
+ *
+ * */
 /* eslint-disable max-len */
 /**
  * Apply 3-D rotation
@@ -43,6 +47,7 @@ var deg2rad = H.deg2rad;
  */
 /* eslint-enable max-len */
 /**
+ * Rotates the position as defined in angles.
  * @private
  * @param {number} x
  *        X coordinate
@@ -50,9 +55,9 @@ var deg2rad = H.deg2rad;
  *        Y coordinate
  * @param {number} z
  *        Z coordinate
- * @param {Highcharts.Rotation3dObject} angles
+ * @param {Highcharts.Rotation3DObject} angles
  *        Rotation angles
- * @return {Highcharts.Rotation3dObject}
+ * @return {Highcharts.Position3DObject}
  *         Rotated position
  */
 function rotate3D(x, y, z, angles) {
@@ -64,37 +69,6 @@ function rotate3D(x, y, z, angles) {
             angles.cosA * angles.cosB * z
     };
 }
-/**
- * Perspective3D function is available in global Highcharts scope because is
- * needed also outside of perspective() function (#8042).
- * @private
- * @function Highcharts.perspective3D
- *
- * @param {Highcharts.Position3DObject} coordinate
- * 3D position
- *
- * @param {Highcharts.Position3DObject} origin
- * 3D root position
- *
- * @param {number} distance
- * Perspective distance
- *
- * @return {Highcharts.PositionObject}
- * Perspective 3D Position
- *
- * @requires highcharts-3d
- */
-function perspective3D(coordinate, origin, distance) {
-    var projection = ((distance > 0) &&
-        (distance < Number.POSITIVE_INFINITY)) ?
-        distance / (coordinate.z + origin.z + distance) :
-        1;
-    return {
-        x: coordinate.x * projection,
-        y: coordinate.y * projection
-    };
-}
-H.perspective3D = perspective3D;
 /**
  * Transforms a given array of points according to the angles in chart.options.
  *
@@ -154,7 +128,36 @@ function perspective(points, chart, insidePlotArea, useInvertedPersp) {
         };
     });
 }
-H.perspective = perspective;
+/**
+ * Perspective3D function is available in global Highcharts scope because is
+ * needed also outside of perspective() function (#8042).
+ * @private
+ * @function Highcharts.perspective3D
+ *
+ * @param {Highcharts.Position3DObject} coordinate
+ * 3D position
+ *
+ * @param {Highcharts.Position3DObject} origin
+ * 3D root position
+ *
+ * @param {number} distance
+ * Perspective distance
+ *
+ * @return {Highcharts.PositionObject}
+ * Perspective 3D Position
+ *
+ * @requires highcharts-3d
+ */
+function perspective3D(coordinate, origin, distance) {
+    var projection = ((distance > 0) &&
+        (distance < Number.POSITIVE_INFINITY)) ?
+        distance / (coordinate.z + origin.z + distance) :
+        1;
+    return {
+        x: coordinate.x * projection,
+        y: coordinate.y * projection
+    };
+}
 /**
  * Calculate a distance from camera to points - made for calculating zIndex of
  * scatter points.
@@ -186,7 +189,6 @@ function pointCameraDistance(coordinates, chart) {
         Math.pow(cameraPosition.z - pick(coordinates.plotZ, coordinates.z), 2));
     return distance;
 }
-H.pointCameraDistance = pointCameraDistance;
 /**
  * Calculate area of a 2D polygon using Shoelace algorithm
  * https://en.wikipedia.org/wiki/Shoelace_formula
@@ -210,7 +212,6 @@ function shapeArea(vertexes) {
     }
     return area / 2;
 }
-H.shapeArea = shapeArea;
 /**
  * Calculate area of a 3D polygon after perspective projection
  *
@@ -234,12 +235,16 @@ H.shapeArea = shapeArea;
 function shapeArea3D(vertexes, chart, insidePlotArea) {
     return shapeArea(perspective(vertexes, chart, insidePlotArea));
 }
-H.shapeArea3d = shapeArea3D;
-var mathModule = {
+/* *
+ *
+ *  Default Export
+ *
+ * */
+var Math3D = {
     perspective: perspective,
     perspective3D: perspective3D,
     pointCameraDistance: pointCameraDistance,
     shapeArea: shapeArea,
     shapeArea3D: shapeArea3D
 };
-export default mathModule;
+export default Math3D;

package/es-modules/Core/Navigator.js

@@ -391,6 +391,18 @@ extend(defaultOptions, {
              */
             threshold: null
         },
+        /**
+         * Enable or disable navigator sticking to right, while adding new
+         * points. If `undefined`, the navigator sticks to the axis maximum only
+         * if it was already at the maximum prior to adding points.
+         *
+         * @type      {boolean}
+         * @default   undefined
+         * @since 10.2.1
+         * @sample {highstock} stock/navigator/sticktomax-false/
+         * stickToMax set to false
+         * @apioption navigator.stickToMax
+         */
         /**
          * Options for the navigator X axis. Default series options for the
          * navigator xAxis are:
@@ -1142,7 +1154,9 @@ var Navigator = /** @class */ (function () {
                 pick(navigator.scrollbar.options.liveRedraw, 
                 // By default, don't run live redraw on VML, on touch
                 // devices or if the chart is in boost.
-                H.svg && !isTouchDevice && !this.chart.isBoosting)) {
+                H.svg &&
+                    !isTouchDevice &&
+                    !this.chart.boosted)) {
                 e.DOMType = e.type; // DOMType is for IE8
                 setTimeout(function () {
                     navigator.onMouseUp(e);
@@ -1722,12 +1736,13 @@ var Navigator = /** @class */ (function () {
      * @function Highcharts.Navigator#updateDataHandler
      */
     Navigator.prototype.updatedDataHandler = function () {
-        var navigator = this.chart.navigator, baseSeries = this, navigatorSeries = this.navigatorSeries;
-        // If the scrollbar is scrolled all the way to the right, keep right as
-        // new data  comes in.
-        navigator.stickToMax = navigator.reversedExtremes ?
+        var navigator = this.chart.navigator, baseSeries = this, navigatorSeries = this.navigatorSeries, shouldStickToMax = navigator.reversedExtremes ?
             Math.round(navigator.zoomedMin) === 0 :
             Math.round(navigator.zoomedMax) >= Math.round(navigator.size);
+        // If the scrollbar is scrolled all the way to the right, keep right as
+        // new data comes in, unless user set navigator.stickToMax to false.
+        navigator.stickToMax = pick(this.chart.options.navigator &&
+            this.chart.options.navigator.stickToMax, shouldStickToMax);
         navigator.stickToMin = navigator.shouldStickToMin(baseSeries, navigator);
         // Set the navigator series data to the new data of the base series
         if (navigatorSeries && !navigator.hasNavigatorData) {
@@ -1849,8 +1864,10 @@ if (!H.Navigator) {
         var chartOptions = this.options, navigator = chartOptions.navigator, rangeSelector = chartOptions.rangeSelector;
         if (((navigator && navigator.enabled) ||
             (rangeSelector && rangeSelector.enabled)) &&
-            ((!isTouchDevice && chartOptions.chart.zoomType === 'x') ||
-                (isTouchDevice && chartOptions.chart.pinchType === 'x'))) {
+            ((!isTouchDevice &&
+                chartOptions.chart.zooming.type === 'x') ||
+                (isTouchDevice &&
+                    chartOptions.chart.zooming.pinchType === 'x'))) {
             return false;
         }
     });

package/es-modules/Core/Pointer.js

@@ -504,10 +504,8 @@ var Pointer = /** @class */ (function () {
             // Only search on hovered series if it has stickyTracking false
             [hoverSeries] :
             // Filter what series to look in.
-            series.filter(function (s) {
-                return eventArgs.filter ? eventArgs.filter(s) : filter(s) &&
-                    s.stickyTracking;
-            });
+            series.filter(function (s) { return s.stickyTracking &&
+                (eventArgs.filter || filter)(s); });
         // Use existing hovered point or find the one closest to coordinates.
         var hoverPoint = useExisting || !e ?
             existingHoverPoint :
@@ -532,8 +530,8 @@ var Pointer = /** @class */ (function () {
                         * Boost returns a minimal point. Convert it to a usable
                         * point for tooltip and states.
                         */
-                        if (s.chart.isBoosting) {
-                            point = s.getPoint(point);
+                        if (s.boosted && s.boost) {
+                            point = s.boost.getPoint(point);
                         }
                         hoverPoints.push(point);
                     }
@@ -1382,7 +1380,7 @@ var Pointer = /** @class */ (function () {
      * @function Highcharts.Pointer#touchSelect
      */
     Pointer.prototype.touchSelect = function (e) {
-        return Boolean(this.chart.options.chart.zoomBySingleTouch &&
+        return Boolean(this.chart.options.chart.zooming.singleTouch &&
             e.touches &&
             e.touches.length === 1);
     };
@@ -1394,10 +1392,10 @@ var Pointer = /** @class */ (function () {
      */
     Pointer.prototype.zoomOption = function (e) {
         var chart = this.chart, options = chart.options.chart, inverted = chart.inverted;
-        var zoomType = options.zoomType || '', zoomX, zoomY;
+        var zoomType = options.zooming.type || '', zoomX, zoomY;
         // Look for the pinchType option
         if (/touch/.test(e.type)) {
-            zoomType = pick(options.pinchType, zoomType);
+            zoomType = pick(options.zooming.pinchType, zoomType);
         }
         this.zoomX = zoomX = /x/.test(zoomType);
         this.zoomY = zoomY = /y/.test(zoomType);

package/es-modules/Core/Renderer/HTML/AST.js

@@ -239,7 +239,8 @@ var AST = /** @class */ (function () {
             .trim()
             // The style attribute throws a warning when parsing when CSP is
             // enabled (#6884), so use an alias and pick it up below
-            .replace(/ style="/g, ' data-style="');
+            // Make all quotation marks parse correctly to DOM (#17627)
+            .replace(/ style=(["'])/g, ' data-style=$1');
         var doc;
         if (hasValidDOMParser) {
             doc = new DOMParser().parseFromString(trustedTypesPolicy ?
@@ -363,6 +364,7 @@ var AST = /** @class */ (function () {
         'target',
         'tabindex',
         'text-align',
+        'text-anchor',
         'textAnchor',
         'textLength',
         'title',
@@ -463,6 +465,7 @@ var AST = /** @class */ (function () {
         'svg',
         'table',
         'text',
+        'textPath',
         'thead',
         'tbody',
         'tspan',