highcharts 13.0.0 → 13.0.2

package/es-modules/Series/Treegraph/TreegraphLink.js

@@ -12,7 +12,7 @@
 'use strict';
 import Point from '../../Core/Series/Point.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
-import { extend, pick } from '../../Shared/Utilities.js';
+import { extend } from '../../Shared/Utilities.js';
 const { seriesTypes: { column: { prototype: { pointClass: ColumnPoint } } } } = SeriesRegistry;
 /* *
  *
@@ -63,7 +63,7 @@ class LinkPoint extends ColumnPoint {
         animation, runEvent);
         this.visible = this.toNode.visible;
         extend(this, oldOptions);
-        if (pick(redraw, true)) {
+        if (redraw ?? true) {
             this.series.chart.redraw(animation);
         }
     }

package/es-modules/Series/Treegraph/TreegraphSeries.js

@@ -25,7 +25,7 @@ import TreegraphLayout from './TreegraphLayout.js';
 import TreegraphSeriesDefaults from './TreegraphSeriesDefaults.js';
 import SVGElement from '../../Core/Renderer/SVG/SVGElement.js';
 import { composeTextPath } from '../../Extensions/TextPath.js';
-import { arrayMax, crisp, extend, merge, pick, relativeLength, splat } from '../../Shared/Utilities.js';
+import { arrayMax, crisp, extend, merge, relativeLength, splat } from '../../Shared/Utilities.js';
 composeTextPath(SVGElement);
 /* *
  *
@@ -141,7 +141,8 @@ class TreegraphSeries extends TreemapSeries {
                 }
                 else {
                     // #19552
-                    point.collapsed = pick(point.collapsed, (this.mapOptionsToLevel[point.node.level] || {}).collapsed);
+                    point.collapsed = (point.collapsed ??
+                        (this.mapOptionsToLevel[point.node.level] || {}).collapsed);
                     point.linkToParent.visible =
                         point.linkToParent.toNode.visible;
                 }
@@ -171,7 +172,8 @@ class TreegraphSeries extends TreemapSeries {
         const point = node.point;
         if (point) {
             // Take the level options into account.
-            point.collapsed = pick(point.collapsed, (this.mapOptionsToLevel[node.level] || {}).collapsed);
+            point.collapsed = (point.collapsed ??
+                (this.mapOptionsToLevel[node.level] || {}).collapsed);
             point.visible = visibility;
             visibility = visibility === false ? false : !point.collapsed;
         }
@@ -227,8 +229,10 @@ class TreegraphSeries extends TreemapSeries {
         }
     }
     translateLink(link) {
-        const fromNode = link.fromNode, toNode = link.toNode, linkWidth = this.options.link?.lineWidth || 0, factor = pick(this.options.link?.curveFactor, 0.5), hasXData = toNode.x !== toNode.node.level ||
-            fromNode.x !== fromNode.node.level, type = pick(link.options.link?.type, this.options.link?.type, 'default');
+        const fromNode = link.fromNode, toNode = link.toNode, linkWidth = this.options.link?.lineWidth || 0, factor = this.options.link?.curveFactor ?? 0.5, hasXData = toNode.x !== toNode.node.level ||
+            fromNode.x !== fromNode.node.level, type = (link.options.link?.type ??
+            this.options.link?.type ??
+            'default');
         if (fromNode.shapeArgs && toNode.shapeArgs) {
             const fromNodeWidth = (fromNode.shapeArgs.width || 0), inverted = this.chart.inverted, y1 = crisp((fromNode.shapeArgs.y || 0) +
                 (fromNode.shapeArgs.height || 0) / 2, linkWidth), y2 = crisp((toNode.shapeArgs.y || 0) +
@@ -348,7 +352,7 @@ class TreegraphSeries extends TreemapSeries {
         // Links must also be destroyed.
         if (this.links) {
             for (const link of this.links) {
-                link.destroy();
+                link.destroy(true);
             }
             this.links.length = 0;
         }
@@ -360,15 +364,18 @@ class TreegraphSeries extends TreemapSeries {
      */
     pointAttribs(point, state) {
         const series = this, levelOptions = point &&
-            series.mapOptionsToLevel[point.node.level ?? 0] || {}, options = point && point.options, stateOptions = (levelOptions.states &&
-            levelOptions.states[state]) ||
-            {};
+            series.mapOptionsToLevel[point.node.level] ||
+            {}, options = point?.options || {}, stateOptions = levelOptions.states?.[state || 'normal'] || {};
         if (point) {
             point.options.marker = merge(series.options.marker, levelOptions.marker, point.options.marker);
         }
-        const linkColor = pick(stateOptions && stateOptions.link && stateOptions.link.color, options && options.link && options.link.color, levelOptions && levelOptions.link && levelOptions.link.color, series.options.link && series.options.link.color), linkLineWidth = pick(stateOptions && stateOptions.link &&
-            stateOptions.link.lineWidth, options && options.link && options.link.lineWidth, levelOptions && levelOptions.link &&
-            levelOptions.link.lineWidth, series.options.link && series.options.link.lineWidth), attribs = seriesProto.pointAttribs.call(series, point, state);
+        const linkColor = (stateOptions.link?.color ??
+            options.link?.color ??
+            levelOptions.link?.color ??
+            series.options.link?.color), linkLineWidth = (stateOptions.link?.lineWidth ??
+            options.link?.lineWidth ??
+            levelOptions.link?.lineWidth ??
+            series.options.link?.lineWidth), attribs = seriesProto.pointAttribs.call(series, point, state);
         if (point) {
             if (point.isLink) {
                 attribs.stroke = linkColor;
@@ -398,7 +405,9 @@ class TreegraphSeries extends TreemapSeries {
             plotSizeX - width / 2 - x :
             x - width / 2), nodeY = node.y = (!reversed ?
             plotSizeY - y - height / 2 :
-            y - height / 2), borderRadius = pick(point.options.borderRadius, level.borderRadius, this.options.borderRadius), symbolFn = symbols[symbol || 'circle'];
+            y - height / 2), borderRadius = (point.options.borderRadius ??
+            level.borderRadius ??
+            this.options.borderRadius), symbolFn = symbols[symbol || 'circle'];
         if (symbolFn === void 0) {
             point.hasImage = true;
             point.shapeType = 'image';

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

@@ -14,7 +14,7 @@
 import DPU from '../DrawPointUtilities.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 const { pie: { prototype: { pointClass: PiePoint } }, scatter: { prototype: { pointClass: ScatterPoint } } } = SeriesRegistry.seriesTypes;
-import { extend, isNumber, pick } from '../../Shared/Utilities.js';
+import { extend, isNumber } from '../../Shared/Utilities.js';
 /* *
  *
  *  Class
@@ -50,7 +50,7 @@ class TreemapPoint extends ScatterPoint {
         else if (!this.node.isGroup &&
             !this.node.isLeaf &&
             !series.nodeMap[series.rootNode].isGroup &&
-            !pick(options.interactByLeaf, !options.allowTraversingTree)) {
+            !(options.interactByLeaf ?? !options.allowTraversingTree)) {
             className += ' highcharts-internal-node-interactive';
         }
         else if (!this.node.isGroup &&

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

@@ -27,7 +27,7 @@ import TreemapSeriesDefaults from './TreemapSeriesDefaults.js';
 import TreemapUtilities from './TreemapUtilities.js';
 import TU from '../TreeUtilities.js';
 const { getColor, getLevelOptions, updateRootId } = TU;
-import { addEvent, arrayMax, clamp, correctFloat, crisp, defined, extend, fireEvent, isArray, isNumber, isObject, isString, merge, pick, pushUnique, splat, stableSort } from '../../Shared/Utilities.js';
+import { addEvent, arrayMax, clamp, correctFloat, crisp, defined, extend, fireEvent, isArray, isNumber, isObject, isString, merge, pushUnique, splat, stableSort } from '../../Shared/Utilities.js';
 import { error } from '../../Core/Utilities.js';
 Series.keepProps.push('simulation', 'hadOutsideDataLabels');
 /* *
@@ -342,9 +342,9 @@ class TreemapSeries extends ScatterSeries {
      * The rectangular area of the parent.
      */
     calculateChildrenAreas(parent, area) {
-        const series = this, options = series.options, mapOptionsToLevel = series.mapOptionsToLevel, level = mapOptionsToLevel[parent.level + 1], algorithm = pick((level?.layoutAlgorithm &&
+        const series = this, options = series.options, mapOptionsToLevel = series.mapOptionsToLevel, level = mapOptionsToLevel[parent.level + 1], algorithm = ((level?.layoutAlgorithm &&
             series[level?.layoutAlgorithm] &&
-            level.layoutAlgorithm), options.layoutAlgorithm), alternate = options.alternateStartingDirection, 
+            level.layoutAlgorithm) ?? options.layoutAlgorithm), alternate = options.alternateStartingDirection, 
         // Collect all children which should be included
         children = parent.children.filter((n) => parent.isGroup || !n.ignore), groupPadding = level?.groupPadding ?? options.groupPadding ?? 0, rootNode = series.nodeMap[series.rootNode];
         if (!algorithm) {
@@ -726,7 +726,7 @@ class TreemapSeries extends ScatterSeries {
      */
     getListOfParents(data, existingIds) {
         const arr = isArray(data) ? data : [], ids = isArray(existingIds) ? existingIds : [], listOfParents = arr.reduce(function (prev, curr, i) {
-            const parent = pick(curr.parent, '');
+            const parent = (curr.parent ?? '');
             if (typeof prev[parent] === 'undefined') {
                 prev[parent] = [];
             }
@@ -879,13 +879,16 @@ class TreemapSeries extends ScatterSeries {
             series.mapOptionsToLevel :
             {}), level = point?.node && mapOptionsToLevel[point.node.level] || {}, options = this.options, stateOptions = state && options.states && options.states[state] || {}, className = point?.node && point.getClassName() || '', 
         // Set attributes by precedence. Point trumps level trumps series.
-        // Stroke width uses pick because it can be 0.
+        // Stroke width uses nullish coalescing because it can be 0.
         attr = {
             'stroke': (point && point.borderColor) ||
                 level.borderColor ||
                 stateOptions.borderColor ||
                 options.borderColor,
-            'stroke-width': pick(point && point.borderWidth, level.borderWidth, stateOptions.borderWidth, options.borderWidth),
+            'stroke-width': ((point && point.borderWidth) ??
+                level.borderWidth ??
+                stateOptions.borderWidth ??
+                options.borderWidth),
             'dashstyle': point?.borderDashStyle ||
                 level.borderDashStyle ||
                 stateOptions.borderDashStyle ||
@@ -1026,7 +1029,7 @@ class TreemapSeries extends ScatterSeries {
         const series = this, eventArgs = extend({
             newRootId: id,
             previousRootId: series.rootNode,
-            redraw: pick(redraw, true),
+            redraw: (redraw ?? true),
             series: series
         }, eventArguments);
         /**
@@ -1083,7 +1086,7 @@ class TreemapSeries extends ScatterSeries {
         // Sort the children
         stableSort(children, (a, b) => ((a.sortIndex || 0) - (b.sortIndex || 0)));
         // Set the values
-        let val = pick(point?.simulatedValue, point?.options.value, childrenTotal);
+        let val = point?.simulatedValue ?? point?.options.value ?? childrenTotal;
         if (point) {
             point.value = val;
         }
@@ -1097,14 +1100,14 @@ class TreemapSeries extends ScatterSeries {
             children: children,
             childrenTotal: childrenTotal,
             // Ignore this node if point is not visible
-            ignore: !(pick(point?.visible, true) && (val > 0)),
+            ignore: !((point?.visible ?? true) && (val > 0)),
             isLeaf: tree.visible && !(series.type === 'treegraph' ?
                 children.length > 0 :
                 childrenTotal),
             isGroup: point?.isGroup,
             levelDynamic: (tree.level - (levelIsConstant ? 0 : nodeRoot.level)),
-            name: pick(point?.name, ''),
-            sortIndex: pick(point?.sortIndex, -val),
+            name: (point?.name ?? ''),
+            sortIndex: (point?.sortIndex ?? -val),
             val: val
         });
         return tree;

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

@@ -412,6 +412,15 @@ const TreemapSeriesDefaults = {
      * @product   highcharts
      * @apioption plotOptions.treemap.levels.dataLabels
      */
+    /**
+     * Can set the group padding on a specific level. Overrides the series
+     * option of the same name.
+     *
+     * @type      {number}
+     * @since     12.2.0
+     * @product   highcharts
+     * @apioption plotOptions.treemap.levels.groupPadding
+     */
     /**
      * Can set the layoutAlgorithm option on a specific level.
      *
@@ -442,15 +451,27 @@ const TreemapSeriesDefaults = {
      * @product   highcharts
      * @apioption plotOptions.treemap.levels.level
      */
+    /**
+     * Whether the `level` number is absolute, or relative to the currently
+     * visible root. Overrides the series option of the same name for this
+     * level.
+     *
+     * @type      {boolean}
+     * @product   highcharts
+     * @apioption plotOptions.treemap.levels.levelIsConstant
+     */
     // Presentational options
     /**
      * The color of the border surrounding each tree map item.
      *
-     * @type {Highcharts.ColorString}
+     * @type    {Highcharts.ColorString}
+     * @product highcharts
      */
     borderColor: 'var(--highcharts-neutral-color-10)',
     /**
      * The width of the border surrounding each tree map item.
+     *
+     * @product highcharts
      */
     borderWidth: 1,
     colorKey: 'colorValue',

package/es-modules/Series/VariablePie/VariablePieSeries.js

@@ -15,7 +15,7 @@
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 const { pie: PieSeries } = SeriesRegistry.seriesTypes;
 import VariablePieSeriesDefaults from './VariablePieSeriesDefaults.js';
-import { arrayMax, arrayMin, clamp, extend, fireEvent, merge, pick } from '../../Shared/Utilities.js';
+import { arrayMax, arrayMin, clamp, extend, fireEvent, merge } from '../../Shared/Utilities.js';
 /* *
  *
  *  Class
@@ -60,8 +60,10 @@ class VariablePieSeries extends PieSeries {
         series.minPxSize = positions[3] + extremes.minPointSize;
         series.maxPxSize = clamp(positions[2], positions[3] + extremes.minPointSize, extremes.maxPointSize);
         if (zData.length) {
-            zMin = pick(seriesOptions.zMin, arrayMin(zData.filter(series.zValEval)));
-            zMax = pick(seriesOptions.zMax, arrayMax(zData.filter(series.zValEval)));
+            zMin =
+                seriesOptions.zMin ?? arrayMin(zData.filter(series.zValEval));
+            zMax =
+                seriesOptions.zMax ?? arrayMax(zData.filter(series.zValEval));
             this.getRadii(zMin, zMax, series.minPxSize, series.maxPxSize);
         }
     }
@@ -164,7 +166,7 @@ class VariablePieSeries extends PieSeries {
     translate(positions) {
         this.generatePoints();
         const series = this, precision = 1000, // Issue #172
-        options = series.options, slicedOffset = options.slicedOffset, startAngle = options.startAngle || 0, startAngleRad = Math.PI / 180 * (startAngle - 90), endAngleRad = Math.PI / 180 * (pick(options.endAngle, startAngle + 360) - 90), circ = endAngleRad - startAngleRad, // 2 * Math.PI,
+        options = series.options, slicedOffset = options.slicedOffset, startAngle = options.startAngle || 0, startAngleRad = Math.PI / 180 * (startAngle - 90), endAngleRad = Math.PI / 180 * ((options.endAngle ?? startAngle + 360) - 90), circ = endAngleRad - startAngleRad, // 2 * Math.PI,
         points = series.points, ignoreHiddenPoint = options.ignoreHiddenPoint;
         let cumulative = 0, start, end, angle, 
         // The x component of the radius vector for a given point

package/es-modules/Series/VariablePie/VariablePieSeriesDefaults.js

@@ -93,8 +93,9 @@ const VariablePieSeriesDefaults = {
      * @sample {highcharts} highcharts/variable-radius-pie/sizeby/
      *         Difference between area and radius sizeBy
      *
-     * @type  {Highcharts.VariablePieSizeByValue}
-     * @since 6.0.0
+     * @declare Highcharts.VariablePieSizeByValue
+     * @since   6.0.0
+     * @type    {"area"|"radius"}
      */
     sizeBy: 'area',
     tooltip: {

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

@@ -17,7 +17,7 @@ const { column: ColumnSeries } = SeriesRegistry.seriesTypes;
 import VariwideComposition from './VariwideComposition.js';
 import VariwidePoint from './VariwidePoint.js';
 import VariwideSeriesDefaults from './VariwideSeriesDefaults.js';
-import { addEvent, arrayMax, arrayMin, crisp, extend, merge, pick } from '../../Shared/Utilities.js';
+import { addEvent, arrayMax, arrayMin, crisp, extend, merge } from '../../Shared/Utilities.js';
 /* *
  *
  *  Class
@@ -79,7 +79,7 @@ class VariwideSeries extends ColumnSeries {
             (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));
+            minPx - this.chart.plotLeft - goRight * axis.minPixelPadding, linearSlotLeft = i / relZ.length * len, linearSlotRight = (i + goRight) / relZ.length * len, slotLeft = ((relZ[i] ?? totalZ) / totalZ) * len, slotRight = ((relZ[i + goRight] ?? totalZ) / totalZ) * len, xInsideLinearSlot = (x - (left + linearSlotLeft));
         // Set crosshairWidth for every point (#8173)
         if (point) {
             point.crosshairWidth = slotRight - slotLeft;

package/es-modules/Series/Vector/VectorSeries.js

@@ -12,13 +12,12 @@
  *
  * */
 'use strict';
-import A from '../../Core/Animation/AnimationUtilities.js';
-const { animObject } = A;
+import { animObject } from '../../Core/Animation/AnimationUtilities.js';
 import H from '../../Core/Globals.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 const { series: Series, seriesTypes: { scatter: ScatterSeries } } = SeriesRegistry;
 import VectorSeriesDefaults from './VectorSeriesDefaults.js';
-import { arrayMax, extend, merge, pick } from '../../Shared/Utilities.js';
+import { arrayMax, extend, merge } from '../../Shared/Utilities.js';
 /* *
  *
  *  Class
@@ -118,7 +117,7 @@ class VectorSeries extends ScatterSeries {
                         .add(this.markerGroup)
                         .addClass('highcharts-point ' +
                         'highcharts-color-' +
-                        pick(point.colorIndex, point.series.colorIndex));
+                        (point.colorIndex ?? point.series.colorIndex));
                 }
                 point.graphic
                     .attr({
@@ -145,13 +144,12 @@ class VectorSeries extends ScatterSeries {
         const options = this.options;
         let stroke = point?.color || this.color, strokeWidth = this.options.lineWidth;
         if (state) {
-            stroke = options.states[state].color || stroke;
-            strokeWidth =
-                (options.states[state].lineWidth || strokeWidth) +
-                    (options.states[state].lineWidthPlus || 0);
+            stroke = options.states?.[state]?.color || stroke;
+            strokeWidth = (options.states?.[state]?.lineWidthPlus || 0) +
+                (options.states?.[state]?.lineWidth || strokeWidth || 0);
         }
         return {
-            'stroke': stroke,
+            stroke,
             'stroke-width': strokeWidth
         };
     }

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

@@ -16,8 +16,7 @@
  *
  * */
 'use strict';
-import A from '../../Core/Animation/AnimationUtilities.js';
-const { animObject } = A;
+import { animObject } from '../../Core/Animation/AnimationUtilities.js';
 import Color from '../../Core/Color/Color.js';
 const { parse: color } = Color;
 import CU from '../../Core/Geometry/CircleUtilities.js';
@@ -331,11 +330,11 @@ class VennSeries extends ScatterSeries {
      * Returns the calculated attributes.
      */
     pointAttribs(point, state) {
-        const series = this, seriesOptions = series.options || {}, pointOptions = point?.options || {}, stateOptions = (state && seriesOptions.states[state]) || {}, options = merge(seriesOptions, pointOptions, stateOptions);
+        const series = this, seriesOptions = series.options || {}, pointOptions = point?.options || {}, stateOptions = (state && seriesOptions.states?.[state]) || {}, options = merge(seriesOptions, pointOptions, stateOptions);
         // Return resulting values for the attributes.
         return {
             'fill': color(options.color || point.color)
-                .brighten(options.brightness)
+                .brighten(options.brightness || 0)
                 .get(),
             // Set opacity directly to the SVG element, not to pattern #14372.
             opacity: options.opacity,

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

@@ -15,7 +15,7 @@ const { column: ColumnSeries, line: LineSeries } = SeriesRegistry.seriesTypes;
 import WaterfallAxis from '../../Core/Axis/WaterfallAxis.js';
 import WaterfallPoint from './WaterfallPoint.js';
 import WaterfallSeriesDefaults from './WaterfallSeriesDefaults.js';
-import { addEvent, arrayMax, arrayMin, correctFloat, crisp, extend, isNumber, isObject, merge, objectEach, pick } from '../../Shared/Utilities.js';
+import { addEvent, arrayMax, arrayMin, correctFloat, crisp, extend, isNumber, isObject, merge, objectEach } from '../../Shared/Utilities.js';
 /* *
  *
  *  Functions
@@ -111,7 +111,7 @@ class WaterfallSeries extends ColumnSeries {
     pointAttribs(point, state) {
         const upColor = this.options.upColor;
         // Set or reset up color (#3710, update to negative)
-        if (upColor && !point.options.color && isNumber(point.y)) {
+        if (upColor && point && !point.options.color && isNumber(point.y)) {
             point.color = point.y > 0 ? upColor : void 0;
         }
         const attr = ColumnSeries.prototype.pointAttribs.call(this, point, state);
@@ -350,7 +350,7 @@ extend(WaterfallSeries.prototype, {
 });
 // Translate data points from raw values
 addEvent(WaterfallSeries, 'afterColumnTranslate', function () {
-    const series = this, { options, points, yAxis } = series, minPointLength = pick(options.minPointLength, 5), halfMinPointLength = minPointLength / 2, threshold = options.threshold || 0, stacking = options.stacking, actualStack = yAxis.waterfall?.stacks[series.stackKey], processedYData = series.getColumn('y', true);
+    const series = this, { options, points, yAxis } = series, minPointLength = (options.minPointLength ?? 5), halfMinPointLength = minPointLength / 2, threshold = options.threshold || 0, stacking = options.stacking, actualStack = yAxis.waterfall?.stacks[series.stackKey], processedYData = series.getColumn('y', true);
     let previousIntermediate = threshold, previousY = threshold, y, total, hPos;
     for (let i = 0; i < points.length; i++) {
         const point = points[i], yValue = processedYData[i], shapeArgs = point.shapeArgs, box = extend({

package/es-modules/Series/Windbarb/WindbarbSeries.js

@@ -12,8 +12,7 @@
  *
  * */
 'use strict';
-import A from '../../Core/Animation/AnimationUtilities.js';
-const { animObject } = A;
+import { animObject } from '../../Core/Animation/AnimationUtilities.js';
 import ApproximationRegistry from '../../Extensions/DataGrouping/ApproximationRegistry.js';
 import H from '../../Core/Globals.js';
 import OnSeriesComposition from '../OnSeriesComposition.js';
@@ -21,7 +20,7 @@ import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 const { column: ColumnSeries } = SeriesRegistry.seriesTypes;
 import WindbarbPoint from './WindbarbPoint.js';
 import WindbarbSeriesDefaults from './WindbarbSeriesDefaults.js';
-import { extend, merge, pick } from '../../Shared/Utilities.js';
+import { extend, merge } from '../../Shared/Utilities.js';
 /* *
  *
  *  Functions
@@ -75,15 +74,14 @@ class WindbarbSeries extends ColumnSeries {
     // Get presentational attributes.
     pointAttribs(point, state) {
         const options = this.options;
-        let stroke = point?.color || this.color, strokeWidth = this.options.lineWidth;
+        let stroke = point?.color || this.color, strokeWidth = options.lineWidth;
         if (state) {
-            stroke = options.states[state].color || stroke;
-            strokeWidth =
-                (options.states[state].lineWidth || strokeWidth) +
-                    (options.states[state].lineWidthPlus || 0);
+            stroke = options.states?.[state]?.color || stroke;
+            strokeWidth = (options.states?.[state]?.lineWidthPlus || 0) +
+                (options.states?.[state]?.lineWidth || strokeWidth || 0);
         }
         return {
-            'stroke': stroke,
+            stroke,
             'stroke-width': strokeWidth
         };
     }
@@ -152,7 +150,7 @@ class WindbarbSeries extends ColumnSeries {
                         .add(this.markerGroup)
                         .addClass('highcharts-point ' +
                         'highcharts-color-' +
-                        pick(point.colorIndex, point.series.colorIndex));
+                        (point.colorIndex ?? point.series.colorIndex));
                 }
                 // Position the graphic
                 point.graphic

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

@@ -20,7 +20,7 @@ import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 const { column: ColumnSeries } = SeriesRegistry.seriesTypes;
 import XRangeSeriesDefaults from './XRangeSeriesDefaults.js';
 import XRangePoint from './XRangePoint.js';
-import { addEvent, clamp, crisp, defined, extend, find, isNumber, isObject, merge, pick, pushUnique, relativeLength } from '../../Shared/Utilities.js';
+import { addEvent, clamp, crisp, defined, extend, find, isNumber, isObject, merge, pushUnique, relativeLength } from '../../Shared/Utilities.js';
 /* *
  *
  *  Functions
@@ -34,7 +34,7 @@ function onAxisAfterGetSeriesExtremes() {
     const time = this.chart.time;
     let dataMax, modMax;
     if (this.isXAxis) {
-        dataMax = pick(this.dataMax, -Number.MAX_VALUE);
+        dataMax = this.dataMax ?? -Number.MAX_VALUE;
         for (const series of this.series) {
             const column = (series.dataTable.getColumn('x2', true) ||
                 series.dataTable.getColumn('end', true) ||
@@ -159,7 +159,7 @@ class XRangeSeries extends ColumnSeries {
     }
     alignDataLabel(point) {
         const oldPlotX = point.plotX;
-        point.plotX = pick(point.dlBox?.centerX, point.plotX);
+        point.plotX = point.dlBox?.centerX ?? point.plotX;
         if (point.dataLabel && point.shapeArgs?.width) {
             point.dataLabel.css({
                 width: `${point.shapeArgs.width}px`
@@ -172,9 +172,9 @@ class XRangeSeries extends ColumnSeries {
      * @private
      */
     translatePoint(point) {
-        const xAxis = this.xAxis, yAxis = this.yAxis, metrics = this.columnMetrics, options = this.options, minPointLength = options.minPointLength || 0, oldColWidth = (point.shapeArgs?.width || 0) / 2, seriesXOffset = this.pointXOffset = metrics.offset, posX = pick(point.x2, point.x + (point.len || 0)), borderRadius = options.borderRadius, plotTop = this.chart.plotTop, plotLeft = this.chart.plotLeft;
+        const xAxis = this.xAxis, yAxis = this.yAxis, metrics = this.columnMetrics, options = this.options, minPointLength = options.minPointLength || 0, oldColWidth = (point.shapeArgs?.width || 0) / 2, seriesXOffset = this.pointXOffset = metrics.offset, posX = point.x2 ?? (point.x + (point.len || 0)), borderRadius = options.borderRadius, plotTop = this.chart.plotTop, plotLeft = this.chart.plotLeft;
         let plotX = point.plotX, plotX2 = xAxis.translate(posX, 0, 0, 0, 1);
-        const length = Math.abs(plotX2 - plotX), inverted = this.chart.inverted, borderWidth = pick(options.borderWidth, 1);
+        const length = Math.abs(plotX2 - plotX), inverted = this.chart.inverted, borderWidth = options.borderWidth ?? 1;
         let widthDifference, partialFill, yOffset = metrics.offset, pointHeight = Math.round(metrics.width), dlLeft, dlRight, dlWidth, clipRectWidth;
         if (minPointLength) {
             widthDifference = minPointLength - length;
@@ -304,9 +304,9 @@ class XRangeSeries extends ColumnSeries {
      *        'animate' (animates changes) or 'attr' (sets options)
      */
     drawPoint(point, verb) {
-        const seriesOpts = this.options, renderer = this.chart.renderer, type = point.shapeType, shapeArgs = point.shapeArgs, partShapeArgs = point.partShapeArgs, clipRectArgs = point.clipRectArgs, pointState = point.state, stateOpts = (seriesOpts.states[pointState || 'normal'] ||
-            {}), pointStateVerb = typeof pointState === 'undefined' ?
-            'attr' : verb, pointAttr = this.pointAttribs(point, pointState), animation = pick(this.chart.options.chart.animation, stateOpts.animation);
+        const seriesOpts = this.options, renderer = this.chart.renderer, type = point.shapeType, shapeArgs = point.shapeArgs, partShapeArgs = point.partShapeArgs, clipRectArgs = point.clipRectArgs, pointState = point.state, stateOpts = seriesOpts.states?.[pointState || 'normal'] || {}, pointStateVerb = typeof pointState === 'undefined' ?
+            'attr' : verb, pointAttr = this.pointAttribs(point, pointState), animation = (this.chart.options.chart.animation ??
+            stateOpts.animation);
         let graphic = point.graphic, pfOptions = point.partialFill;
         if (!point.isNull && point.visible !== false) {
             const className = point.getClassName();

package/es-modules/Shared/TimeBase.js

@@ -85,6 +85,10 @@ const isDateTimeFormatOptions = (obj) => obj.main === void 0;
  *
  * @param {Highcharts.TimeOptions} [options] Time options as defined in
  * [chart.options.time](/highcharts/time).
+ *
+ * @param {Highcharts.LangOptions} [lang]
+ * Language options. When `options.locale` is not set, `lang.locale` is used as
+ * the locale fallback for locale-aware date formatting.
  */
 class TimeBase {
     /* *
@@ -103,8 +107,8 @@ class TimeBase {
         };
         this.variableTimezone = false;
         this.Date = win.Date;
-        this.update(options);
         this.lang = lang;
+        this.update(options);
     }
     /* *
      *
@@ -216,7 +220,9 @@ class TimeBase {
     /**
      * Shorthand to get a cached `Intl.DateTimeFormat` instance.
      */
-    dateTimeFormat(options, timestamp, locale = this.options.locale || pageLang) {
+    dateTimeFormat(options, timestamp, locale = (this.options.locale ||
+        this.lang?.locale ||
+        pageLang)) {
         const cacheKey = JSON.stringify(options) + locale;
         if (isString(options)) {
             options = this.str2dtf(options);
@@ -302,17 +308,16 @@ class TimeBase {
         // eslint-disable-next-line new-cap
         let d = this.Date.UTC(year, month, date, hours, minutes || 0, seconds || 0, milliseconds || 0);
         if (this.timezone !== 'UTC') {
-            const offset = this.getTimezoneOffset(d);
+            const offset = this.getTimezoneOffset(d), localHours = (hours - offset / timeUnits.hour + 24) % 24;
             d += offset;
-            // Adjustments close to DST transitions
             if (
-            // Optimize for speed by limiting the number of calls to
-            // `getTimezoneOffset`. According to
+            // Limit the number of calls to `getTimezoneOffset` to months
+            // where DST changes may occur. According to
             // https://en.wikipedia.org/wiki/Daylight_saving_time_by_country,
             // DST change may only occur in these months.
             [2, 3, 8, 9, 10, 11].indexOf(month) !== -1 &&
-                // DST transitions occur only in the night-time
-                (hours < 5 || hours > 20)) {
+                // DST changes only occur at night (#24420)
+                (localHours < 5 || localHours > 20)) {
                 const newOffset = this.getTimezoneOffset(d);
                 if (offset !== newOffset) {
                     d += newOffset - offset;

package/es-modules/Shared/Utilities.js

@@ -708,7 +708,7 @@ export function getStyle(el, prop, toInt) {
     const css = win.getComputedStyle(el, void 0); // eslint-disable-line no-undefined
     if (css) {
         style = css.getPropertyValue(prop);
-        if (pick(toInt, prop !== 'opacity')) {
+        if (toInt ?? prop !== 'opacity') {
             style = pInt(style);
         }
     }
@@ -958,7 +958,7 @@ export function merge(extendOrSource, ...sources) {
 export function normalizeTickInterval(interval, multiples, magnitude, allowDecimals, hasTickAmount) {
     let i, retInterval = interval;
     // Round to a tenfold of 1, 2, 2.5 or 5
-    magnitude = pick(magnitude, getMagnitude(interval));
+    magnitude = (magnitude ?? getMagnitude(interval));
     const normalized = interval / magnitude;
     // Multiples for a linear scale
     if (!multiples) {
@@ -1071,20 +1071,22 @@ export function pad(number, length, padder) {
             .replace('-', '')
             .length).join(padder || '0') + number;
 }
-/* eslint-disable jsdoc/check-param-names */
+/* eslint-disable valid-jsdoc */
 /**
  * Return the first value that is not null or undefined.
  *
+ * @deprecated 13.0.2
+ * Use nullish coalescing (`??`) or explicit fallback logic instead.
+ *
  * @function Highcharts.pick<T>
  *
- * @param {...Array<T|null|undefined>} items
+ * @param {...(T|null|undefined)} args
  *        Variable number of arguments to inspect.
  *
  * @return {T}
  *         The value of the first argument that is not null or undefined.
  */
-export function pick() {
-    const args = arguments;
+export function pick(...args) {
     const length = args.length;
     for (let i = 0; i < length; i++) {
         const arg = args[i];
@@ -1093,7 +1095,7 @@ export function pick() {
         }
     }
 }
-/* eslint-enable jsdoc/check-param-names */
+/* eslint-enable valid-jsdoc */
 /**
  * Shortcut for parseInt
  *