highcharts 9.1.1 → 9.2.2

package/es-modules/Extensions/DataGrouping.js

@@ -147,6 +147,109 @@ var approximations = H.approximations = {
         // else, return is undefined
     }
 };
+var applyGrouping = function () {
+    var series = this, chart = series.chart, options = series.options, dataGroupingOptions = options.dataGrouping, groupingEnabled = series.allowDG !== false && dataGroupingOptions &&
+        pick(dataGroupingOptions.enabled, chart.options.isStock), visible = (series.visible || !chart.options.chart.ignoreHiddenSeries), hasGroupedData, skip, lastDataGrouping = this.currentDataGrouping, currentDataGrouping, croppedData, revertRequireSorting = false;
+    // Data needs to be sorted for dataGrouping
+    if (groupingEnabled && !series.requireSorting) {
+        series.requireSorting = revertRequireSorting = true;
+    }
+    // Skip if processData returns false or if grouping is disabled (in that
+    // order)
+    skip = skipDataGrouping(series) || !groupingEnabled;
+    // Revert original requireSorting value if changed
+    if (revertRequireSorting) {
+        series.requireSorting = false;
+    }
+    if (!skip) {
+        series.destroyGroupedData();
+        var i = void 0, processedXData = dataGroupingOptions.groupAll ?
+            series.xData :
+            series.processedXData, processedYData = dataGroupingOptions.groupAll ?
+            series.yData :
+            series.processedYData, plotSizeX = chart.plotSizeX, xAxis = series.xAxis, ordinal = xAxis.options.ordinal, groupPixelWidth = series.groupPixelWidth;
+        // Execute grouping if the amount of points is greater than the limit
+        // defined in groupPixelWidth
+        if (groupPixelWidth &&
+            processedXData &&
+            processedXData.length) {
+            hasGroupedData = true;
+            // Force recreation of point instances in series.translate, #5699
+            series.isDirty = true;
+            series.points = null; // #6709
+            var extremes = xAxis.getExtremes(), xMin = extremes.min, xMax = extremes.max, groupIntervalFactor = (ordinal &&
+                xAxis.ordinal &&
+                xAxis.ordinal.getGroupIntervalFactor(xMin, xMax, series)) || 1, interval = (groupPixelWidth * (xMax - xMin) / plotSizeX) *
+                groupIntervalFactor, groupPositions = xAxis.getTimeTicks(DateTimeAxis.Additions.prototype.normalizeTimeTickInterval(interval, dataGroupingOptions.units ||
+                defaultDataGroupingUnits), 
+            // Processed data may extend beyond axis (#4907)
+            Math.min(xMin, processedXData[0]), Math.max(xMax, processedXData[processedXData.length - 1]), xAxis.options.startOfWeek, processedXData, series.closestPointRange), groupedData = seriesProto.groupData.apply(series, [
+                processedXData,
+                processedYData,
+                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) {
+                dataGroupingOptions.firstAnchor = 'firstPoint';
+                dataGroupingOptions.anchor = 'middle';
+                dataGroupingOptions.lastAnchor = 'lastPoint';
+                error(32, false, chart, { 'dataGrouping.smoothed': 'use dataGrouping.anchor' });
+            }
+            anchorPoints(series, groupedXData, xMax);
+            // Record what data grouping values were used
+            for (i = 1; i < groupPositions.length; i++) {
+                // The grouped gapSize needs to be the largest distance between
+                // the group to capture varying group sizes like months or DST
+                // crossing (#10000). Also check that the gap is not at the
+                // start of a segment.
+                if (!groupPositions.info.segmentStarts ||
+                    groupPositions.info.segmentStarts.indexOf(i) === -1) {
+                    gapSize = Math.max(groupPositions[i] - groupPositions[i - 1], gapSize);
+                }
+            }
+            currentDataGrouping = groupPositions.info;
+            currentDataGrouping.gapSize = gapSize;
+            series.closestPointRange = groupPositions.info.totalRange;
+            series.groupMap = groupedData.groupMap;
+            if (visible) {
+                adjustExtremes(xAxis, groupedXData);
+            }
+            // We calculated all group positions but we should render
+            // only the ones within the visible range
+            if (dataGroupingOptions.groupAll) {
+                // Keep the reference to all grouped points
+                // for further calculation (eg. heikinashi).
+                series.allGroupedData = groupedYData;
+                croppedData = series.cropData(groupedXData, groupedYData, xAxis.min, xAxis.max, 1 // Ordinal xAxis will remove left-most points otherwise
+                );
+                groupedXData = croppedData.xData;
+                groupedYData = croppedData.yData;
+                series.cropStart = croppedData.start; // #15005
+            }
+            // Set series props
+            series.processedXData = groupedXData;
+            series.processedYData = groupedYData;
+        }
+        else {
+            series.groupMap = null;
+        }
+        series.hasGroupedData = hasGroupedData;
+        series.currentDataGrouping = currentDataGrouping;
+        series.preventGraphAnimation =
+            (lastDataGrouping && lastDataGrouping.totalRange) !==
+                (currentDataGrouping && currentDataGrouping.totalRange);
+    }
+};
+var skipDataGrouping = function (series) {
+    if (series.isCartesian &&
+        !series.isDirty &&
+        !series.xAxis.isDirty &&
+        !series.yAxis.isDirty) {
+        return false;
+    }
+};
 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,
@@ -419,6 +522,10 @@ commonOptions = {
     },
     ohlc: {
         groupPixelWidth: 5
+    },
+    // Move to HeikinAshiSeries.ts aftre refactoring data grouping.
+    heikinashi: {
+        groupPixelWidth: 10
     }
 }, 
 // units are defined in a separate array to allow complete overriding in
@@ -482,106 +589,15 @@ seriesProto.getDGApproximation = function () {
  * @return {void}
  */
 seriesProto.groupData = groupData;
-// Extend the basic processData method, that crops the data to the current zoom
-// range, with data grouping logic.
-seriesProto.processData = function () {
-    var series = this, chart = series.chart, options = series.options, dataGroupingOptions = options.dataGrouping, groupingEnabled = series.allowDG !== false && dataGroupingOptions &&
-        pick(dataGroupingOptions.enabled, chart.options.isStock), visible = (series.visible || !chart.options.chart.ignoreHiddenSeries), hasGroupedData, skip, lastDataGrouping = this.currentDataGrouping, currentDataGrouping, croppedData, revertRequireSorting = false;
-    // Run base method
-    series.forceCrop = groupingEnabled; // #334
-    series.groupPixelWidth = null; // #2110
-    series.hasProcessed = true; // #2692
-    // Data needs to be sorted for dataGrouping
-    if (groupingEnabled && !series.requireSorting) {
-        series.requireSorting = revertRequireSorting = true;
-    }
-    // Skip if processData returns false or if grouping is disabled (in that
-    // order)
-    skip = (baseProcessData.apply(series, arguments) === false ||
-        !groupingEnabled);
-    // Revert original requireSorting value if changed
-    if (revertRequireSorting) {
-        series.requireSorting = false;
-    }
-    if (!skip) {
-        series.destroyGroupedData();
-        var i = void 0, processedXData = dataGroupingOptions.groupAll ?
-            series.xData :
-            series.processedXData, processedYData = dataGroupingOptions.groupAll ?
-            series.yData :
-            series.processedYData, plotSizeX = chart.plotSizeX, xAxis = series.xAxis, ordinal = xAxis.options.ordinal, groupPixelWidth = series.groupPixelWidth =
-            xAxis.getGroupPixelWidth && xAxis.getGroupPixelWidth();
-        // Execute grouping if the amount of points is greater than the limit
-        // defined in groupPixelWidth
-        if (groupPixelWidth &&
-            processedXData &&
-            processedXData.length) {
-            hasGroupedData = true;
-            // Force recreation of point instances in series.translate, #5699
-            series.isDirty = true;
-            series.points = null; // #6709
-            var extremes = xAxis.getExtremes(), xMin = extremes.min, xMax = extremes.max, groupIntervalFactor = (ordinal &&
-                xAxis.ordinal &&
-                xAxis.ordinal.getGroupIntervalFactor(xMin, xMax, series)) || 1, interval = (groupPixelWidth * (xMax - xMin) / plotSizeX) *
-                groupIntervalFactor, groupPositions = xAxis.getTimeTicks(DateTimeAxis.AdditionsClass.prototype.normalizeTimeTickInterval(interval, dataGroupingOptions.units ||
-                defaultDataGroupingUnits), 
-            // Processed data may extend beyond axis (#4907)
-            Math.min(xMin, processedXData[0]), Math.max(xMax, processedXData[processedXData.length - 1]), xAxis.options.startOfWeek, processedXData, series.closestPointRange), groupedData = seriesProto.groupData.apply(series, [
-                processedXData,
-                processedYData,
-                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) {
-                dataGroupingOptions.firstAnchor = 'firstPoint';
-                dataGroupingOptions.anchor = 'middle';
-                dataGroupingOptions.lastAnchor = 'lastPoint';
-                error(32, false, chart, { 'dataGrouping.smoothed': 'use dataGrouping.anchor' });
-            }
-            anchorPoints(series, groupedXData, xMax);
-            // Record what data grouping values were used
-            for (i = 1; i < groupPositions.length; i++) {
-                // The grouped gapSize needs to be the largest distance between
-                // the group to capture varying group sizes like months or DST
-                // crossing (#10000). Also check that the gap is not at the
-                // start of a segment.
-                if (!groupPositions.info.segmentStarts ||
-                    groupPositions.info.segmentStarts.indexOf(i) === -1) {
-                    gapSize = Math.max(groupPositions[i] - groupPositions[i - 1], gapSize);
-                }
-            }
-            currentDataGrouping = groupPositions.info;
-            currentDataGrouping.gapSize = gapSize;
-            series.closestPointRange = groupPositions.info.totalRange;
-            series.groupMap = groupedData.groupMap;
-            if (visible) {
-                adjustExtremes(xAxis, groupedXData);
-            }
-            // We calculated all group positions but we should render
-            // only the ones within the visible range
-            if (dataGroupingOptions.groupAll) {
-                croppedData = series.cropData(groupedXData, groupedYData, xAxis.min, xAxis.max, 1 // Ordinal xAxis will remove left-most points otherwise
-                );
-                groupedXData = croppedData.xData;
-                groupedYData = croppedData.yData;
-                series.cropStart = croppedData.start; // #15005
-            }
-            // Set series props
-            series.processedXData = groupedXData;
-            series.processedYData = groupedYData;
-        }
-        else {
-            series.groupMap = null;
-        }
-        series.hasGroupedData = hasGroupedData;
-        series.currentDataGrouping = currentDataGrouping;
-        series.preventGraphAnimation =
-            (lastDataGrouping && lastDataGrouping.totalRange) !==
-                (currentDataGrouping && currentDataGrouping.totalRange);
-    }
-};
+/**
+ * For the processed data, calculate the grouped data if needed.
+ *
+ * @private
+ * @function Highcharts.Series#applyGrouping
+ *
+ * @return {void}
+ */
+seriesProto.applyGrouping = applyGrouping;
 // Destroy the grouped data points. #622, #740
 seriesProto.destroyGroupedData = function () {
     // Clear previous groups
@@ -607,6 +623,112 @@ seriesProto.generatePoints = function () {
     this.destroyGroupedData(); // #622
     this.groupedData = this.hasGroupedData ? this.points : null;
 };
+/**
+ * Check the groupPixelWidth and apply the grouping if needed.
+ * Fired only after processing the data.
+ *
+ * @product highstock
+ *
+ * @function Highcharts.Axis#applyGrouping
+ */
+Axis.prototype.applyGrouping = function () {
+    var axis = this, series = axis.series;
+    series.forEach(function (series) {
+        // Reset the groupPixelWidth, then calculate if needed.
+        series.groupPixelWidth = void 0; // #2110
+        series.groupPixelWidth = axis.getGroupPixelWidth && axis.getGroupPixelWidth();
+        if (series.groupPixelWidth) {
+            series.hasProcessed = true; // #2692
+        }
+        // Fire independing on series.groupPixelWidth to always set a proper
+        // dataGrouping state, (#16238)
+        series.applyGrouping();
+    });
+};
+// Get the data grouping pixel width based on the greatest defined individual
+// width of the axis' series, and if whether one of the axes need grouping.
+Axis.prototype.getGroupPixelWidth = function () {
+    var series = this.series, len = series.length, i, groupPixelWidth = 0, doGrouping = false, dataLength, dgOptions;
+    // If multiple series are compared on the same x axis, give them the same
+    // group pixel width (#334)
+    i = len;
+    while (i--) {
+        dgOptions = series[i].options.dataGrouping;
+        if (dgOptions) {
+            groupPixelWidth = Math.max(groupPixelWidth, 
+            // Fallback to commonOptions (#9693)
+            pick(dgOptions.groupPixelWidth, commonOptions.groupPixelWidth));
+        }
+    }
+    // If one of the series needs grouping, apply it to all (#1634)
+    i = len;
+    while (i--) {
+        dgOptions = series[i].options.dataGrouping;
+        if (dgOptions) { // #2692
+            dataLength = (series[i].processedXData || series[i].data).length;
+            // 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 && dgOptions.forced)) {
+                doGrouping = true;
+            }
+        }
+    }
+    return doGrouping ? groupPixelWidth : 0;
+};
+/**
+ * Highcharts Stock only. Force data grouping on all the axis' series.
+ *
+ * @product highstock
+ *
+ * @function Highcharts.Axis#setDataGrouping
+ *
+ * @param {boolean|Highcharts.DataGroupingOptionsObject} [dataGrouping]
+ *        A `dataGrouping` configuration. Use `false` to disable data grouping
+ *        dynamically.
+ *
+ * @param {boolean} [redraw=true]
+ *        Whether to redraw the chart or wait for a later call to
+ *        {@link Chart#redraw}.
+ */
+Axis.prototype.setDataGrouping = function (dataGrouping, redraw) {
+    var axis = this;
+    var i;
+    redraw = pick(redraw, true);
+    if (!dataGrouping) {
+        dataGrouping = {
+            forced: false,
+            units: null
+        };
+    }
+    // Axis is instantiated, update all series
+    if (this instanceof Axis) {
+        i = this.series.length;
+        while (i--) {
+            this.series[i].update({
+                dataGrouping: dataGrouping
+            }, false);
+        }
+        // Axis not yet instanciated, alter series options
+    }
+    else {
+        this.chart.options.series.forEach(function (seriesOptions) {
+            seriesOptions.dataGrouping = dataGrouping;
+        }, false);
+    }
+    // Clear ordinal slope, so we won't accidentaly use the old one (#7827)
+    if (axis.ordinal) {
+        axis.ordinal.slope = void 0;
+    }
+    if (redraw) {
+        this.chart.redraw();
+    }
+};
+// When all series are processed, calculate the group pixel width and then
+// if this value is different than zero apply groupings.
+addEvent(Axis, 'postProcessData', Axis.prototype.applyGrouping);
 // Override point prototype to throw a warning when trying to update grouped
 // points.
 addEvent(Point, 'update', function () {
@@ -618,7 +740,7 @@ addEvent(Point, 'update', function () {
 // Extend the original method, make the tooltip's header reflect the grouped
 // range.
 addEvent(Tooltip, 'headerFormatter', function (e) {
-    var tooltip = this, chart = this.chart, time = chart.time, labelConfig = e.labelConfig, series = labelConfig.series, options = series.options, tooltipOptions = series.tooltipOptions, dataGroupingOptions = options.dataGrouping, xDateFormat = tooltipOptions.xDateFormat, xDateFormatEnd, xAxis = series.xAxis, currentDataGrouping, dateTimeLabelFormats, labelFormats, formattedKey, formatString = tooltipOptions[(e.isFooter ? 'footer' : 'header') + 'Format'];
+    var tooltip = this, chart = this.chart, time = chart.time, labelConfig = e.labelConfig, series = labelConfig.series, options = series.options, tooltipOptions = series.tooltipOptions, dataGroupingOptions = options.dataGrouping, xDateFormat = tooltipOptions.xDateFormat, xDateFormatEnd, xAxis = series.xAxis, currentDataGrouping, dateTimeLabelFormats, labelFormats, formattedKey, formatString = tooltipOptions[e.isFooter ? 'footerFormat' : 'headerFormat'];
     // apply only to grouped series
     if (xAxis &&
         xAxis.options.type === 'datetime' &&
@@ -645,8 +767,8 @@ addEvent(Tooltip, 'headerFormatter', function (e) {
             // best fit, so if the least distance between points is one minute, show
             // it, but if the least distance is one day, skip hours and minutes etc.
         }
-        else if (!xDateFormat && dateTimeLabelFormats) {
-            xDateFormat = tooltip.getXDateFormat(labelConfig, tooltipOptions, xAxis);
+        else if (!xDateFormat && dateTimeLabelFormats && xAxis.dateTime) {
+            xDateFormat = xAxis.dateTime.getXDateFormat(labelConfig.x, tooltipOptions.dateTimeLabelFormats);
         }
         // now format the key
         formattedKey = time.dateFormat(xDateFormat, labelConfig.key);
@@ -695,87 +817,6 @@ addEvent(Axis, 'afterSetScale', function () {
         series.hasProcessed = false;
     });
 });
-// Get the data grouping pixel width based on the greatest defined individual
-// width of the axis' series, and if whether one of the axes need grouping.
-Axis.prototype.getGroupPixelWidth = function () {
-    var series = this.series, len = series.length, i, groupPixelWidth = 0, doGrouping = false, dataLength, dgOptions;
-    // If multiple series are compared on the same x axis, give them the same
-    // group pixel width (#334)
-    i = len;
-    while (i--) {
-        dgOptions = series[i].options.dataGrouping;
-        if (dgOptions) {
-            groupPixelWidth = Math.max(groupPixelWidth, 
-            // Fallback to commonOptions (#9693)
-            pick(dgOptions.groupPixelWidth, commonOptions.groupPixelWidth));
-        }
-    }
-    // If one of the series needs grouping, apply it to all (#1634)
-    i = len;
-    while (i--) {
-        dgOptions = series[i].options.dataGrouping;
-        if (dgOptions && series[i].hasProcessed) { // #2692
-            dataLength = (series[i].processedXData || series[i].data).length;
-            // 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 && dgOptions.forced)) {
-                doGrouping = true;
-            }
-        }
-    }
-    return doGrouping ? groupPixelWidth : 0;
-};
-/**
- * Highcharts Stock only. Force data grouping on all the axis' series.
- *
- * @product highstock
- *
- * @function Highcharts.Axis#setDataGrouping
- *
- * @param {boolean|Highcharts.DataGroupingOptionsObject} [dataGrouping]
- *        A `dataGrouping` configuration. Use `false` to disable data grouping
- *        dynamically.
- *
- * @param {boolean} [redraw=true]
- *        Whether to redraw the chart or wait for a later call to
- *        {@link Chart#redraw}.
- */
-Axis.prototype.setDataGrouping = function (dataGrouping, redraw) {
-    var axis = this;
-    var i;
-    redraw = pick(redraw, true);
-    if (!dataGrouping) {
-        dataGrouping = {
-            forced: false,
-            units: null
-        };
-    }
-    // Axis is instantiated, update all series
-    if (this instanceof Axis) {
-        i = this.series.length;
-        while (i--) {
-            this.series[i].update({
-                dataGrouping: dataGrouping
-            }, false);
-        }
-        // Axis not yet instanciated, alter series options
-    }
-    else {
-        this.chart.options.series.forEach(function (seriesOptions) {
-            seriesOptions.dataGrouping = dataGrouping;
-        }, false);
-    }
-    // Clear ordinal slope, so we won't accidentaly use the old one (#7827)
-    if (axis.ordinal) {
-        axis.ordinal.slope = void 0;
-    }
-    if (redraw) {
-        this.chart.redraw();
-    }
-};
 H.dataGrouping = dataGrouping;
 export default dataGrouping;
 /* eslint-enable no-invalid-this, valid-jsdoc */

package/es-modules/Extensions/Debugger/ErrorMessages.js

@@ -11,8 +11,8 @@
 var errorMessages = {
     "10": {
         "title": "Can't plot zero or subzero values on a logarithmic axis",
-        "text": "<h1>Can't plot zero or subzero values on a logarithmic axis</h1><p>This error occurs in the following situations: </p><ul><li>If a zero or subzero data value is added to a logarithmic axis</li><li>If the minimum of a logarithimic axis is set to 0 or less</li><li>If the threshold is set to 0 or less</li></ul><p>Note: As of Highcharts 5.0.8 it's possible to bypass this error message by setting <code>Axis.prototype.allowNegativeLog</code> to true, and add custom conversion functions. <a href=\"https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/samples/highcharts/yaxis/type-log-negative/\">View live demo</a>. It is also possible to use a similar workaround for colorAxis. <a href=\"https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/samples/highcharts/coloraxis/logarithmic-with-emulate-negative-values/\">View live demo</a>.</p>",
-        "enduser": "<h1>Can't plot zero or subzero values on a logarithmic axis</h1><p>This error occurs in the following situations:</p><ul><li>If a zero or subzero data value is added to a logarithmic axis</li><li>If the minimum of a logarithimic axis is set to 0 or less</li><li>If the threshold is set to 0 or less</li></ul><p>As of Highcharts 5.0.8 it's possible to bypass this error message by setting <code>Axis.prototype.allowNegativeLog</code> to <code>true</code> and add custom conversion functions. <a href=\"http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/samples/highcharts/yaxis/type-log-negative/\">\">View Live Demo</a>. It is also possible to use a similar workaround for colorAxis. <a href=\"https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/samples/highcharts/coloraxis/logarithmic-with-emulate-negative-values/\">View live demo</a>.</p>"
+        "text": "<h1>Can't plot zero or subzero values on a logarithmic axis</h1><p>This error occurs in the following situations: </p><ul><li>If a zero or subzero data value is added to a logarithmic axis</li><li>If the minimum of a logarithimic axis is set to 0 or less</li><li>If the threshold is set to 0 or less</li></ul><p>Note: As of Highcharts 5.0.8 it's possible to bypass this error message by setting <code>Axis.prototype.allowNegativeLog</code> to true, and add custom conversion functions. <a href=\"https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/yaxis/type-log-negative/\">View live demo</a>. It is also possible to use a similar workaround for colorAxis. <a href=\"https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/coloraxis/logarithmic-with-emulate-negative-values/\">View live demo</a>.</p>",
+        "enduser": "<h1>Can't plot zero or subzero values on a logarithmic axis</h1><p>This error occurs in the following situations:</p><ul><li>If a zero or subzero data value is added to a logarithmic axis</li><li>If the minimum of a logarithimic axis is set to 0 or less</li><li>If the threshold is set to 0 or less</li></ul><p>As of Highcharts 5.0.8 it's possible to bypass this error message by setting <code>Axis.prototype.allowNegativeLog</code> to <code>true</code> and add custom conversion functions. <a href=\"http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/yaxis/type-log-negative/\">\">View Live Demo</a>. It is also possible to use a similar workaround for colorAxis. <a href=\"https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/coloraxis/logarithmic-with-emulate-negative-values/\">View live demo</a>.</p>"
     },
     "11": {
         "title": "Can't link axes of different type",

package/es-modules/Extensions/DraggablePoints.js

@@ -19,7 +19,7 @@ import Series from '../Core/Series/Series.js';
 import SeriesRegistry from '../Core/Series/SeriesRegistry.js';
 var seriesTypes = SeriesRegistry.seriesTypes;
 import U from '../Core/Utilities.js';
-var addEvent = U.addEvent, clamp = U.clamp, merge = U.merge, objectEach = U.objectEach, pick = U.pick;
+var addEvent = U.addEvent, clamp = U.clamp, isNumber = U.isNumber, merge = U.merge, objectEach = U.objectEach, pick = U.pick;
 /**
  * Flip a side property, used with resizeRect. If input side is "left", return
  * "right" etc.
@@ -1631,11 +1631,19 @@ Series.prototype.getGuideBox = function (points) {
     // Find bounding box of all points
     points.forEach(function (point) {
         var bBox = point.graphic && point.graphic.getBBox() || point.shapeArgs;
-        if (bBox && (bBox.width || bBox.height || bBox.x || bBox.y)) {
+        if (bBox) {
+            var plotX2 = void 0;
+            var x2 = point.x2;
+            if (isNumber(x2)) {
+                plotX2 = point.series.xAxis.translate(x2, false, false, false, true);
+            }
+            // Avoid a 0 min when some of the points being dragged are
+            // completely outside the plot
+            var skipBBox = !(bBox.width || bBox.height || bBox.x || bBox.y);
             changed = true;
-            minX = Math.min(point.plotX || 0, bBox.x || 0, minX);
-            maxX = Math.max((bBox.x || 0) + (bBox.width || 0), maxX);
-            minY = Math.min(point.plotY || 0, bBox.y || 0, minY);
+            minX = Math.min(point.plotX || 0, plotX2 || 0, skipBBox ? Infinity : bBox.x || 0, minX);
+            maxX = Math.max(point.plotX || 0, plotX2 || 0, (bBox.x || 0) + (bBox.width || 0), maxX);
+            minY = Math.min(point.plotY || 0, skipBBox ? Infinity : bBox.y || 0, minY);
             maxY = Math.max((bBox.y || 0) + (bBox.height || 0), maxY);
         }
     });

package/es-modules/Extensions/Drilldown.js

@@ -521,7 +521,7 @@ Chart.prototype.addSingleSeriesAsDrilldown = function (point, ddOptions) {
         // no graphic in line series with markers disabled
         bBox: point.graphic ? point.graphic.getBBox() : {},
         color: point.isNull ?
-            new Color(colorProp.color).setOpacity(0).get() :
+            Color.parse(colorProp.color).setOpacity(0).get() :
             colorProp.color,
         lowerSeriesOptions: ddOptions,
         pointOptions: oldSeries.options.data[pointIndex],
@@ -586,7 +586,7 @@ Chart.prototype.getDrilldownBackText = function () {
     if (drilldownLevels && drilldownLevels.length > 0) { // #3352, async loading
         lastLevel = drilldownLevels[drilldownLevels.length - 1];
         lastLevel.series = lastLevel.seriesOptions;
-        return format(this.options.lang.drillUpText, lastLevel);
+        return format(this.options.lang.drillUpText || '', lastLevel);
     }
 };
 Chart.prototype.showDrillUpButton = function () {
@@ -623,6 +623,9 @@ Chart.prototype.showDrillUpButton = function () {
  * @requires  modules/drilldown
  *
  * @function Highcharts.Chart#drillUp
+ *
+ * @sample {highcharts} highcharts/drilldown/programmatic
+ *         Programmatic drilldown
  */
 Chart.prototype.drillUp = function () {
     if (!this.drilldownLevels || this.drilldownLevels.length === 0) {
@@ -935,8 +938,26 @@ if (PieSeries) {
         }
     });
 }
-Point.prototype.doDrilldown = function (_holdRedraw, category, originalEvent) {
-    var series = this.series, chart = series.chart, drilldown = chart.options.drilldown, i = (drilldown.series || []).length, seriesOptions;
+/**
+ * Perform drilldown on a point instance. The [drilldown](https://api.highcharts.com/highcharts/series.line.data.drilldown)
+ * property must be set on the point options.
+ *
+ * To drill down multiple points in the same category, use
+ * `Axis.drilldownCategory` instead.
+ *
+ * @requires  modules/drilldown
+ *
+ * @function Highcharts.Point#doDrilldown
+ *
+ * @sample {highcharts} highcharts/drilldown/programmatic
+ *         Programmatic drilldown
+ */
+Point.prototype.doDrilldown = function () {
+    this.runDrilldown();
+};
+Point.prototype.runDrilldown = function (holdRedraw, category, originalEvent) {
+    var series = this.series, chart = series.chart, drilldown = chart.options.drilldown;
+    var i = (drilldown.series || []).length, seriesOptions;
     if (!chart.ddDupes) {
         chart.ddDupes = [];
     }
@@ -959,7 +980,7 @@ Point.prototype.doDrilldown = function (_holdRedraw, category, originalEvent) {
     }, function (e) {
         var chart = e.point.series && e.point.series.chart, seriesOptions = e.seriesOptions;
         if (chart && seriesOptions) {
-            if (_holdRedraw) {
+            if (holdRedraw) {
                 chart.addSingleSeriesAsDrilldown(e.point, seriesOptions);
             }
             else {
@@ -970,22 +991,28 @@ Point.prototype.doDrilldown = function (_holdRedraw, category, originalEvent) {
 };
 /**
  * Drill down to a given category. This is the same as clicking on an axis
- * label.
+ * label. If multiple series with drilldown are present, all will drill down to
+ * the given category.
+ *
+ * See also `Point.doDrilldown` for drilling down on a single point instance.
  *
- * @private
  * @function Highcharts.Axis#drilldownCategory
+ *
+ * @sample {highcharts} highcharts/drilldown/programmatic
+ *         Programmatic drilldown
+ *
  * @param {number} x
- *        Tick position
- * @param {global.MouseEvent} e
- *        Click event
+ *        The index of the category
+ * @param {global.MouseEvent} [originalEvent]
+ *        The original event, used internally.
  */
-Axis.prototype.drilldownCategory = function (x, e) {
+Axis.prototype.drilldownCategory = function (x, originalEvent) {
     this.getDDPoints(x).forEach(function (point) {
         if (point &&
             point.series &&
             point.series.visible &&
-            point.doDrilldown) { // #3197
-            point.doDrilldown(true, x, e);
+            point.runDrilldown) { // #3197
+            point.runDrilldown(true, x, originalEvent);
         }
     });
     this.chart.applyDrilldown();
@@ -1071,7 +1098,7 @@ var handlePointClick = function (e) {
         series.xAxis.drilldownCategory(point.x, e);
     }
     else {
-        point.doDrilldown(void 0, void 0, e);
+        point.runDrilldown(void 0, void 0, e);
     }
 };
 addEvent(Series, 'afterDrawDataLabels', function () {

package/es-modules/Extensions/ExportData.js

@@ -835,7 +835,7 @@ function getBlobFromContent(content, type) {
         nav.userAgent.indexOf('Chrome') < 0), domurl = win.URL || win.webkitURL || win;
     try {
         // MS specific
-        if (nav.msSaveOrOpenBlob && win.MSBlobBuilder) {
+        if ((nav.msSaveOrOpenBlob) && win.MSBlobBuilder) {
             var blob = new win.MSBlobBuilder();
             blob.append(content);
             return blob.getBlob('image/svg+xml');
@@ -851,6 +851,7 @@ function getBlobFromContent(content, type) {
         // Ignore
     }
 }
+/* eslint-disable valid-jsdoc */
 /**
  * Generates a data URL of CSV for local download in the browser. This is the
  * default action for a click on the 'Download CSV' button.
@@ -949,9 +950,11 @@ Chart.prototype.toggleDataTable = function (show) {
         lang.viewData &&
         lang.hideData &&
         menuItems &&
-        exportDivElements &&
-        exportDivElements.length) {
-        AST.setElementHTML(exportDivElements[menuItems.indexOf('viewData')], this.isDataTableVisible ? lang.hideData : lang.viewData);
+        exportDivElements) {
+        var exportDivElement = exportDivElements[menuItems.indexOf('viewData')];
+        if (exportDivElement) {
+            AST.setElementHTML(exportDivElement, this.isDataTableVisible ? lang.hideData : lang.viewData);
+        }
     }
 };
 // Add "Download CSV" to the exporting menu.