highcharts 13.0.0 → 13.0.1

package/es-modules/Series/CenteredUtilities.js

@@ -14,7 +14,7 @@ import H from '../Core/Globals.js';
 const { deg2rad } = H;
 import { fireEvent, isNumber, pick, relativeLength } from '../Shared/Utilities.js';
 /**
- * @private
+ * @internal
  */
 var CenteredUtilities;
 (function (CenteredUtilities) {
@@ -32,7 +32,7 @@ var CenteredUtilities;
      * Get the center of the pie based on the size and center options relative
      * to the plot area. Borrowed by the polar and gauge series types.
      *
-     * @private
+     * @internal
      * @function Highcharts.CenteredSeriesMixin.getCenter
      */
     function getCenter() {
@@ -77,7 +77,7 @@ var CenteredUtilities;
      * GetStartAndEndRadians - Calculates start and end angles in radians.
      * Used in series types such as pie and sunburst.
      *
-     * @private
+     * @internal
      * @function Highcharts.CenteredSeriesMixin.getStartAndEndRadians
      *
      * @param {number} [start]
@@ -109,6 +109,7 @@ var CenteredUtilities;
  *  Default Export
  *
  * */
+/** @internal */
 export default CenteredUtilities;
 /* *
  *
@@ -116,7 +117,7 @@ export default CenteredUtilities;
  *
  * */
 /**
- * @private
+ * @internal
  * @interface Highcharts.RadianAngles
  */ /**
 * @name Highcharts.RadianAngles#end

package/es-modules/Series/ColorMapComposition.js

@@ -26,11 +26,13 @@ var ColorMapComposition;
      *  Constants
      *
      * */
+    /** @internal */
     ColorMapComposition.pointMembers = {
         dataLabelOnNull: true,
         moveToTopOnHover: true,
         isValid: pointIsValid
     };
+    /** @internal */
     ColorMapComposition.seriesMembers = {
         colorKey: 'value',
         axisTypes: ['xAxis', 'yAxis', 'colorAxis'],
@@ -46,7 +48,7 @@ var ColorMapComposition;
      *
      * */
     /**
-     * @private
+     * @internal
      */
     function compose(SeriesClass) {
         const PointClass = SeriesClass.prototype.pointClass;
@@ -56,7 +58,7 @@ var ColorMapComposition;
     ColorMapComposition.compose = compose;
     /**
      * Move points to the top of the z-index order when hovered.
-     * @private
+     * @internal
      */
     function onPointAfterSetState(e) {
         const point = this, series = point.series, renderer = series.chart.renderer;
@@ -92,7 +94,7 @@ var ColorMapComposition;
     /**
      * Color points have a value option that determines whether or not it is
      * a null point
-     * @private
+     * @internal
      */
     function pointIsValid() {
         return (this.value !== null &&
@@ -103,7 +105,7 @@ var ColorMapComposition;
     }
     /**
      * Get the color attributes to apply on the graphic
-     * @private
+     * @internal
      * @function Highcharts.colorMapSeriesMixin.colorAttribs
      * @param {Highcharts.Point} point
      * @return {Highcharts.SVGAttributes}
@@ -124,4 +126,5 @@ var ColorMapComposition;
  *  Default Export
  *
  * */
+/** @internal */
 export default ColorMapComposition;

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

@@ -10,6 +10,7 @@
  *
  * */
 import Point from '../../Core/Series/Point.js';
+/** @internal */
 export class ColumnPoint extends Point {
 }
 /* *
@@ -17,4 +18,5 @@ export class ColumnPoint extends Point {
  *  Default Export
  *
  * */
+/** @internal */
 export default ColumnPoint;

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

@@ -10,8 +10,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 ColumnSeriesDefaults from './ColumnSeriesDefaults.js';
@@ -418,11 +417,11 @@ class ColumnSeries extends Series {
      */
     pointAttribs(point, state) {
         const options = this.options, p2o = this.pointAttrToOptions || {}, strokeOption = p2o.stroke || 'borderColor', strokeWidthOption = p2o['stroke-width'] || 'borderWidth';
-        let stateOptions, zone, brightness, fill = (point && point.color) || this.color, 
+        let stateOptions, zone, brightness, fill = point?.color || this.color, 
         // Set to fill when borderColor null:
-        stroke = ((point && point[strokeOption]) ||
+        stroke = (point?.[strokeOption] ||
             options[strokeOption] ||
-            fill), dashstyle = (point && point.options.dashStyle) || options.dashStyle, strokeWidth = (point?.[strokeWidthOption]) ??
+            fill), dashstyle = point?.options.dashStyle || options.dashStyle, strokeWidth = point?.[strokeWidthOption] ??
             options[strokeWidthOption] ??
             this[strokeWidthOption] ?? 1, opacity = (point?.isNull && options.nullInteraction) ?
             0 :
@@ -443,7 +442,7 @@ class ColumnSeries extends Series {
         }
         // Select or hover states
         if (state && point) {
-            stateOptions = merge(options.states[state], 
+            stateOptions = merge(options.states?.[state], 
             // #6401
             point.options.states?.[state] || {});
             brightness = stateOptions.brightness;
@@ -453,14 +452,13 @@ class ColumnSeries extends Series {
                         .brighten(stateOptions.brightness)
                         .get()) || fill;
             stroke = stateOptions[strokeOption] || stroke;
-            strokeWidth =
-                stateOptions[strokeWidthOption] || strokeWidth;
+            strokeWidth = stateOptions[strokeWidthOption] || strokeWidth;
             dashstyle = stateOptions.dashStyle || dashstyle;
-            opacity = pick(stateOptions.opacity, opacity);
+            opacity = stateOptions.opacity ?? opacity;
         }
         const ret = {
-            fill: fill,
-            stroke: stroke,
+            fill,
+            stroke,
             'stroke-width': strokeWidth,
             opacity: point?.condemned ? 0 : opacity
         };
@@ -501,6 +499,7 @@ class ColumnSeries extends Series {
                         initialAttr = merge(shapeArgs, point.getOrigin(point.origin, shapeArgs));
                         if (!styledMode) {
                             initialAttr.opacity = 0;
+                            initialAttr['stroke-width'] = 0;
                         }
                         shouldUpdate = true;
                         verb = 'animate';
@@ -516,7 +515,7 @@ class ColumnSeries extends Series {
                 }
                 // Presentational
                 if (!styledMode) {
-                    graphic[verb](series.pointAttribs(point, (point.selected && 'select')))
+                    graphic[verb](series.pointAttribs(point, point.selected ? 'select' : ''))
                         .shadow(point.allowShadow !== false && options.shadow);
                 }
                 graphic
@@ -640,6 +639,7 @@ SeriesRegistry.registerSeriesType('column', ColumnSeries);
  *  Default Export
  *
  * */
+/** @internal */
 export default ColumnSeries;
 /* *
  *

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

@@ -149,6 +149,8 @@ const ColumnSeriesDefaults = {
      *          0.25
      * @sample {highcharts} highcharts/plotoptions/column-pointpadding-none/
      *         0 for tightly packed columns
+     * @sample {highcharts} highcharts/plotoptions/pie-pointpadding/
+     *         Pie point padding plugin
      *
      * @product highcharts highstock gantt
      */
@@ -480,12 +482,12 @@ const ColumnSeriesDefaults = {
  */
 /**
  * @excluding halo, lineWidth, lineWidthPlus, marker
- * @product   highcharts highstock
+ * @product   highcharts highstock gantt
  * @apioption series.column.states.hover
  */
 /**
  * @excluding halo, lineWidth, lineWidthPlus, marker
- * @product   highcharts highstock
+ * @product   highcharts highstock gantt
  * @apioption series.column.states.select
  */
 /**

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

@@ -20,7 +20,7 @@ import { addEvent, extend, pick, pushUnique, wrap } from '../../Shared/Utilities
  *  Functions
  *
  * */
-/** @private */
+/** @internal */
 function columnSeriesTranslate3dShapes() {
     const series = this, chart = series.chart, seriesOptions = series.options, depth = seriesOptions.depth, stack = seriesOptions.stacking ?
         (seriesOptions.stack || 0) :
@@ -117,7 +117,7 @@ function columnSeriesTranslate3dShapes() {
     // Store for later use #4067
     series.z = z;
 }
-/** @private */
+/** @internal */
 function compose(SeriesClass, StackItemClass) {
     if (pushUnique(composed, 'Column3D')) {
         const seriesProto = SeriesClass.prototype, stackItemProto = StackItemClass.prototype, { column: ColumnSeriesClass, columnRange: ColumnRangeSeriesClass } = SeriesClass.types;
@@ -148,7 +148,7 @@ function compose(SeriesClass, StackItemClass) {
     }
 }
 /**
- * @private
+ * @internal
  * @param {Highcharts.Chart} chart
  * Chart with stacks
  * @param {string} stacking
@@ -170,7 +170,7 @@ function retrieveStacks(chart, stacking) {
     stacks.totalStacks = i + 1;
     return stacks;
 }
-/** @private */
+/** @internal */
 function onColumnSeriesAfterInit() {
     if (this.chart.is3d()) {
         const series = this, seriesOptions = series.options, grouping = seriesOptions.grouping, stacking = seriesOptions.stacking, reversedStacks = series.yAxis.options.reversedStacks;
@@ -200,14 +200,14 @@ function onColumnSeriesAfterInit() {
 /**
  * In 3D mode, simple checking for a new shape to animate is not enough.
  * Additionally check if graphic is a group of elements
- * @private
+ * @internal
  */
 function wrapColumnPointHasNewShapeType(proceed, ...args) {
     return this.series.chart.is3d() ?
         this.graphic && this.graphic.element.nodeName !== 'g' :
         proceed.apply(this, args);
 }
-/** @private */
+/** @internal */
 function wrapColumnSeriesAnimate(proceed) {
     if (!this.chart.is3d()) {
         proceed.apply(this, [].slice.call(arguments, 1));
@@ -259,7 +259,7 @@ function wrapColumnSeriesAnimate(proceed) {
  * In case of 3d columns there is no sense to add these columns to a specific
  * series group. If a series is added to a group all columns will have the same
  * zIndex in comparison to another series.
- * @private
+ * @internal
  */
 function wrapColumnSeriesPlotGroup(proceed, prop, _name, _visibility, _zIndex, parent) {
     if (prop !== 'dataLabelsGroup' && prop !== 'markerGroup') {
@@ -284,7 +284,7 @@ function wrapColumnSeriesPlotGroup(proceed, prop, _name, _visibility, _zIndex, p
     }
     return proceed.apply(this, Array.prototype.slice.call(arguments, 1));
 }
-/** @private */
+/** @internal */
 function wrapColumnSeriesPointAttribs(proceed) {
     const attr = proceed.apply(this, [].slice.call(arguments, 1));
     if (this.chart.is3d && this.chart.is3d()) {
@@ -297,7 +297,7 @@ function wrapColumnSeriesPointAttribs(proceed) {
 /**
  * In 3D mode, all column-series are rendered in one main group. Because of that
  * we need to apply inactive state on all points.
- * @private
+ * @internal
  */
 function wrapColumnSeriesSetState(proceed, state, inherit) {
     const is3d = this.chart.is3d && this.chart.is3d();
@@ -312,7 +312,7 @@ function wrapColumnSeriesSetState(proceed, state, inherit) {
 /**
  * When series is not added to group it is needed to change setVisible method to
  * allow correct Legend functionality. This wrap is basing on pie chart series.
- * @private
+ * @internal
  */
 function wrapColumnSeriesSetVisible(proceed, vis) {
     const series = this;
@@ -331,7 +331,7 @@ function wrapColumnSeriesSetVisible(proceed, vis) {
     }
     proceed.apply(this, Array.prototype.slice.call(arguments, 1));
 }
-/** @private */
+/** @internal */
 function wrapColumnSeriesTranslate(proceed) {
     proceed.apply(this, [].slice.call(arguments, 1));
     // Do not do this if the chart is not 3D
@@ -339,7 +339,7 @@ function wrapColumnSeriesTranslate(proceed) {
         this.translate3dShapes();
     }
 }
-/** @private */
+/** @internal */
 function wrapSeriesAlignDataLabel(proceed, point, _dataLabel, options, alignTo) {
     const chart = this.chart;
     // In 3D we need to pass point.outsidePlot option to the justifyDataLabel
@@ -379,7 +379,7 @@ function wrapSeriesAlignDataLabel(proceed, point, _dataLabel, options, alignTo)
 }
 /**
  * Don't use justifyDataLabel when point is outsidePlot.
- * @private
+ * @internal
  */
 function wrapSeriesJustifyDataLabel(proceed) {
     return (!(arguments[2].outside3dPlot) ?
@@ -388,7 +388,7 @@ function wrapSeriesJustifyDataLabel(proceed) {
 }
 /**
  * Added stackLabels position calculation for 3D charts.
- * @private
+ * @internal
  */
 function wrapStackItemGetStackBox(proceed, stackBoxProps) {
     const stackBox = proceed.apply(this, [].slice.call(arguments, 1));
@@ -432,9 +432,11 @@ function wrapStackItemGetStackBox(proceed, stackBoxProps) {
  *  Default Export
  *
  * */
+/** @internal */
 const Column3DComposition = {
     compose
 };
+/** @internal */
 export default Column3DComposition;
 /* *
  *

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

@@ -0,0 +1,18 @@
+/* *
+ *
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Torstein Hønsi
+ *
+ *  Integration of this software requires a license.
+ *  - For commercial use, see www.highcharts.com/license
+ *  - For non-commercial, see www.highcharts.com/license-eula
+ *
+ *
+ * */
+/* *
+ *
+ *  Default Export
+ *
+ * */
+/** @internal */
+export default ColumnPyramidPoint;

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

@@ -0,0 +1,12 @@
+/* *
+ *
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Torstein Hønsi
+ *
+ *  Integration of this software requires a license.
+ *  - For commercial use, see www.highcharts.com/license
+ *  - For non-commercial, see www.highcharts.com/license-eula
+ *
+ *
+ * */
+export {};

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

@@ -22,7 +22,7 @@ import { clamp, merge, pick } from '../../Shared/Utilities.js';
 /**
  * The ColumnPyramidSeries class
  *
- * @private
+ * @internal
  * @class
  * @name Highcharts.seriesTypes.columnpyramid
  *
@@ -36,7 +36,7 @@ class ColumnPyramidSeries extends ColumnSeries {
      * */
     /**
      * Overrides the column translate method
-     * @private
+     * @internal
      */
     translate() {
         const series = this, chart = series.chart, options = series.options, dense = series.dense =
@@ -177,4 +177,5 @@ SeriesRegistry.registerSeriesType('columnpyramid', ColumnPyramidSeries);
  *  Default Export
  *
  * */
+/** @internal */
 export default ColumnPyramidSeries;

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

@@ -0,0 +1,12 @@
+/* *
+ *
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Torstein Hønsi
+ *
+ *  Integration of this software requires a license.
+ *  - For commercial use, see www.highcharts.com/license
+ *  - For non-commercial, see www.highcharts.com/license-eula
+ *
+ *
+ * */
+export {};

package/es-modules/Series/ColumnRange/ColumnRangePoint.js

@@ -18,6 +18,7 @@ import { extend, isNumber } from '../../Shared/Utilities.js';
  *  Class
  *
  * */
+/** @internal */
 class ColumnRangePoint extends AreaRangePoint {
     /* *
      *
@@ -36,4 +37,5 @@ extend(ColumnRangePoint.prototype, {
  *  Default Export
  *
  * */
+/** @internal */
 export default ColumnRangePoint;

package/es-modules/Series/ColumnRange/ColumnRangePointOptions.js

@@ -0,0 +1,12 @@
+/* *
+ *
+ *  (c) 2010-2026 Highsoft AS
+ *  Author: Torstein Hønsi
+ *
+ *  Integration of this software requires a license.
+ *  - For commercial use, see www.highcharts.com/license
+ *  - For non-commercial, see www.highcharts.com/license-eula
+ *
+ *
+ * */
+export {};

package/es-modules/Series/ColumnRange/ColumnRangeSeries.js

@@ -11,58 +11,12 @@
  * */
 'use strict';
 import ColumnRangePoint from './ColumnRangePoint.js';
+import ColumnRangeSeriesDefaults from './ColumnRangeSeriesDefaults.js';
 import H from '../../Core/Globals.js';
 const { noop } = H;
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
 const { seriesTypes: { arearange: AreaRangeSeries, column: ColumnSeries, column: { prototype: columnProto } } } = SeriesRegistry;
 import { addEvent, clamp, extend, isNumber, merge, pick } from '../../Shared/Utilities.js';
-/* *
- *
- *  Constants
- *
- * */
-/**
- * The column range is a cartesian series type with higher and lower
- * Y values along an X axis. To display horizontal bars, set
- * [chart.inverted](#chart.inverted) to `true`.
- *
- * @sample {highcharts|highstock} highcharts/demo/columnrange/
- *         Inverted column range
- *
- * @extends      plotOptions.column
- * @since        2.3.0
- * @excluding    negativeColor, stacking, softThreshold, threshold
- * @product      highcharts highstock
- * @requires     highcharts-more
- * @optionparent plotOptions.columnrange
- */
-const columnRangeOptions = {
-    borderRadius: {
-        where: 'all'
-    },
-    /**
-     * Extended data labels for range series types. Range series data labels
-     * have no `x` and `y` options. Instead, they have `xLow`, `xHigh`,
-     * `yLow` and `yHigh` options to allow the higher and lower data label
-     * sets individually.
-     *
-     * @declare   Highcharts.SeriesAreaRangeDataLabelsOptionsObject
-     * @extends   plotOptions.arearange.dataLabels
-     * @since     2.3.0
-     * @product   highcharts highstock
-     * @apioption plotOptions.columnrange.dataLabels
-     */
-    pointRange: null,
-    legendSymbol: 'rectangle',
-    /** @ignore-option */
-    marker: null,
-    states: {
-        hover: {
-            /** @ignore-option */
-            halo: false
-        }
-    }
-};
 /* *
  *
  *  Class
@@ -71,7 +25,7 @@ const columnRangeOptions = {
 /**
  * The ColumnRangeSeries class
  *
- * @private
+ * @internal
  * @class
  * @name Highcharts.seriesTypes.columnrange
  *
@@ -120,17 +74,17 @@ class ColumnRangeSeries extends AreaRangeSeries {
     translate3dShapes() {
         return columnProto.translate3dShapes.apply(this, arguments);
     }
+    /**
+     * Translate data points from raw values x and y to plotX and plotY
+     * @internal
+     */
     afterColumnTranslate() {
-        /**
-         * Translate data points from raw values x and y to plotX and plotY
-         * @private
-         */
         const yAxis = this.yAxis, xAxis = this.xAxis, startAngleRad = xAxis.startAngleRad, chart = this.chart, isRadial = this.xAxis.isRadial, safeDistance = Math.max(chart.chartWidth, chart.chartHeight) + 999;
         let height, heightDifference, start, y;
         // eslint-disable-next-line valid-jsdoc
         /**
          * Don't draw too far outside plot area (#6835)
-         * @private
+         * @internal
          */
         function safeBounds(pixelPos) {
             return clamp(pixelPos, -safeDistance, safeDistance);
@@ -189,7 +143,7 @@ class ColumnRangeSeries extends AreaRangeSeries {
  *  Static Properties
  *
  * */
-ColumnRangeSeries.defaultOptions = merge(ColumnSeries.defaultOptions, AreaRangeSeries.defaultOptions, columnRangeOptions);
+ColumnRangeSeries.defaultOptions = merge(ColumnSeries.defaultOptions, AreaRangeSeries.defaultOptions, ColumnRangeSeriesDefaults);
 addEvent(ColumnRangeSeries, 'afterColumnTranslate', function () {
     ColumnRangeSeries.prototype.afterColumnTranslate.apply(this);
 }, { order: 5 });
@@ -212,92 +166,5 @@ SeriesRegistry.registerSeriesType('columnrange', ColumnRangeSeries);
  *  Default Export
  *
  * */
+/** @internal */
 export default ColumnRangeSeries;
-/* *
- *
- *  API Options
- *
- * */
-/**
- * A `columnrange` series. If the [type](#series.columnrange.type)
- * option is not specified, it is inherited from
- * [chart.type](#chart.type).
- *
- * @extends   series,plotOptions.columnrange
- * @excluding dataParser, dataURL, stack, stacking
- * @product   highcharts highstock
- * @requires  highcharts-more
- * @apioption series.columnrange
- */
-/**
- * An array of data points for the series. For the `columnrange` series
- * type, points can be given in the following ways:
- *
- * 1. An array of arrays with 3 or 2 values. In this case, the values correspond
- *    to `x,low,high`. If the first value is a string, it is applied as the name
- *    of the point, and the `x` value is inferred. The `x` value can also be
- *    omitted, in which case the inner arrays should be of length 2\. Then the
- *    `x` value is automatically calculated, either starting at 0 and
- *    incremented by 1, or from `pointStart` and `pointInterval` given in the
- *    series options.
- *    ```js
- *    data: [
- *        [0, 4, 2],
- *        [1, 2, 1],
- *        [2, 9, 10]
- *    ]
- *    ```
- *
- * 2. An array of objects with named values. The following snippet shows only a
- *    few settings, see the complete options set below. If the total number of
- *    data points exceeds the series'
- *    [turboThreshold](#series.columnrange.turboThreshold), this option is not
- *    available.
- *    ```js
- *    data: [{
- *        x: 1,
- *        low: 0,
- *        high: 4,
- *        name: "Point2",
- *        color: "#00FF00"
- *    }, {
- *        x: 1,
- *        low: 5,
- *        high: 3,
- *        name: "Point1",
- *        color: "#FF00FF"
- *    }]
- *    ```
- *
- * @sample {highcharts} highcharts/series/data-array-of-arrays/
- *         Arrays of numeric x and y
- * @sample {highcharts} highcharts/series/data-array-of-arrays-datetime/
- *         Arrays of datetime x and y
- * @sample {highcharts} highcharts/series/data-array-of-name-value/
- *         Arrays of point.name and y
- * @sample {highcharts} highcharts/series/data-array-of-objects/
- *         Config objects
- *
- * @basic
- * @type      {Array<Array<(number|string),number>|Array<(number|string),number,number>|*>}
- * @extends   series.arearange.data
- * @excluding marker
- * @product   highcharts highstock
- * @apioption series.columnrange.data
- */
-/**
- * @extends   series.columnrange.dataLabels
- * @product   highcharts highstock
- * @apioption series.columnrange.data.dataLabels
- */
-/**
- * @excluding halo, lineWidth, lineWidthPlus, marker
- * @product   highcharts highstock
- * @apioption series.columnrange.states.hover
- */
-/**
- * @excluding halo, lineWidth, lineWidthPlus, marker
- * @product   highcharts highstock
- * @apioption series.columnrange.states.select
- */
-''; // Adds doclets above into transpiled