highcharts 10.0.0 → 10.2.1

package/es-modules/Series/Polygon/PolygonSeries.js

@@ -12,10 +12,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());

package/es-modules/Series/Pyramid/PyramidSeries.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());

package/es-modules/Series/Pyramid3D/Pyramid3DSeries.js

@@ -15,10 +15,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());

package/es-modules/Series/Sankey/SankeyPoint.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());

package/es-modules/Series/Sankey/SankeySeries.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
@@ -196,7 +198,11 @@ var SankeySeries = /** @class */ (function (_super) {
             return {};
         }
         var series = this, level = point.isNode ? point.level : point.fromNode.level, levelOptions = series.mapOptionsToLevel[level || 0] || {}, options = point.options, stateOptions = (levelOptions.states && levelOptions.states[state || '']) || {}, values = [
-            'colorByPoint', 'borderColor', 'borderWidth', 'linkOpacity'
+            'colorByPoint',
+            'borderColor',
+            'borderWidth',
+            'linkOpacity',
+            'opacity'
         ].reduce(function (obj, key) {
             obj[key] = pick(stateOptions[key], options[key], levelOptions[key], series.options[key]);
             return obj;
@@ -206,7 +212,8 @@ var SankeySeries = /** @class */ (function (_super) {
             return {
                 fill: color,
                 stroke: values.borderColor,
-                'stroke-width': values.borderWidth
+                'stroke-width': values.borderWidth,
+                opacity: values.opacity
             };
         }
         // Link attributes
@@ -388,8 +395,10 @@ var SankeySeries = /** @class */ (function (_super) {
             point.dlBox.x,
             point.dlBox.y + linkHeight / 2
         ];
-        // Pass test in drawPoints
+        // Pass test in drawPoints. plotX/Y needs to be defined for dataLabels.
+        // #15863
         point.y = point.plotY = 1;
+        point.x = point.plotX = 1;
         if (!point.color) {
             point.color = fromNode.color;
         }
@@ -473,6 +482,8 @@ var SankeySeries = /** @class */ (function (_super) {
      *               zones, minPointLength, dataSorting, boostBlending
      * @requires     modules/sankey
      * @optionparent plotOptions.sankey
+     *
+     * @private
      */
     SankeySeries.defaultOptions = merge(ColumnSeries.defaultOptions, {
         borderWidth: 0,
@@ -608,6 +619,12 @@ var SankeySeries = /** @class */ (function (_super) {
          * @private
          */
         linkOpacity: 0.5,
+        /**
+         * Opacity for the nodes in the sankey diagram.
+         *
+         * @private
+         */
+        opacity: 1,
         /**
          * The minimal width for a line of a sankey. By default,
          * 0 values are not shown.
@@ -648,7 +665,11 @@ var SankeySeries = /** @class */ (function (_super) {
                  * Opacity for the links between nodes in the sankey diagram in
                  * hover mode.
                  */
-                linkOpacity: 1
+                linkOpacity: 1,
+                /**
+                 * Opacity for the nodes in the sankey diagram in hover mode.
+                 */
+                opacity: 1
             },
             /**
              * The opposite state of a hover for a single point node/link.
@@ -662,10 +683,7 @@ var SankeySeries = /** @class */ (function (_super) {
                  */
                 linkOpacity: 0.1,
                 /**
-                 * Opacity of inactive markers.
-                 *
-                 * @type      {number}
-                 * @apioption plotOptions.series.states.inactive.opacity
+                 * Opacity of the nodes in the sankey diagram in inactive mode.
                  */
                 opacity: 0.1,
                 /**
@@ -1018,11 +1036,21 @@ export default SankeySeries;
  *     }]
  *  ```
  *
+ *  When you provide the data as tuples, the keys option has to be set as well.
+ *
+ *  ```js
+ *     keys: ['from', 'to', 'weight'],
+ *     data: [
+ *         ['Category1', 'Category2', 2],
+ *         ['Category1', 'Category3', 5]
+ *     ]
+ *  ```
+ *
  * @sample {highcharts} highcharts/series/data-array-of-objects/
  *         Config objects
  *
  * @declare   Highcharts.SeriesSankeyPointOptionsObject
- * @type      {Array<*>}
+ * @type      {Array<*>|Array<Array<(string|number)>>}
  * @extends   series.line.data
  * @excluding dragDrop, drilldown, marker, x, y
  * @product   highcharts

package/es-modules/Series/Scatter/ScatterSeries.js

@@ -12,18 +12,19 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-import ColumnSeries from '../Column/ColumnSeries.js';
-import LineSeries from '../Line/LineSeries.js';
 import SeriesRegistry from '../../Core/Series/SeriesRegistry.js';
+var _a = SeriesRegistry.seriesTypes, ColumnSeries = _a.column, LineSeries = _a.line;
 import U from '../../Core/Utilities.js';
 var addEvent = U.addEvent, extend = U.extend, merge = U.merge;
 /* *
@@ -39,6 +40,11 @@ var addEvent = U.addEvent, extend = U.extend, merge = U.merge;
 var ScatterSeries = /** @class */ (function (_super) {
     __extends(ScatterSeries, _super);
     function ScatterSeries() {
+        /* *
+         *
+         *  Static Properties
+         *
+         * */
         var _this = _super !== null && _super.apply(this, arguments) || this;
         /* *
          *
@@ -99,7 +105,6 @@ var ScatterSeries = /** @class */ (function (_super) {
     };
     /**
      * @private
-     * @function Highcharts.seriesTypes.scatter#drawGraph
      */
     ScatterSeries.prototype.drawGraph = function () {
         if (this.options.lineWidth) {
@@ -196,9 +201,12 @@ var ScatterSeries = /** @class */ (function (_super) {
          * series, in a scatter plot the series.name by default shows in the
          * headerFormat and point.x and point.y in the pointFormat.
          *
-         * @product highcharts highstock
+         * @product highcharts highstock highmaps
          */
         tooltip: {
+            /**
+             * @product highcharts highstock
+             */
             headerFormat: '<span style="color:{point.color}">\u25CF</span> ' +
                 '<span style="font-size: 10px"> {series.name}</span><br/>',
             pointFormat: 'x: <b>{point.x}</b><br/>y: <b>{point.y}</b><br/>'
@@ -303,4 +311,4 @@ export default ScatterSeries;
  * @product   highcharts highstock
  * @apioption series.scatter.data
  */
-''; // adds doclets above to transpilat
+''; // keeps doclets above in JS file

package/es-modules/Series/Scatter3D/Scatter3DPoint.js

@@ -14,10 +14,12 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());

package/es-modules/Series/Scatter3D/Scatter3DSeries.js

@@ -14,16 +14,18 @@ var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
             ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
         return extendStatics(d, b);
     };
     return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
         extendStatics(d, b);
         function __() { this.constructor = d; }
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
-import Math3D from '../../Extensions/Math3D.js';
+import Math3D from '../../Core/Math3D.js';
 var pointCameraDistance = Math3D.pointCameraDistance;
 import Scatter3DPoint from './Scatter3DPoint.js';
 import ScatterSeries from '../Scatter/ScatterSeries.js';

package/es-modules/Series/SeriesOnPointComposition.js

@@ -0,0 +1,395 @@
+/* *
+ *
+ *  (c) 2010-2022 Rafal Sebestjanski, Piotr Madej
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+import Point from '../Core/Series/Point.js';
+import Series from '../Core/Series/Series.js';
+import SeriesRegistry from '../Core/Series/SeriesRegistry.js';
+import SVGRenderer from '../Core/Renderer/SVG/SVGRenderer.js';
+var _a = SeriesRegistry.seriesTypes, bubble = _a.bubble, pie = _a.pie, sunburst = _a.sunburst;
+import U from '../Core/Utilities.js';
+var addEvent = U.addEvent, defined = U.defined, find = U.find, isNumber = U.isNumber;
+/* *
+ *
+ *  Composition
+ *
+ * */
+var SeriesOnPointComposition;
+(function (SeriesOnPointComposition) {
+    /* *
+     *
+     *  Declarations
+     *
+     * */
+    /* *
+     *
+     *  Constants
+     *
+     * */
+    var composedClasses = [];
+    /* *
+     *
+     *  Functions
+     *
+     * */
+    /* eslint-disable valid-jsdoc */
+    /**
+     * Extends the series with a small addition.
+     *
+     * @private
+     *
+     * @param SeriesClass
+     * Series class to use.
+     *
+     * @param ChartClass
+     * Chart class to use.
+     */
+    function compose(SeriesClass, ChartClass) {
+        var _a = Additions.prototype, chartGetZData = _a.chartGetZData, seriesAfterInit = _a.seriesAfterInit, seriesAfterRender = _a.seriesAfterRender, seriesGetCenter = _a.seriesGetCenter, seriesShowOrHide = _a.seriesShowOrHide, seriesTranslate = _a.seriesTranslate;
+        // We can mark support for pie series here because it's in the core.
+        // But all other series outside the core should be marked in its module.
+        // This is crucial when loading series-on-point before loading a
+        // module, e.g. sunburst.
+        // Supported series types:
+        // - pie
+        // - sunburst
+        pie.prototype.onPointSupported = true;
+        if (composedClasses.indexOf(SeriesClass) === -1) {
+            composedClasses.push(SeriesClass);
+            addEvent(Series, 'afterInit', seriesAfterInit);
+            addEvent(Series, 'afterRender', seriesAfterRender);
+            addEvent(Series, 'afterGetCenter', seriesGetCenter);
+            addEvent(Series, 'hide', seriesShowOrHide);
+            addEvent(Series, 'show', seriesShowOrHide);
+            addEvent(Series, 'translate', seriesTranslate);
+        }
+        if (composedClasses.indexOf(ChartClass) === -1) {
+            composedClasses.push(ChartClass);
+            addEvent(ChartClass, 'beforeRender', chartGetZData);
+            addEvent(ChartClass, 'beforeRedraw', chartGetZData);
+        }
+        return SeriesClass;
+    }
+    SeriesOnPointComposition.compose = compose;
+    /* *
+     *
+     *  Classes
+     *
+     * */
+    /**
+     * @private
+     */
+    var Additions = /** @class */ (function () {
+        /* *
+         *
+         *  Constructors
+         *
+         * */
+        /**
+         * @private
+         */
+        function Additions(series) {
+            /**
+             * @ignore
+             */
+            this.getRadii = bubble.prototype.getRadii;
+            /**
+             * @ignore
+             */
+            this.getRadius = bubble.prototype.getRadius;
+            /**
+             * @ignore
+             */
+            this.getPxExtremes = bubble.prototype.getPxExtremes;
+            /**
+             * @ignore
+             */
+            this.getZExtremes = bubble.prototype.getZExtremes;
+            this.chart = series.chart;
+            this.series = series;
+            this.options = series.options.onPoint;
+        }
+        /**
+         * Draw connector line that starts from the initial point's position
+         * and ends in the center of the series.
+         * @private
+         */
+        Additions.prototype.drawConnector = function () {
+            if (!this.connector) {
+                this.connector = this.series.chart.renderer.path()
+                    .addClass('highcharts-connector-seriesonpoint')
+                    .attr({
+                    zIndex: -1
+                })
+                    .add(this.series.markerGroup);
+            }
+            var attribs = this.getConnectorAttributes();
+            attribs && this.connector.animate(attribs);
+        };
+        /**
+         * Get connector line path and styles that connects series and point.
+         *
+         * @private
+         *
+         * @return {Highcharts.SVGAttributes} attribs - the path and styles.
+         */
+        Additions.prototype.getConnectorAttributes = function () {
+            var chart = this.series.chart, onPointOptions = this.options;
+            if (!onPointOptions) {
+                return;
+            }
+            var connectorOpts = onPointOptions.connectorOptions || {}, position = onPointOptions.position, connectedPoint = chart.get(onPointOptions.id);
+            if (!(connectedPoint instanceof Point) ||
+                !position ||
+                !defined(connectedPoint.plotX) ||
+                !defined(connectedPoint.plotY)) {
+                return;
+            }
+            var xFrom = defined(position.x) ?
+                position.x :
+                connectedPoint.plotX, yFrom = defined(position.y) ?
+                position.y :
+                connectedPoint.plotY, xTo = xFrom + (position.offsetX || 0), yTo = yFrom + (position.offsetY || 0), width = connectorOpts.width || 1, color = connectorOpts.stroke || this.series.color, dashStyle = connectorOpts.dashstyle, attribs = {
+                d: SVGRenderer.prototype.crispLine([
+                    ['M', xFrom, yFrom],
+                    ['L', xTo, yTo]
+                ], width, 'ceil'),
+                'stroke-width': width
+            };
+            if (!chart.styledMode) {
+                attribs.stroke = color;
+                attribs.dashstyle = dashStyle;
+            }
+            return attribs;
+        };
+        /**
+         * Initialize Series on point on series init.
+         *
+         * @ignore
+         */
+        Additions.prototype.seriesAfterInit = function () {
+            if (this.onPointSupported && this.options.onPoint) {
+                this.bubblePadding = true;
+                this.useMapGeometry = true;
+                this.onPoint = new Additions(this);
+            }
+        };
+        /**
+         * @ignore
+         */
+        Additions.prototype.seriesAfterRender = function () {
+            // Clear bubbleZExtremes to reset z calculations on update.
+            delete this.chart.bubbleZExtremes;
+            this.onPoint && this.onPoint.drawConnector();
+        };
+        /**
+         * Recalculate series.center (x, y and size).
+         *
+         * @ignore
+         */
+        Additions.prototype.seriesGetCenter = function (e) {
+            var onPointOptions = this.options.onPoint, center = e.positions;
+            if (onPointOptions) {
+                var connectedPoint = this.chart.get(onPointOptions.id);
+                if (connectedPoint instanceof Point &&
+                    defined(connectedPoint.plotX) &&
+                    defined(connectedPoint.plotY)) {
+                    center[0] = connectedPoint.plotX;
+                    center[1] = connectedPoint.plotY;
+                }
+                var position = onPointOptions.position;
+                if (position) {
+                    if (defined(position.x)) {
+                        center[0] = position.x;
+                    }
+                    if (defined(position.y)) {
+                        center[1] = position.y;
+                    }
+                    if (position.offsetX) {
+                        center[0] += position.offsetX;
+                    }
+                    if (position.offsetY) {
+                        center[1] += position.offsetY;
+                    }
+                }
+            }
+            // Get and set the size
+            var radius = this.radii && this.radii[this.index];
+            if (isNumber(radius)) {
+                center[2] = radius * 2;
+            }
+            e.positions = center;
+        };
+        /**
+         * @ignore
+         */
+        Additions.prototype.seriesShowOrHide = function () {
+            var allSeries = this.chart.series;
+            // When toggling a series visibility, loop through all points
+            this.points.forEach(function (point) {
+                // Find all series that are on toggled points
+                var series = find(allSeries, function (series) {
+                    var id = ((series.onPoint || {}).options || {}).id;
+                    if (!id) {
+                        return false;
+                    }
+                    return id === point.id;
+                });
+                // And also toggle series that are on toggled points. Redraw is
+                // not needed because it's fired later after showOrhide event
+                series && series.setVisible(!series.visible, false);
+            });
+        };
+        /**
+         * Calculate required radius (z data) before original translate.
+         *
+         * @ignore
+         * @function Highcharts.Series#translate
+         */
+        Additions.prototype.seriesTranslate = function () {
+            if (this.onPoint) {
+                this.onPoint.getRadii();
+                this.radii = this.onPoint.radii;
+            }
+        };
+        /**
+         * @ignore
+         */
+        Additions.prototype.chartGetZData = function () {
+            var zData = [];
+            this.series.forEach(function (series) {
+                var onPointOpts = series.options.onPoint;
+                zData.push(onPointOpts && onPointOpts.z ? onPointOpts.z : null);
+            });
+            this.series.forEach(function (series) {
+                // Save z values of all the series
+                if (series.onPoint) {
+                    series.onPoint.zData = series.zData = zData;
+                }
+            });
+        };
+        return Additions;
+    }());
+    SeriesOnPointComposition.Additions = Additions;
+})(SeriesOnPointComposition || (SeriesOnPointComposition = {}));
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default SeriesOnPointComposition;
+/* *
+ *
+ *  API Options
+ *
+ * */
+/**
+ * Options for the _Series on point_ feature. Only `pie` and `sunburst` series
+ * are supported at this moment.
+ *
+ * @sample      {highcharts} highcharts/series-on-point/series-on-point
+ *              Series on point
+ * @sample      {highmaps} maps/demo/map-pies
+ *              Pies on a map
+ * @requires    modules/series-on-point
+ * @since 10.2.0
+ * @type        {object}
+ * @apioption   plotOptions.series.onPoint
+ */
+/**
+ * Options for the connector in the _Series on point_ feature.
+ *
+ * In styled mode, the connector can be styled with the
+ * `.highcharts-connector-seriesonpoint` class name.
+ *
+ * @requires    modules/series-on-point
+ * @since 10.2.0
+ * @type        {Highcharts.SVGAttributes}
+ * @apioption   plotOptions.series.onPoint.connectorOptions
+ */
+/**
+ * Color of the connector line. By default it's the series' color.
+ *
+ * @requires    modules/series-on-point
+ * @since 10.2.0
+ * @type        {string}
+ * @apioption   plotOptions.series.onPoint.connectorOptions.stroke
+ */
+/**
+ * A name for the dash style to use for the connector.
+ *
+ * @requires    modules/series-on-point
+ * @since 10.2.0
+ * @type        {string}
+ * @apioption   plotOptions.series.onPoint.connectorOptions.dashstyle
+ */
+/**
+ * Pixel width of the connector line.
+ *
+ * @default     1
+ * @requires    modules/series-on-point
+ * @type        {number}
+ * @since 10.2.0
+ * @apioption   plotOptions.series.onPoint.connectorOptions.width
+ */
+/**
+ * The `id` of the point that we connect the series to. Only points with a given
+ * `plotX` and `plotY` values and map points are valid.
+ *
+ * @requires   modules/series-on-point
+ * @since 10.2.0
+ * @type       {string}
+ * @apioption  plotOptions.series.onPoint.id
+ */
+/**
+ * Options allowing to set a position and an offset of the series in the
+ * _Series on point_ feature.
+ *
+ * @requires    modules/series-on-point
+ * @since 10.2.0
+ * @type        {object}
+ * @apioption   plotOptions.series.onPoint.position
+ */
+/**
+ * Series center offset from the original x position. If defined, the connector
+ * line is drawn connecting original position with new position.
+ *
+ * @requires   modules/series-on-point
+ * @since 10.2.0
+ * @type       {number}
+ * @apioption  plotOptions.series.onPoint.position.offsetX
+ */
+/**
+ * Series center offset from the original y position. If defined, the connector
+ * line is drawn from original position to a new position.
+ *
+ * @requires   modules/series-on-point
+ * @since 10.2.0
+ * @type       {number}
+ * @apioption  plotOptions.series.onPoint.position.offsetY
+ */
+/**
+ * X position of the series center. By default, the series is displayed on the
+ * point that it is connected to.
+ *
+ * @requires   modules/series-on-point
+ * @since 10.2.0
+ * @type       {number}
+ * @apioption  plotOptions.series.onPoint.position.x
+ */
+/**
+ * Y position of the series center. By default, the series is displayed on the
+ * point that it is connected to.
+ *
+ * @requires   modules/series-on-point
+ * @since 10.2.0
+ * @type       {number}
+ * @apioption  plotOptions.series.onPoint.position.y
+ */
+''; // keeps doclets above in transpiled file