highcharts 9.3.1 → 10.0.0

package/es-modules/Extensions/Data.js

@@ -19,6 +19,8 @@ import Point from '../Core/Series/Point.js';
 import SeriesRegistry from '../Core/Series/SeriesRegistry.js';
 var seriesTypes = SeriesRegistry.seriesTypes;
 import U from '../Core/Utilities.js';
+import D from '../Core/DefaultOptions.js';
+var getOptions = D.getOptions;
 var addEvent = U.addEvent, defined = U.defined, extend = U.extend, fireEvent = U.fireEvent, isNumber = U.isNumber, merge = U.merge, objectEach = U.objectEach, pick = U.pick, splat = U.splat;
 /**
  * Callback function to modify the CSV before parsing it by the data module.
@@ -590,9 +592,6 @@ var Data = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Data#init
-     * @param {Highcharts.DataOptions} options
-     * @param {Highcharts.Options} [chartOptions]
-     * @param {Highcharts.Chart} [chart]
      */
     Data.prototype.init = function (options, chartOptions, chart) {
         var decimalPoint = options.decimalPoint, hasData;
@@ -612,6 +611,10 @@ var Data = /** @class */ (function () {
         this.firstRowAsNames = pick(options.firstRowAsNames, this.firstRowAsNames, true);
         this.decimalRegex = (decimalPoint &&
             new RegExp('^(-?[0-9]+)' + decimalPoint + '([0-9]+)$'));
+        // Always stop old polling when we have new options
+        if (this.liveDataTimeout !== void 0) {
+            clearTimeout(this.liveDataTimeout);
+        }
         // This is a two-dimensional array holding the raw, trimmed string
         // values with the same organisation as the columns array. It makes it
         // possible for example to revert from interpreted timestamps to
@@ -620,11 +623,7 @@ var Data = /** @class */ (function () {
         // No need to parse or interpret anything
         if (this.columns.length) {
             this.dataFound();
-            hasData = true;
-        }
-        if (this.hasURLOption(options)) {
-            clearTimeout(this.liveDataTimeout);
-            hasData = false;
+            hasData = !this.hasURLOption(options);
         }
         if (!hasData) {
             // Fetch live data
@@ -758,10 +757,6 @@ var Data = /** @class */ (function () {
      * Parse a CSV input string
      *
      * @function Highcharts.Data#parseCSV
-     *
-     * @param {Highcharts.DataOptions} [inOptions]
-     *
-     * @return {Array<Array<Highcharts.DataValueType>>}
      */
     Data.prototype.parseCSV = function (inOptions) {
         var self = this, options = inOptions || this.options, csv = options.csv, columns, startRow = (typeof options.startRow !== 'undefined' && options.startRow ?
@@ -1184,8 +1179,6 @@ var Data = /** @class */ (function () {
      * Parse a HTML table
      *
      * @function Highcharts.Data#parseTable
-     *
-     * @return {Array<Array<Highcharts.DataValueType>>}
      */
     Data.prototype.parseTable = function () {
         var options = this.options, table = options.table, columns = this.columns || [], startRow = options.startRow || 0, endRow = options.endRow || Number.MAX_VALUE, startColumn = options.startColumn || 0, endColumn = options.endColumn || Number.MAX_VALUE;
@@ -1366,7 +1359,7 @@ var Data = /** @class */ (function () {
                 success: function (json) {
                     fn(json);
                     if (options.enablePolling) {
-                        setTimeout(function () {
+                        data.liveDataTimeout = setTimeout(function () {
                             fetchSheet(fn);
                         }, refreshRate);
                     }
@@ -1460,9 +1453,10 @@ var Data = /** @class */ (function () {
      *        Column index
      */
     Data.prototype.parseColumn = function (column, col) {
-        var rawColumns = this.rawColumns, columns = this.columns, row = column.length, val, floatVal, trimVal, trimInsideVal, firstRowAsNames = this.firstRowAsNames, isXColumn = this.valueCount.xColumns.indexOf(col) !== -1, dateVal, backup = [], diff, chartOptions = this.chartOptions, descending, columnTypes = this.options.columnTypes || [], columnType = columnTypes[col], forceCategory = isXColumn && ((chartOptions &&
+        var rawColumns = this.rawColumns, columns = this.columns, firstRowAsNames = this.firstRowAsNames, isXColumn = this.valueCount.xColumns.indexOf(col) !== -1, backup = [], chartOptions = this.chartOptions, columnTypes = this.options.columnTypes || [], columnType = columnTypes[col], forceCategory = isXColumn && ((chartOptions &&
             chartOptions.xAxis &&
-            splat(chartOptions.xAxis)[0].type === 'category') || columnType === 'string');
+            splat(chartOptions.xAxis)[0].type === 'category') || columnType === 'string'), columnHasName = defined(column.name);
+        var row = column.length, val, floatVal, trimVal, trimInsideVal, dateVal, diff, descending;
         if (!rawColumns[col]) {
             rawColumns[col] = [];
         }
@@ -1477,7 +1471,8 @@ var Data = /** @class */ (function () {
             }
             // Disable number or date parsing by setting the X axis type to
             // category
-            if (forceCategory || (row === 0 && firstRowAsNames)) {
+            if (forceCategory ||
+                (row === 0 && firstRowAsNames && !columnHasName)) {
                 column[row] = '' + trimVal;
             }
             else if (+trimInsideVal === floatVal) { // is numeric
@@ -1561,10 +1556,6 @@ var Data = /** @class */ (function () {
      * `options.parseDate`.
      *
      * @function Highcharts.Data#parseDate
-     *
-     * @param {string} val
-     *
-     * @return {number}
      */
     Data.prototype.parseDate = function (val) {
         var parseDate = this.options.parseDate;
@@ -1628,10 +1619,6 @@ var Data = /** @class */ (function () {
      * Reorganize rows into columns.
      *
      * @function Highcharts.Data#rowsToColumns
-     *
-     * @param {Array<Array<Highcharts.DataValueType>>} rows
-     *
-     * @return {Array<Array<Highcharts.DataValueType>>|undefined}
      */
     Data.prototype.rowsToColumns = function (rows) {
         var row, rowsLength, col, colsLength, columns;
@@ -1673,8 +1660,6 @@ var Data = /** @class */ (function () {
      * A hook for working directly on the parsed columns
      *
      * @function Highcharts.Data#parsed
-     *
-     * @return {boolean|undefined}
      */
     Data.prototype.parsed = function () {
         if (this.options.parsed) {
@@ -1719,7 +1704,10 @@ var Data = /** @class */ (function () {
             // Get the names and shift the top row
             if (this.firstRowAsNames) {
                 for (i = 0; i < columns.length; i++) {
-                    columns[i].name = columns[i].shift();
+                    var curCol = columns[i];
+                    if (!defined(curCol.name)) {
+                        curCol.name = pick(curCol.shift(), '').toString();
+                    }
                 }
             }
             // Use the next columns for series
@@ -1831,7 +1819,7 @@ var Data = /** @class */ (function () {
      * @param {boolean} [redraw=true]
      */
     Data.prototype.update = function (options, redraw) {
-        var chart = this.chart;
+        var chart = this.chart, chartOptions = chart.options;
         if (options) {
             // Set the complete handler
             options.afterComplete = function (dataOptions) {
@@ -1850,8 +1838,13 @@ var Data = /** @class */ (function () {
                 }
             };
             // Apply it
-            merge(true, chart.options.data, options);
-            this.init(chart.options.data);
+            merge(true, chartOptions.data, options);
+            // Reset columns if fetching spreadsheet, to force a re-fetch
+            if (chartOptions.data && chartOptions.data.googleSpreadsheetKey &&
+                !options.columns) {
+                delete chartOptions.data.columns;
+            }
+            this.init(chartOptions.data);
         }
     };
     return Data;
@@ -1862,14 +1855,6 @@ var Data = /** @class */ (function () {
  * Creates a data object to parse data for a chart.
  *
  * @function Highcharts.data
- *
- * @param {Highcharts.DataOptions} dataOptions
- *
- * @param {Highcharts.Options} [chartOptions]
- *
- * @param {Highcharts.Chart} [chart]
- *
- * @return {Highcharts.Data}
  */
 G.data = function (dataOptions, chartOptions, chart) {
     return new G.Data(dataOptions, chartOptions, chart);
@@ -1879,7 +1864,9 @@ G.data = function (dataOptions, chartOptions, chart) {
 addEvent(Chart, 'init', function (e) {
     var chart = this, // eslint-disable-line no-invalid-this
     userOptions = (e.args[0] || {}), callback = e.args[1];
-    if (userOptions && userOptions.data && !chart.hasDataDef) {
+    var defaultDataOptions = getOptions().data;
+    if ((defaultDataOptions || userOptions && userOptions.data) &&
+        !chart.hasDataDef) {
         chart.hasDataDef = true;
         /**
          * The data parser for this chart.
@@ -1887,7 +1874,8 @@ addEvent(Chart, 'init', function (e) {
          * @name Highcharts.Chart#data
          * @type {Highcharts.Data|undefined}
          */
-        chart.data = new G.Data(extend(userOptions.data, {
+        var dataOptions = merge(defaultDataOptions, userOptions.data);
+        chart.data = new G.Data(extend(dataOptions, {
             afterComplete: function (dataOptions) {
                 var i, series;
                 // Merge series configs
@@ -1944,10 +1932,6 @@ var SeriesBuilder = /** @class */ (function () {
      * from the free columns (this is handled by the ColumnCursor instance).
      *
      * @function SeriesBuilder#populateColumns
-     *
-     * @param {Array<number>} freeIndexes
-     *
-     * @returns {boolean}
      */
     SeriesBuilder.prototype.populateColumns = function (freeIndexes) {
         var builder = this, enoughColumns = true;
@@ -1974,12 +1958,6 @@ var SeriesBuilder = /** @class */ (function () {
      * on the names of the readers.
      *
      * @function SeriesBuilder#read<T>
-     *
-     * @param {Array<Array<T>>} columns
-     *
-     * @param {number} rowIndex
-     *
-     * @returns {Array<T>|Highcharts.Dictionary<T>}
      */
     SeriesBuilder.prototype.read = function (columns, rowIndex) {
         var builder = this, pointIsArray = builder.pointIsArray, point = pointIsArray ? [] : {}, columnIndexes;
@@ -2022,10 +2000,6 @@ var SeriesBuilder = /** @class */ (function () {
      * an index when columns are populated.
      *
      * @function SeriesBuilder#addColumnReader
-     *
-     * @param {number} columnIndex
-     *
-     * @param {string} configName
      */
     SeriesBuilder.prototype.addColumnReader = function (columnIndex, configName) {
         this.readers.push({
@@ -2043,8 +2017,6 @@ var SeriesBuilder = /** @class */ (function () {
      * reading data.
      *
      * @function SeriesBuilder#getReferencedColumnIndexes
-     *
-     * @returns {Array<number>}
      */
     SeriesBuilder.prototype.getReferencedColumnIndexes = function () {
         var i, referencedColumnIndexes = [], columnReader;
@@ -2060,10 +2032,6 @@ var SeriesBuilder = /** @class */ (function () {
      * Returns true if the builder has a reader for the given configName.
      *
      * @function SeriesBuider#hasReader
-     *
-     * @param {string} configName
-     *
-     * @returns {boolean|undefined}
      */
     SeriesBuilder.prototype.hasReader = function (configName) {
         var i, columnReader;

package/es-modules/Extensions/DataGrouping.js

@@ -198,13 +198,17 @@ var applyGrouping = function (hasExtemesChanged) {
                 groupPositions,
                 dataGroupingOptions.approximation
             ]), groupedXData = groupedData.groupedXData, groupedYData = groupedData.groupedYData, gapSize = 0;
-            // The smoothed option is deprecated, instead,
-            // there is a fallback to the new anchoring mechanism. #12455.
-            if (dataGroupingOptions && dataGroupingOptions.smoothed && groupedXData.length) {
+            // The smoothed option is deprecated, instead, there is a fallback
+            // to the new anchoring mechanism. #12455.
+            if (dataGroupingOptions &&
+                dataGroupingOptions.smoothed &&
+                groupedXData.length) {
                 dataGroupingOptions.firstAnchor = 'firstPoint';
                 dataGroupingOptions.anchor = 'middle';
                 dataGroupingOptions.lastAnchor = 'lastPoint';
-                error(32, false, chart, { 'dataGrouping.smoothed': 'use dataGrouping.anchor' });
+                error(32, false, chart, {
+                    'dataGrouping.smoothed': 'use dataGrouping.anchor'
+                });
             }
             anchorPoints(series, groupedXData, xMax);
             // Record what data grouping values were used
@@ -262,7 +266,8 @@ var groupData = function (xData, yData, groupPositions, approximation) {
     var series = this, data = series.data, dataOptions = series.options && series.options.data, groupedXData = [], groupedYData = [], groupMap = [], dataLength = xData.length, pointX, pointY, groupedY, 
     // when grouping the fake extended axis for panning,
     // we don't need to consider y
-    handleYData = !!yData, values = [], approximationFn, pointArrayMap = series.pointArrayMap, pointArrayMapLength = pointArrayMap && pointArrayMap.length, extendedPointArrayMap = ['x'].concat(pointArrayMap || ['y']), groupAll = this.options.dataGrouping && this.options.dataGrouping.groupAll, pos = 0, start = 0, valuesLen, i, j;
+    handleYData = !!yData, values = [], approximationFn, pointArrayMap = series.pointArrayMap, pointArrayMapLength = pointArrayMap && pointArrayMap.length, extendedPointArrayMap = ['x'].concat(pointArrayMap || ['y']), groupAll = (this.options.dataGrouping &&
+        this.options.dataGrouping.groupAll), pos = 0, start = 0, valuesLen, i, j;
     /**
      * @private
      */
@@ -380,15 +385,15 @@ var groupData = function (xData, yData, groupPositions, approximation) {
     };
 };
 var anchorPoints = function (series, groupedXData, xMax) {
-    var options = series.options, dataGroupingOptions = options.dataGrouping, totalRange = series.currentDataGrouping && series.currentDataGrouping.gapSize;
+    var options = series.options, dataGroupingOptions = options.dataGrouping, totalRange = (series.currentDataGrouping && series.currentDataGrouping.gapSize);
     var i;
     // DataGrouping x-coordinates.
     if (dataGroupingOptions && series.xData && totalRange && series.groupMap) {
         var groupedDataLength = groupedXData.length - 1, anchor = dataGroupingOptions.anchor, firstAnchor = pick(dataGroupingOptions.firstAnchor, anchor), lastAnchor = pick(dataGroupingOptions.lastAnchor, anchor);
         // Anchor points that are not extremes.
         if (anchor && anchor !== 'start') {
-            var shiftInterval = totalRange *
-                { middle: 0.5, end: 1 }[anchor];
+            var shiftInterval = (totalRange *
+                { middle: 0.5, end: 1 }[anchor]);
             i = groupedXData.length - 1;
             while (i-- && i > 0) {
                 groupedXData[i] += shiftInterval;
@@ -650,7 +655,8 @@ Axis.prototype.applyGrouping = function (e) {
     series.forEach(function (series) {
         // Reset the groupPixelWidth, then calculate if needed.
         series.groupPixelWidth = void 0; // #2110
-        series.groupPixelWidth = axis.getGroupPixelWidth && axis.getGroupPixelWidth();
+        series.groupPixelWidth = (axis.getGroupPixelWidth &&
+            axis.getGroupPixelWidth());
         if (series.groupPixelWidth) {
             series.hasProcessed = true; // #2692
         }
@@ -683,7 +689,8 @@ Axis.prototype.getGroupPixelWidth = function () {
             // Execute grouping if the amount of points is greater than the
             // limit defined in groupPixelWidth
             if (series[i].groupPixelWidth ||
-                dataLength > (this.chart.plotSizeX / groupPixelWidth) ||
+                (dataLength >
+                    (this.chart.plotSizeX / groupPixelWidth)) ||
                 (dataLength && dgOptions.forced)) {
                 doGrouping = true;
             }
@@ -728,8 +735,11 @@ Axis.prototype.setDataGrouping = function (dataGrouping, redraw) {
     }
     else {
         this.chart.options.series.forEach(function (seriesOptions) {
-            seriesOptions.dataGrouping = dataGrouping;
-        }, false);
+            // Merging dataGrouping options with already defined options #16759
+            seriesOptions.dataGrouping = typeof dataGrouping === 'boolean' ?
+                dataGrouping :
+                merge(dataGrouping, seriesOptions.dataGrouping);
+        });
     }
     // Clear ordinal slope, so we won't accidentaly use the old one (#7827)
     if (axis.ordinal) {
@@ -806,10 +816,10 @@ addEvent(Series, 'destroy', seriesProto.destroyGroupedData);
 // some series types are defined after this.
 addEvent(Series, 'afterSetOptions', function (e) {
     var options = e.options, type = this.type, plotOptions = this.chart.options.plotOptions, defaultOptions = D.defaultOptions.plotOptions[type].dataGrouping, 
-    // External series, for example technical indicators should also
-    // inherit commonOptions which are not available outside this module
-    baseOptions = this.useCommonDataGrouping && commonOptions;
-    if (specificOptions[type] || baseOptions) { // #1284
+    // External series, for example technical indicators should also inherit
+    // commonOptions which are not available outside this module
+    baseOptions = (this.useCommonDataGrouping && commonOptions);
+    if (plotOptions && (specificOptions[type] || baseOptions)) { // #1284
         if (!defaultOptions) {
             defaultOptions = merge(commonOptions, specificOptions[type]);
         }
@@ -943,7 +953,7 @@ export default dataGrouping;
  * to two weeks, the second and third item of the week array are used,
  *  and applied to the start and end date of the time span.
  *
- * @type      {object}
+ * @type      {Object}
  * @apioption plotOptions.series.dataGrouping.dateTimeLabelFormats
  */
 /**

package/es-modules/Extensions/DraggablePoints.js

@@ -242,7 +242,7 @@ if (seriesTypes.columnrange) {
             resize: true,
             resizeSide: 'bottom',
             handlePositioner: function (point) {
-                var bBox = point.shapeArgs || point.graphic.getBBox();
+                var bBox = (point.shapeArgs || point.graphic.getBBox());
                 return {
                     x: bBox.x || 0,
                     y: (bBox.y || 0) + (bBox.height || 0)
@@ -268,7 +268,7 @@ if (seriesTypes.columnrange) {
             resize: true,
             resizeSide: 'top',
             handlePositioner: function (point) {
-                var bBox = point.shapeArgs || point.graphic.getBBox();
+                var bBox = (point.shapeArgs || point.graphic.getBBox());
                 return {
                     x: bBox.x || 0,
                     y: bBox.y || 0
@@ -710,7 +710,6 @@ if (seriesTypes.xrange) {
  * @private
  * @param {string} type
  *        Unsupported series type
- * @return {void}
  */
 function (type) {
     if (seriesTypes[type]) {
@@ -812,11 +811,11 @@ var defaultGuideBoxOptions = {
     }
 };
 /**
- * Options for the drag handles.
+ * Options for the drag handles available in column series.
  *
  * @declare      Highcharts.DragDropHandleOptionsObject
  * @since        6.2.0
- * @optionparent plotOptions.series.dragDrop.dragHandle
+ * @optionparent plotOptions.column.dragDrop.dragHandle
  *
  * @private
  */
@@ -828,7 +827,7 @@ var defaultDragHandleOptions = {
      *
      * @type      {Function}
      * @since     6.2.0
-     * @apioption plotOptions.series.dragDrop.dragHandle.pathFormatter
+     * @apioption plotOptions.column.dragDrop.dragHandle.pathFormatter
      */
     // pathFormatter: null,
     /**
@@ -838,7 +837,7 @@ var defaultDragHandleOptions = {
      *
      * @type      {string}
      * @since     6.2.0
-     * @apioption plotOptions.series.dragDrop.dragHandle.cursor
+     * @apioption plotOptions.column.dragDrop.dragHandle.cursor
      */
     // cursor: null,
     /**
@@ -1218,7 +1217,7 @@ function hasDraggedPastSensitivity(e, chart, sensitivity) {
  * @param {Highcharts.SVGElement} [guideBox]
  *        The guide box to take snapshot of.
  *
- * @return {object}
+ * @return {Object}
  *         Snapshot object. Point properties are placed in a hashmap with IDs as
  *         keys.
  */
@@ -1366,7 +1365,7 @@ function initDragDrop(e, point) {
  * @private
  * @function getNewPoints
  *
- * @param {object} dragDropData
+ * @param {Object} dragDropData
  *        A chart's dragDropData with drag/drop origin information, and info on
  *        which points are being dragged.
  *
@@ -1545,7 +1544,7 @@ Chart.prototype.setGuideBoxState = function (state, options) {
  * @private
  * @function Highcharts.Point#getDropValues
  *
- * @param {object} origin
+ * @param {Object} origin
  *        Mouse position (chartX/Y) and point props at current data values.
  *        Point props should be organized per point.id in a hashmap.
  *
@@ -1630,7 +1629,7 @@ Series.prototype.getGuideBox = function (points) {
     var chart = this.chart, minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity, changed;
     // Find bounding box of all points
     points.forEach(function (point) {
-        var bBox = point.graphic && point.graphic.getBBox() || point.shapeArgs;
+        var bBox = (point.graphic && point.graphic.getBBox() || point.shapeArgs);
         if (bBox) {
             var plotX2 = void 0;
             var x2 = point.x2;
@@ -1758,13 +1757,15 @@ Point.prototype.showDragHandles = function () {
             // Find position and path of handle
             pos = positioner(point);
             handleAttrs.d = path = pathFormatter(point);
-            if (!path || pos.x < 0 || pos.y < 0) {
+            // Correct left edge value depending on the xAxis' type, #16596
+            var minEdge = point.series.xAxis.categories ? -0.5 : 0;
+            if (!path || pos.x < minEdge || pos.y < 0) {
                 return;
             }
             // If cursor is not set explicitly, use axis direction
             handleAttrs.cursor = handleOptions.cursor ||
-                (val.axis === 'x') !== !!chart.inverted ?
-                'ew-resize' : 'ns-resize';
+                ((val.axis === 'x') !== !!chart.inverted ?
+                    'ew-resize' : 'ns-resize');
             // Create and add the handle element if it doesn't exist
             handle = chart.dragHandles[val.optionName];
             if (!handle) {
@@ -1815,7 +1816,7 @@ Chart.prototype.hideDragHandles = function () {
  * @private
  * @function countProps
  *
- * @param {object} obj
+ * @param {Object} obj
  *        The object to count.
  *
  * @return {number}