highcharts 9.3.3 → 10.0.0

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

@@ -25,6 +25,8 @@ import BubbleSeries from '../Bubble/BubbleSeries.js';
 import MapBubblePoint from './MapBubblePoint.js';
 import MapSeries from '../Map/MapSeries.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
+import H from '../../Core/Globals.js';
+var noop = H.noop;
 var MapPointSeries = SeriesRegistry.seriesTypes.mappoint;
 import U from '../../Core/Utilities.js';
 var extend = U.extend, merge = U.merge;
@@ -57,6 +59,12 @@ var MapBubbleSeries = /** @class */ (function (_super) {
         _this.points = void 0;
         return _this;
     }
+    MapBubbleSeries.prototype.searchPoint = function (e, compareX) {
+        return this.searchKDTree({
+            clientX: e.chartX - this.chart.plotLeft,
+            plotY: e.chartY - this.chart.plotTop
+        }, compareX, e);
+    };
     MapBubbleSeries.prototype.translate = function () {
         MapPointSeries.prototype.translate.call(this);
         this.getRadii();
@@ -189,6 +197,7 @@ var MapBubbleSeries = /** @class */ (function (_super) {
          * @apioption plotOptions.mapbubble.zThreshold
          */
         animationLimit: 500,
+        joinBy: 'hc-key',
         tooltip: {
             pointFormat: '{point.name}: {point.z}'
         }
@@ -203,6 +212,8 @@ extend(MapBubbleSeries.prototype, {
     // 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,
     useMapGeometry: true,

package/es-modules/Series/MapPoint/MapPointPoint.js

@@ -50,16 +50,10 @@ var MapPointPoint = /** @class */ (function (_super) {
      *
      * */
     /* eslint-disable valid-jsdoc */
-    MapPointPoint.prototype.applyOptions = function (options, x) {
-        var mergedOptions = (typeof options.lat !== 'undefined' &&
-            typeof options.lon !== 'undefined' ?
-            merge(options, this.series.chart.fromLatLonToPoint(options)) :
-            options);
-        return _super.prototype.applyOptions.call(this, mergedOptions, x);
-    };
     MapPointPoint.prototype.isValid = function () {
         return Boolean(this.options.geometry ||
-            (isNumber(this.x) && isNumber(this.y)));
+            (isNumber(this.x) && isNumber(this.y)) ||
+            (isNumber(this.options.lon) && isNumber(this.options.lat)));
     };
     return MapPointPoint;
 }(ScatterSeries.prototype.pointClass));

package/es-modules/Series/MapPoint/MapPointSeries.js

@@ -56,6 +56,7 @@ var MapPointSeries = /** @class */ (function (_super) {
          *  Properties
          *
          * */
+        _this.chart = void 0;
         _this.data = void 0;
         _this.options = void 0;
         _this.points = void 0;
@@ -74,6 +75,30 @@ var MapPointSeries = /** @class */ (function (_super) {
             this.dataLabelsGroup.clip(this.chart.clipRect);
         }
     };
+    /**
+     * Resolve `lon`, `lat` or `geometry` options and project the resulted
+     * coordinates.
+     *
+     * @private
+     */
+    MapPointSeries.prototype.projectPoint = function (pointOptions) {
+        var mapView = this.chart.mapView;
+        if (mapView) {
+            var geometry = pointOptions.geometry, lon = pointOptions.lon, lat = pointOptions.lat;
+            var coordinates = (geometry &&
+                geometry.type === 'Point' &&
+                geometry.coordinates);
+            if (isNumber(lon) && isNumber(lat)) {
+                coordinates = [lon, lat];
+            }
+            if (coordinates) {
+                return mapView.lonLatToProjectedUnits({
+                    lon: coordinates[0],
+                    lat: coordinates[1]
+                });
+            }
+        }
+    };
     MapPointSeries.prototype.translate = function () {
         var _this = this;
         var mapView = this.chart.mapView;
@@ -83,16 +108,13 @@ var MapPointSeries = /** @class */ (function (_super) {
         this.generatePoints();
         // Create map based translation
         if (mapView) {
-            var _a = mapView.projection, forward_1 = _a.forward, hasCoordinates_1 = _a.hasCoordinates;
+            var hasCoordinates_1 = mapView.projection.hasCoordinates;
             this.points.forEach(function (p) {
                 var _a = p.x, x = _a === void 0 ? void 0 : _a, _b = p.y, y = _b === void 0 ? void 0 : _b;
-                var geometry = p.options.geometry, coordinates = (geometry &&
-                    geometry.type === 'Point' &&
-                    geometry.coordinates);
-                if (coordinates) {
-                    var xy = forward_1(coordinates);
-                    x = xy[0];
-                    y = xy[1];
+                var xy = _this.projectPoint(p.options);
+                if (xy) {
+                    x = xy.x;
+                    y = xy.y;
                     // Map bubbles getting geometry from shape
                 }
                 else if (p.bounds) {
@@ -100,6 +122,7 @@ var MapPointSeries = /** @class */ (function (_super) {
                     y = p.bounds.midY;
                 }
                 if (isNumber(x) && isNumber(y)) {
+                    // Establish plotX and plotY
                     var plotCoords = mapView.projectedUnitsToPixels({ x: x, y: y });
                     p.plotX = plotCoords.x;
                     p.plotY = hasCoordinates_1 ?
@@ -107,8 +130,7 @@ var MapPointSeries = /** @class */ (function (_super) {
                         _this.chart.plotHeight - plotCoords.y;
                 }
                 else {
-                    p.plotX = void 0;
-                    p.plotY = void 0;
+                    p.y = p.plotX = p.plotY = void 0;
                 }
                 p.isInside = _this.isPointInside(p);
                 // Find point zone
@@ -287,9 +309,9 @@ export default MapPointSeries;
  * @apioption series.mappoint.data.lon
  */
 /**
- * The x coordinate of the point in terms of the map path coordinates.
+ * The x coordinate of the point in terms of projected units.
  *
- * @sample {highmaps} maps/demo/mapline-mappoint/
+ * @sample {highmaps} maps/series/mapline-mappoint-path-xy/
  *         Map point demo
  *
  * @type      {number}
@@ -297,9 +319,9 @@ export default MapPointSeries;
  * @apioption series.mappoint.data.x
  */
 /**
- * The x coordinate of the point in terms of the map path coordinates.
+ * The x coordinate of the point in terms of projected units.
  *
- * @sample {highmaps} maps/demo/mapline-mappoint/
+ * @sample {highmaps} maps/series/mapline-mappoint-path-xy/
  *         Map point demo
  *
  * @type      {number|null}

package/es-modules/Series/NodesComposition.js

@@ -7,7 +7,7 @@
 import Point from '../Core/Series/Point.js';
 import Series from '../Core/Series/Series.js';
 import U from '../Core/Utilities.js';
-var defined = U.defined, extend = U.extend, find = U.find, pick = U.pick;
+var defined = U.defined, extend = U.extend, find = U.find, merge = U.merge, pick = U.pick;
 /* *
  *
  *  Composition
@@ -41,6 +41,7 @@ var NodesComposition;
             var pointProto = PointClass.prototype;
             pointProto.setNodeState = setNodeState;
             pointProto.setState = setNodeState;
+            pointProto.update = updateNode;
         }
         if (composedClasses.indexOf(SeriesClass) === -1) {
             composedClasses.push(SeriesClass);
@@ -69,17 +70,6 @@ var NodesComposition;
             }, options));
             node.linksTo = [];
             node.linksFrom = [];
-            node.formatPrefix = 'node';
-            // for use in formats
-            node.name = node.name || node.options.id || '';
-            // Mass is used in networkgraph:
-            node.mass = pick(
-            // Node:
-            node.options.mass, node.options.marker && node.options.marker.radius, 
-            // Series:
-            this.options.marker && this.options.marker.radius, 
-            // Default:
-            4);
             /**
              * Return the largest sum of either the incoming or outgoing links.
              * @private
@@ -119,8 +109,19 @@ var NodesComposition;
                 return (!node.linksTo.length ||
                     outgoing !== node.linksTo.length);
             };
-            this.nodes.push(node);
+            node.index = this.nodes.push(node) - 1;
         }
+        node.formatPrefix = 'node';
+        // for use in formats
+        node.name = node.name || node.options.id || '';
+        // Mass is used in networkgraph:
+        node.mass = pick(
+        // Node:
+        node.options.mass, node.options.marker && node.options.marker.radius, 
+        // Series:
+        this.options.marker && this.options.marker.radius, 
+        // Default:
+        4);
         return node;
     }
     NodesComposition.createNode = createNode;
@@ -220,6 +221,52 @@ var NodesComposition;
         Point.prototype.setState.apply(this, args);
     }
     NodesComposition.setNodeState = setNodeState;
+    /**
+     * When updating a node, don't update `series.options.data`, but `series.options.nodes`
+     */
+    function updateNode(options, redraw, animation, runEvent) {
+        var _this = this;
+        var nodes = this.series.options.nodes, data = this.series.options.data, dataLength = data && data.length || 0, linkConfig = data && data[this.index];
+        Point.prototype.update.call(this, options, this.isNode ? false : redraw, // Hold the redraw for nodes
+        animation, runEvent);
+        if (this.isNode) {
+            // this.index refers to `series.nodes`, not `options.nodes` array
+            var nodeIndex = (nodes || [])
+                .reduce(// Array.findIndex needs a polyfill
+            function (prevIndex, n, index) {
+                return (_this.id === n.id ? index : prevIndex);
+            }, -1), 
+            // Merge old config with new config. New config is stored in
+            // options.data, because of default logic in point.update()
+            nodeConfig = merge(nodes && nodes[nodeIndex] || {}, data && data[this.index] || {});
+            // Restore link config
+            if (data) {
+                if (linkConfig) {
+                    data[this.index] = linkConfig;
+                }
+                else {
+                    // Remove node from config if there's more nodes than links
+                    data.length = dataLength;
+                }
+            }
+            // Set node config
+            if (nodes) {
+                if (nodeIndex >= 0) {
+                    nodes[nodeIndex] = nodeConfig;
+                }
+                else {
+                    nodes.push(nodeConfig);
+                }
+            }
+            else {
+                this.series.options.nodes = [nodeConfig];
+            }
+            if (pick(redraw, true)) {
+                this.series.chart.redraw(animation);
+            }
+        }
+    }
+    NodesComposition.updateNode = updateNode;
 })(NodesComposition || (NodesComposition = {}));
 /* *
  *

package/es-modules/Series/OHLC/OHLCSeries.js

@@ -244,6 +244,13 @@ addEvent(Series, 'afterSetOptions', function (e) {
  * @product   highstock
  * @apioption series.ohlc.data
  */
+/**
+ * The closing value of each data point.
+ *
+ * @type      {number}
+ * @product   highstock
+ * @apioption series.ohlc.data.close
+ */
 /**
  * The opening value of each data point.
  *

package/es-modules/Series/Organization/OrganizationPoint.js

@@ -24,7 +24,30 @@ var __extends = (this && this.__extends) || (function () {
     };
 })();
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
-var SankeyPoint = SeriesRegistry.seriesTypes.sankey.prototype.pointClass;
+var SankeyPointClass = SeriesRegistry.seriesTypes.sankey.prototype.pointClass;
+import U from '../../Core/Utilities.js';
+var defined = U.defined, find = U.find, pick = U.pick;
+/**
+ * Get columns offset including all sibiling and cousins etc.
+ *
+ * @private
+ * @param node Point
+ */
+function getOffset(node) {
+    var offset = node.linksFrom.length;
+    node.linksFrom.forEach(function (link) {
+        if (link.id === link.toNode.linksTo[0].id) {
+            // Node has children, that hangs directly from it:
+            offset += getOffset(link.toNode);
+        }
+        else {
+            // If the node hangs from multiple parents, and this is not
+            // the last one, ignore it:
+            offset--;
+        }
+    });
+    return offset;
+}
 /* *
  *
  *  Class
@@ -61,8 +84,51 @@ var OrganizationPoint = /** @class */ (function (_super) {
     OrganizationPoint.prototype.getSum = function () {
         return 1;
     };
+    /**
+     * Set node.column for hanging layout
+     * @private
+     */
+    OrganizationPoint.prototype.setNodeColumn = function () {
+        _super.prototype.setNodeColumn.call(this);
+        var node = this, fromNode = node.getFromNode().fromNode;
+        // Hanging layout
+        if (
+        // Not defined by user
+        !defined(node.options.column) &&
+            // Has links to
+            node.linksTo.length !== 0 &&
+            // And parent uses hanging layout
+            fromNode &&
+            fromNode.options.layout === 'hanging') {
+            // Default all children of the hanging node
+            // to have hanging layout
+            node.options.layout = pick(node.options.layout, 'hanging');
+            node.hangsFrom = fromNode;
+            var i_1 = -1;
+            find(fromNode.linksFrom, function (link, index) {
+                var found = link.toNode === node;
+                if (found) {
+                    i_1 = index;
+                }
+                return found;
+            });
+            // For all siblings' children (recursively)
+            // increase the column offset to prevent overlapping
+            for (var j = 0; j < fromNode.linksFrom.length; j++) {
+                var link = fromNode.linksFrom[j];
+                if (link.toNode.id === node.id) {
+                    // Break
+                    j = fromNode.linksFrom.length;
+                }
+                else {
+                    i_1 += getOffset(link.toNode);
+                }
+            }
+            node.column = (node.column || 0) + i_1;
+        }
+    };
     return OrganizationPoint;
-}(SankeyPoint));
+}(SankeyPointClass));
 /* *
  *
  *  Default Export

package/es-modules/Series/Organization/OrganizationSeries.js

@@ -178,23 +178,6 @@ var OrganizationSeries = /** @class */ (function (_super) {
         };
         return node;
     };
-    OrganizationSeries.prototype.createNodeColumn = function () {
-        var column = _super.prototype.createNodeColumn
-            .call(this);
-        // Wrap the offset function so that the hanging node's children are
-        // aligned to their parent
-        wrap(column, 'offset', function (proceed, node, factor) {
-            var offset = proceed.call(this, node, factor); // eslint-disable-line no-invalid-this
-            // Modify the default output if the parent's layout is 'hanging'
-            if (node.hangsFrom) {
-                return {
-                    absoluteTop: node.hangsFrom.nodeY
-                };
-            }
-            return offset;
-        });
-        return column;
-    };
     OrganizationSeries.prototype.pointAttribs = function (point, state) {
         var series = this, attribs = SankeySeries.prototype.pointAttribs.call(series, point, state), level = point.isNode ? point.level : point.fromNode.level, levelOptions = series.mapOptionsToLevel[level || 0] || {}, options = point.options, stateOptions = (levelOptions.states &&
             levelOptions.states[state]) || {}, values = ['borderRadius', 'linkColor', 'linkLineWidth']
@@ -265,16 +248,37 @@ var OrganizationSeries = /** @class */ (function (_super) {
     };
     OrganizationSeries.prototype.translateNode = function (node, column) {
         SankeySeries.prototype.translateNode.call(this, node, column);
-        if (node.hangsFrom) {
-            node.shapeArgs.height -=
-                this.options.hangingIndent;
-            if (!this.chart.inverted) {
-                node.shapeArgs.y += this.options.hangingIndent;
+        var parentNode = node.hangsFrom, indent = this.options.hangingIndent || 0, sign = this.chart.inverted ? -1 : 1, shapeArgs = node.shapeArgs, indentLogic = this.options.hangingIndentTranslation, minLength = this.options.minNodeLength || 10;
+        if (parentNode) {
+            if (indentLogic === 'cumulative') {
+                // Move to the right:
+                shapeArgs.height -= indent;
+                shapeArgs.y -= sign * indent;
+                while (parentNode) {
+                    shapeArgs.y += sign * indent;
+                    parentNode = parentNode.hangsFrom;
+                }
+            }
+            else if (indentLogic === 'shrink') {
+                // Resize the node:
+                while (parentNode &&
+                    shapeArgs.height > indent + minLength) {
+                    shapeArgs.height -= indent;
+                    parentNode = parentNode.hangsFrom;
+                }
+            }
+            else {
+                // indentLogic === "inherit"
+                // Do nothing (v9.3.2 and prev versions):
+                shapeArgs.height -= indent;
+                if (!this.chart.inverted) {
+                    shapeArgs.y += indent;
+                }
             }
         }
         node.nodeHeight = this.chart.inverted ?
-            node.shapeArgs.width :
-            node.shapeArgs.height;
+            shapeArgs.width :
+            shapeArgs.height;
     };
     /**
      * An organization chart is a diagram that shows the structure of an
@@ -428,6 +432,31 @@ var OrganizationSeries = /** @class */ (function (_super) {
          * @private
          */
         hangingIndent: 20,
+        /**
+         * Defines the indentation of a `hanging` layout parent's children.
+         * Possible options:
+         *
+         * - `inherit` (default): Only the first child adds the indentation,
+         * children of a child with indentation inherit the indentation.
+         * - `cumulative`: All children of a child with indentation add its
+         * own indent. The option may cause overlapping of nodes.
+         * Then use `shrink` option:
+         * - `shrink`: Nodes shrink by the
+         * [hangingIndent](#plotOptions.organization.hangingIndent)
+         * value until they reach the
+         * [minNodeLength](#plotOptions.organization.minNodeLength).
+         *
+         * @sample highcharts/series-organization/hanging-cumulative
+         *         Every indent increases the indentation
+         *
+         * @sample highcharts/series-organization/hanging-shrink
+         *         Every indent decreases the nodes' width
+         *
+         * @type {Highcharts.OrganizationHangingIndentTranslationValue}
+         * @since 10.0.0
+         * @default inherit
+         */
+        hangingIndentTranslation: 'inherit',
         /**
          * The color of the links between nodes.
          *
@@ -445,10 +474,25 @@ var OrganizationSeries = /** @class */ (function (_super) {
          */
         linkLineWidth: 1,
         /**
-         * In a horizontal chart, the width of the nodes in pixels. Node that
+         * In a horizontal chart, the minimum width of the **hanging** nodes
+         * only, in pixels. In a vertical chart, the minimum height of the
+         * **haning** nodes only, in pixels too.
+         *
+         * Note: Used only when
+         * [hangingIndentTranslation](#plotOptions.organization.hangingIndentTranslation)
+         * is set to `shrink`.
+         *
+         * @see [nodeWidth](#plotOptions.organization.nodeWidth)
+         * @private
+         */
+        minNodeLength: 10,
+        /**
+         * In a horizontal chart, the width of the nodes in pixels. Note that
          * most organization charts are vertical, so the name of this option
          * is counterintuitive.
          *
+         * @see [minNodeLength](#plotOptions.organization.minNodeLength)
+         *
          * @private
          */
         nodeWidth: 50,
@@ -480,6 +524,13 @@ export default OrganizationSeries;
  *
  * @typedef {"normal"|"hanging"} Highcharts.SeriesOrganizationNodesLayoutValue
  */
+/**
+ * Indent translation value for the child nodes in an organization chart, when
+ * parent has `hanging` layout. Option can shrink nodes (for tight charts),
+ * translate children to the left, or render nodes directly under the parent.
+ *
+ * @typedef {"inherit"|"cumulative"|"shrink"} Highcharts.OrganizationHangingIndentTranslationValue
+ */
 ''; // detach doclets above
 /* *
  *
@@ -546,6 +597,9 @@ export default OrganizationSeries;
  * Layout for the node's children. If `hanging`, this node's children will hang
  * below their parent, allowing a tighter packing of nodes in the diagram.
  *
+ * Note: Since @next version, the `hanging` layout is set by default for
+ * children of a parent using `hanging` layout.
+ *
  * @sample highcharts/demo/organization-chart
  *         Hanging layout
  *

package/es-modules/Series/Pie/PiePoint.js

@@ -118,12 +118,19 @@ var PiePoint = /** @class */ (function (_super) {
         return isNumber(this.y) && this.y >= 0;
     };
     /**
-     * Toggle the visibility of the pie slice.
-     * @private
+     * Toggle the visibility of a pie slice or other data point. Note that this
+     * method is available only for some series, like pie, treemap and sunburst.
+     *
+     * @function Highcharts.Point#setVisible
+     *
+     * @param {boolean} [vis]
+     * True to show the pie slice or other data point, false to hide. If
+     * undefined, the visibility is toggled.
+     *
+     * @param {boolean} [redraw] Whether to redraw the chart after the point is
+     * altered. If doing more operations on the chart, it is a good idea to set
+     * redraw to false and call {@link Chart#redraw|chart.redraw()} after.
      *
-     * @param {boolean} vis
-     * Whether to show the slice or not. If undefined, the visibility is
-     * toggled.
      */
     PiePoint.prototype.setVisible = function (vis, redraw) {
         var _this = this;

package/es-modules/Series/Pie3D/Pie3DSeries.js

@@ -171,6 +171,25 @@ var Pie3DSeries = /** @class */ (function (_super) {
             };
         });
     };
+    /**
+     * @private
+     */
+    Pie3DSeries.prototype.drawTracker = function () {
+        _super.prototype.drawTracker.apply(this, arguments);
+        // Do not do this if the chart is not 3D
+        if (!this.chart.is3d()) {
+            return;
+        }
+        this.points.forEach(function (point) {
+            if (point.graphic) {
+                ['out', 'inn', 'side1', 'side2'].forEach(function (face) {
+                    if (point.graphic) {
+                        point.graphic[face].element.point = point;
+                    }
+                });
+            }
+        });
+    };
     return Pie3DSeries;
 }(PieSeries));
 extend(Pie3DSeries.prototype, {