highcharts 10.0.0 → 10.2.1

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

@@ -10,8 +10,8 @@
 'use strict';
 import A from '../Animation/AnimationUtilities.js';
 var animObject = A.animObject, setAnimation = A.setAnimation;
-import D from '../DefaultOptions.js';
-var defaultOptions = D.defaultOptions;
+import DO from '../DefaultOptions.js';
+var defaultOptions = DO.defaultOptions;
 import F from '../Foundation.js';
 var registerEventOptions = F.registerEventOptions;
 import H from '../Globals.js';
@@ -575,7 +575,7 @@ var Series = /** @class */ (function () {
             this.getCyclic('color');
         }
         else if (this.options.colorByPoint) {
-            this.color = "#cccccc" /* neutralColor20 */;
+            this.color = "#cccccc" /* Palette.neutralColor20 */;
         }
         else {
             this.getCyclic('color', this.options.color ||
@@ -670,7 +670,7 @@ var Series = /** @class */ (function () {
     };
     /**
      * Internal function called from setData. If the point count is the same
-     * as is was, or if there are overlapping X values, just run
+     * as it was, or if there are overlapping X values, just run
      * Point.update which is cheaper, allows animation, and keeps references
      * to points. This also allows adding or removing points if the X-es
      * don't match.
@@ -746,7 +746,7 @@ var Series = /** @class */ (function () {
             data.forEach(function (point, i) {
                 // .update doesn't exist on a linked, hidden series (#3709)
                 // (#10187)
-                if (point !== oldData[i].y && oldData[i].update) {
+                if (point !== oldData[i].y && (oldData[i].update)) {
                     oldData[i].update(point, false, null, false);
                 }
             });
@@ -825,17 +825,28 @@ var Series = /** @class */ (function () {
      *        `false` to prevent.
      */
     Series.prototype.setData = function (data, redraw, animation, updatePoints) {
+        if (redraw === void 0) { redraw = true; }
         var series = this, oldData = series.points, oldDataLength = (oldData && oldData.length) || 0, options = series.options, chart = series.chart, dataSorting = options.dataSorting, xAxis = series.xAxis, turboThreshold = options.turboThreshold, xData = this.xData, yData = this.yData, pointArrayMap = series.pointArrayMap, valueCount = pointArrayMap && pointArrayMap.length, keys = options.keys;
-        var i, pt, updatedData, indexOfX = 0, indexOfY = 1, firstPoint = null;
-        data = data || [];
+        var i, pt, updatedData, indexOfX = 0, indexOfY = 1, firstPoint = null, copiedData;
+        if (!chart.options.chart.allowMutatingData) { // #4259
+            // Remove old reference
+            if (options.data) {
+                delete series.options.data;
+            }
+            if (series.userOptions.data) {
+                delete series.userOptions.data;
+            }
+            copiedData = merge(true, data);
+        }
+        data = copiedData || data || [];
         var dataLength = data.length;
-        redraw = pick(redraw, true);
         if (dataSorting && dataSorting.enabled) {
             data = this.sortData(data);
         }
         // First try to run Point.update which is cheaper, allows animation,
         // and keeps references to points.
-        if (updatePoints !== false &&
+        if (chart.options.chart.allowMutatingData &&
+            updatePoints !== false &&
             dataLength &&
             oldDataLength &&
             !series.cropped &&
@@ -843,7 +854,7 @@ var Series = /** @class */ (function () {
             series.visible &&
             // Soft updating has no benefit in boost, and causes JS error
             // (#8355)
-            !series.isSeriesBoosting) {
+            !series.boosted) {
             updatedData = this.updateData(data, animation);
         }
         if (!updatedData) {
@@ -936,7 +947,7 @@ var Series = /** @class */ (function () {
             // destroy old points
             i = oldDataLength;
             while (i--) {
-                if (oldData[i] && oldData[i].destroy) {
+                if (oldData[i] && (oldData[i].destroy)) {
                     oldData[i].destroy();
                 }
             }
@@ -1189,26 +1200,6 @@ var Series = /** @class */ (function () {
             else {
                 // splat the y data in case of ohlc data array
                 point = (new PointClass()).init(series, [processedXData[i]].concat(splat(processedYData[i])));
-                /**
-                 * Highcharts Stock only. If a point object is created by data
-                 * grouping, it doesn't reflect actual points in the raw
-                 * data. In this case, the `dataGroup` property holds
-                 * information that points back to the raw data.
-                 *
-                 * - `dataGroup.start` is the index of the first raw data
-                 *   point in the group.
-                 *
-                 * - `dataGroup.length` is the amount of points in the
-                 *   group.
-                 *
-                 * @product highstock
-                 *
-                 * @name Highcharts.Point#dataGroup
-                 * @type {Highcharts.DataGroupingInfoObject|undefined}
-                 *
-                 * @sample stock/members/point-datagroup
-                 *         Click to inspect raw data points
-                 */
                 point.dataGroup = series.groupMap[groupCropStartIndex + i];
                 if (point.dataGroup.options) {
                     point.options = point.dataGroup.options;
@@ -1733,7 +1724,7 @@ var Series = /** @class */ (function () {
         this.setClip();
         // Destroy temporary clip rectangles that are no longer in use
         objectEach(this.chart.sharedClips, function (clip, key, sharedClips) {
-            if (clip && !_this.chart.container.querySelector("[clip-path=\"url(#" + clip.id + ")\"]")) {
+            if (clip && !_this.chart.container.querySelector("[clip-path=\"url(#".concat(clip.id, ")\"]"))) {
                 clip.destroy();
                 delete sharedClips[key];
             }
@@ -2006,7 +1997,7 @@ var Series = /** @class */ (function () {
      * @function Highcharts.Series#applyZones
      */
     Series.prototype.applyZones = function () {
-        var series = this, chart = this.chart, renderer = chart.renderer, zones = this.zones, clips = (this.clips || []), graph = this.graph, area = this.area, chartSizeMax = Math.max(chart.chartWidth, chart.chartHeight), axis = this[(this.zoneAxis || 'y') + 'Axis'], inverted = chart.inverted;
+        var series = this, chart = this.chart, renderer = chart.renderer, zones = this.zones, clips = (this.clips || []), graph = this.graph, area = this.area, plotSizeMax = Math.max(chart.plotWidth, chart.plotHeight), axis = this[(this.zoneAxis || 'y') + 'Axis'], inverted = chart.inverted;
         var translatedFrom, translatedTo, clipAttr, extremes, reversed, horiz, pxRange, pxPosMin, pxPosMax, zoneArea, zoneGraph, ignoreZones = false;
         if (zones.length &&
             (graph || area) &&
@@ -2030,8 +2021,8 @@ var Series = /** @class */ (function () {
                 translatedFrom = reversed ?
                     (horiz ? chart.plotWidth : 0) :
                     (horiz ? 0 : (axis.toPixels(extremes.min) || 0));
-                translatedFrom = clamp(pick(translatedTo, translatedFrom), 0, chartSizeMax);
-                translatedTo = clamp(Math.round(axis.toPixels(pick(threshold.value, extremes.max), true) || 0), 0, chartSizeMax);
+                translatedFrom = clamp(pick(translatedTo, translatedFrom), 0, plotSizeMax);
+                translatedTo = clamp(Math.round(axis.toPixels(pick(threshold.value, extremes.max), true) || 0), 0, plotSizeMax);
                 if (ignoreZones) {
                     translatedFrom = translatedTo =
                         axis.toPixels(extremes.max);
@@ -2044,7 +2035,7 @@ var Series = /** @class */ (function () {
                         x: inverted ? pxPosMax : pxPosMin,
                         y: 0,
                         width: pxRange,
-                        height: chartSizeMax
+                        height: plotSizeMax
                     };
                     if (!horiz) {
                         clipAttr.x = chart.plotHeight - clipAttr.x;
@@ -2054,7 +2045,7 @@ var Series = /** @class */ (function () {
                     clipAttr = {
                         x: 0,
                         y: inverted ? pxPosMax : pxPosMin,
-                        width: chartSizeMax,
+                        width: plotSizeMax,
                         height: pxRange
                     };
                     if (horiz) {
@@ -2112,10 +2103,10 @@ var Series = /** @class */ (function () {
         else if (series.visible) {
             // If zones were removed, restore graph and area
             if (graph) {
-                graph.show(true);
+                graph.show();
             }
             if (area) {
-                area.show(true);
+                area.show();
             }
         }
     };
@@ -2480,7 +2471,7 @@ var Series = /** @class */ (function () {
             }
             if (tree[sideB]) {
                 // compare distance to current best to splitting point to
-                // decide wether to check side B or not
+                // decide whether to check side B or not
                 if (Math.sqrt(tdist * tdist) < ret[kdComparer]) {
                     nPoint2 = _search(search, tree[sideB], depth + 1, dimensions);
                     ret = (nPoint2[kdComparer] <
@@ -2565,7 +2556,7 @@ var Series = /** @class */ (function () {
         else if (series.graph) { // create
             series.tracker = renderer.path(trackerPath)
                 .attr({
-                visibility: series.visible ? 'visible' : 'hidden',
+                visibility: series.visible ? 'inherit' : 'hidden',
                 zIndex: 2
             })
                 .addClass(trackByArea ?
@@ -2696,7 +2687,7 @@ var Series = /** @class */ (function () {
         }
         // Shift the first point off the parallel arrays
         if (shift) {
-            if (data[0] && data[0].remove) {
+            if (data[0] && (data[0].remove)) {
                 data[0].remove(false);
             }
             else {
@@ -2886,7 +2877,8 @@ var Series = /** @class */ (function () {
             series.hasOptionChanged('keys'));
         newType = newType || initialType;
         if (keepPoints) {
-            preserve.push('data', 'isDirtyData', 'points', 'processedXData', 'processedYData', 'xIncrement', 'cropped', '_hasPointMarkers', '_hasPointLabels', 'clips', // #15420
+            preserve.push('data', 'isDirtyData', 'points', 'processedData', // #17057
+            'processedXData', 'processedYData', 'xIncrement', 'cropped', '_hasPointMarkers', '_hasPointLabels', 'clips', // #15420
             // Networkgraph (#14397)
             'nodes', 'layout', 
             // Treemap
@@ -3346,6 +3338,31 @@ var Series = /** @class */ (function () {
         return this.chart.isInsidePlot(plotX, plotY, options);
     };
     Series.defaultOptions = SeriesDefaults;
+    /**
+     * Registry of all available series types.
+     *
+     * @name Highcharts.Series.types
+     * @type {Highcharts.Dictionary<typeof_Highcharts.Series>}
+     */
+    Series.types = SeriesRegistry.seriesTypes;
+    /* *
+     *
+     *  Static Functions
+     *
+     * */
+    /**
+     * Registers a series class to be accessible via `Series.types`.
+     *
+     * @function Highcharts.Series.registerType
+     *
+     * @param {string} seriesType
+     * The series type as an identifier string in lower case.
+     *
+     * @param {Function} SeriesClass
+     * The series class as a class pattern or a constructor function with
+     * prototype.
+     */
+    Series.registerType = SeriesRegistry.registerSeriesType;
     return Series;
 }());
 extend(Series.prototype, {

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

@@ -14,16 +14,18 @@ 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 __());
     };
 })();
-import Math3D from '../../Extensions/Math3D.js';
+import Math3D from '../Math3D.js';
 var perspective = Math3D.perspective;
 import Series from '../Series/Series.js';
 import U from '../Utilities.js';

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

@@ -410,6 +410,9 @@ var seriesDefaults = {
     /**
      * The line cap used for line ends and line joins on the graph.
      *
+     * @sample highcharts/series-line/linecap/
+     *         Line cap comparison
+     *
      * @type       {Highcharts.SeriesLinecapValue}
      * @default    round
      * @product    highcharts highstock
@@ -981,7 +984,7 @@ var seriesDefaults = {
          *
          * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
          */
-        lineColor: "#ffffff" /* backgroundColor */,
+        lineColor: "#ffffff" /* Palette.backgroundColor */,
         /**
          * The width of the point marker's outline.
          *
@@ -1181,7 +1184,7 @@ var seriesDefaults = {
                  *
                  * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
                  */
-                fillColor: "#cccccc" /* neutralColor20 */,
+                fillColor: "#cccccc" /* Palette.neutralColor20 */,
                 /**
                  * The color of the point marker's outline. When
                  * `undefined`, the series' or point's color is used.
@@ -1191,7 +1194,7 @@ var seriesDefaults = {
                  *
                  * @type {Highcharts.ColorString|Highcharts.GradientColorObject|Highcharts.PatternObject}
                  */
-                lineColor: "#000000" /* neutralColor100 */,
+                lineColor: "#000000" /* Palette.neutralColor100 */,
                 /**
                  * The width of the point marker's outline.
                  *
@@ -1811,13 +1814,13 @@ var seriesDefaults = {
          */
         x: 0,
         /**
-         * The Z index of the data labels. The default Z index puts it above
-         * the series. Use a Z index of 2 to display it behind the series.
+         * The z index of the data labels. Use a `zIndex` of 6 to display it above
+         * the series, or use a `zIndex` of 2 to display it behind the series.
          *
          * @type      {number}
          * @default   6
          * @since     2.3.5
-         * @apioption plotOptions.series.dataLabels.z
+         * @apioption plotOptions.series.dataLabels.zIndex
          */
         /**
          * The y position offset of the label relative to the point in
@@ -2255,6 +2258,8 @@ var seriesDefaults = {
      *
      * @sample highcharts/coloraxis/custom-color-key/
      *         Custom color key
+     * @sample highcharts/coloraxis/color-key-with-stops/
+     *         Custom colorKey with color axis stops
      * @sample highcharts/coloraxis/changed-default-color-key/
      *         Changed default color key
      *

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

@@ -36,43 +36,21 @@ var SeriesRegistry;
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
-    /**
-     * Internal function to initialize an individual series.
-     * @private
-     */
-    function getSeries(chart, options) {
-        if (options === void 0) { options = {}; }
-        var optionsChart = chart.options.chart, type = (options.type ||
-            optionsChart.type ||
-            optionsChart.defaultSeriesType ||
-            ''), SeriesClass = SeriesRegistry.seriesTypes[type];
-        // No such series type
-        if (!SeriesRegistry) {
-            error(17, true, chart, { missingModuleFor: type });
-        }
-        var series = new SeriesClass();
-        if (typeof series.init === 'function') {
-            series.init(chart, options);
-        }
-        return series;
-    }
-    SeriesRegistry.getSeries = getSeries;
     /**
      * Registers class pattern of a series.
      *
      * @private
      */
-    function registerSeriesType(seriesType, seriesClass) {
-        var defaultPlotOptions = defaultOptions.plotOptions || {}, seriesOptions = seriesClass.defaultOptions;
-        if (!seriesClass.prototype.pointClass) {
-            seriesClass.prototype.pointClass = Point;
+    function registerSeriesType(seriesType, SeriesClass) {
+        var defaultPlotOptions = defaultOptions.plotOptions || {}, seriesOptions = SeriesClass.defaultOptions, seriesProto = SeriesClass.prototype;
+        seriesProto.type = seriesType;
+        if (!seriesProto.pointClass) {
+            seriesProto.pointClass = Point;
         }
-        seriesClass.prototype.type = seriesType;
         if (seriesOptions) {
             defaultPlotOptions[seriesType] = seriesOptions;
         }
-        SeriesRegistry.seriesTypes[seriesType] = seriesClass;
+        SeriesRegistry.seriesTypes[seriesType] = SeriesClass;
     }
     SeriesRegistry.registerSeriesType = registerSeriesType;
     /**
@@ -117,7 +95,6 @@ var SeriesRegistry;
         return SeriesRegistry.seriesTypes[type];
     }
     SeriesRegistry.seriesType = seriesType;
-    /* eslint-enable valid-jsdoc */
 })(SeriesRegistry || (SeriesRegistry = {}));
 /* *
  *

package/es-modules/Core/Time.js

@@ -203,12 +203,12 @@ var Time = /** @class */ (function () {
      *
      */
     Time.prototype.update = function (options) {
-        var useUTC = pick(options && options.useUTC, true), time = this;
+        var useUTC = pick(options && options.useUTC, true);
         this.options = options = merge(true, this.options || {}, options);
         // Allow using a different Date class
         this.Date = options.Date || win.Date || Date;
         this.useUTC = useUTC;
-        this.timezoneOffset = (useUTC && options.timezoneOffset);
+        this.timezoneOffset = (useUTC && options.timezoneOffset) || void 0;
         this.getTimezoneOffset = this.timezoneOffsetFunction();
         /*
          * The time object has options allowing for variable time zones, meaning
@@ -633,7 +633,9 @@ var Time = /** @class */ (function () {
             hour: 6,
             day: 3
         };
-        var format, n, lastN = 'millisecond'; // for sub-millisecond data, #4223
+        var n = 'millisecond', 
+        // for sub-millisecond data, #4223
+        lastN = n;
         for (n in timeUnits) { // eslint-disable-line guard-for-in
             // If the range is exactly one week and we're looking at a
             // Sunday/Monday, go for the week format
@@ -660,10 +662,7 @@ var Time = /** @class */ (function () {
                 lastN = n;
             }
         }
-        if (n) {
-            format = this.resolveDTLFormat(dateTimeLabelFormats[n]).main;
-        }
-        return format;
+        return this.resolveDTLFormat(dateTimeLabelFormats[n]).main;
     };
     return Time;
 }());

package/es-modules/Core/Tooltip.js

@@ -383,11 +383,22 @@ var Tooltip = /** @class */ (function () {
         return this.label;
     };
     /**
-     * Place the tooltip in a chart without spilling over
-     * and not covering the point it self.
+     * Place the tooltip in a chart without spilling over and not covering the
+     * point itself.
      *
-     * @private
      * @function Highcharts.Tooltip#getPosition
+     *
+     * @param {number} boxWidth
+     *        Width of the tooltip box.
+     *
+     * @param {number} boxHeight
+     *        Height of the tooltip box.
+     *
+     * @param {Highcharts.Point} point
+     *        Tooltip related point.
+     *
+     * @return {Highcharts.PositionObject}
+     *         Recommended position of the tooltip.
      */
     Tooltip.prototype.getPosition = function (boxWidth, boxHeight, point) {
         var chart = this.chart, distance = this.distance, ret = {}, 
@@ -795,7 +806,7 @@ var Tooltip = /** @class */ (function () {
                             stroke: (options.borderColor ||
                                 point.color ||
                                 currentSeries.color ||
-                                "#666666" /* neutralColor60 */)
+                                "#666666" /* Palette.neutralColor60 */)
                         });
                     }
                     tooltip.updatePosition({
@@ -967,7 +978,7 @@ var Tooltip = /** @class */ (function () {
                     stroke: (options.borderColor ||
                         point.color ||
                         series.color ||
-                        "#333333" /* neutralColor80 */)
+                        "#333333" /* Palette.neutralColor80 */)
                 });
             }
             return tt;
@@ -1259,7 +1270,7 @@ var Tooltip = /** @class */ (function () {
             // scale transform/css zoom. #11329.
             if (chartPosition.scaleX !== 1 || chartPosition.scaleY !== 1) {
                 css(this.container, {
-                    transform: "scale(" + chartPosition.scaleX + ", " + chartPosition.scaleY + ")"
+                    transform: "scale(".concat(chartPosition.scaleX, ", ").concat(chartPosition.scaleY, ")")
                 });
                 anchorX *= chartPosition.scaleX;
                 anchorY *= chartPosition.scaleY;

package/es-modules/Core/Utilities.js

@@ -48,11 +48,11 @@ var charts = H.charts, doc = H.doc, win = H.win;
 function error(code, stop, chart, params) {
     var severity = stop ? 'Highcharts error' : 'Highcharts warning';
     if (code === 32) {
-        code = severity + ": Deprecated member";
+        code = "".concat(severity, ": Deprecated member");
     }
     var isCode = isNumber(code);
     var message = isCode ?
-        severity + " #" + code + ": www.highcharts.com/errors/" + code + "/" :
+        "".concat(severity, " #").concat(code, ": www.highcharts.com/errors/").concat(code, "/") :
         code.toString();
     var defaultHandler = function () {
         if (stop) {
@@ -71,7 +71,7 @@ function error(code, stop, chart, params) {
             message += '?';
         }
         objectEach(params, function (value, key) {
-            additionalMessages_1 += "\n - " + key + ": " + value;
+            additionalMessages_1 += "\n - ".concat(key, ": ").concat(value);
             if (isCode) {
                 message += encodeURI(key) + '=' + encodeURI(value);
             }
@@ -526,7 +526,7 @@ function pick() {
 function css(el, styles) {
     if (H.isMS && !H.svg) { // #2686
         if (styles && defined(styles.opacity)) {
-            styles.filter = "alpha(opacity=" + styles.opacity * 100 + ")";
+            styles.filter = "alpha(opacity=".concat(styles.opacity * 100, ")");
         }
     }
     extend(el.style, styles);
@@ -715,7 +715,7 @@ function getMagnitude(num) {
 function normalizeTickInterval(interval, multiples, magnitude, allowDecimals, hasTickAmount) {
     var i, retInterval = interval;
     // round to a tenfold of 1, 2, 2.5 or 5
-    magnitude = pick(magnitude, 1);
+    magnitude = pick(magnitude, getMagnitude(interval));
     var normalized = interval / magnitude;
     // multiples for a linear scale
     if (!multiples) {
@@ -1005,7 +1005,7 @@ function getStyle(el, prop, toInt) {
         error(27, true);
     }
     // Otherwise, get the computed style
-    var css = win.getComputedStyle(el, undefined); // eslint-disable-line no-undefined
+    var css = win.getComputedStyle(el, void 0); // eslint-disable-line no-undefined
     if (css) {
         style = css.getPropertyValue(prop);
         if (pick(toInt, prop !== 'opacity')) {
@@ -1125,8 +1125,6 @@ function offset(el) {
  *
  * @param {T} [ctx]
  *        The context.
- *
- * @return {void}
  */
 function objectEach(obj, fn, ctx) {
     /* eslint-enable valid-jsdoc */
@@ -1235,7 +1233,7 @@ objectEach({
 }, function (val, key) {
     H[key] = function (arr) {
         var _a;
-        error(32, false, void 0, (_a = {}, _a["Highcharts." + key] = "use Array." + val, _a));
+        error(32, false, void 0, (_a = {}, _a["Highcharts.".concat(key)] = "use Array.".concat(val), _a));
         return Array.prototype[val].apply(arr, [].slice.call(arguments, 1));
     };
 });

package/es-modules/Data/DataConverter.js

@@ -207,7 +207,7 @@ var DataConverter = /** @class */ (function () {
      * Converted value as a string.
      */
     DataConverter.prototype.asString = function (value) {
-        return "" + value;
+        return "".concat(value);
     };
     /**
      * Trim a string from whitespaces.
@@ -466,6 +466,11 @@ var DataConverter = /** @class */ (function () {
         }
         return format;
     };
+    /* *
+     *
+     *  Static Properties
+     *
+     * */
     /**
      * Default options
      */

package/es-modules/Data/DataPromise.js

@@ -1,6 +1,6 @@
 /* *
  *
- *  (c) 2020-2021 Highsoft AS
+ *  (c) 2020-2022 Highsoft AS
  *
  *  License: www.highcharts.com/license
  *