highcharts 10.2.0 → 10.2.1

package/es-modules/Series/Bubble/BubbleLegendItem.js

@@ -17,28 +17,11 @@ import H from '../../Core/Globals.js';
 var noop = H.noop;
 import U from '../../Core/Utilities.js';
 var arrayMax = U.arrayMax, arrayMin = U.arrayMin, isNumber = U.isNumber, merge = U.merge, pick = U.pick, stableSort = U.stableSort;
-/**
- * @interface Highcharts.BubbleLegendFormatterContextObject
- */ /**
-* The center y position of the range.
-* @name Highcharts.BubbleLegendFormatterContextObject#center
-* @type {number}
-*/ /**
-* The radius of the bubble range.
-* @name Highcharts.BubbleLegendFormatterContextObject#radius
-* @type {number}
-*/ /**
-* The bubble value.
-* @name Highcharts.BubbleLegendFormatterContextObject#value
-* @type {number}
-*/
-''; // detach doclets above
 /* *
  *
  *  Class
  *
  * */
-/* eslint-disable no-invalid-this, valid-jsdoc */
 /**
  * BubbleLegend class.
  *
@@ -52,7 +35,17 @@ var arrayMax = U.arrayMax, arrayMin = U.arrayMin, isNumber = U.isNumber, merge =
  * Legend of item.
  */
 var BubbleLegendItem = /** @class */ (function () {
+    /* *
+     *
+     *  Constructor
+     *
+     * */
     function BubbleLegendItem(options, legend) {
+        /* *
+         *
+         *  Properties
+         *
+         * */
         this.chart = void 0;
         this.fontMetrics = void 0;
         this.legend = void 0;
@@ -71,15 +64,14 @@ var BubbleLegendItem = /** @class */ (function () {
         this.setState = noop;
         this.init(options, legend);
     }
+    /* *
+     *
+     *  Functions
+     *
+     * */
     /**
      * Create basic bubbleLegend properties similar to item in legend.
-     *
      * @private
-     * @function Highcharts.BubbleLegend#init
-     * @param {Highcharts.LegendBubbleLegendOptions} options
-     *        Bubble legend options
-     * @param {Highcharts.Legend} legend
-     *        Legend
      */
     BubbleLegendItem.prototype.init = function (options, legend) {
         this.options = options;
@@ -91,9 +83,9 @@ var BubbleLegendItem = /** @class */ (function () {
      * Depending on the position option, add bubbleLegend to legend items.
      *
      * @private
-     * @function Highcharts.BubbleLegend#addToLegend
+     *
      * @param {Array<(Highcharts.Point|Highcharts.Series)>} items
-     * All legend items
+     *        All legend items
      */
     BubbleLegendItem.prototype.addToLegend = function (items) {
         // Insert bubbleLegend into legend items
@@ -104,7 +96,7 @@ var BubbleLegendItem = /** @class */ (function () {
      * creation.
      *
      * @private
-     * @function Highcharts.BubbleLegend#drawLegendSymbol
+     *
      * @param {Highcharts.Legend} legend
      *        Legend instance
      */
@@ -140,9 +132,7 @@ var BubbleLegendItem = /** @class */ (function () {
     };
     /**
      * Set style options for each bubbleLegend range.
-     *
      * @private
-     * @function Highcharts.BubbleLegend#setOptions
      */
     BubbleLegendItem.prototype.setOptions = function () {
         var ranges = this.ranges, options = this.options, series = this.chart.series[options.seriesIndex], baseline = this.legend.baseline, bubbleAttribs = {
@@ -186,9 +176,10 @@ var BubbleLegendItem = /** @class */ (function () {
      * used code from BubbleSeries.js 'getRadius' method.
      *
      * @private
-     * @function Highcharts.BubbleLegend#getRangeRadius
+     *
      * @param {number} value
      *        Range value
+     *
      * @return {number|null}
      *         Radius for one range
      */
@@ -198,9 +189,7 @@ var BubbleLegendItem = /** @class */ (function () {
     };
     /**
      * Render the legendSymbol group.
-     *
      * @private
-     * @function Highcharts.BubbleLegend#render
      */
     BubbleLegendItem.prototype.render = function () {
         var renderer = this.chart.renderer, zThreshold = this.options.zThreshold;
@@ -231,7 +220,7 @@ var BubbleLegendItem = /** @class */ (function () {
      * Render one range, consisting of bubble symbol, connector and label.
      *
      * @private
-     * @function Highcharts.BubbleLegend#renderRange
+     *
      * @param {Highcharts.LegendBubbleLegendRangesOptions} range
      *        Range options
      */
@@ -288,9 +277,7 @@ var BubbleLegendItem = /** @class */ (function () {
     };
     /**
      * Get the label which takes up the most space.
-     *
      * @private
-     * @function Highcharts.BubbleLegend#getMaxLabelSize
      */
     BubbleLegendItem.prototype.getMaxLabelSize = function () {
         var labels = this.symbols.labels;
@@ -311,9 +298,10 @@ var BubbleLegendItem = /** @class */ (function () {
      * Get formatted label for range.
      *
      * @private
-     * @function Highcharts.BubbleLegend#formatLabel
+     *
      * @param {Highcharts.LegendBubbleLegendRangesOptions} range
      *        Range options
+     *
      * @return {string}
      *         Range label text
      */
@@ -327,9 +315,7 @@ var BubbleLegendItem = /** @class */ (function () {
     /**
      * By using default chart 'hideOverlappingLabels' method, hide or show
      * labels and connectors.
-     *
      * @private
-     * @function Highcharts.BubbleLegend#hideOverlappingLabels
      */
     BubbleLegendItem.prototype.hideOverlappingLabels = function () {
         var chart = this.chart, allowOverlap = this.options.labels.allowOverlap, symbols = this.symbols;
@@ -350,7 +336,7 @@ var BubbleLegendItem = /** @class */ (function () {
      * Calculate ranges from created series.
      *
      * @private
-     * @function Highcharts.BubbleLegend#getRanges
+     *
      * @return {Array<Highcharts.LegendBubbleLegendRangesOptions>}
      *         Array of range objects
      */
@@ -397,7 +383,7 @@ var BubbleLegendItem = /** @class */ (function () {
      * Calculate bubble legend sizes from rendered series.
      *
      * @private
-     * @function Highcharts.BubbleLegend#predictBubbleSizes
+     *
      * @return {Array<number,number>}
      *         Calculated min and max bubble sizes
      */
@@ -424,11 +410,7 @@ var BubbleLegendItem = /** @class */ (function () {
     };
     /**
      * Correct ranges with calculated sizes.
-     *
      * @private
-     * @function Highcharts.BubbleLegend#updateRanges
-     * @param {number} min
-     * @param {number} max
      */
     BubbleLegendItem.prototype.updateRanges = function (min, max) {
         var bubbleLegendOptions = this.legend.options.bubbleLegend;
@@ -440,9 +422,7 @@ var BubbleLegendItem = /** @class */ (function () {
      * Because of the possibility of creating another legend line, predicted
      * bubble legend sizes may differ by a few pixels, so it is necessary to
      * correct them.
-     *
      * @private
-     * @function Highcharts.BubbleLegend#correctSizes
      */
     BubbleLegendItem.prototype.correctSizes = function () {
         var legend = this.legend, chart = this.chart, bubbleSeries = chart.series[this.options.seriesIndex], pxSizes = bubbleSeries.getPxExtremes(), bubbleSeriesSize = pxSizes.maxPxSize, bubbleLegendSize = this.options.maxSize;
@@ -460,3 +440,24 @@ var BubbleLegendItem = /** @class */ (function () {
  *
  * */
 export default BubbleLegendItem;
+/* *
+ *
+ *  API Declarations
+ *
+ * */
+/**
+ * @interface Highcharts.BubbleLegendFormatterContextObject
+ */ /**
+* The center y position of the range.
+* @name Highcharts.BubbleLegendFormatterContextObject#center
+* @type {number}
+*/ /**
+* The radius of the bubble range.
+* @name Highcharts.BubbleLegendFormatterContextObject#radius
+* @type {number}
+*/ /**
+* The bubble value.
+* @name Highcharts.BubbleLegendFormatterContextObject#value
+* @type {number}
+*/
+''; // detach doclets above

package/es-modules/Series/Bubble/BubbleSeries.js

@@ -23,21 +23,79 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-import Axis from '../../Core/Axis/Axis.js';
 import BubbleLegendComposition from './BubbleLegendComposition.js';
 import BubblePoint from './BubblePoint.js';
 import Color from '../../Core/Color/Color.js';
 var color = Color.parse;
 import H from '../../Core/Globals.js';
 var noop = H.noop;
-import Series from '../../Core/Series/Series.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
-var _a = SeriesRegistry.seriesTypes, ColumnSeries = _a.column, ScatterSeries = _a.scatter;
+var Series = SeriesRegistry.series, _a = SeriesRegistry.seriesTypes, columnProto = _a.column.prototype, ScatterSeries = _a.scatter;
 import U from '../../Core/Utilities.js';
 var addEvent = U.addEvent, arrayMax = U.arrayMax, arrayMin = U.arrayMin, clamp = U.clamp, extend = U.extend, isNumber = U.isNumber, merge = U.merge, pick = U.pick;
-import '../Column/ColumnSeries.js';
-import '../Scatter/ScatterSeries.js';
-import './BubbleLegendItem.js';
+/* *
+ *
+ *  Constants
+ *
+ * */
+var composedClasses = [];
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * Add logic to pad each axis with the amount of pixels necessary to avoid the
+ * bubbles to overflow.
+ */
+function axisBeforePadding() {
+    var _this = this;
+    var axisLength = this.len, chart = this.chart, isXAxis = this.isXAxis, dataKey = isXAxis ? 'xData' : 'yData', min = this.min, range = this.max - min;
+    var pxMin = 0, pxMax = axisLength, transA = axisLength / range, hasActiveSeries;
+    // Handle padding on the second pass, or on redraw
+    this.series.forEach(function (series) {
+        if (series.bubblePadding &&
+            (series.visible || !chart.options.chart.ignoreHiddenSeries)) {
+            // Correction for #1673
+            _this.allowZoomOutside = true;
+            hasActiveSeries = true;
+            var data = series[dataKey];
+            if (isXAxis) {
+                (series.onPoint || series).getRadii(0, 0, series);
+                if (series.onPoint) {
+                    series.radii = series.onPoint.radii;
+                }
+            }
+            if (range > 0) {
+                var i = data.length;
+                while (i--) {
+                    if (isNumber(data[i]) &&
+                        _this.dataMin <= data[i] &&
+                        data[i] <= _this.max) {
+                        var radius = series.radii && series.radii[i] || 0;
+                        pxMin = Math.min(((data[i] - min) * transA) - radius, pxMin);
+                        pxMax = Math.max(((data[i] - min) * transA) + radius, pxMax);
+                    }
+                }
+            }
+        }
+    });
+    // Apply the padding to the min and max properties
+    if (hasActiveSeries && range > 0 && !this.logarithmic) {
+        pxMax -= axisLength;
+        transA *= (axisLength +
+            Math.max(0, pxMin) - // #8901
+            Math.min(pxMax, axisLength)) / axisLength;
+        [
+            ['min', 'userMin', pxMin],
+            ['max', 'userMax', pxMax]
+        ].forEach(function (keys) {
+            if (typeof pick(_this.options[keys[0]], _this[keys[1]]) === 'undefined') {
+                _this[keys[0]] += keys[2] / transA;
+            }
+        });
+    }
+}
 /* *
  *
  *  Class
@@ -66,14 +124,24 @@ var BubbleSeries = /** @class */ (function (_super) {
         _this.yData = void 0;
         _this.zData = void 0;
         return _this;
-        /* eslint-enable valid-jsdoc */
     }
+    /* *
+     *
+     *  Static Functions
+     *
+     * */
+    BubbleSeries.compose = function (AxisClass, ChartClass, LegendClass, SeriesClass) {
+        BubbleLegendComposition.compose(ChartClass, LegendClass, SeriesClass);
+        if (composedClasses.indexOf(AxisClass) === -1) {
+            composedClasses.push(AxisClass);
+            AxisClass.prototype.beforePadding = axisBeforePadding;
+        }
+    };
     /* *
      *
      *  Functions
      *
      * */
-    /* eslint-disable valid-jsdoc */
     /**
      * Perform animation on the bubbles
      * @private
@@ -108,7 +176,8 @@ var BubbleSeries = /** @class */ (function (_super) {
      */
     BubbleSeries.prototype.getRadii = function () {
         var _this = this;
-        var len, i, zData = this.zData, yData = this.yData, radii = [], value, zExtremes = this.chart.bubbleZExtremes;
+        var zData = this.zData, yData = this.yData, radii = [];
+        var len, i, value, zExtremes = this.chart.bubbleZExtremes;
         var _a = this.getPxExtremes(), minPxSize = _a.minPxSize, maxPxSize = _a.maxPxSize;
         // Get the collective Z extremes of all bubblish series. The chart-level
         // `bubbleZExtremes` are only computed once, and reset on `updatedData`
@@ -149,7 +218,8 @@ var BubbleSeries = /** @class */ (function (_super) {
      * @private
      */
     BubbleSeries.prototype.getRadius = function (zMin, zMax, minSize, maxSize, value, yValue) {
-        var options = this.options, sizeByArea = options.sizeBy !== 'width', zThreshold = options.zThreshold, zRange = zMax - zMin, pos = 0.5;
+        var options = this.options, sizeByArea = options.sizeBy !== 'width', zThreshold = options.zThreshold;
+        var zRange = zMax - zMin, pos = 0.5;
         // #8608 - bubble should be visible when z is undefined
         if (yValue === null || value === null) {
             return null;
@@ -268,7 +338,6 @@ var BubbleSeries = /** @class */ (function (_super) {
             }
         }
     };
-    BubbleSeries.compose = BubbleLegendComposition.compose;
     /**
      * A bubble series is a three dimensional series type where each point
      * renders an X, Y and Z value. Each points is drawn as a bubble where the
@@ -507,7 +576,7 @@ var BubbleSeries = /** @class */ (function (_super) {
     return BubbleSeries;
 }(ScatterSeries));
 extend(BubbleSeries.prototype, {
-    alignDataLabel: ColumnSeries.prototype.alignDataLabel,
+    alignDataLabel: columnProto.alignDataLabel,
     applyZones: noop,
     bubblePadding: true,
     buildKDTree: noop,
@@ -524,60 +593,10 @@ extend(BubbleSeries.prototype, {
 addEvent(BubbleSeries, 'updatedData', function (e) {
     delete e.target.chart.bubbleZExtremes;
 });
-/* *
- *
- *  Axis ?
- *
- * */
-// Add logic to pad each axis with the amount of pixels necessary to avoid the
-// bubbles to overflow.
-Axis.prototype.beforePadding = function () {
-    var axis = this, axisLength = this.len, chart = this.chart, pxMin = 0, pxMax = axisLength, isXAxis = this.isXAxis, dataKey = isXAxis ? 'xData' : 'yData', min = this.min, range = this.max - min, transA = axisLength / range, hasActiveSeries;
-    // Handle padding on the second pass, or on redraw
-    this.series.forEach(function (series) {
-        if (series.bubblePadding &&
-            (series.visible || !chart.options.chart.ignoreHiddenSeries)) {
-            // Correction for #1673
-            axis.allowZoomOutside = true;
-            hasActiveSeries = true;
-            var data = series[dataKey];
-            if (isXAxis) {
-                (series.onPoint || series).getRadii(0, 0, series);
-                if (series.onPoint) {
-                    series.radii = series.onPoint.radii;
-                }
-            }
-            if (range > 0) {
-                var i = data.length;
-                while (i--) {
-                    if (isNumber(data[i]) &&
-                        axis.dataMin <= data[i] &&
-                        data[i] <= axis.max) {
-                        var radius = series.radii && series.radii[i] || 0;
-                        pxMin = Math.min(((data[i] - min) * transA) - radius, pxMin);
-                        pxMax = Math.max(((data[i] - min) * transA) + radius, pxMax);
-                    }
-                }
-            }
-        }
-    });
-    // Apply the padding to the min and max properties
-    if (hasActiveSeries && range > 0 && !this.logarithmic) {
-        pxMax -= axisLength;
-        transA *= (axisLength +
-            Math.max(0, pxMin) - // #8901
-            Math.min(pxMax, axisLength)) / axisLength;
-        [
-            ['min', 'userMin', pxMin],
-            ['max', 'userMax', pxMax]
-        ].forEach(function (keys) {
-            if (typeof pick(axis.options[keys[0]], axis[keys[1]]) === 'undefined') {
-                axis[keys[0]] += keys[2] / transA;
-            }
-        });
-    }
-    /* eslint-enable valid-jsdoc */
-};
+// After removing series, delete the chart-level Z extremes cache, #17502.
+addEvent(BubbleSeries, 'remove', function (e) {
+    delete e.target.chart.bubbleZExtremes;
+});
 SeriesRegistry.registerSeriesType('bubble', BubbleSeries);
 /* *
  *

package/es-modules/Series/Column/ColumnSeries.js

@@ -637,6 +637,8 @@ var ColumnSeries = /** @class */ (function (_super) {
      *               lineWidth, marker, step, useOhlcData
      * @product      highcharts highstock
      * @optionparent plotOptions.column
+     *
+     * @private
      */
     ColumnSeries.defaultOptions = merge(Series.defaultOptions, {
         /**

package/es-modules/Series/Column3D/Column3DComposition.js

@@ -13,10 +13,10 @@ var columnProto = ColumnSeries.prototype;
 import H from '../../Core/Globals.js';
 var svg = H.svg;
 import Series from '../../Core/Series/Series.js';
-import Math3D from '../../Extensions/Math3D.js';
+import Math3D from '../../Core/Math3D.js';
 var perspective = Math3D.perspective;
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
-import StackItem from '../../Extensions/Stacking.js';
+import StackItem from '../../Core/Axis/Stacking/StackItem.js';
 import U from '../../Core/Utilities.js';
 var addEvent = U.addEvent, pick = U.pick, wrap = U.wrap;
 /* *

package/es-modules/Series/ColumnPyramid/ColumnPyramidSeries.js

@@ -124,7 +124,7 @@ var ColumnPyramidSeries = /** @class */ (function (_super) {
                     (chart.plotHeight - translatedThreshold);
             // topXwidth and bottomXwidth = width of lines from the center
             // calculated from tanges proportion.
-            // Can not be a NaN #12514
+            // Cannot be a NaN #12514
             topXwidth = stackHeight ?
                 (barW * (barY - topPointY)) / stackHeight : 0;
             // like topXwidth, but with height of point

package/es-modules/Series/Cylinder/CylinderComposition.js

@@ -16,7 +16,7 @@ import Color from '../../Core/Color/Color.js';
 var color = Color.parse;
 import H from '../../Core/Globals.js';
 var charts = H.charts, deg2rad = H.deg2rad;
-import Math3D from '../../Extensions/Math3D.js';
+import Math3D from '../../Core/Math3D.js';
 var perspective = Math3D.perspective;
 import RendererRegistry from '../../Core/Renderer/RendererRegistry.js';
 import U from '../../Core/Utilities.js';

package/es-modules/Series/DependencyWheel/DependencyWheelPoint.js

@@ -28,7 +28,7 @@ var __extends = (this && this.__extends) || (function () {
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 var SankeyPoint = SeriesRegistry.seriesTypes.sankey.prototype.pointClass;
 import U from '../../Core/Utilities.js';
-var extend = U.extend;
+var wrap = U.wrap;
 /* *
  *
  *  Class
@@ -66,18 +66,30 @@ var DependencyWheelPoint = /** @class */ (function (_super) {
      * @private
      */
     DependencyWheelPoint.prototype.getDataLabelPath = function (label) {
+        var _this = this;
         var renderer = this.series.chart.renderer, shapeArgs = this.shapeArgs, upperHalf = this.angle < 0 || this.angle > Math.PI, start = shapeArgs.start || 0, end = shapeArgs.end || 0;
+        // First time
         if (!this.dataLabelPath) {
-            this.dataLabelPath = renderer
-                .arc({
-                open: true,
-                longArc: Math.abs(Math.abs(start) - Math.abs(end)) < Math.PI ? 0 : 1
-            })
-                // Add it inside the data label group so it gets destroyed
-                // with the label
-                .add(label);
+            // Destroy the path with the label
+            wrap(label, 'destroy', function (proceed) {
+                if (_this.dataLabelPath) {
+                    _this.dataLabelPath = _this.dataLabelPath.destroy();
+                }
+                return proceed.call(label);
+            });
+            // Subsequent times
         }
-        this.dataLabelPath.attr({
+        else {
+            this.dataLabelPath = this.dataLabelPath.destroy();
+            delete this.dataLabelPath;
+        }
+        // All times
+        this.dataLabelPath = renderer
+            .arc({
+            open: true,
+            longArc: Math.abs(Math.abs(start) - Math.abs(end)) < Math.PI ? 0 : 1
+        })
+            .attr({
             x: shapeArgs.x,
             y: shapeArgs.y,
             r: (shapeArgs.r +
@@ -85,7 +97,8 @@ var DependencyWheelPoint = /** @class */ (function (_super) {
             start: (upperHalf ? start : end),
             end: (upperHalf ? end : start),
             clockwise: +upperHalf
-        });
+        })
+            .add(renderer.defs);
         return this.dataLabelPath;
     };
     DependencyWheelPoint.prototype.isValid = function () {

package/es-modules/Series/DependencyWheel/DependencyWheelSeries.js

@@ -28,9 +28,9 @@ var __extends = (this && this.__extends) || (function () {
 import A from '../../Core/Animation/AnimationUtilities.js';
 var animObject = A.animObject;
 import DependencyWheelPoint from './DependencyWheelPoint.js';
-import SankeyColumnComposition from '../Sankey/SankeyColumnComposition.js';
 import H from '../../Core/Globals.js';
 var deg2rad = H.deg2rad;
+import SankeyColumnComposition from '../Sankey/SankeyColumnComposition.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 var _a = SeriesRegistry.seriesTypes, PieSeries = _a.pie, SankeySeries = _a.sankey;
 import U from '../../Core/Utilities.js';
@@ -288,6 +288,20 @@ var DependencyWheelSeries = /** @class */ (function (_super) {
          */
         center: [null, null],
         curveFactor: 0.6,
+        /**
+         * Distance between the data label and the center of the node.
+         *
+         * @type      {number}
+         * @default   0
+         * @apioption plotOptions.dependencywheel.dataLabels.distance
+         */
+        /**
+         * Size of the wheel in pixel or percent relative to the canvas space.
+         *
+         * @type      {number|string}
+         * @default   100%
+         * @apioption plotOptions.dependencywheel.size
+         */
         /**
          * The start angle of the dependency wheel, in degrees where 0 is up.
          */
@@ -355,7 +369,7 @@ export default DependencyWheelSeries;
  *     }]
  *  ```
  *
- * @type      {Array<*>}
+ * @type      {Array<Array<string,string,number>|*>}
  * @extends   series.sankey.data
  * @product   highcharts
  * @excluding outgoing, dataLabels