highcharts 10.2.1 → 10.3.1

package/es-modules/Extensions/DataGrouping.js

@@ -1,1177 +0,0 @@
-/* *
- *
- *  (c) 2010-2021 Torstein Honsi
- *
- *  License: www.highcharts.com/license
- *
- *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
- *
- * */
-'use strict';
-import Axis from '../Core/Axis/Axis.js';
-import DateTimeAxis from '../Core/Axis/DateTimeAxis.js';
-import F from '../Core/FormatUtilities.js';
-var format = F.format;
-import H from '../Core/Globals.js';
-import Point from '../Core/Series/Point.js';
-import Series from '../Core/Series/Series.js';
-var seriesProto = Series.prototype;
-import Tooltip from '../Core/Tooltip.js';
-import D from '../Core/DefaultOptions.js';
-import U from '../Core/Utilities.js';
-var addEvent = U.addEvent, arrayMax = U.arrayMax, arrayMin = U.arrayMin, correctFloat = U.correctFloat, defined = U.defined, error = U.error, extend = U.extend, isNumber = U.isNumber, merge = U.merge, pick = U.pick;
-import '../Core/Axis/Axis.js';
-/* ************************************************************************** *
- *  Start data grouping module                                                *
- * ************************************************************************** */
-/* eslint-disable no-invalid-this, valid-jsdoc */
-/**
- * Define the available approximation types. The data grouping
- * approximations takes an array or numbers as the first parameter. In case
- * of ohlc, four arrays are sent in as four parameters. Each array consists
- * only of numbers. In case null values belong to the group, the property
- * .hasNulls will be set to true on the array.
- *
- * @product highstock
- *
- * @private
- * @name Highcharts.approximations
- * @type {Highcharts.Dictionary<Function>}
- */
-var approximations = H.approximations = {
-    sum: function (arr) {
-        var len = arr.length, ret;
-        // 1. it consists of nulls exclusive
-        if (!len && arr.hasNulls) {
-            ret = null;
-            // 2. it has a length and real values
-        }
-        else if (len) {
-            ret = 0;
-            while (len--) {
-                ret += arr[len];
-            }
-        }
-        // 3. it has zero length, so just return undefined
-        // => doNothing()
-        return ret;
-    },
-    average: function (arr) {
-        var len = arr.length, ret = approximations.sum(arr);
-        // If we have a number, return it divided by the length. If not,
-        // return null or undefined based on what the sum method finds.
-        if (isNumber(ret) && len) {
-            ret = correctFloat(ret / len);
-        }
-        return ret;
-    },
-    // The same as average, but for series with multiple values, like area
-    // ranges.
-    averages: function () {
-        var ret = [];
-        [].forEach.call(arguments, function (arr) {
-            ret.push(approximations.average(arr));
-        });
-        // Return undefined when first elem. is undefined and let
-        // sum method handle null (#7377)
-        return typeof ret[0] === 'undefined' ? void 0 : ret;
-    },
-    open: function (arr) {
-        return arr.length ? arr[0] : (arr.hasNulls ? null : void 0);
-    },
-    high: function (arr) {
-        return arr.length ?
-            arrayMax(arr) :
-            (arr.hasNulls ? null : void 0);
-    },
-    low: function (arr) {
-        return arr.length ?
-            arrayMin(arr) :
-            (arr.hasNulls ? null : void 0);
-    },
-    close: function (arr) {
-        return arr.length ?
-            arr[arr.length - 1] :
-            (arr.hasNulls ? null : void 0);
-    },
-    // HLC, OHLC and range are special cases where a multidimensional array is
-    // input and an array is output.
-    hlc: function (high, low, close) {
-        high = approximations.high(high);
-        low = approximations.low(low);
-        close = approximations.close(close);
-        if (isNumber(high) ||
-            isNumber(low) ||
-            isNumber(close)) {
-            return [high, low, close];
-        }
-    },
-    ohlc: function (open, high, low, close) {
-        open = approximations.open(open);
-        high = approximations.high(high);
-        low = approximations.low(low);
-        close = approximations.close(close);
-        if (isNumber(open) ||
-            isNumber(high) ||
-            isNumber(low) ||
-            isNumber(close)) {
-            return [open, high, low, close];
-        }
-    },
-    range: function (low, high) {
-        low = approximations.low(low);
-        high = approximations.high(high);
-        if (isNumber(low) || isNumber(high)) {
-            return [low, high];
-        }
-        if (low === null && high === null) {
-            return null;
-        }
-        // else, return is undefined
-    }
-};
-var applyGrouping = function (hasExtemesChanged) {
-    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 skipDataGrouping method returns false or if grouping is disabled
-    // (in that order).
-    skip = skipDataGrouping(series, hasExtemesChanged) === 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;
-        // 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, force) {
-    return !(series.isCartesian &&
-        !series.isDirty &&
-        !series.xAxis.isDirty &&
-        !series.yAxis.isDirty &&
-        !force);
-};
-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;
-    /**
-     * @private
-     */
-    function getApproximation(approx) {
-        if (typeof approx === 'function') {
-            return approx;
-        }
-        if (approximations[approx]) {
-            return approximations[approx];
-        }
-        return approximations[(series.getDGApproximation && series.getDGApproximation()) ||
-            'average'];
-    }
-    approximationFn = getApproximation(approximation);
-    // Calculate values array size from pointArrayMap length
-    if (pointArrayMapLength) {
-        pointArrayMap.forEach(function () {
-            values.push([]);
-        });
-    }
-    else {
-        values.push([]);
-    }
-    valuesLen = pointArrayMapLength || 1;
-    // Start with the first point within the X axis range (#2696)
-    for (i = 0; i <= dataLength; i++) {
-        if (xData[i] >= groupPositions[0]) {
-            break;
-        }
-    }
-    for (i; i <= dataLength; i++) {
-        // when a new group is entered, summarize and initialize
-        // the previous group
-        while ((typeof groupPositions[pos + 1] !== 'undefined' &&
-            xData[i] >= groupPositions[pos + 1]) ||
-            i === dataLength) { // get the last group
-            // get group x and y
-            pointX = groupPositions[pos];
-            series.dataGroupInfo = {
-                start: groupAll ? start : (series.cropStart + start),
-                length: values[0].length
-            };
-            groupedY = approximationFn.apply(series, values);
-            // By default, let options of the first grouped point be passed over
-            // to the grouped point. This allows preserving properties like
-            // `name` and `color` or custom properties. Implementers can
-            // override this from the approximation function, where they can
-            // write custom options to `this.dataGroupInfo.options`.
-            if (series.pointClass && !defined(series.dataGroupInfo.options)) {
-                // Convert numbers and arrays into objects
-                series.dataGroupInfo.options = merge(series.pointClass.prototype
-                    .optionsToObject.call({ series: series }, series.options.data[series.cropStart + start]));
-                // Make sure the raw data (x, y, open, high etc) is not copied
-                // over and overwriting approximated data.
-                extendedPointArrayMap.forEach(function (key) {
-                    delete series.dataGroupInfo.options[key];
-                });
-            }
-            // push the grouped data
-            if (typeof groupedY !== 'undefined') {
-                groupedXData.push(pointX);
-                groupedYData.push(groupedY);
-                groupMap.push(series.dataGroupInfo);
-            }
-            // reset the aggregate arrays
-            start = i;
-            for (j = 0; j < valuesLen; j++) {
-                values[j].length = 0; // faster than values[j] = []
-                values[j].hasNulls = false;
-            }
-            // Advance on the group positions
-            pos += 1;
-            // don't loop beyond the last group
-            if (i === dataLength) {
-                break;
-            }
-        }
-        // break out
-        if (i === dataLength) {
-            break;
-        }
-        // for each raw data point, push it to an array that contains all values
-        // for this specific group
-        if (pointArrayMap) {
-            var index = (series.options.dataGrouping &&
-                series.options.dataGrouping.groupAll ?
-                i : series.cropStart + i), point = (data && data[index]) ||
-                series.pointClass.prototype.applyOptions.apply({
-                    series: series
-                }, [dataOptions[index]]), val = void 0;
-            for (j = 0; j < pointArrayMapLength; j++) {
-                val = point[pointArrayMap[j]];
-                if (isNumber(val)) {
-                    values[j].push(val);
-                }
-                else if (val === null) {
-                    values[j].hasNulls = true;
-                }
-            }
-        }
-        else {
-            pointY = handleYData ? yData[i] : null;
-            if (isNumber(pointY)) {
-                values[0].push(pointY);
-            }
-            else if (pointY === null) {
-                values[0].hasNulls = true;
-            }
-        }
-    }
-    return {
-        groupedXData: groupedXData,
-        groupedYData: groupedYData,
-        groupMap: groupMap
-    };
-};
-var anchorPoints = function (series, groupedXData, xMax) {
-    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]);
-            i = groupedXData.length - 1;
-            while (i-- && i > 0) {
-                groupedXData[i] += shiftInterval;
-            }
-        }
-        // Change the first point position, but only when it is
-        // the first point in the data set not in the current zoom.
-        if (firstAnchor &&
-            firstAnchor !== 'start' &&
-            series.xData[0] >= groupedXData[0]) {
-            var groupStart = series.groupMap[0].start, groupLength = series.groupMap[0].length;
-            var firstGroupstEnd = void 0;
-            if (isNumber(groupStart) && isNumber(groupLength)) {
-                firstGroupstEnd = groupStart + (groupLength - 1);
-            }
-            groupedXData[0] = {
-                middle: groupedXData[0] + 0.5 * totalRange,
-                end: groupedXData[0] + totalRange,
-                firstPoint: series.xData[0],
-                lastPoint: firstGroupstEnd && series.xData[firstGroupstEnd]
-            }[firstAnchor];
-        }
-        // Change the last point position but only when it is
-        // the last point in the data set not in the current zoom.
-        if (lastAnchor &&
-            lastAnchor !== 'start' &&
-            totalRange &&
-            groupedXData[groupedDataLength] >= xMax - totalRange) {
-            var lastGroupStart = series.groupMap[series.groupMap.length - 1].start;
-            groupedXData[groupedDataLength] = {
-                middle: groupedXData[groupedDataLength] + 0.5 * totalRange,
-                end: groupedXData[groupedDataLength] + totalRange,
-                firstPoint: lastGroupStart && series.xData[lastGroupStart],
-                lastPoint: series.xData[series.xData.length - 1]
-            }[lastAnchor];
-        }
-    }
-};
-var adjustExtremes = function (xAxis, groupedXData) {
-    // Make sure the X axis extends to show the first group (#2533)
-    // But only for visible series (#5493, #6393)
-    if (defined(groupedXData[0]) &&
-        isNumber(xAxis.min) &&
-        isNumber(xAxis.dataMin) &&
-        groupedXData[0] < xAxis.min) {
-        if ((!defined(xAxis.options.min) &&
-            xAxis.min <= xAxis.dataMin) ||
-            xAxis.min === xAxis.dataMin) {
-            xAxis.min = Math.min(groupedXData[0], xAxis.min);
-        }
-        xAxis.dataMin = Math.min(groupedXData[0], xAxis.dataMin);
-    }
-    // When the last anchor set, change the extremes that
-    // the last point is visible (#12455).
-    if (defined(groupedXData[groupedXData.length - 1]) &&
-        isNumber(xAxis.max) &&
-        isNumber(xAxis.dataMax) &&
-        groupedXData[groupedXData.length - 1] > xAxis.max) {
-        if ((!defined(xAxis.options.max) &&
-            isNumber(xAxis.dataMax) &&
-            xAxis.max >= xAxis.dataMax) || xAxis.max === xAxis.dataMax) {
-            xAxis.max = Math.max(groupedXData[groupedXData.length - 1], xAxis.max);
-        }
-        xAxis.dataMax = Math.max(groupedXData[groupedXData.length - 1], xAxis.dataMax);
-    }
-};
-var dataGrouping = {
-    approximations: approximations,
-    groupData: groupData
-};
-// -----------------------------------------------------------------------------
-// The following code applies to implementation of data grouping on a Series
-var baseProcessData = seriesProto.processData, baseGeneratePoints = seriesProto.generatePoints, 
-/** @ignore */
-commonOptions = {
-    // enabled: null, // (true for stock charts, false for basic),
-    // forced: undefined,
-    groupPixelWidth: 2,
-    // the first one is the point or start value, the second is the start
-    // value if we're dealing with range, the third one is the end value if
-    // dealing with a range
-    dateTimeLabelFormats: {
-        millisecond: [
-            '%A, %b %e, %H:%M:%S.%L',
-            '%A, %b %e, %H:%M:%S.%L',
-            '-%H:%M:%S.%L'
-        ],
-        second: [
-            '%A, %b %e, %H:%M:%S',
-            '%A, %b %e, %H:%M:%S',
-            '-%H:%M:%S'
-        ],
-        minute: [
-            '%A, %b %e, %H:%M',
-            '%A, %b %e, %H:%M',
-            '-%H:%M'
-        ],
-        hour: [
-            '%A, %b %e, %H:%M',
-            '%A, %b %e, %H:%M',
-            '-%H:%M'
-        ],
-        day: [
-            '%A, %b %e, %Y',
-            '%A, %b %e',
-            '-%A, %b %e, %Y'
-        ],
-        week: [
-            'Week from %A, %b %e, %Y',
-            '%A, %b %e',
-            '-%A, %b %e, %Y'
-        ],
-        month: [
-            '%B %Y',
-            '%B',
-            '-%B %Y'
-        ],
-        year: [
-            '%Y',
-            '%Y',
-            '-%Y'
-        ]
-    }
-    // smoothed = false, // enable this for navigator series only
-}, specificOptions = {
-    line: {},
-    spline: {},
-    area: {},
-    areaspline: {},
-    arearange: {},
-    column: {
-        groupPixelWidth: 10
-    },
-    columnrange: {
-        groupPixelWidth: 10
-    },
-    candlestick: {
-        groupPixelWidth: 10
-    },
-    ohlc: {
-        groupPixelWidth: 5
-    },
-    hlc: {
-        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
-// case of a user option
-defaultDataGroupingUnits = H.defaultDataGroupingUnits = [
-    [
-        'millisecond',
-        [1, 2, 5, 10, 20, 25, 50, 100, 200, 500] // allowed multiples
-    ], [
-        'second',
-        [1, 2, 5, 10, 15, 30]
-    ], [
-        'minute',
-        [1, 2, 5, 10, 15, 30]
-    ], [
-        'hour',
-        [1, 2, 3, 4, 6, 8, 12]
-    ], [
-        'day',
-        [1]
-    ], [
-        'week',
-        [1]
-    ], [
-        'month',
-        [1, 3, 6]
-    ], [
-        'year',
-        null
-    ]
-];
-// Set default approximations to the prototypes if present. Properties are
-// inherited down. Can be overridden for individual series types.
-seriesProto.getDGApproximation = function () {
-    if (this.is('arearange')) {
-        return 'range';
-    }
-    if (this.is('ohlc')) {
-        return 'ohlc';
-    }
-    if (this.is('hlc')) {
-        return 'hlc';
-    }
-    if (this.is('column')) {
-        return 'sum';
-    }
-    return 'average';
-};
-/**
- * Takes parallel arrays of x and y data and groups the data into intervals
- * defined by groupPositions, a collection of starting x values for each group.
- *
- * @private
- * @function Highcharts.Series#groupData
- *
- * @param {Array<number>} xData
- *
- * @param {Array<number>|Array<Array<number>>} yData
- *
- * @param {boolean} groupPositions
- *
- * @param {string|Function} approximation
- *
- * @return {void}
- */
-seriesProto.groupData = groupData;
-/**
- * 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
-    if (this.groupedData) {
-        this.groupedData.forEach(function (point, i) {
-            if (point) {
-                this.groupedData[i] = point.destroy ?
-                    point.destroy() : null;
-            }
-        }, this);
-        // Clears all:
-        // - `this.groupedData`
-        // - `this.points`
-        // - `preserve` object in series.update()
-        this.groupedData.length = 0;
-    }
-};
-// Override the generatePoints method by adding a reference to grouped data
-seriesProto.generatePoints = function () {
-    baseGeneratePoints.apply(this);
-    // Record grouped data in order to let it be destroyed the next time
-    // processData runs
-    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 (e) {
-    var axis = this, series = axis.series;
-    // Reset the groupPixelWidth for all series, #17141.
-    series.forEach(function (series) {
-        series.groupPixelWidth = void 0; // #2110
-    });
-    series.forEach(function (series) {
-        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(!!e.hasExtemesChanged);
-    });
-};
-// 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) {
-            // 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) {
-        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 () {
-    if (this.dataGroup) {
-        error(24, false, this.series.chart);
-        return false;
-    }
-});
-// 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 ? 'footerFormat' : 'headerFormat'];
-    // apply only to grouped series
-    if (xAxis &&
-        xAxis.options.type === 'datetime' &&
-        dataGroupingOptions &&
-        isNumber(labelConfig.key)) {
-        // set variables
-        currentDataGrouping = series.currentDataGrouping;
-        dateTimeLabelFormats = dataGroupingOptions.dateTimeLabelFormats ||
-            // Fallback to commonOptions (#9693)
-            commonOptions.dateTimeLabelFormats;
-        // if we have grouped data, use the grouping information to get the
-        // right format
-        if (currentDataGrouping) {
-            labelFormats =
-                dateTimeLabelFormats[currentDataGrouping.unitName];
-            if (currentDataGrouping.count === 1) {
-                xDateFormat = labelFormats[0];
-            }
-            else {
-                xDateFormat = labelFormats[1];
-                xDateFormatEnd = labelFormats[2];
-            }
-            // if not grouped, and we don't have set the xDateFormat option, get the
-            // 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 && xAxis.dateTime) {
-            xDateFormat = xAxis.dateTime.getXDateFormat(labelConfig.x, tooltipOptions.dateTimeLabelFormats);
-        }
-        // now format the key
-        formattedKey = time.dateFormat(xDateFormat, labelConfig.key);
-        if (xDateFormatEnd) {
-            formattedKey += time.dateFormat(xDateFormatEnd, labelConfig.key + currentDataGrouping.totalRange - 1);
-        }
-        // Replace default header style with class name
-        if (series.chart.styledMode) {
-            formatString = this.styledModeFormat(formatString);
-        }
-        // return the replaced format
-        e.text = format(formatString, {
-            point: extend(labelConfig.point, { key: formattedKey }),
-            series: series
-        }, chart);
-        e.preventDefault();
-    }
-});
-// Destroy grouped data on series destroy
-addEvent(Series, 'destroy', seriesProto.destroyGroupedData);
-// Handle default options for data grouping. This must be set at runtime because
-// 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 (plotOptions && (specificOptions[type] || baseOptions)) { // #1284
-        if (!defaultOptions) {
-            defaultOptions = merge(commonOptions, specificOptions[type]);
-        }
-        var rangeSelector = this.chart.rangeSelector;
-        options.dataGrouping = merge(baseOptions, defaultOptions, plotOptions.series && plotOptions.series.dataGrouping, // #1228
-        // Set by the StockChart constructor:
-        plotOptions[type].dataGrouping, this.userOptions.dataGrouping, !options.isInternal &&
-            rangeSelector &&
-            isNumber(rangeSelector.selected) &&
-            rangeSelector.buttonOptions[rangeSelector.selected].dataGrouping);
-    }
-});
-// When resetting the scale reset the hasProccessed flag to avoid taking
-// previous data grouping of neighbour series into accound when determining
-// group pixel width (#2692).
-addEvent(Axis, 'afterSetScale', function () {
-    this.series.forEach(function (series) {
-        series.hasProcessed = false;
-    });
-});
-/* *
- *
- *  Default Export
- *
- * */
-// @todo move to master
-H.dataGrouping = dataGrouping;
-export default dataGrouping;
-/* *
- *
- *  API Declarations
- *
- * */
-/**
- * @typedef {"average"|"averages"|"open"|"high"|"low"|"close"|"sum"} Highcharts.DataGroupingApproximationValue
- */
-/**
- * The position of the point inside the group.
- *
- * @typedef    {"start"|"middle"|"end"} Highcharts.DataGroupingAnchor
- */
-/**
- * The position of the first or last point in the series inside the group.
- *
- * @typedef    {"start"|"middle"|"end"|"firstPoint"|"lastPoint"} Highcharts.DataGroupingAnchorExtremes
- */
-/**
- * Highcharts Stock only.
- *
- * @product highstock
- * @interface Highcharts.DataGroupingInfoObject
- */ /**
-* @name Highcharts.DataGroupingInfoObject#length
-* @type {number}
-*/ /**
-* @name Highcharts.DataGroupingInfoObject#options
-* @type {Highcharts.SeriesOptionsType|undefined}
-*/ /**
-* @name Highcharts.DataGroupingInfoObject#start
-* @type {number}
-*/
-/**
- * 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.
- *
- * @sample stock/members/point-datagroup
- *         Click to inspect raw data points
- *
- * @product highstock
- *
- * @name Highcharts.Point#dataGroup
- * @type {Highcharts.DataGroupingInfoObject|undefined}
- */
-(''); // detach doclets above
-/* *
- *
- *  API Options
- *
- * */
-/**
- * Data grouping is the concept of sampling the data values into larger
- * blocks in order to ease readability and increase performance of the
- * JavaScript charts. Highcharts Stock by default applies data grouping when
- * the points become closer than a certain pixel value, determined by
- * the `groupPixelWidth` option.
- *
- * If data grouping is applied, the grouping information of grouped
- * points can be read from the [Point.dataGroup](
- * /class-reference/Highcharts.Point#dataGroup). If point options other than
- * the data itself are set, for example `name` or `color` or custom properties,
- * the grouping logic doesn't know how to group it. In this case the options of
- * the first point instance are copied over to the group point. This can be
- * altered through a custom `approximation` callback function.
- *
- * @declare   Highcharts.DataGroupingOptionsObject
- * @product   highstock
- * @requires  product:highstock
- * @requires  module:modules/datagrouping
- * @apioption plotOptions.series.dataGrouping
- */
-/**
- * Specifies how the points should be located on the X axis inside the group.
- * Points that are extremes can be set separately. Available options:
- *
- * - `start` places the point at the beginning of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 00:00:00)
- *
- * - `middle` places the point in the middle of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 12:00:00)
- *
- * - `end` places the point at the end of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 23:59:59)
- *
- * @sample {highstock} stock/plotoptions/series-datagrouping-anchor
- *         Changing the point x-coordinate inside the group.
- *
- * @see [dataGrouping.firstAnchor](#plotOptions.series.dataGrouping.firstAnchor)
- * @see [dataGrouping.lastAnchor](#plotOptions.series.dataGrouping.lastAnchor)
- *
- * @type       {Highcharts.DataGroupingAnchor}
- * @since 9.1.0
- * @default    start
- * @apioption  plotOptions.series.dataGrouping.anchor
- */
-/**
- * The method of approximation inside a group. When for example 30 days
- * are grouped into one month, this determines what value should represent
- * the group. Possible values are "average", "averages", "open", "high",
- * "low", "close" and "sum". For OHLC and candlestick series the approximation
- * is "ohlc" by default, which finds the open, high, low and close values
- * within all the grouped data. For ranges, the approximation is "range",
- * which finds the low and high values. For multi-dimensional data,
- * like ranges and OHLC, "averages" will compute the average for each
- * dimension.
- *
- * Custom aggregate methods can be added by assigning a callback function
- * as the approximation. This function takes a numeric array as the
- * argument and should return a single numeric value or `null`. Note
- * that the numeric array will never contain null values, only true
- * numbers. Instead, if null values are present in the raw data, the
- * numeric array will have an `.hasNulls` property set to `true`. For
- * single-value data sets the data is available in the first argument
- * of the callback function. For OHLC data sets, all the open values
- * are in the first argument, all high values in the second etc.
- *
- * Since v4.2.7, grouping meta data is available in the approximation
- * callback from `this.dataGroupInfo`. It can be used to extract information
- * from the raw data.
- *
- * Defaults to `average` for line-type series, `sum` for columns, `range`
- * for range series, `hlc` for HLC, and `ohlc` for OHLC and candlestick.
- *
- * @sample {highstock} stock/plotoptions/series-datagrouping-approximation
- *         Approximation callback with custom data
- * @sample {highstock} stock/plotoptions/series-datagrouping-simple-approximation
- *         Simple approximation demo
- *
- * @type       {Highcharts.DataGroupingApproximationValue|Function}
- * @apioption  plotOptions.series.dataGrouping.approximation
- */
-/**
- * Datetime formats for the header of the tooltip in a stock chart.
- * The format can vary within a chart depending on the currently selected
- * time range and the current data grouping.
- *
- * The default formats are:
- * ```js
- * {
- *     millisecond: [
- *         '%A, %b %e, %H:%M:%S.%L', '%A, %b %e, %H:%M:%S.%L', '-%H:%M:%S.%L'
- *     ],
- *     second: ['%A, %b %e, %H:%M:%S', '%A, %b %e, %H:%M:%S', '-%H:%M:%S'],
- *     minute: ['%A, %b %e, %H:%M', '%A, %b %e, %H:%M', '-%H:%M'],
- *     hour: ['%A, %b %e, %H:%M', '%A, %b %e, %H:%M', '-%H:%M'],
- *     day: ['%A, %b %e, %Y', '%A, %b %e', '-%A, %b %e, %Y'],
- *     week: ['Week from %A, %b %e, %Y', '%A, %b %e', '-%A, %b %e, %Y'],
- *     month: ['%B %Y', '%B', '-%B %Y'],
- *     year: ['%Y', '%Y', '-%Y']
- * }
- * ```
- *
- * For each of these array definitions, the first item is the format
- * used when the active time span is one unit. For instance, if the
- * current data applies to one week, the first item of the week array
- * is used. The second and third items are used when the active time
- * span is more than two units. For instance, if the current data applies
- * 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}
- * @apioption plotOptions.series.dataGrouping.dateTimeLabelFormats
- */
-/**
- * Enable or disable data grouping.
- *
- * @type      {boolean}
- * @default   true
- * @apioption plotOptions.series.dataGrouping.enabled
- */
-/**
- * Specifies how the first grouped point is positioned on the xAxis.
- * If firstAnchor and/or lastAnchor are defined, then those options take
- * precedence over anchor for the first and/or last grouped points.
- * Available options:
- *
- * -`start` places the point at the beginning of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 00:00:00)
- *
- * -`middle` places the point in the middle of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 12:00:00)
- *
- * -`end` places the point at the end of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 23:59:59)
- *
- * -`firstPoint` the first point in the group
- * (e.g. points at 00:13, 00:35, 00:59 -> 00:13)
- *
- * -`lastPoint` the last point in the group
- * (e.g. points at 00:13, 00:35, 00:59 -> 00:59)
- *
- * @sample {highstock} stock/plotoptions/series-datagrouping-first-anchor
- *         Applying first and last anchor.
- *
- * @see [dataGrouping.anchor](#plotOptions.series.dataGrouping.anchor)
- *
- * @type       {Highcharts.DataGroupingAnchorExtremes}
- * @since 9.1.0
- * @default    start
- * @apioption  plotOptions.series.dataGrouping.firstAnchor
- */
-/**
- * When data grouping is forced, it runs no matter how small the intervals
- * are. This can be handy for example when the sum should be calculated
- * for values appearing at random times within each hour.
- *
- * @type      {boolean}
- * @default   false
- * @apioption plotOptions.series.dataGrouping.forced
- */
-/**
- * The approximate pixel width of each group. If for example a series
- * with 30 points is displayed over a 600 pixel wide plot area, no grouping
- * is performed. If however the series contains so many points that
- * the spacing is less than the groupPixelWidth, Highcharts will try
- * to group it into appropriate groups so that each is more or less
- * two pixels wide. If multiple series with different group pixel widths
- * are drawn on the same x axis, all series will take the greatest width.
- * For example, line series have 2px default group width, while column
- * series have 10px. If combined, both the line and the column will
- * have 10px by default.
- *
- * @type      {number}
- * @default   2
- * @apioption plotOptions.series.dataGrouping.groupPixelWidth
- */
-/**
- * By default only points within the visible range are grouped. Enabling this
- * option will force data grouping to calculate all grouped points for a given
- * dataset. That option prevents for example a column series from calculating
- * a grouped point partially. The effect is similar to
- * [Series.getExtremesFromAll](#plotOptions.series.getExtremesFromAll) but does
- * not affect yAxis extremes.
- *
- * @sample {highstock} stock/plotoptions/series-datagrouping-groupall/
- *         Two series with the same data but different groupAll setting
- *
- * @type      {boolean}
- * @default   false
- * @since     6.1.0
- * @apioption plotOptions.series.dataGrouping.groupAll
- */
-/**
- * Specifies how the last grouped point is positioned on the xAxis.
- * If firstAnchor and/or lastAnchor are defined, then those options take
- * precedence over anchor for the first and/or last grouped points.
- * Available options:
- *
- * -`start` places the point at the beginning of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 00:00:00)
- *
- * -`middle` places the point in the middle of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 12:00:00)
- *
- * -`end` places the point at the end of the group
- * (e.g. range 00:00:00 - 23:59:59 -> 23:59:59)
- *
- * -`firstPoint` the first point in the group
- * (e.g. points at 00:13, 00:35, 00:59 -> 00:13)
- *
- * -`lastPoint` the last point in the group
- * (e.g. points at 00:13, 00:35, 00:59 -> 00:59)
- *
- * @sample {highstock} stock/plotoptions/series-datagrouping-first-anchor
- *         Applying first and last anchor.
- *
- * @sample {highstock} stock/plotoptions/series-datagrouping-last-anchor
- *         Applying the last anchor in the chart with live data.
- *
- * @see [dataGrouping.anchor](#plotOptions.series.dataGrouping.anchor)
- *
- * @type       {Highcharts.DataGroupingAnchorExtremes}
- * @since 9.1.0
- * @default    start
- * @apioption  plotOptions.series.dataGrouping.lastAnchor
- */
-/**
- * Normally, a group is indexed by the start of that group, so for example
- * when 30 daily values are grouped into one month, that month's x value
- * will be the 1st of the month. This apparently shifts the data to
- * the left. When the smoothed option is true, this is compensated for.
- * The data is shifted to the middle of the group, and min and max
- * values are preserved. Internally, this is used in the Navigator series.
- *
- * @type      {boolean}
- * @default   false
- * @deprecated
- * @apioption plotOptions.series.dataGrouping.smoothed
- */
-/**
- * An array determining what time intervals the data is allowed to be
- * grouped to. Each array item is an array where the first value is
- * the time unit and the second value another array of allowed multiples.
- *
- * Defaults to:
- * ```js
- * units: [[
- *     'millisecond', // unit name
- *     [1, 2, 5, 10, 20, 25, 50, 100, 200, 500] // allowed multiples
- * ], [
- *     'second',
- *     [1, 2, 5, 10, 15, 30]
- * ], [
- *     'minute',
- *     [1, 2, 5, 10, 15, 30]
- * ], [
- *     'hour',
- *     [1, 2, 3, 4, 6, 8, 12]
- * ], [
- *     'day',
- *     [1]
- * ], [
- *     'week',
- *     [1]
- * ], [
- *     'month',
- *     [1, 3, 6]
- * ], [
- *     'year',
- *     null
- * ]]
- * ```
- *
- * @type      {Array<Array<string,(Array<number>|null)>>}
- * @apioption plotOptions.series.dataGrouping.units
- */
-/**
- * The approximate pixel width of each group. If for example a series
- * with 30 points is displayed over a 600 pixel wide plot area, no grouping
- * is performed. If however the series contains so many points that
- * the spacing is less than the groupPixelWidth, Highcharts will try
- * to group it into appropriate groups so that each is more or less
- * two pixels wide. Defaults to `10`.
- *
- * @sample {highstock} stock/plotoptions/series-datagrouping-grouppixelwidth/
- *         Two series with the same data density but different groupPixelWidth
- *
- * @type      {number}
- * @default   10
- * @apioption plotOptions.column.dataGrouping.groupPixelWidth
- */
-''; // required by JSDoc parsing