highcharts 9.3.1 → 10.0.0

package/es-modules/Series/Treemap/TreemapSeries.js

@@ -25,8 +25,7 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import Color from '../../Core/Color/Color.js';
 var color = Color.parse;
-import ColorMapComposition from '../ColorMapComposition.js';
-var colorMapSeriesMixin = ColorMapComposition.colorMapSeriesMixin;
+import ColorMapMixin from '../ColorMapMixin.js';
 import H from '../../Core/Globals.js';
 var noop = H.noop;
 import LegendSymbol from '../../Core/Legend/LegendSymbol.js';
@@ -36,9 +35,10 @@ import TreemapAlgorithmGroup from './TreemapAlgorithmGroup.js';
 import TreemapPoint from './TreemapPoint.js';
 import TreemapUtilities from './TreemapUtilities.js';
 import TU from '../TreeUtilities.js';
+import Breadcrumbs from '../../Extensions/Breadcrumbs.js';
 var getColor = TU.getColor, getLevelOptions = TU.getLevelOptions, updateRootId = TU.updateRootId;
 import U from '../../Core/Utilities.js';
-var addEvent = U.addEvent, correctFloat = U.correctFloat, defined = U.defined, error = U.error, extend = U.extend, fireEvent = U.fireEvent, isArray = U.isArray, isObject = U.isObject, isString = U.isString, merge = U.merge, pick = U.pick, stableSort = U.stableSort;
+var addEvent = U.addEvent, correctFloat = U.correctFloat, defined = U.defined, error = U.error, extend = U.extend, fireEvent = U.fireEvent, isArray = U.isArray, isNumber = U.isNumber, isObject = U.isObject, isString = U.isString, merge = U.merge, pick = U.pick, stableSort = U.stableSort;
 import './TreemapComposition.js';
 /* *
  *
@@ -74,6 +74,7 @@ var TreemapSeries = /** @class */ (function (_super) {
         _this.points = void 0;
         _this.rootNode = void 0;
         _this.tree = void 0;
+        _this.level = void 0;
         return _this;
         /* eslint-enable valid-jsdoc */
     }
@@ -250,11 +251,11 @@ var TreemapSeries = /** @class */ (function (_super) {
      * @private
      * @function Highcharts.Series#calculateChildrenAreas
      *
-     * @param {object} node
-     *        The node which is parent to the children.
+     * @param {Object} node
+     * The node which is parent to the children.
      *
-     * @param {object} area
-     *        The rectangular area of the parent.
+     * @param {Object} area
+     * The rectangular area of the parent.
      */
     TreemapSeries.prototype.calculateChildrenAreas = function (parent, area) {
         var series = this, options = series.options, mapOptionsToLevel = series.mapOptionsToLevel, level = mapOptionsToLevel[parent.level + 1], algorithm = pick((series[(level && level.layoutAlgorithm)] &&
@@ -288,6 +289,44 @@ var TreemapSeries = /** @class */ (function (_super) {
             }
         });
     };
+    /**
+    * Create level list.
+    *
+    * @requires  modules/breadcrumbs
+    *
+    * @function TreemapSeries#createList
+    * @param {TreemapSeries} this
+    *        Treemap Series class.
+    */
+    TreemapSeries.prototype.createList = function (e) {
+        var chart = this.chart, breadcrumbs = chart.breadcrumbs, list = [];
+        if (breadcrumbs) {
+            var currentLevelNumber_1 = 0;
+            list.push({
+                level: currentLevelNumber_1,
+                levelOptions: chart.series[0]
+            });
+            var node = e.target.nodeMap[e.newRootId];
+            var extraNodes = [];
+            // When the root node is set and has parent,
+            // recreate the path from the node tree.
+            while (node.parent || node.parent === '') {
+                extraNodes.push(node);
+                node = e.target.nodeMap[node.parent];
+            }
+            extraNodes.reverse().forEach(function (node) {
+                list.push({
+                    level: ++currentLevelNumber_1,
+                    levelOptions: node
+                });
+            });
+            // If the list has only first element, we should clear it
+            if (list.length <= 1) {
+                list.length = 0;
+            }
+        }
+        return list;
+    };
     /**
      * Extend drawDataLabels with logic to handle custom options related to
      * the treemap series:
@@ -462,7 +501,7 @@ var TreemapSeries = /** @class */ (function (_super) {
      * @param {Array<string>} [existingIds]
      *        List of all point ids.
      *
-     * @return {object}
+     * @return {Object}
      *         Map from parent id to children index in data.
      */
     TreemapSeries.prototype.getListOfParents = function (data, existingIds) {
@@ -507,11 +546,10 @@ var TreemapSeries = /** @class */ (function (_super) {
         return !!this.processedXData.length; // != 0
     };
     TreemapSeries.prototype.init = function (chart, options) {
-        var series = this, setOptionsEvent;
+        var series = this, breadcrumbsOptions = merge(options.drillUpButton, options.breadcrumbs);
+        var setOptionsEvent;
         // If color series logic is loaded, add some properties
-        if (colorMapSeriesMixin) {
-            this.colorAttribs = ColorMapComposition.seriesColorAttribs;
-        }
+        this.colorAttribs = ColorMapMixin.SeriesMixin.colorAttribs;
         setOptionsEvent = addEvent(series, 'setOptions', function (event) {
             var options = event.userOptions;
             if (defined(options.allowDrillToNode) &&
@@ -532,7 +570,38 @@ var TreemapSeries = /** @class */ (function (_super) {
         series.eventsToUnbind.push(setOptionsEvent);
         if (series.options.allowTraversingTree) {
             series.eventsToUnbind.push(addEvent(series, 'click', series.onClickDrillToNode));
+            series.eventsToUnbind.push(addEvent(series, 'setRootNode', function (e) {
+                var chart = series.chart;
+                if (chart.breadcrumbs) {
+                    // Create a list using the event after drilldown.
+                    chart.breadcrumbs.updateProperties(series.createList(e));
+                }
+            }));
+            series.eventsToUnbind.push(addEvent(series, 'update', function (e, redraw) {
+                var breadcrumbs = this.chart.breadcrumbs;
+                if (breadcrumbs && e.options.breadcrumbs) {
+                    breadcrumbs.update(e.options.breadcrumbs);
+                }
+            }));
+            series.eventsToUnbind.push(addEvent(series, 'destroy', function destroyEvents(e) {
+                var chart = this.chart;
+                if (chart.breadcrumbs) {
+                    chart.breadcrumbs.destroy();
+                    if (!e.keepEventsForUpdate) {
+                        chart.breadcrumbs = void 0;
+                    }
+                }
+            }));
+        }
+        if (!chart.breadcrumbs) {
+            chart.breadcrumbs = new Breadcrumbs(chart, breadcrumbsOptions);
         }
+        series.eventsToUnbind.push(addEvent(chart.breadcrumbs, 'up', function (e) {
+            var drillUpsNumber = this.level - e.newLevel;
+            for (var i = 0; i < drillUpsNumber; i++) {
+                series.drillUp();
+            }
+        }));
     };
     /**
      * Add drilling on the suitable points.
@@ -591,38 +660,6 @@ var TreemapSeries = /** @class */ (function (_super) {
         }
         return attr;
     };
-    TreemapSeries.prototype.renderTraverseUpButton = function (rootId) {
-        var series = this, nodeMap = series.nodeMap, node = nodeMap[rootId], name = node.name, buttonOptions = series.options.traverseUpButton, backText = pick(buttonOptions.text, name, '◁ Back'), attr, states;
-        if (rootId === '' || (series.is('sunburst') &&
-            series.tree.children.length === 1 &&
-            rootId === series.tree.children[0].id)) {
-            if (series.drillUpButton) {
-                series.drillUpButton = series.drillUpButton.destroy();
-            }
-        }
-        else if (!this.drillUpButton) {
-            attr = buttonOptions.theme;
-            states = attr && attr.states;
-            this.drillUpButton = this.chart.renderer
-                .button(backText, 0, 0, function () {
-                series.drillUp();
-            }, attr, states && states.hover, states && states.select)
-                .addClass('highcharts-drillup-button')
-                .attr({
-                align: buttonOptions.position.align,
-                zIndex: 7
-            })
-                .add()
-                .align(buttonOptions.position, false, buttonOptions.relativeTo || 'plotBox');
-        }
-        else {
-            this.drillUpButton.placed = false;
-            this.drillUpButton.attr({
-                text: backText
-            })
-                .align();
-        }
-    };
     /**
      * Set the node's color recursively, from the parent down.
      * @private
@@ -703,7 +740,7 @@ var TreemapSeries = /** @class */ (function (_super) {
      * @param {boolean} [redraw=true]
      * Wether to redraw the chart or not.
      *
-     * @param {object} [eventArguments]
+     * @param {Object} [eventArguments]
      * Arguments to be accessed in event handler.
      *
      * @param {string} [eventArguments.newRootId]
@@ -715,14 +752,14 @@ var TreemapSeries = /** @class */ (function (_super) {
      * @param {boolean} [eventArguments.redraw]
      * Wether to redraw the chart after.
      *
-     * @param {object} [eventArguments.series]
+     * @param {Object} [eventArguments.series]
      * The series to update the root of.
      *
      * @param {string} [eventArguments.trigger]
      * The action which triggered the event. Undefined if the setRootNode is
      * called directly.
      *
-     * @fires Highcharts.Series#event:setRootNode
+     * @emits Highcharts.Series#event:setRootNode
      */
     TreemapSeries.prototype.setRootNode = function (id, redraw, eventArguments) {
         var series = this, eventArgs = extend({
@@ -735,16 +772,15 @@ var TreemapSeries = /** @class */ (function (_super) {
          * The default functionality of the setRootNode event.
          *
          * @private
-         * @param {object} args The event arguments.
+         * @param {Object} args The event arguments.
          * @param {string} args.newRootId Id of the new root.
          * @param {string} args.previousRootId Id of the previous root.
          * @param {boolean} args.redraw Wether to redraw the chart after.
-         * @param {object} args.series The series to update the root of.
+         * @param {Object} args.series The series to update the root of.
          * @param {string} [args.trigger=undefined] The action which
          * triggered the event. Undefined if the setRootNode is called
          * directly.
-         * @return {void}
-         */
+             */
         var defaultFn = function (args) {
             var series = args.series;
             // Store previous and new root ids on the series.
@@ -831,7 +867,6 @@ var TreemapSeries = /** @class */ (function (_super) {
             rootId = series.rootNode;
             rootNode = series.nodeMap[rootId];
         }
-        series.renderTraverseUpButton(rootId);
         series.mapOptionsToLevel = getLevelOptions({
             from: rootNode.level + 1,
             levels: options.levels,
@@ -900,7 +935,7 @@ var TreemapSeries = /** @class */ (function (_super) {
      *         Treemap
      *
      * @extends      plotOptions.scatter
-     * @excluding    dragDrop, marker, jitter, dataSorting
+     * @excluding    cluster, connectEnds, connectNulls, dataSorting, dragDrop, jitter, marker
      * @product      highcharts
      * @requires     modules/treemap
      * @optionparent plotOptions.treemap
@@ -937,6 +972,16 @@ var TreemapSeries = /** @class */ (function (_super) {
          * The border radius for each treemap item.
          */
         borderRadius: 0,
+        /**
+         * Options for the breadcrumbs, the navigation at the top leading the
+         * way up through the traversed levels.
+         *
+         *
+         * @since 10.0.0
+         * @product   highcharts
+         * @extends   navigation.breadcrumbs
+         * @optionparent plotOptions.treemap.breadcrumbs
+         */
         /**
          * When the series contains less points than the crop threshold, all
          * points are drawn, event if the points fall outside the visible plot
@@ -959,10 +1004,11 @@ var TreemapSeries = /** @class */ (function (_super) {
          * additional properties `newRootId`, `previousRootId`, `redraw` and
          * `trigger`.
          *
-         * @type {function}
-         * @default undefined
          * @sample {highcharts} highcharts/plotoptions/treemap-events-setrootnode/
          *         Alert update information on setRootNode event.
+         *
+         * @type {Function}
+         * @default undefined
          * @since 7.0.3
          * @product highcharts
          * @apioption plotOptions.treemap.events.setRootNode
@@ -1098,52 +1144,12 @@ var TreemapSeries = /** @class */ (function (_super) {
          */
         levelIsConstant: true,
         /**
-         * Options for the button appearing when drilling down in a treemap.
-         * Deprecated and replaced by
-         * [traverseUpButton](#plotOptions.treemap.traverseUpButton).
+         * Options for the button appearing when traversing down in a treemap.
+         *
+         * Since v9.3.3 the `traverseUpButton` is replaced by `breadcrumbs`.
          *
          * @deprecated
          */
-        drillUpButton: {
-            /**
-             * The position of the button.
-             *
-             * @deprecated
-             */
-            position: {
-                /**
-                 * Vertical alignment of the button.
-                 *
-                 * @deprecated
-                 * @type      {Highcharts.VerticalAlignValue}
-                 * @default   top
-                 * @product   highcharts
-                 * @apioption plotOptions.treemap.drillUpButton.position.verticalAlign
-                 */
-                /**
-                 * Horizontal alignment of the button.
-                 *
-                 * @deprecated
-                 * @type {Highcharts.AlignValue}
-                 */
-                align: 'right',
-                /**
-                 * Horizontal offset of the button.
-                 *
-                 * @deprecated
-                 */
-                x: -10,
-                /**
-                 * Vertical offset of the button.
-                 *
-                 * @deprecated
-                 */
-                y: 10
-            }
-        },
-        /**
-         * Options for the button appearing when traversing down in a treemap.
-         */
         traverseUpButton: {
             /**
              * The position of the button.
@@ -1378,7 +1384,6 @@ extend(TreemapSeries.prototype, {
         recursive: TreemapUtilities.recursive
     }
 });
-ColorMapComposition.compose(TreemapSeries);
 SeriesRegistry.registerSeriesType('treemap', TreemapSeries);
 /* *
  *

package/es-modules/Series/Variwide/VariwideSeries.js

@@ -100,7 +100,11 @@ var VariwideSeries = /** @class */ (function (_super) {
      *         Distorted X position
      */
     VariwideSeries.prototype.postTranslate = function (index, x, point) {
-        var axis = this.xAxis, relZ = this.relZ, i = axis.reversed ? relZ.length - index : index, goRight = axis.reversed ? -1 : 1, minPx = axis.toPixels(axis.reversed ? (axis.dataMax || 0) + axis.pointRange : (axis.dataMin || 0)), maxPx = axis.toPixels(axis.reversed ? (axis.dataMin || 0) : (axis.dataMax || 0) + axis.pointRange), len = Math.abs(maxPx - minPx), totalZ = this.totalZ, left = this.chart.inverted ?
+        var axis = this.xAxis, relZ = this.relZ, i = axis.reversed ? relZ.length - index : index, goRight = axis.reversed ? -1 : 1, minPx = axis.toPixels(axis.reversed ?
+            (axis.dataMax || 0) + axis.pointRange :
+            (axis.dataMin || 0)), maxPx = axis.toPixels(axis.reversed ?
+            (axis.dataMin || 0) :
+            (axis.dataMax || 0) + axis.pointRange), len = Math.abs(maxPx - minPx), totalZ = this.totalZ, left = this.chart.inverted ?
             maxPx - (this.chart.plotTop - goRight * axis.minPixelPadding) :
             minPx - this.chart.plotLeft - goRight * axis.minPixelPadding, linearSlotLeft = i / relZ.length * len, linearSlotRight = (i + goRight) / relZ.length * len, slotLeft = (pick(relZ[i], totalZ) / totalZ) * len, slotRight = (pick(relZ[i + goRight], totalZ) / totalZ) * len, xInsideLinearSlot = (x - (left + linearSlotLeft));
         // Set crosshairWidth for every point (#8173)

package/es-modules/Series/Venn/VennSeries.js

@@ -107,12 +107,12 @@ var VennSeries = /** @class */ (function (_super) {
                 { x: circle.x, y: circle.y + d },
                 { x: circle.x, y: circle.y - d }
             ]
-                // Iterate the given points and return the one with the largest
-                // margin.
+                // Iterate the given points and return the one with the
+                // largest margin.
                 .reduce(function (best, point) {
                 var margin = VennUtils.getMarginFromCircles(point, internal, external);
-                // If the margin better than the current best, then update
-                // sbest.
+                // If the margin better than the current best, then
+                // update sbest.
                 if (best.margin < margin) {
                     best.point = point;
                     best.margin = margin;
@@ -210,16 +210,13 @@ var VennSeries = /** @class */ (function (_super) {
         if (relations.length > 0) {
             var mapOfIdToCircles_1 = VennUtils.layoutGreedyVenn(relations);
             var setRelations_1 = relations.filter(VennUtils.isSet);
-            relations
-                .forEach(function (relation) {
+            relations.forEach(function (relation) {
                 var sets = relation.sets;
                 var id = sets.join();
                 // Get shape from map of circles, or calculate intersection.
                 var shape = VennUtils.isSet(relation) ?
                     mapOfIdToCircles_1[id] :
-                    getAreaOfIntersectionBetweenCircles(sets.map(function (set) {
-                        return mapOfIdToCircles_1[set];
-                    }));
+                    getAreaOfIntersectionBetweenCircles(sets.map(function (set) { return mapOfIdToCircles_1[set]; }));
                 // Calculate label values if the set has a shape
                 if (shape) {
                     mapOfIdToShape[id] = shape;

package/es-modules/Series/Venn/VennUtils.js

@@ -303,11 +303,10 @@ function layoutGreedyVenn(relations) {
      * Takes a set and updates the position, and add the set to the list of
      * positioned sets.
      * @private
-     * @param {object} set
+     * @param {Object} set
      * The set to add to its final position.
-     * @param {object} coordinates
+     * @param {Object} coordinates
      * The coordinates to position the set at.
-     * @return {void}
      */
     var positionSet = function positionSet(set, coordinates) {
         var circle = set.circle;
@@ -575,10 +574,12 @@ function processVennData(data) {
 /**
  * Takes two sets and finds the one with the largest total overlap.
  * @private
- * @param {object} a The first set to compare.
- * @param {object} b The second set to compare.
- * @return {number} Returns 0 if a and b are equal, <0 if a is greater, >0 if b
- * is greater.
+ * @param {Object} a
+ * The first set to compare.
+ * @param {Object} b
+ * The second set to compare.
+ * @return {number}
+ * Returns 0 if a and b are equal, <0 if a is greater, >0 if b is greater.
  */
 function sortByTotalOverlap(a, b) {
     return b.totalOverlap - a.totalOverlap;

package/es-modules/Series/Waterfall/WaterfallSeries.js

@@ -33,9 +33,12 @@ import '../../Core/DefaultOptions.js';
 /**
  * Returns true if the key is a direct property of the object.
  * @private
- * @param {*} obj - Object with property to test
- * @param {string} key - Property key to test
- * @return {boolean} - Whether it is a direct property
+ * @param {*} obj
+ * Object with property to test
+ * @param {string} key
+ * Property key to test
+ * @return {boolean}
+ * Whether it is a direct property
  */
 function ownProp(obj, key) {
     return Object.hasOwnProperty.call(obj, key);
@@ -261,6 +264,8 @@ var WaterfallSeries = /** @class */ (function (_super) {
                     point.tooltipPos[1] = tooltipY;
                 }
             }
+            // Check point position after recalculation (#16788)
+            point.isInside = this.isPointInside(point);
         }
     };
     // Call default processData then override yData to reflect waterfall's

package/es-modules/Series/Wordcloud/WordcloudSeries.js

@@ -326,7 +326,7 @@ var WordcloudSeries = /** @class */ (function (_super) {
          * cloud. Read more about it in our
          * [documentation](https://www.highcharts.com/docs/chart-and-series-types/word-cloud-series#custom-placement-strategies)
          *
-         * @validvalue: ["center", "random"]
+         * @validvalue ["center", "random"]
          */
         placementStrategy: 'center',
         /**
@@ -359,7 +359,7 @@ var WordcloudSeries = /** @class */ (function (_super) {
          * algorithms for use in word cloud. Read more about it in our
          * [documentation](https://www.highcharts.com/docs/chart-and-series-types/word-cloud-series#custom-spiralling-algorithm)
          *
-         * @validvalue: ["archimedean", "rectangular", "square"]
+         * @validvalue ["archimedean", "rectangular", "square"]
          */
         spiral: 'rectangular',
         /**

package/es-modules/Series/Wordcloud/WordcloudUtils.js

@@ -91,10 +91,9 @@ function getAxesFromPolygon(polygon) {
  * @private
  * @function project
  * @param {Highcharts.PolygonObject} polygon
- *        Array of points in a polygon.
+ * Array of points in a polygon.
  * @param {Highcharts.PolygonPointObject} target
- *        The coordinate of pr
- * @return {Highcharts.RangeObject}
+ * The coordinate of pr
  */
 function project(polygon, target) {
     var products = polygon.map(function (point) {
@@ -315,7 +314,7 @@ function getRandomPosition(size) {
  * @param {number} targetHeight
  * Height of target area.
  *
- * @param {object} field
+ * @param {Object} field
  * The playing field.
  *
  * @param {Highcharts.Series} series
@@ -346,10 +345,10 @@ function getScale(targetWidth, targetHeight, field) {
  * @param {Array<Highcharts.Point>} data
  * Array of points.
  *
- * @param {object} data.dimensions
+ * @param {Object} data.dimensions
  * The height and width of the word.
  *
- * @return {object}
+ * @return {Object}
  * The width and height of the playing field.
  */
 function getPlayingField(targetWidth, targetHeight, data) {
@@ -432,7 +431,7 @@ function getRotation(orientations, index, from, to) {
  * @param {Function} fn
  * The spiral function.
  *
- * @param {object} params
+ * @param {Object} params
  * Additional parameters for the spiral.
  *
  * @return {Function}
@@ -615,9 +614,6 @@ function updateFieldBoundaries(field, rectangle) {
  *
  * @private
  * @function correctFloat
- * @param {number} number
- * @param {number} [precision]
- * @return {number}
  */
 function correctFloat(number, precision) {
     var p = isNumber(precision) ? precision : 14, magnitude = Math.pow(10, p);

package/es-modules/Series/XRange/XRangePoint.js

@@ -57,14 +57,14 @@ var XRangePoint = /** @class */ (function (_super) {
      * @private
      * @function getColorByCategory
      *
-     * @param {object} series
-     *        The series which the point belongs to.
+     * @param {Object} series
+     * The series which the point belongs to.
      *
-     * @param {object} point
-     *        The point to calculate its color for.
+     * @param {Object} point
+     * The point to calculate its color for.
      *
-     * @return {object}
-     *         Returns an object containing the properties color and colorIndex.
+     * @return {Object}
+     * Returns an object containing the properties color and colorIndex.
      */
     XRangePoint.getColorByCategory = function (series, point) {
         var colors = series.options.colors || series.chart.options.colors, colorCount = colors ?
@@ -119,8 +119,6 @@ var XRangePoint = /** @class */ (function (_super) {
      *
      * @private
      * @function Highcharts.Point#init
-     *
-     * @return {Highcharts.Point}
      */
     XRangePoint.prototype.init = function () {
         Point.prototype.init.apply(this, arguments);
@@ -140,8 +138,6 @@ var XRangePoint = /** @class */ (function (_super) {
     /**
      * @private
      * @function Highcharts.Point#getLabelConfig
-     *
-     * @return {Highcharts.PointLabelObject}
      */
     // Add x2 and yCategory to the available properties for tooltip formats
     XRangePoint.prototype.getLabelConfig = function () {
@@ -153,8 +149,6 @@ var XRangePoint = /** @class */ (function (_super) {
     /**
      * @private
      * @function Highcharts.Point#isValid
-     *
-     * @return {boolean}
      */
     XRangePoint.prototype.isValid = function () {
         return typeof this.x === 'number' &&

package/es-modules/Series/XRange/XRangeSeries.js

@@ -83,7 +83,6 @@ var XRangeSeries = /** @class */ (function (_super) {
     /**
      * @private
      * @function Highcarts.seriesTypes.xrange#init
-     * @return {void}
      */
     XRangeSeries.prototype.init = function () {
         ColumnSeries.prototype.init.apply(this, arguments);
@@ -95,8 +94,6 @@ var XRangeSeries = /** @class */ (function (_super) {
      *
      * @private
      * @function Highcharts.Series#getColumnMetrics
-     *
-     * @return {Highcharts.ColumnMetricsObject}
      */
     XRangeSeries.prototype.getColumnMetrics = function () {
         var metrics, chart = this.chart;
@@ -121,18 +118,6 @@ var XRangeSeries = /** @class */ (function (_super) {
      *
      * @private
      * @function Highcharts.Series#cropData
-     *
-     * @param {Array<number>} xData
-     *
-     * @param {Array<number>} yData
-     *
-     * @param {number} min
-     *
-     * @param {number} max
-     *
-     * @param {number} [cropShoulder]
-     *
-     * @return {*}
      */
     XRangeSeries.prototype.cropData = function (xData, yData, min, max) {
         // Replace xData with x2Data to find the appropriate cropStart
@@ -147,9 +132,10 @@ var XRangeSeries = /** @class */ (function (_super) {
      *
      * @private
      * @function Highcharts.Series#findPointIndex
-     * @param {object} options The options of the point.
-     * @returns {number|undefined} Returns index of a matching point,
-     * returns undefined if no match is found.
+     * @param {Object} options
+     * The options of the point.
+     * @return {number|undefined}
+     * Returns index of a matching point, or undefined if no match is found.
      */
     XRangeSeries.prototype.findPointIndex = function (options) {
         var _a = this, cropped = _a.cropped, cropStart = _a.cropStart, points = _a.points;
@@ -386,8 +372,6 @@ var XRangeSeries = /** @class */ (function (_super) {
      *
      * @private
      * @function Highcharts.Series#getAnimationVerb
-     *
-     * @return {string}
      */
     XRangeSeries.prototype.getAnimationVerb = function () {
         return (this.chart.pointCount < (this.options.animationLimit || 250) ?

package/es-modules/Stock/Indicators/ABands/ABandsIndicator.js

@@ -160,6 +160,17 @@ var ABandsIndicator = /** @class */ (function (_super) {
      * @optionparent plotOptions.abands
      */
     ABandsIndicator.defaultOptions = merge(SMAIndicator.defaultOptions, {
+        /**
+         * Option for fill color between lines in Accelleration bands Indicator.
+         *
+         * @sample {highstock} stock/indicators/indicator-area-fill
+         *      Background fill between lines.
+         *
+         * @type {Highcharts.Color}
+         * @since 9.3.2
+         * @apioption plotOptions.abands.fillColor
+         *
+         */
         params: {
             period: 20,
             /**
@@ -194,6 +205,7 @@ var ABandsIndicator = /** @class */ (function (_super) {
     return ABandsIndicator;
 }(SMAIndicator));
 extend(ABandsIndicator.prototype, {
+    areaLinesNames: ['top', 'bottom'],
     linesApiNames: ['topLine', 'bottomLine'],
     nameBase: 'Acceleration Bands',
     nameComponents: ['period', 'factor'],

package/es-modules/Stock/Indicators/Aroon/AroonIndicator.js

@@ -166,6 +166,7 @@ var AroonIndicator = /** @class */ (function (_super) {
     return AroonIndicator;
 }(SMAIndicator));
 extend(AroonIndicator.prototype, {
+    areaLinesNames: [],
     linesApiNames: ['aroonDown'],
     nameBase: 'Aroon',
     pointArrayMap: ['y', 'aroonDown'],