highcharts 13.0.0 → 13.0.2

package/es-modules/Extensions/Sonification/TimelineFromChart.js

@@ -16,7 +16,7 @@ import SonificationTimeline from './SonificationTimeline.js';
 import SonificationInstrument from './SonificationInstrument.js';
 import SonificationSpeaker from './SonificationSpeaker.js';
 import T from '../../Core/Templating.js';
-import { clamp, defined, extend, getNestedProperty, merge, pick } from '../../Shared/Utilities.js';
+import { clamp, defined, extend, getNestedProperty, merge } from '../../Shared/Utilities.js';
 const { format } = T;
 const isNoteDefinition = (str) => (/^([a-g][#b]?)[0-8]$/i).test(str);
 /**
@@ -219,8 +219,8 @@ function getMappingParameterValue(context, propMetrics, useSeriesExtremes, defau
     if (typeof mappingOptions === 'object') {
         mapTo = mappingOptions.mapTo;
         mapFunc = mappingOptions.mapFunction || mapFunc;
-        min = pick(mappingOptions.min, min);
-        max = pick(mappingOptions.max, max);
+        min = (mappingOptions.min ?? min);
+        max = (mappingOptions.max ?? max);
         within = mappingOptions.within || defaultMapping.within;
         scale = mappingOptions.scale;
     }
@@ -294,9 +294,9 @@ function getMappingParameterValue(context, propMetrics, useSeriesExtremes, defau
  * @internal
  */
 function getParamValWithDefault(context, propMetrics, useSeriesExtremes, mappingParamOptions, fallback, defaults, contextValueProp) {
-    return pick(getMappingParameterValue(context, propMetrics, useSeriesExtremes, extend({
+    return (getMappingParameterValue(context, propMetrics, useSeriesExtremes, extend({
         min: 0, max: 1, mapTo: 'y', mapFunction: 'linear', within: 'chart'
-    }, (defaults || {})), mappingParamOptions, contextValueProp), fallback);
+    }, (defaults || {})), mappingParamOptions, contextValueProp) ?? fallback);
 }
 /**
  * Get time value for a point event.
@@ -358,7 +358,7 @@ function addTimelineChannelFromTrack(timeline, audioContext, destinationNode, op
             synthPatch: options.instrument,
             midiTrackName: options.midiName
         });
-    return timeline.addChannel(options.type || 'instrument', engine, pick(options.showPlayMarker, true));
+    return timeline.addChannel(options.type || 'instrument', engine, (options.showPlayMarker ?? true));
 }
 /**
  * Add event from a point to a mapped instrument track.
@@ -474,8 +474,8 @@ function addMappedEventForPoint(context, channel, trackOptions, propMetrics) {
         }
     }
     else if (trackOptions.mapping) {
-        eventsAdded = addMappedInstrumentEvent(context, channel, trackOptions.mapping, propMetrics, pick(trackOptions
-            .roundToMusicalNotes, true));
+        eventsAdded = addMappedInstrumentEvent(context, channel, trackOptions.mapping, propMetrics, (trackOptions
+            .roundToMusicalNotes ?? true));
     }
     return eventsAdded;
 }
@@ -534,7 +534,7 @@ function isActive(context, activeWhen, lastPropValue) {
         return activeWhen(context);
     }
     if (typeof activeWhen === 'object') {
-        const prop = activeWhen.prop, val = pick(context.value, context.point && getPointPropValue(context.point, prop));
+        const prop = activeWhen.prop, val = context.value ?? (context.point && getPointPropValue(context.point, prop));
         if (typeof val !== 'number') {
             return false;
         }
@@ -551,7 +551,7 @@ function isActive(context, activeWhen, lastPropValue) {
                 hasLastValue && lastPropValue > crossingDown &&
                     val <= crossingDown);
         }
-        const max = pick(activeWhen.max, Infinity), min = pick(activeWhen.min, -Infinity);
+        const max = (activeWhen.max ?? Infinity), min = (activeWhen.min ?? -Infinity);
         return val <= max && val >= min && crossingOk;
     }
     return true;
@@ -703,7 +703,7 @@ function timelineFromChart(audioContext, destinationNode, chart) {
                         addMappedSpeechEvent({ time, value }, contextChannel, mergedOpts.mapping, propMetrics, valueProp);
                     }
                     else {
-                        addMappedInstrumentEvent({ time, value }, contextChannel, mergedOpts.mapping, propMetrics, pick(mergedOpts.roundToMusicalNotes, true), valueProp);
+                        addMappedInstrumentEvent({ time, value }, contextChannel, mergedOpts.mapping, propMetrics, (mergedOpts.roundToMusicalNotes ?? true), valueProp);
                     }
                 };
                 if (timeInterval) {

package/es-modules/Gantt/Legacy.js

@@ -11,7 +11,7 @@
  * */
 'use strict';
 import { error } from '../Core/Utilities.js';
-import { merge, pick } from '../Shared/Utilities.js';
+import { merge } from '../Shared/Utilities.js';
 /* *
  *
  *  Constants
@@ -68,7 +68,7 @@ function calculateObstacleMargin(obstacles) {
  */
 function distance(a, b, bbMargin) {
     // Count the distance even if we are slightly off
-    const margin = pick(bbMargin, 10), yOverlap = a.yMax + margin > b.yMin - margin &&
+    const margin = (bbMargin ?? 10), yOverlap = a.yMax + margin > b.yMin - margin &&
         a.yMin - margin < b.yMax + margin, xOverlap = a.xMax + margin > b.xMin - margin &&
         a.xMin - margin < b.xMax + margin, xDistance = yOverlap ? (a.xMin > b.xMax ? a.xMin - b.xMax : b.xMin - a.xMax) : Infinity, yDistance = xOverlap ? (a.yMin > b.yMax ? a.yMin - b.yMax : b.yMin - a.yMax) : Infinity;
     // If the rectangles collide, try recomputing with smaller margin.

package/es-modules/Gantt/Pathfinder.js

@@ -14,7 +14,7 @@ import Connection from './Connection.js';
 import PathfinderAlgorithms from './PathfinderAlgorithms.js';
 import PathfinderComposition from './PathfinderComposition.js';
 import Point from '../Core/Series/Point.js';
-import { addEvent, defined, pick, splat } from '../Shared/Utilities.js';
+import { addEvent, defined, splat } from '../Shared/Utilities.js';
 /* *
  *
  *  Constants
@@ -65,7 +65,7 @@ function getPointBB(point) {
  */
 function calculateObstacleDistance(a, b, bbMargin) {
     // Count the distance even if we are slightly off
-    const margin = pick(bbMargin, 10), yOverlap = a.yMax + margin > b.yMin - margin &&
+    const margin = (bbMargin ?? 10), yOverlap = a.yMax + margin > b.yMin - margin &&
         a.yMin - margin < b.yMax + margin, xOverlap = a.xMax + margin > b.xMin - margin &&
         a.xMin - margin < b.xMax + margin, xDistance = yOverlap ? (a.xMin > b.xMax ? a.xMin - b.xMax : b.xMin - a.xMax) : Infinity, yDistance = xOverlap ? (a.yMin > b.yMax ? a.yMin - b.yMax : b.yMin - a.yMax) : Infinity;
     // If the rectangles collide, try recomputing with smaller margin.
@@ -310,7 +310,7 @@ class Pathfinder {
      * with xMin, xMax, yMin and yMax properties.
      */
     getChartObstacles(options) {
-        const series = this.chart.series, margin = pick(options.algorithmMargin, 0);
+        const series = this.chart.series, margin = (options.algorithmMargin ?? 0);
         let obstacles = [], calculatedMargin;
         for (let i = 0, sLen = series.length; i < sLen; ++i) {
             if (series[i].visible && !series[i].options.isInternal) {

package/es-modules/Gantt/PathfinderAlgorithms.js

@@ -11,7 +11,6 @@
  * */
 'use strict';
 import PathUtilities from '../Series/PathUtilities.js';
-import { pick } from '../Shared/Utilities.js';
 /* *
  *
  *  Constants
@@ -208,7 +207,8 @@ function straight(start, end) {
  */
 const simpleConnect = function (start, end, options) {
     const segments = [], chartObstacles = options.chartObstacles, startObstacleIx = findObstacleFromPoint(chartObstacles, start), endObstacleIx = findObstacleFromPoint(chartObstacles, end);
-    let endSegment, dir = pick(options.startDirectionX, abs(end.x - start.x) > abs(end.y - start.y)) ? 'x' : 'y', startObstacle, endObstacle, waypoint, useMax, endPoint;
+    let endSegment, dir = (options.startDirectionX ??
+        (abs(end.x - start.x) > abs(end.y - start.y))) ? 'x' : 'y', startObstacle, endObstacle, waypoint, useMax, endPoint;
     // eslint-disable-next-line valid-jsdoc
     /**
      * Return a clone of a point with a property set from a target object,
@@ -350,7 +350,8 @@ function fastAvoid(start, end, options) {
             - When going around the end obstacle we should not always go the
                 shortest route, rather pick the one closer to the end point
     */
-    const dirIsX = pick(options.startDirectionX, abs(end.x - start.x) > abs(end.y - start.y)), dir = dirIsX ? 'x' : 'y', endSegments = [], 
+    const dirIsX = options.startDirectionX ??
+        (abs(end.x - start.x) > abs(end.y - start.y)), dir = dirIsX ? 'x' : 'y', endSegments = [], 
     // Boundaries to stay within. If beyond soft boundary, prefer to
     // change direction ASAP. If at hard max, always change immediately.
     metrics = options.obstacleMetrics, softMinX = min(start.x, end.x) - metrics.maxWidth - 10, softMaxX = max(start.x, end.x) + metrics.maxWidth + 10, softMinY = min(start.y, end.y) - metrics.maxHeight - 10, softMaxY = max(start.y, end.y) + metrics.maxHeight + 10;

package/es-modules/Gantt/Tree.js

@@ -74,7 +74,7 @@ function getNode(id, parent, level, data, mapOfIdToChildren, options) {
     }
     // Call getNode recursively on the children. Calculate the height of the
     // node, and the number of descendants.
-    const children = ((mapOfIdToChildren[id] || [])).map((child) => {
+    const children = (mapOfIdToChildren[id] || []).map((child) => {
         const node = getNode(child.id, id, (level + 1), child, mapOfIdToChildren, options), childStart = child.start || NaN, childEnd = (child.milestone === true ?
             childStart :
             child.end ||

package/es-modules/Maps/GeoJSONComposition.js

@@ -549,4 +549,17 @@ export default GeoJSONComposition;
 * Second point's Y of the bounding box.
 * @name Highcharts.MapBounds#y2
 */
-''; // Detach doclets above
+/**
+ * A latitude/longitude object.
+ *
+ * @interface Highcharts.MapLonLatObject
+ */ /**
+* The latitude.
+* @name Highcharts.MapLonLatObject#lat
+* @type {number}
+*/ /**
+* The longitude.
+* @name Highcharts.MapLonLatObject#lon
+* @type {number}
+*/
+''; // Keep doclets above

package/es-modules/Maps/MapNavigation.js

@@ -17,7 +17,7 @@ const { composed } = H;
 import MapNavigationDefaults from './MapNavigationDefaults.js';
 import MapPointer from './MapPointer.js';
 import MapSymbols from './MapSymbols.js';
-import { extend, objectEach, merge, pick, pushUnique, addEvent } from '../Shared/Utilities.js';
+import { extend, objectEach, merge, pushUnique, addEvent } from '../Shared/Utilities.js';
 /* *
  *
  *  Functions
@@ -107,7 +107,7 @@ class MapNavigation {
             navButtons.pop()?.destroy();
         }
         if (!chart.renderer.forExport &&
-            pick(navOptions.enableButtons, navOptions.enabled)) {
+            (navOptions.enableButtons ?? navOptions.enabled)) {
             if (!mapNav.navButtonsGroup) {
                 mapNav.navButtonsGroup = chart.renderer.g()
                     .attr({
@@ -238,7 +238,7 @@ class MapNavigation {
     updateEvents(options) {
         const chart = this.chart;
         // Add the double click event
-        if (pick(options.enableDoubleClickZoom, options.enabled) ||
+        if ((options.enableDoubleClickZoom ?? options.enabled) ||
             options.enableDoubleClickZoomTo) {
             this.unbindDblClick = this.unbindDblClick || addEvent(chart.container, 'dblclick', function (e) {
                 chart.pointer.onContainerDblClick(e);
@@ -249,7 +249,7 @@ class MapNavigation {
             this.unbindDblClick = this.unbindDblClick();
         }
         // Add the mousewheel event
-        if (pick(options.enableMouseWheelZoom, options.enabled)) {
+        if (options.enableMouseWheelZoom ?? options.enabled) {
             this.unbindMouseWheel = this.unbindMouseWheel || addEvent(chart.container, 'wheel', function (e) {
                 // Prevent scrolling when the pointer is over the element
                 // with that class, for example annotation popup #12100.

package/es-modules/Maps/MapPointer.js

@@ -10,7 +10,7 @@
  *
  * */
 'use strict';
-import { defined, extend, internalClearTimeout, pick, wrap } from '../Shared/Utilities.js';
+import { defined, extend, internalClearTimeout, wrap } from '../Shared/Utilities.js';
 /* *
  *
  *  Composition
@@ -124,7 +124,7 @@ var MapPointer;
         const mapNavigation = this.chart.options.mapNavigation;
         // Pinch status
         if (mapNavigation &&
-            pick(mapNavigation.enableTouchZoom, mapNavigation.enabled)) {
+            (mapNavigation.enableTouchZoom ?? mapNavigation.enabled)) {
             this.chart.zooming.pinchType = 'xy';
         }
         proceed.apply(this, [].slice.call(arguments, 1));

package/es-modules/Maps/MapView.js

@@ -20,7 +20,7 @@ const { topo2geo } = GeoJSONComposition;
 import MU from './MapUtilities.js';
 const { boundsFromPath } = MU;
 import Projection from './Projection.js';
-import { addEvent, clamp, crisp, fireEvent, isArray, isNumber, isObject, isString, merge, pick, pushUnique, relativeLength } from '../Shared/Utilities.js';
+import { addEvent, clamp, crisp, fireEvent, isArray, isNumber, isObject, isString, merge, pushUnique, relativeLength } from '../Shared/Utilities.js';
 /* *
  *
  *  Constants
@@ -207,7 +207,7 @@ class MapView {
          * The current center of the view in terms of `[longitude, latitude]`.
          * @name Highcharts.MapView#center
          * @readonly
-         * @type {LonLatArray}
+         * @type {Highcharts.LonLatArray}
          */
         this.center = o.center;
         this.options = o;
@@ -283,7 +283,7 @@ class MapView {
     fitToBounds(bounds, padding, redraw = true, animation) {
         const b = bounds || this.getProjectedBounds();
         if (b) {
-            const pad = pick(padding, bounds ? 0 : this.options.padding), fullField = this.getField(false), padArr = isArray(pad) ? pad : [pad, pad, pad, pad];
+            const pad = padding ?? (bounds ? 0 : this.options.padding), fullField = this.getField(false), padArr = isArray(pad) ? pad : [pad, pad, pad, pad];
             this.padding = [
                 relativeLength(padArr[0], fullField.height),
                 relativeLength(padArr[1], fullField.width),

package/es-modules/Series/ArcDiagram/ArcDiagramSeries.js

@@ -20,7 +20,7 @@ import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 import SVGRenderer from '../../Core/Renderer/SVG/SVGRenderer.js';
 import SVGElement from '../../Core/Renderer/SVG/SVGElement.js';
 import { composeTextPath } from '../../Extensions/TextPath.js';
-import { crisp, extend, merge, pick, relativeLength } from '../../Shared/Utilities.js';
+import { crisp, extend, merge, relativeLength } from '../../Shared/Utilities.js';
 composeTextPath(SVGElement);
 const { prototype: { symbols } } = SVGRenderer;
 const { seriesTypes: { column: ColumnSeries, sankey: SankeySeries } } = SeriesRegistry;
@@ -137,9 +137,11 @@ class ArcDiagramSeries extends SankeySeries {
      * @internal
      */
     translateLink(point) {
-        const series = this, fromNode = point.fromNode, toNode = point.toNode, chart = this.chart, translationFactor = series.translationFactor, pointOptions = point.options, seriesOptions = series.options, linkWeight = pick(pointOptions.linkWeight, seriesOptions.linkWeight, Math.max((point.weight || 0) *
-            translationFactor *
-            fromNode.scale, (series.options.minLinkWidth || 0))), centeredLinks = point.series.options.centeredLinks, nodeTop = fromNode.nodeY;
+        const series = this, fromNode = point.fromNode, toNode = point.toNode, chart = this.chart, translationFactor = series.translationFactor, pointOptions = point.options, seriesOptions = series.options, linkWeight = (pointOptions.linkWeight ??
+            seriesOptions.linkWeight ??
+            Math.max((point.weight || 0) *
+                translationFactor *
+                fromNode.scale, series.options.minLinkWidth || 0)), centeredLinks = point.series.options.centeredLinks, nodeTop = fromNode.nodeY;
         const getX = (node, fromOrTo) => {
             const linkLeft = ((node.offset(point, fromOrTo) || 0) *
                 translationFactor);
@@ -168,7 +170,7 @@ class ArcDiagramSeries extends SankeySeries {
             toX,
             toX + linkWeight
         ];
-        const linkRadius = ((toX + linkWeight - fromX) / Math.abs(toX + linkWeight - fromX)) * pick(seriesOptions.linkRadius, Math.min(Math.abs(toX + linkWeight - fromX) / 2, fromNode.nodeY - Math.abs(linkWeight)));
+        const linkRadius = ((toX + linkWeight - fromX) / Math.abs(toX + linkWeight - fromX)) * (seriesOptions.linkRadius ?? Math.min(Math.abs(toX + linkWeight - fromX) / 2, fromNode.nodeY - Math.abs(linkWeight)));
         point.shapeArgs = {
             d: [
                 ['M', fromX, bottom],
@@ -225,7 +227,7 @@ class ArcDiagramSeries extends SankeySeries {
         const series = this, translationFactor = series.translationFactor, chart = series.chart, maxNodesLength = chart.inverted ?
             chart.plotWidth : chart.plotHeight, options = series.options, maxRadius = Math.min(chart.plotWidth, chart.plotHeight, maxNodesLength / node.series.nodes.length - this.nodePadding), sum = node.getSum() * (column.sankeyColumn.scale || 0), equalNodes = options.equalNodes, nodeHeight = equalNodes ?
             maxRadius :
-            Math.max(sum * translationFactor, this.options.minLinkWidth || 0), lineWidth = options.marker?.lineWidth || 0, nodeOffset = column.sankeyColumn.offset(node, translationFactor), fromNodeLeft = crisp(pick(nodeOffset && nodeOffset.absoluteLeft, ((column.sankeyColumn.left(translationFactor) || 0) +
+            Math.max(sum * translationFactor, this.options.minLinkWidth || 0), lineWidth = options.marker?.lineWidth || 0, nodeOffset = column.sankeyColumn.offset(node, translationFactor), fromNodeLeft = crisp(((nodeOffset && nodeOffset.absoluteLeft) ?? ((column.sankeyColumn.left(translationFactor) || 0) +
             (nodeOffset && nodeOffset.relativeLeft || 0))), lineWidth), markerOptions = merge(options.marker, node.options.marker), symbol = markerOptions.symbol, markerRadius = markerOptions.radius, top = parseInt(options.offset ?? '100', 10) *
             ((chart.inverted ?
                 chart.plotWidth : chart.plotHeight) - (crisp(this.colDistance * (node.column || 0) +

package/es-modules/Series/Area/AreaSeries.js

@@ -13,7 +13,7 @@
 import AreaSeriesDefaults from './AreaSeriesDefaults.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 const { seriesTypes: { line: LineSeries } } = SeriesRegistry;
-import { defined, extend, merge, objectEach, pick } from '../../Shared/Utilities.js';
+import { defined, extend, merge, objectEach } from '../../Shared/Utilities.js';
 /* *
  *
  *  Class
@@ -100,8 +100,7 @@ class AreaSeries extends LineSeries {
      */
     getGraphPath(points) {
         const getGraphPath = LineSeries.prototype.getGraphPath, options = this.options, stacking = options.stacking, yAxis = this.yAxis, bottomPoints = [], graphPoints = [], seriesIndex = this.index, stacks = yAxis.stacking.stacks[this.stackKey], threshold = options.threshold, translatedThreshold = Math.round(// #10909
-        yAxis.getThreshold(options.threshold)), connectNulls = pick(// #10574
-        options.connectNulls, stacking === 'percent'), 
+        yAxis.getThreshold(options.threshold)), connectNulls = (options.connectNulls ?? stacking === 'percent'), 
         // To display null points in underlying stacked series, this
         // series graph must be broken, and the area also fall down to
         // fill the gap left by the null point. #2069
@@ -154,9 +153,9 @@ class AreaSeries extends LineSeries {
             // Treat points with undefined plotY as null (e.g. non-positive
             // values on logarithmic axis, #18422)
             isNull = points[i].isNull || !defined(points[i].plotY);
-            plotX = pick(points[i].rectPlotX, points[i].plotX);
+            plotX = (points[i].rectPlotX ?? points[i].plotX);
             yBottom = stacking ?
-                pick(points[i].yBottom, translatedThreshold) :
+                (points[i].yBottom ?? translatedThreshold) :
                 translatedThreshold;
             if (!isNull || connectNulls) {
                 if (!connectNulls) {