highcharts 10.2.0 → 10.2.1

package/es-modules/Series/DragNodesComposition.js

@@ -0,0 +1,166 @@
+/* *
+ *
+ *  Networkgraph series
+ *
+ *  (c) 2010-2021 Paweł Fus
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+import U from '../Core/Utilities.js';
+var addEvent = U.addEvent;
+/* *
+ *
+ *  Constants
+ *
+ * */
+var composedClasses = [];
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * @private
+ */
+function compose(ChartClass) {
+    if (composedClasses.indexOf(ChartClass) === -1) {
+        composedClasses.push(ChartClass);
+        addEvent(ChartClass, 'load', onChartLoad);
+    }
+}
+/**
+ * Draggable mode:
+ * @private
+ */
+function onChartLoad() {
+    var chart = this;
+    var mousedownUnbinder, mousemoveUnbinder, mouseupUnbinder;
+    if (chart.container) {
+        mousedownUnbinder = addEvent(chart.container, 'mousedown', function (event) {
+            var point = chart.hoverPoint;
+            if (point &&
+                point.series &&
+                point.series.hasDraggableNodes &&
+                point.series.options.draggable) {
+                point.series.onMouseDown(point, event);
+                mousemoveUnbinder = addEvent(chart.container, 'mousemove', function (e) { return (point &&
+                    point.series &&
+                    point.series.onMouseMove(point, e)); });
+                mouseupUnbinder = addEvent(chart.container.ownerDocument, 'mouseup', function (e) {
+                    mousemoveUnbinder();
+                    mouseupUnbinder();
+                    return point &&
+                        point.series &&
+                        point.series.onMouseUp(point, e);
+                });
+            }
+        });
+    }
+    addEvent(chart, 'destroy', function () {
+        mousedownUnbinder();
+    });
+}
+/**
+ * Mouse down action, initializing drag&drop mode.
+ *
+ * @private
+ * @param {Highcharts.Point} point
+ *        The point that event occured.
+ * @param {Highcharts.PointerEventObject} event
+ *        Browser event, before normalization.
+ */
+function onMouseDown(point, event) {
+    var normalizedEvent = this.chart.pointer.normalize(event);
+    point.fixedPosition = {
+        chartX: normalizedEvent.chartX,
+        chartY: normalizedEvent.chartY,
+        plotX: point.plotX,
+        plotY: point.plotY
+    };
+    point.inDragMode = true;
+}
+/**
+ * Mouse move action during drag&drop.
+ *
+ * @private
+ *
+ * @param {global.Event} event
+ *        Browser event, before normalization.
+ * @param {Highcharts.Point} point
+ *        The point that event occured.
+ *
+ */
+function onMouseMove(point, event) {
+    if (point.fixedPosition && point.inDragMode) {
+        var series = this, chart = series.chart, normalizedEvent = chart.pointer.normalize(event), diffX = point.fixedPosition.chartX - normalizedEvent.chartX, diffY = point.fixedPosition.chartY - normalizedEvent.chartY, graphLayoutsLookup = chart.graphLayoutsLookup;
+        var newPlotX = void 0, newPlotY = void 0;
+        // At least 5px to apply change (avoids simple click):
+        if (Math.abs(diffX) > 5 || Math.abs(diffY) > 5) {
+            newPlotX = point.fixedPosition.plotX - diffX;
+            newPlotY = point.fixedPosition.plotY - diffY;
+            if (chart.isInsidePlot(newPlotX, newPlotY)) {
+                point.plotX = newPlotX;
+                point.plotY = newPlotY;
+                point.hasDragged = true;
+                this.redrawHalo(point);
+                graphLayoutsLookup.forEach(function (layout) {
+                    layout.restartSimulation();
+                });
+            }
+        }
+    }
+}
+/**
+ * Mouse up action, finalizing drag&drop.
+ *
+ * @private
+ * @param {Highcharts.Point} point
+ *        The point that event occured.
+ */
+function onMouseUp(point, _event) {
+    if (point.fixedPosition) {
+        if (point.hasDragged) {
+            if (this.layout.enableSimulation) {
+                this.layout.start();
+            }
+            else {
+                this.chart.redraw();
+            }
+        }
+        point.inDragMode = point.hasDragged = false;
+        if (!this.options.fixedDraggable) {
+            delete point.fixedPosition;
+        }
+    }
+}
+/**
+ * Redraw halo on mousemove during the drag&drop action.
+ *
+ * @private
+ * @param {Highcharts.Point} point
+ *        The point that should show halo.
+ */
+function redrawHalo(point) {
+    if (point && this.halo) {
+        this.halo.attr({
+            d: point.haloPath(this.options.states.hover.halo.size)
+        });
+    }
+}
+/* *
+ *
+ *  Default Export
+ *
+ * */
+var DragNodesComposition = {
+    compose: compose,
+    onMouseDown: onMouseDown,
+    onMouseMove: onMouseMove,
+    onMouseUp: onMouseUp,
+    redrawHalo: redrawHalo
+};
+export default DragNodesComposition;

package/es-modules/Series/Funnel3D/Funnel3DSeries.js

@@ -31,7 +31,7 @@ import Funnel3DComposition from './Funnel3DComposition.js';
 import Funnel3DPoint from './Funnel3DPoint.js';
 import H from '../../Core/Globals.js';
 var noop = H.noop;
-import Math3D from '../../Extensions/Math3D.js';
+import Math3D from '../../Core/Math3D.js';
 var perspective = Math3D.perspective;
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 var Series = SeriesRegistry.series, ColumnSeries = SeriesRegistry.seriesTypes.column;

package/es-modules/Series/Gantt/GanttSeries.js

@@ -33,7 +33,7 @@ var Series = SeriesRegistry.series, XRangeSeries = SeriesRegistry.seriesTypes.xr
 import Tick from '../../Core/Axis/Tick.js';
 import U from '../../Core/Utilities.js';
 var extend = U.extend, isNumber = U.isNumber, merge = U.merge, splat = U.splat;
-import TreeGridAxis from '../../Core/Axis/TreeGridAxis.js';
+import TreeGridAxis from '../../Core/Axis/TreeGrid/TreeGridAxis.js';
 TreeGridAxis.compose(Axis, Chart, Series, Tick);
 import '../../Extensions/CurrentDateIndication.js';
 import '../../Extensions/StaticScale.js';

package/es-modules/Series/GraphLayoutComposition.js

@@ -0,0 +1,130 @@
+/* *
+ *
+ *  Networkgraph series
+ *
+ *  (c) 2010-2021 Paweł Fus
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+import A from '../Core/Animation/AnimationUtilities.js';
+var setAnimation = A.setAnimation;
+import U from '../Core/Utilities.js';
+var addEvent = U.addEvent;
+/* *
+ *
+ *  Constants
+ *
+ * */
+var composedClasses = [];
+var integrations = {};
+var layouts = {};
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * @private
+ */
+function compose(ChartClass) {
+    if (composedClasses.indexOf(ChartClass)) {
+        composedClasses.push(ChartClass);
+        addEvent(ChartClass, 'afterPrint', onChartAfterPrint);
+        addEvent(ChartClass, 'beforePrint', onChartBeforePrint);
+        addEvent(ChartClass, 'predraw', onChartPredraw);
+        addEvent(ChartClass, 'render', onChartRender);
+    }
+}
+/**
+ * Re-enable simulation after print.
+ * @private
+ */
+function onChartAfterPrint() {
+    if (this.graphLayoutsLookup) {
+        this.graphLayoutsLookup.forEach(function (layout) {
+            // return to default simulation
+            layout.updateSimulation();
+        });
+        this.redraw();
+    }
+}
+/**
+ * Disable simulation before print if enabled.
+ * @private
+ */
+function onChartBeforePrint() {
+    if (this.graphLayoutsLookup) {
+        this.graphLayoutsLookup.forEach(function (layout) {
+            layout.updateSimulation(false);
+        });
+        this.redraw();
+    }
+}
+/**
+ * Clear previous layouts.
+ * @private
+ */
+function onChartPredraw() {
+    if (this.graphLayoutsLookup) {
+        this.graphLayoutsLookup.forEach(function (layout) {
+            layout.stop();
+        });
+    }
+}
+/**
+ * @private
+ */
+function onChartRender() {
+    var systemsStable, afterRender = false;
+    var layoutStep = function (layout) {
+        if (layout.maxIterations-- &&
+            isFinite(layout.temperature) &&
+            !layout.isStable() &&
+            !layout.enableSimulation) {
+            // Hook similar to build-in addEvent, but instead of
+            // creating whole events logic, use just a function.
+            // It's faster which is important for rAF code.
+            // Used e.g. in packed-bubble series for bubble radius
+            // calculations
+            if (layout.beforeStep) {
+                layout.beforeStep();
+            }
+            layout.step();
+            systemsStable = false;
+            afterRender = true;
+        }
+    };
+    if (this.graphLayoutsLookup) {
+        setAnimation(false, this);
+        // Start simulation
+        this.graphLayoutsLookup.forEach(function (layout) { return layout.start(); });
+        // Just one sync step, to run different layouts similar to
+        // async mode.
+        while (!systemsStable) {
+            systemsStable = true;
+            this.graphLayoutsLookup.forEach(layoutStep);
+        }
+        if (afterRender) {
+            this.series.forEach(function (series) {
+                if (series && series.layout) {
+                    series.render();
+                }
+            });
+        }
+    }
+}
+/* *
+ *
+ *  Default Export
+ *
+ * */
+var GraphLayoutComposition = {
+    compose: compose,
+    integrations: integrations,
+    layouts: layouts
+};
+export default GraphLayoutComposition;

package/es-modules/Series/Heatmap/HeatmapSeries.js

@@ -305,7 +305,11 @@ var HeatmapSeries = /** @class */ (function (_super) {
          */
         animation: false,
         /**
-         * The border radius for each heatmap item.
+         * The border radius for each heatmap item. The border's color and
+         * width can be set in marker options.
+         *
+         * @see [lineColor](#plotOptions.heatmap.marker.lineColor)
+         * @see [lineWidth](#plotOptions.heatmap.marker.lineWidth)
          */
         borderRadius: 0,
         /**

package/es-modules/Series/Lollipop/LollipopPoint.js

@@ -24,7 +24,7 @@ var __extends = (this && this.__extends) || (function () {
     };
 })();
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
-var Point = SeriesRegistry.series.prototype.pointClass, _a = SeriesRegistry.seriesTypes, areaProto = _a.area.prototype, DumbbellPoint = _a.dumbbell.prototype.pointClass;
+var pointProto = SeriesRegistry.series.prototype.pointClass.prototype, _a = SeriesRegistry.seriesTypes, areaProto = _a.area.prototype, DumbbellPoint = _a.dumbbell.prototype.pointClass;
 import U from '../../Core/Utilities.js';
 var isObject = U.isObject, extend = U.extend;
 /* *
@@ -35,28 +35,38 @@ var isObject = U.isObject, extend = U.extend;
 var LollipopPoint = /** @class */ (function (_super) {
     __extends(LollipopPoint, _super);
     function LollipopPoint() {
+        /* *
+         *
+         *  Properties
+         *
+         * */
         var _this = _super !== null && _super.apply(this, arguments) || this;
-        _this.series = void 0;
         _this.options = void 0;
+        _this.series = void 0;
         return _this;
     }
+    /* *
+     *
+     *  Functions
+     *
+     * */
+    LollipopPoint.prototype.init = function (_series, options, _x) {
+        if (isObject(options) && 'low' in options) {
+            options.y = options.low;
+            delete options.low;
+        }
+        return pointProto.init.apply(this, arguments);
+    };
     return LollipopPoint;
 }(DumbbellPoint));
 extend(LollipopPoint.prototype, {
     pointSetState: areaProto.pointClass.prototype.setState,
     // Does not work with the inherited `isvalid`
-    isValid: Point.prototype.isValid,
-    init: function (series, options, x) {
-        if (isObject(options) && 'low' in options) {
-            options.y = options.low;
-            delete options.low;
-        }
-        return Point.prototype.init.apply(this, arguments);
-    }
+    isValid: pointProto.isValid
 });
 /* *
  *
- *  Default export
+ *  Default Export
  *
  * */
 export default LollipopPoint;

package/es-modules/Series/Lollipop/LollipopSeries.js

@@ -34,7 +34,7 @@ var pick = U.pick, merge = U.merge, extend = U.extend;
  *
  * */
 /**
- * lollipop series type
+ * Lollipop series type
  *
  * @private
  * @class
@@ -48,7 +48,7 @@ var LollipopSeries = /** @class */ (function (_super) {
     function LollipopSeries() {
         /* *
          *
-         *  Static properties
+         *  Static Properties
          *
          * */
         var _this = _super !== null && _super.apply(this, arguments) || this;
@@ -62,6 +62,11 @@ var LollipopSeries = /** @class */ (function (_super) {
         _this.points = void 0;
         return _this;
     }
+    /* *
+     *
+     *  Functions
+     *
+     * */
     LollipopSeries.prototype.toYData = function (point) {
         return [pick(point.y, point.low)];
     };
@@ -80,7 +85,7 @@ var LollipopSeries = /** @class */ (function (_super) {
      * @product      highcharts highstock
      * @excluding    fillColor, fillOpacity, lineWidth, stack, stacking,
      *               lowColor, stickyTracking, trackByArea
-     * @since 8.0.0
+     * @since        8.0.0
      * @optionparent plotOptions.lollipop
      */
     LollipopSeries.defaultOptions = merge(DumbbellSeries.defaultOptions, {
@@ -202,10 +207,10 @@ export default LollipopSeries;
  * @apioption series.lollipop.data
  */
 /**
-* The y value of the point.
-*
-* @type      {number|null}
-* @product   highcharts highstock
-* @apioption series.line.data.y
-*/
-''; // adds doclets above to transpiled file
+ * The y value of the point.
+ *
+ * @type      {number|null}
+ * @product   highcharts highstock
+ * @apioption series.line.data.y
+ */
+(''); // adds doclets above to transpiled file

package/es-modules/Series/Map/MapSeries.js

@@ -701,6 +701,8 @@ var MapSeries = /** @class */ (function (_super) {
      * @excluding    marker, cluster
      * @product      highmaps
      * @optionparent plotOptions.map
+     *
+     * @private
      */
     MapSeries.defaultOptions = merge(ScatterSeries.defaultOptions, {
         /**
@@ -711,6 +713,8 @@ var MapSeries = /** @class */ (function (_super) {
          *         US map with world map backdrop
          *
          * @since 10.0.0
+         *
+         * @private
          */
         affectsMapView: true,
         animation: false,
@@ -1105,8 +1109,9 @@ export default MapSeries;
  * The geometry type. Can be one of `LineString`, `Polygon`, `MultiLineString`
  * or `MultiPolygon`.
  *
+ * @declare   Highcharts.MapGeometryTypeValue
  * @type      {string}
- * @since 9.3.0
+ * @since     9.3.0
  * @product   highmaps
  * @validvalue ["LineString", "Polygon", "MultiLineString", "MultiPolygon"]
  * @apioption series.map.data.geometry.type

package/es-modules/Series/MapBubble/MapBubblePoint.js

@@ -28,9 +28,11 @@ var __extends = (this && this.__extends) || (function () {
  *  Imports
  *
  * */
-import MapPoint from '../Map/MapPoint.js';
+import BubblePoint from '../Bubble/BubblePoint.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
-var _a = SeriesRegistry.seriesTypes, BubbleSeries = _a.bubble, MapSeries = _a.map;
+var mapPointProto = SeriesRegistry.seriesTypes.map.prototype.pointClass.prototype;
+import U from '../../Core/Utilities.js';
+var extend = U.extend;
 /* *
  *
  *  Class
@@ -39,26 +41,22 @@ var _a = SeriesRegistry.seriesTypes, BubbleSeries = _a.bubble, MapSeries = _a.ma
 var MapBubblePoint = /** @class */ (function (_super) {
     __extends(MapBubblePoint, _super);
     function MapBubblePoint() {
-        /* *
-         *
-         *  Functions
-         *
-         * */
-        var _this = _super !== null && _super.apply(this, arguments) || this;
-        _this.applyOptions = MapSeries.prototype.pointClass.prototype.applyOptions;
-        _this.getProjectedBounds = MapPoint.prototype.getProjectedBounds;
-        return _this;
-        /* eslint-enable valid-jsdoc */
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    /* eslint-disable valid-jsdoc */
-    /**
-     * @private
-     */
+    /* *
+     *
+     *  Functions
+     *
+     * */
     MapBubblePoint.prototype.isValid = function () {
         return typeof this.z === 'number';
     };
     return MapBubblePoint;
-}(BubbleSeries.prototype.pointClass));
+}(BubblePoint));
+extend(MapBubblePoint.prototype, {
+    applyOptions: mapPointProto.applyOptions,
+    getProjectedBounds: mapPointProto.getProjectedBounds
+});
 /* *
  *
  *  Default Export

package/es-modules/Series/MapBubble/MapBubbleSeries.js

@@ -25,14 +25,10 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import BubbleSeries from '../Bubble/BubbleSeries.js';
 import MapBubblePoint from './MapBubblePoint.js';
-import MapSeries from '../Map/MapSeries.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
-var MapPointSeries = SeriesRegistry.seriesTypes.mappoint;
+var _a = SeriesRegistry.seriesTypes, mapProto = _a.map.prototype, mapPointProto = _a.mappoint.prototype;
 import U from '../../Core/Utilities.js';
 var extend = U.extend, merge = U.merge;
-import '../../Core/DefaultOptions.js';
-import '../Bubble/BubbleSeries.js';
-import '../Map/MapSeries.js';
 /* *
  *
  *  Class
@@ -44,10 +40,18 @@ import '../Map/MapSeries.js';
  * @name Highcharts.seriesTypes.mapbubble
  *
  * @augments Highcharts.Series
+ *
+ * @requires BubbleSeries
+ * @requires MapPointSeries
  */
 var MapBubbleSeries = /** @class */ (function (_super) {
     __extends(MapBubbleSeries, _super);
     function MapBubbleSeries() {
+        /* *
+         *
+         *  Static Properties
+         *
+         * */
         var _this = _super !== null && _super.apply(this, arguments) || this;
         /* *
          *
@@ -66,16 +70,10 @@ var MapBubbleSeries = /** @class */ (function (_super) {
         }, compareX, e);
     };
     MapBubbleSeries.prototype.translate = function () {
-        MapPointSeries.prototype.translate.call(this);
+        mapPointProto.translate.call(this);
         this.getRadii();
         this.translateBubble();
     };
-    /* *
-     *
-     *  Static Properties
-     *
-     * */
-    MapBubbleSeries.compose = BubbleSeries.compose;
     /**
      * A map bubble series is a bubble series laid out on top of a map
      * series, where each bubble is tied to a specific map area.
@@ -152,7 +150,6 @@ var MapBubbleSeries = /** @class */ (function (_super) {
          *
          * @product   highmaps
          * @apioption plotOptions.mapbubble.maxSize
-
          */
         /**
          * Minimum bubble size. Bubbles will automatically size between the
@@ -243,6 +240,9 @@ var MapBubbleSeries = /** @class */ (function (_super) {
          * @default   0
          * @apioption plotOptions.mapbubble.zThreshold
          */
+        /**
+         * @default 500
+         */
         animationLimit: 500,
         joinBy: 'hc-key',
         tooltip: {
@@ -254,16 +254,16 @@ var MapBubbleSeries = /** @class */ (function (_super) {
 extend(MapBubbleSeries.prototype, {
     type: 'mapbubble',
     axisTypes: ['colorAxis'],
-    getProjectedBounds: MapSeries.prototype.getProjectedBounds,
+    getProjectedBounds: mapProto.getProjectedBounds,
     isCartesian: false,
     // If one single value is passed, it is interpreted as z
     pointArrayMap: ['z'],
     pointClass: MapBubblePoint,
-    processData: MapSeries.prototype.processData,
-    projectPoint: MapPointSeries.prototype.projectPoint,
-    setData: MapSeries.prototype.setData,
-    setOptions: MapSeries.prototype.setOptions,
-    updateData: MapSeries.prototype.updateData,
+    processData: mapProto.processData,
+    projectPoint: mapPointProto.projectPoint,
+    setData: mapProto.setData,
+    setOptions: mapProto.setOptions,
+    updateData: mapProto.updateData,
     useMapGeometry: true,
     xyFromShape: true
 });