highcharts 6.1.1 → 6.2.0

package/js/es-modules/parts/Series.js

@@ -1,15 +1,32 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
+
+/**
+ * Translation and scale for the plot area of a series.
+ *
+ * @typedef Highcharts.SeriesPlotBoxObject
+ *
+ * @property {number} translateX
+ *
+ * @property {number} translateY
+ *
+ * @property {number} scaleX
+ *
+ * @property {number} scaleY
+ */
+
 'use strict';
+
 import H from './Globals.js';
 import './Utilities.js';
 import './Options.js';
 import './Legend.js';
 import './Point.js';
 import './SvgRenderer.js';
+
 var addEvent = H.addEvent,
     animObject = H.animObject,
     arrayMax = H.arrayMax,
@@ -40,8 +57,8 @@ var addEvent = H.addEvent,
 /**
  * This is the base series prototype that all other series types inherit from.
  * A new series is initialized either through the
- * {@link https://api.highcharts.com/highcharts/series|series} option structure,
- * or after the chart is initialized, through
+ * {@link https://api.highcharts.com/highcharts/series|series}
+ * option structure, or after the chart is initialized, through
  * {@link Highcharts.Chart#addSeries}.
  *
  * The object can be accessed in a number of ways. All series and point event
@@ -51,8 +68,8 @@ var addEvent = H.addEvent,
  * reference.
  *
  * Another way to reference the series programmatically is by `id`. Add an id
- * in the series configuration options, and get the series object by {@link
- * Highcharts.Chart#get}.
+ * in the series configuration options, and get the series object by
+ * {@link Highcharts.Chart#get}.
  *
  * Configuration options for the series are given in three levels. Options for
  * all series in a chart are given in the
@@ -65,34 +82,51 @@ var addEvent = H.addEvent,
  * The data in the series is stored in various arrays.
  *
  * - First, `series.options.data` contains all the original config options for
- * each point whether added by options or methods like `series.addPoint`.
+ *   each point whether added by options or methods like `series.addPoint`.
+ *
  * - Next, `series.data` contains those values converted to points, but in case
- * the series data length exceeds the `cropThreshold`, or if the data is
- * grouped, `series.data` doesn't contain all the points. It only contains the
- * points that have been created on demand.
+ *   the series data length exceeds the `cropThreshold`, or if the data is
+ *   grouped, `series.data` doesn't contain all the points. It only contains the
+ *   points that have been created on demand.
+ *
  * - Then there's `series.points` that contains all currently visible point
- * objects. In case of cropping, the cropped-away points are not part of this
- * array. The `series.points` array starts at `series.cropStart` compared to
- * `series.data` and `series.options.data`. If however the series data is
- * grouped, these can't be correlated one to one.
+ *   objects. In case of cropping, the cropped-away points are not part of this
+ *   array. The `series.points` array starts at `series.cropStart` compared to
+ *   `series.data` and `series.options.data`. If however the series data is
+ *   grouped, these can't be correlated one to one.
+ *
  * - `series.xData` and `series.processedXData` contain clean x values,
- * equivalent to `series.data` and `series.points`.
+ *   equivalent to `series.data` and `series.points`.
+ *
  * - `series.yData` and `series.processedYData` contain clean y values,
- * equivalent to `series.data` and `series.points`.
+ *   equivalent to `series.data` and `series.points`.
+ *
+ * @class
+ * @name Highcharts.Series
+ *
+ * @param {Highcharts.Chart} chart
+ *        The chart instance.
+ *
+ * @param {Highcharts.PlotSeriesOptions} options
+ *        The series options.
+ *//**
+ * The line series is the base type and is therefor the series base prototype.
  *
- * @class Highcharts.Series
- * @param  {Highcharts.Chart} chart
- *         The chart instance.
- * @param  {Options.plotOptions.series} options
- *         The series options.
+ * @private
+ * @class
+ * @name Highcharts.seriesTypes.line
  *
+ * @augments Highcharts.Series
  */
+H.Series = H.seriesType('line', null
 
 /**
  * General options for all series types.
+ *
  * @optionparent plotOptions.series
  */
-H.Series = H.seriesType('line', null, { // base series options
+, { // base series options
+
     
 
     /**
@@ -102,7 +136,7 @@ H.Series = H.seriesType('line', null, { // base series options
      * run if there is more than 250 points totally. To disable this cap, set
      * `animationLimit` to `Infinity`.
      *
-     * @type {Number}
+     * @type      {number}
      * @apioption plotOptions.series.animationLimit
      */
 
@@ -110,13 +144,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * Allow this series' points to be selected by clicking on the graphic
      * (columns, point markers, pie slices, map areas etc).
      *
-     * @see [Chart#getSelectedPoints](Highcharts.Chart#getSelectedPoints).
+     * @see {@link Highcharts.Chart#getSelectedPoints}.
      *
-     * @type {Boolean}
      * @sample {highcharts} highcharts/plotoptions/series-allowpointselect-line/
      *         Line
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-allowpointselect-column/
+     * @sample {highcharts} highcharts/plotoptions/series-allowpointselect-column/
      *         Column
      * @sample {highcharts} highcharts/plotoptions/series-allowpointselect-pie/
      *         Pie
@@ -124,13 +156,11 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Map area
      * @sample {highmaps} maps/plotoptions/mapbubble-allowpointselect/
      *         Map bubble
-     * @default false
+     *
      * @since 1.2.0
      */
     allowPointSelect: false,
 
-
-
     /**
      * If true, a checkbox is displayed next to the legend item to allow
      * selecting the series. The state of the checkbox is determined by
@@ -140,16 +170,13 @@ H.Series = H.seriesType('line', null, { // base series options
      * Note that if a `colorAxis` is defined, the color axis is represented in
      * the legend, not the series.
      *
-     * @type {Boolean}
      * @sample {highcharts} highcharts/plotoptions/series-showcheckbox-true/
      *         Show select box
-     * @default false
+     *
      * @since 1.2.0
      */
     showCheckbox: false,
 
-
-
     /**
      * Enable or disable the initial animation when a series is displayed.
      * The animation can also be set as a configuration object. Please
@@ -166,15 +193,14 @@ H.Series = H.seriesType('line', null, { // base series options
      *
      * <dt>easing</dt>
      *
-     * <dd>A string reference to an easing function set on the `Math` object.
-     * See the _Custom easing function_ demo below.</dd>
+     * <dd>Can be a string reference to an easing function set on the `Math`
+     * object or a function. See the _Custom easing function_ demo below.</dd>
      *
      * </dl>
      *
      * Due to poor performance, animation is disabled in old IE browsers
      * for several chart types.
      *
-     * @type {Boolean}
      * @sample {highcharts} highcharts/plotoptions/series-animation-disabled/
      *         Animation disabled
      * @sample {highcharts} highcharts/plotoptions/series-animation-slower/
@@ -189,22 +215,47 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Animation enabled on map series
      * @sample {highmaps} maps/plotoptions/mapbubble-animation-false/
      *         Disabled on mapbubble series
+     *
+     * @type    {boolean|Highcharts.AnimationOptionsObject}
      * @default {highcharts} true
      * @default {highstock} true
      * @default {highmaps} false
      */
     animation: {
+
+        /**
+         * @type      {number}
+         * @default   1000
+         * @apioption plotOptions.series.animation.duration
+         */
         duration: 1000
     },
 
     /**
      * An additional class name to apply to the series' graphical elements. This
      * option does not replace default class names of the graphical element.
-     * @type {String}
-     * @since 5.0.0
+     *
+     * @type      {string}
+     * @since     5.0.0
      * @apioption plotOptions.series.className
      */
 
+    /**
+     * Disable this option to allow series rendering in the whole plotting
+     * area.
+     *
+     * **Note:** Clipping should be always enabled when
+     * [chart.zoomType](#chart.zoomType) is set
+     *
+     * @sample {highcharts} highcharts/plotoptions/series-clip/
+     *         Disabled clipping
+     *
+     * @default   true
+     * @type      {boolean}
+     * @since     3.0.0
+     * @apioption plotOptions.series.clip
+     */
+
     /**
      * The main color of the series. In line type series it applies to the
      * line and the point markers unless otherwise specified. In bar type
@@ -222,15 +273,18 @@ H.Series = H.seriesType('line', null, { // base series options
      * color to denote the value of each point. The series color can however be
      * used in a map with multiple series holding categorized data.
      *
-     * @type {Color}
      * @sample {highcharts} highcharts/plotoptions/series-color-general/
      *         General plot option
      * @sample {highcharts} highcharts/plotoptions/series-color-specific/
      *         One specific series
      * @sample {highcharts} highcharts/plotoptions/series-color-area/
      *         Area color
+     * @sample {highcharts} highcharts/series/infographic/
+     *         Pattern fill
      * @sample {highmaps} maps/demo/category-map/
      *         Category map by multiple series
+     *
+     * @type      {Highcharts.ColorString}
      * @apioption plotOptions.series.color
      */
 
@@ -238,8 +292,8 @@ H.Series = H.seriesType('line', null, { // base series options
      * Styled mode only. A specific color index to use for the series, so its
      * graphic representations are given the class name `highcharts-color-{n}`.
      *
-     * @type {Number}
-     * @since 5.0.0
+     * @type      {number}
+     * @since     5.0.0
      * @apioption plotOptions.series.colorIndex
      */
 
@@ -248,13 +302,14 @@ H.Series = H.seriesType('line', null, { // base series options
      * Whether to connect a graph line across null points, or render a gap
      * between the two points on either side of the null.
      *
-     * @type {Boolean}
-     * @default  false
      * @sample {highcharts} highcharts/plotoptions/series-connectnulls-false/
      *         False by default
      * @sample {highcharts} highcharts/plotoptions/series-connectnulls-true/
      *         True
-     * @product highcharts highstock
+     *
+     * @type      {boolean}
+     * @default   false
+     * @product   highcharts highstock
      * @apioption plotOptions.series.connectNulls
      */
 
@@ -264,10 +319,9 @@ H.Series = H.seriesType('line', null, { // base series options
      * to the series, to signal to the user that the points and lines can
      * be clicked.
      *
-     * @validvalue [null, "default", "none", "help", "pointer", "crosshair"]
-     * @type {String}
-     * @see In styled mode, the series cursor can be set with the same classes
+     * In styled mode, the series cursor can be set with the same classes
      * as listed under [series.color](#plotOptions.series.color).
+     *
      * @sample {highcharts} highcharts/plotoptions/series-cursor-line/
      *         On line graph
      * @sample {highcharts} highcharts/plotoptions/series-cursor-column/
@@ -280,31 +334,18 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Map area
      * @sample {highmaps} maps/plotoptions/mapbubble-allowpointselect/
      *         Map bubble
-     * @apioption plotOptions.series.cursor
+     *
+     * @type       {string}
+     * @validvalue ["crosshair","default","help","none","pointer"]
+     * @apioption  plotOptions.series.cursor
      */
 
 
     /**
      * A name for the dash style to use for the graph, or for some series types
-     * the outline of each shape. The value for the `dashStyle` include:
-     *
-     * *   Solid
-     * *   ShortDash
-     * *   ShortDot
-     * *   ShortDashDot
-     * *   ShortDashDotDot
-     * *   Dot
-     * *   Dash
-     * *   LongDash
-     * *   DashDot
-     * *   LongDashDot
-     * *   LongDashDotDot
-     *
-     * @validvalue ["Solid", "ShortDash", "ShortDot", "ShortDashDot",
-     *             "ShortDashDotDot", "Dot", "Dash" ,"LongDash", "DashDot",
-     *             "LongDashDot", "LongDashDotDot"]
-     * @type {String}
-     * @see In styled mode, the [stroke dash-array](http://jsfiddle.net/gh/get/
+     * the outline of each shape.
+     *
+     * In styled mode, the [stroke dash-array](https://jsfiddle.net/gh/get/
      * library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/
      * series-dashstyle/) can be set with the same classes as listed under
      * [series.color](#plotOptions.series.color).
@@ -319,9 +360,14 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Possible values demonstrated
      * @sample {highmaps} maps/plotoptions/series-dashstyle/
      *         Dotted borders on a map
-     * @default Solid
-     * @since 2.1
-     * @apioption plotOptions.series.dashStyle
+     *
+     * @type       {string}
+     * @default    Solid
+     * @since      2.1
+     * @validvalue ["Dash","DashDot","Dot","LongDash","LongDashDot",
+     *             "LongDashDotDot","ShortDash","ShortDashDot",
+     *             "ShortDashDotDot","ShortDot","Solid"]
+     * @apioption  plotOptions.series.dashStyle
      */
 
     /**
@@ -330,29 +376,23 @@ H.Series = H.seriesType('line', null, { // base series options
      * A description of the series to add to the screen reader information
      * about the series.
      *
-     * @type {String}
-     * @default undefined
-     * @since 5.0.0
+     * @type      {string}
+     * @since     5.0.0
      * @apioption plotOptions.series.description
      */
 
-
-
-
-
     /**
      * Enable or disable the mouse tracking for a specific series. This
      * includes point tooltips and click events on graphs and points. For
      * large datasets it improves performance.
      *
-     * @type {Boolean}
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-enablemousetracking-false/
+     * @sample {highcharts} highcharts/plotoptions/series-enablemousetracking-false/
      *         No mouse tracking
-     * @sample {highmaps}
-     *         maps/plotoptions/series-enablemousetracking-false/
+     * @sample {highmaps} maps/plotoptions/series-enablemousetracking-false/
      *         No mouse tracking
-     * @default true
+     *
+     * @type      {boolean}
+     * @default   true
      * @apioption plotOptions.series.enableMouseTracking
      */
 
@@ -365,11 +405,11 @@ H.Series = H.seriesType('line', null, { // base series options
      *
      * Requires the Accessibility module.
      *
-     * @type {Boolean}
      * @sample highcharts/accessibility/art-grants/
      *         Accessible data visualization
-     * @default undefined
-     * @since 5.0.12
+     *
+     * @type      {boolean}
+     * @since     5.0.12
      * @apioption plotOptions.series.exposeElementToA11y
      */
 
@@ -379,69 +419,38 @@ H.Series = H.seriesType('line', null, { // base series options
      * Y axis adjusts to the min and max of the visible data. Cartesian
      * series only.
      *
-     * @type {Boolean}
-     * @default false
-     * @since 4.1.6
-     * @product highcharts highstock
+     * @type      {boolean}
+     * @default   false
+     * @since     4.1.6
+     * @product   highcharts highstock gantt
      * @apioption plotOptions.series.getExtremesFromAll
      */
 
-    /**
-     * An id for the series. This can be used after render time to get a
-     * pointer to the series object through `chart.get()`.
-     *
-     * @type {String}
-     * @sample {highcharts} highcharts/plotoptions/series-id/ Get series by id
-     * @since 1.2.0
-     * @apioption series.id
-     */
-
-    /**
-     * The index of the series in the chart, affecting the internal index
-     * in the `chart.series` array, the visible Z index as well as the order
-     * in the legend.
-     *
-     * @type {Number}
-     * @default undefined
-     * @since 2.3.0
-     * @apioption series.index
-     */
-
     /**
      * An array specifying which option maps to which key in the data point
      * array. This makes it convenient to work with unstructured data arrays
      * from different sources.
      *
-     * @type {Array<String>}
      * @see [series.data](#series.line.data)
+     *
      * @sample {highcharts|highstock} highcharts/series/data-keys/
      *         An extended data array with keys
      * @sample {highcharts|highstock} highcharts/series/data-nested-keys/
      *         Nested keys used to access object properties
-     * @since 4.1.6
-     * @product highcharts highstock
-     * @apioption plotOptions.series.keys
-     */
-
-    /**
-     * The sequential index of the series in the legend.
      *
-     * @sample {highcharts|highstock} highcharts/series/legendindex/
-     *         Legend in opposite order
-     * @type   {Number}
-     * @see    [legend.reversed](#legend.reversed),
-     *         [yAxis.reversedStacks](#yAxis.reversedStacks)
-     * @apioption series.legendIndex
+     * @type      {Array<string>}
+     * @since     4.1.6
+     * @apioption plotOptions.series.keys
      */
 
     /**
      * The line cap used for line ends and line joins on the graph.
      *
+     * @type       {string}
+     * @default    round
+     * @product    highcharts highstock
      * @validvalue ["round", "square"]
-     * @type {String}
-     * @default round
-     * @product highcharts highstock
-     * @apioption plotOptions.series.linecap
+     * @apioption  plotOptions.series.linecap
      */
 
     /**
@@ -450,30 +459,39 @@ H.Series = H.seriesType('line', null, { // base series options
      * two series are linked, only the first one appears in the legend.
      * Toggling the visibility of this also toggles the linked series.
      *
-     * @type {String}
-     * @sample {highcharts} highcharts/demo/arearange-line/ Linked series
-     * @sample {highstock} highcharts/demo/arearange-line/ Linked series
-     * @since 3.0
-     * @product highcharts highstock
+     * @sample {highcharts|highstock} highcharts/demo/arearange-line/
+     *         Linked series
+     *
+     * @type      {string}
+     * @since     3.0
+     * @product   highcharts highstock gantt
      * @apioption plotOptions.series.linkedTo
      */
 
     /**
-     * The name of the series as shown in the legend, tooltip etc.
+     * Options for the corresponding navigator series if `showInNavigator`
+     * is `true` for this series. Available options are the same as any
+     * series, documented at [plotOptions](#plotOptions.series) and
+     * [series](#series).
      *
-     * @type {String}
-     * @sample {highcharts} highcharts/series/name/ Series name
-     * @sample {highmaps} maps/demo/category-map/ Series name
-     * @apioption series.name
+     * These options are merged with options in [navigator.series](
+     * #navigator.series), and will take precedence if the same option is
+     * defined both places.
+     *
+     * @see [navigator.series](#navigator.series)
+     *
+     * @type      {*}
+     * @since     5.0.0
+     * @product   highstock
+     * @apioption plotOptions.series.navigatorOptions
      */
 
     /**
      * The color for the parts of the graph or points that are below the
      * [threshold](#plotOptions.series.threshold).
      *
-     * @type {Color}
-     * @see In styled mode, a negative color is applied by setting this
-     * option to `true` combined with the `.highcharts-negative` class name.
+     * @see In styled mode, a negative color is applied by setting this option
+     *      to `true` combined with the `.highcharts-negative` class name.
      *
      * @sample {highcharts} highcharts/plotoptions/series-negative-color/
      *         Spline, area and column
@@ -489,8 +507,9 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Spline, area and column
      * @sample {highmaps} highcharts/plotoptions/arearange-negativecolor/
      *         Arearange
-     * @default null
-     * @since 3.0
+     *
+     * @type      {Highcharts.ColorString}
+     * @since     3.0
      * @apioption plotOptions.series.negativeColor
      */
 
@@ -499,8 +518,8 @@ H.Series = H.seriesType('line', null, { // base series options
      * #accessibility.pointDescriptionFormatter), but for an individual series.
      * Overrides the chart wide configuration.
      *
-     * @type {Function}
-     * @since 5.0.12
+     * @type      {Function}
+     * @since     5.0.12
      * @apioption plotOptions.series.pointDescriptionFormatter
      */
 
@@ -517,13 +536,14 @@ H.Series = H.seriesType('line', null, { // base series options
      * Please note that this options applies to the _series data_, not the
      * interval of the axis ticks, which is independent.
      *
-     * @type {Number}
      * @sample {highcharts} highcharts/plotoptions/series-pointstart-datetime/
      *         Datetime X axis
      * @sample {highstock} stock/plotoptions/pointinterval-pointstart/
      *         Using pointStart and pointInterval
-     * @default 1
-     * @product highcharts highstock
+     *
+     * @type      {number}
+     * @default   1
+     * @product   highcharts highstock gantt
      * @apioption plotOptions.series.pointInterval
      */
 
@@ -538,19 +558,20 @@ H.Series = H.seriesType('line', null, { // base series options
      * Please note that this options applies to the _series data_, not the
      * interval of the axis ticks, which is independent.
      *
-     * @validvalue [null, "day", "month", "year"]
-     * @type {String}
      * @sample {highcharts} highcharts/plotoptions/series-pointintervalunit/
      *         One point a month
      * @sample {highstock} highcharts/plotoptions/series-pointintervalunit/
      *         One point a month
-     * @since 4.1.0
-     * @product highcharts highstock
-     * @apioption plotOptions.series.pointIntervalUnit
+     *
+     * @type       {string}
+     * @since      4.1.0
+     * @product    highcharts highstock gantt
+     * @validvalue ["day", "month", "year"]
+     * @apioption  plotOptions.series.pointIntervalUnit
      */
 
     /**
-     * Possible values: `null`, `"on"`, `"between"`.
+     * Possible values: `"on"`, `"between"`, `number`.
      *
      * In a column chart, when pointPlacement is `"on"`, the point will
      * not create any padding of the X axis. In a polar column chart this
@@ -569,20 +590,22 @@ H.Series = H.seriesType('line', null, { // base series options
      * #plotOptions.series.pointRange) to work. For column series this is
      * computed, but for line-type series it needs to be set.
      *
-     * Defaults to `null` in cartesian charts, `"between"` in polar charts.
+     * For the `xrange` series type and gantt charts, if the Y axis is a
+     * category axis, the `pointPlacement` applies to the Y axis rather than
+     * the (typically datetime) X axis.
+     *
+     * Defaults to `undefined` in cartesian charts, `"between"` in polar charts.
      *
-     * @validvalue [null, "on", "between"]
-     * @type {String|Number}
      * @see [xAxis.tickmarkPlacement](#xAxis.tickmarkPlacement)
-     * @sample {highcharts|highstock}
-     *         highcharts/plotoptions/series-pointplacement-between/
+     *
+     * @sample {highcharts|highstock} highcharts/plotoptions/series-pointplacement-between/
      *         Between in a column chart
-     * @sample {highcharts|highstock}
-     *         highcharts/plotoptions/series-pointplacement-numeric/
+     * @sample {highcharts|highstock} highcharts/plotoptions/series-pointplacement-numeric/
      *         Numeric placement for custom layout
-     * @default null
-     * @since 2.3.0
-     * @product highcharts highstock
+     *
+     * @type      {string|number}
+     * @since     2.3.0
+     * @product   highcharts highstock gantt
      * @apioption plotOptions.series.pointPlacement
      */
 
@@ -591,15 +614,16 @@ H.Series = H.seriesType('line', null, { // base series options
      * on what value to start. For example, if a series contains one yearly
      * value starting from 1945, set pointStart to 1945.
      *
-     * @type {Number}
      * @sample {highcharts} highcharts/plotoptions/series-pointstart-linear/
      *         Linear
      * @sample {highcharts} highcharts/plotoptions/series-pointstart-datetime/
      *         Datetime
      * @sample {highstock} stock/plotoptions/pointinterval-pointstart/
      *         Using pointStart and pointInterval
-     * @default 0
-     * @product highcharts highstock
+     *
+     * @type      {number}
+     * @default   0
+     * @product   highcharts highstock gantt
      * @apioption plotOptions.series.pointStart
      */
 
@@ -608,22 +632,25 @@ H.Series = H.seriesType('line', null, { // base series options
      * the checkbox next to the series name in the legend will be checked for a
      * selected series.
      *
-     * @type {Boolean}
      * @sample {highcharts} highcharts/plotoptions/series-selected/
      *         One out of two series selected
-     * @default false
-     * @since 1.2.0
+     *
+     * @type      {boolean}
+     * @default   false
+     * @since     1.2.0
      * @apioption plotOptions.series.selected
      */
 
     /**
      * Whether to apply a drop shadow to the graph line. Since 2.3 the shadow
      * can be an object configuration containing `color`, `offsetX`, `offsetY`,
-     *  `opacity` and `width`.
+     * `opacity` and `width`.
      *
-     * @type {Boolean|Object}
-     * @sample {highcharts} highcharts/plotoptions/series-shadow/ Shadow enabled
-     * @default false
+     * @sample {highcharts} highcharts/plotoptions/series-shadow/
+     *         Shadow enabled
+     *
+     * @type      {boolean|Highcharts.ShadowOptionsObject}
+     * @default   false
      * @apioption plotOptions.series.shadow
      */
 
@@ -632,45 +659,42 @@ H.Series = H.seriesType('line', null, { // base series options
      * The default value is `true` for standalone series, `false` for linked
      * series.
      *
-     * @type {Boolean}
      * @sample {highcharts} highcharts/plotoptions/series-showinlegend/
      *         One series in the legend, one hidden
-     * @default true
+     *
+     * @type      {boolean}
+     * @default   true
      * @apioption plotOptions.series.showInLegend
      */
 
     /**
-     * If set to `True`, the accessibility module will skip past the points
-     * in this series for keyboard navigation.
+     * Whether or not to show the series in the navigator. Takes precedence
+     * over [navigator.baseSeries](#navigator.baseSeries) if defined.
      *
-     * @type {Boolean}
-     * @since 5.0.12
-     * @apioption plotOptions.series.skipKeyboardNavigation
+     * @type      {boolean}
+     * @since     5.0.0
+     * @product   highstock
+     * @apioption plotOptions.series.showInNavigator
      */
 
     /**
-     * This option allows grouping series in a stacked chart. The stack
-     * option can be a string or a number or anything else, as long as the
-     * grouped series' stack options match each other.
-     *
-     * @type {String}
-     * @sample {highcharts} highcharts/series/stack/ Stacked and grouped columns
-     * @default null
-     * @since 2.1
-     * @product highcharts highstock
-     * @apioption series.stack
+     * If set to `true`, the accessibility module will skip past the points
+     * in this series for keyboard navigation.
+     *
+     * @type      {boolean}
+     * @since     5.0.12
+     * @apioption plotOptions.series.skipKeyboardNavigation
      */
 
     /**
-     * Whether to stack the values of each series on top of each other.
-     * Possible values are `null` to disable, `"normal"` to stack by value or
+     * Whether to stack the values of each series on top of each other. Possible
+     * values are `undefined` to disable, `"normal"` to stack by value or
      * `"percent"`. When stacking is enabled, data must be sorted in ascending
      * X order. A special stacking option is with the streamgraph series type,
      * where the stacking option is set to `"stream"`.
      *
-     * @validvalue [null, "normal", "percent"]
-     * @type {String}
      * @see [yAxis.reversedStacks](#yAxis.reversedStacks)
+     *
      * @sample {highcharts} highcharts/plotoptions/series-stacking-line/
      *         Line
      * @sample {highcharts} highcharts/plotoptions/series-stacking-column/
@@ -681,8 +705,7 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Area
      * @sample {highcharts} highcharts/plotoptions/series-stacking-percent-line/
      *         Line
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-stacking-percent-column/
+     * @sample {highcharts} highcharts/plotoptions/series-stacking-percent-column/
      *         Column
      * @sample {highcharts} highcharts/plotoptions/series-stacking-percent-bar/
      *         Bar
@@ -690,28 +713,29 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Area
      * @sample {highstock} stock/plotoptions/stacking/
      *         Area
-     * @default null
-     * @product highcharts highstock
-     * @apioption plotOptions.series.stacking
+     *
+     * @type       {string}
+     * @product    highcharts highstock
+     * @validvalue ["normal", "percent"]
+     * @apioption  plotOptions.series.stacking
      */
 
     /**
      * Whether to apply steps to the line. Possible values are `left`, `center`
      * and `right`.
      *
-     * @validvalue [null, "left", "center", "right"]
-     * @type {String}
      * @sample {highcharts} highcharts/plotoptions/line-step/
      *         Different step line options
      * @sample {highcharts} highcharts/plotoptions/area-step/
      *         Stepped, stacked area
      * @sample {highstock} stock/plotoptions/line-step/
      *         Step line
-     * @default {highcharts} null
-     * @default {highstock} false
-     * @since 1.2.5
-     * @product highcharts highstock
-     * @apioption plotOptions.series.step
+     *
+     * @type       {string}
+     * @since      1.2.5
+     * @product    highcharts highstock
+     * @validvalue ["left", "center", "right"]
+     * @apioption  plotOptions.series.step
      */
 
     /**
@@ -719,99 +743,43 @@ H.Series = H.seriesType('line', null, { // base series options
      * series this is only used in conjunction with
      * [negativeColor](#plotOptions.series.negativeColor).
      *
-     * @type {Number}
      * @see [softThreshold](#plotOptions.series.softThreshold).
-     * @default 0
-     * @since 3.0
-     * @product highcharts highstock
-     * @apioption plotOptions.series.threshold
-     */
-
-    /**
-     * The type of series, for example `line` or `column`. By default, the
-     * series type is inherited from [chart.type](#chart.type), so unless the
-     * chart is a combination of series types, there is no need to set it on the
-     * series level.
      *
-     * @validvalue [null, "line", "spline", "column", "area", "areaspline",
-     *       "pie", "arearange", "areasplinerange", "boxplot", "bubble",
-     *       "columnrange", "errorbar", "funnel", "gauge", "scatter",
-     *       "waterfall"]
-     * @type {String}
-     * @sample {highcharts} highcharts/series/type/
-     *         Line and column in the same chart
-     * @sample {highmaps} maps/demo/mapline-mappoint/
-     *         Multiple types in the same map
-     * @apioption series.type
+     * @type      {number}
+     * @default   0
+     * @since     3.0
+     * @product   highcharts highstock
+     * @apioption plotOptions.series.threshold
      */
 
     /**
      * Set the initial visibility of the series.
      *
-     * @type {Boolean}
      * @sample {highcharts} highcharts/plotoptions/series-visible/
      *         Two series, one hidden and one visible
      * @sample {highstock} stock/plotoptions/series-visibility/
      *         Hidden series
-     * @default true
-     * @apioption plotOptions.series.visible
-     */
-
-    /**
-     * When using dual or multiple x axes, this number defines which xAxis
-     * the particular series is connected to. It refers to either the [axis
-     * id](#xAxis.id) or the index of the axis in the xAxis array, with
-     * 0 being the first.
-     *
-     * @type {Number|String}
-     * @default 0
-     * @product highcharts highstock
-     * @apioption series.xAxis
-     */
-
-    /**
-     * When using dual or multiple y axes, this number defines which yAxis
-     * the particular series is connected to. It refers to either the [axis
-     * id](#yAxis.id) or the index of the axis in the yAxis array, with
-     * 0 being the first.
      *
-     * @type {Number|String}
-     * @sample {highcharts} highcharts/series/yaxis/
-     *         Apply the column series to the secondary Y axis
-     * @default 0
-     * @product highcharts highstock
-     * @apioption series.yAxis
+     * @type      {boolean}
+     * @default   true
+     * @apioption plotOptions.series.visible
      */
 
     /**
      * Defines the Axis on which the zones are applied.
      *
-     * @type {String}
      * @see [zones](#plotOptions.series.zones)
+     *
      * @sample {highcharts} highcharts/series/color-zones-zoneaxis-x/
      *         Zones on the X-Axis
      * @sample {highstock} highcharts/series/color-zones-zoneaxis-x/
      *         Zones on the X-Axis
-     * @default y
-     * @since 4.1.0
-     * @product highcharts highstock
-     * @apioption plotOptions.series.zoneAxis
-     */
-
-    /**
-     * Define the visual z index of the series.
      *
-     * @type {Number}
-     * @sample {highcharts} highcharts/plotoptions/series-zindex-default/
-     *         With no z index, the series defined last are on top
-     * @sample {highcharts} highcharts/plotoptions/series-zindex/
-     *         With a z index, the series with the highest z index is on top
-     * @sample {highstock} highcharts/plotoptions/series-zindex-default/
-     *         With no z index, the series defined last are on top
-     * @sample {highstock} highcharts/plotoptions/series-zindex/
-     *         With a z index, the series with the highest z index is on top
-     * @product highcharts highstock
-     * @apioption series.zIndex
+     * @type      {string}
+     * @default   y
+     * @since     4.1.0
+     * @product   highcharts highstock
+     * @apioption plotOptions.series.zoneAxis
      */
 
     /**
@@ -819,21 +787,21 @@ H.Series = H.seriesType('line', null, { // base series options
      * be attached to the series at run time using the `Highcharts.addEvent`
      * function.
      */
+    events: {},
 
     /**
      * Fires after the series has finished its initial animation, or in
      * case animation is disabled, immediately as the series is displayed.
      *
-     * @type {Function}
-     * @context Series
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-events-afteranimate/
+     * @sample {highcharts} highcharts/plotoptions/series-events-afteranimate/
      *         Show label after animate
-     * @sample {highstock}
-     *         highcharts/plotoptions/series-events-afteranimate/
+     * @sample {highstock} highcharts/plotoptions/series-events-afteranimate/
      *         Show label after animate
-     * @since 4.0
-     * @product highcharts highstock
+     *
+     * @type      {Function}
+     * @since     4.0
+     * @product   highcharts highstock
+     * @context   Series
      * @apioption plotOptions.series.events.afterAnimate
      */
 
@@ -844,28 +812,29 @@ H.Series = H.seriesType('line', null, { // base series options
      * found by `event.item`. Return `false` to prevent the default action
      * which is to toggle the select state of the series.
      *
-     * @type {Function}
-     * @context Series
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-events-checkboxclick/
+     * @sample {highcharts} highcharts/plotoptions/series-events-checkboxclick/
      *         Alert checkbox status
-     * @since 1.2.0
+     *
+     * @type      {Function}
+     * @since     1.2.0
+     * @context   Series
      * @apioption plotOptions.series.events.checkboxClick
      */
 
     /**
-     * Fires when the series is clicked. One parameter, `event`, is passed
-     * to the function, containing common event information. Additionally,
+     * Fires when the series is clicked. One parameter, `event`, is passed to
+     * the function, containing common event information. Additionally,
      * `event.point` holds a pointer to the nearest point on the graph.
      *
-     * @type {Function}
-     * @context Series
      * @sample {highcharts} highcharts/plotoptions/series-events-click/
      *         Alert click info
      * @sample {highstock} stock/plotoptions/series-events-click/
      *         Alert click info
      * @sample {highmaps} maps/plotoptions/series-events-click/
      *         Display click info in subtitle
+     *
+     * @type      {Function}
+     * @context   Series
      * @apioption plotOptions.series.events.click
      */
 
@@ -873,11 +842,12 @@ H.Series = H.seriesType('line', null, { // base series options
      * Fires when the series is hidden after chart generation time, either
      * by clicking the legend item or by calling `.hide()`.
      *
-     * @type {Function}
-     * @context Series
      * @sample {highcharts} highcharts/plotoptions/series-events-hide/
      *         Alert when the series is hidden by clicking the legend item
-     * @since 1.2.0
+     *
+     * @type      {Function}
+     * @since     1.2.0
+     * @context   Series
      * @apioption plotOptions.series.events.hide
      */
 
@@ -887,11 +857,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * is to toggle the visibility of the series. This can be prevented
      * by returning `false` or calling `event.preventDefault()`.
      *
-     * @type {Function}
-     * @context Series
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-events-legenditemclick/
+     * @sample {highcharts} highcharts/plotoptions/series-events-legenditemclick/
      *         Confirm hiding and showing
+     *
+     * @type      {Function}
+     * @context   Series
      * @apioption plotOptions.series.events.legendItemClick
      */
 
@@ -902,14 +872,13 @@ H.Series = H.seriesType('line', null, { // base series options
      * doesn't happen before the mouse enters another graph or leaves the
      * plot area.
      *
-     * @type {Function}
-     * @context Series
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-events-mouseover-sticky/
-     *         With sticky tracking    by default
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-events-mouseover-no-sticky/
+     * @sample {highcharts} highcharts/plotoptions/series-events-mouseover-sticky/
+     *         With sticky tracking by default
+     * @sample {highcharts} highcharts/plotoptions/series-events-mouseover-no-sticky/
      *         Without sticky tracking
+     *
+     * @type      {Function}
+     * @context   Series
      * @apioption plotOptions.series.events.mouseOut
      */
 
@@ -917,14 +886,13 @@ H.Series = H.seriesType('line', null, { // base series options
      * Fires when the mouse enters the graph. One parameter, `event`, is
      * passed to the function, containing common event information.
      *
-     * @type {Function}
-     * @context Series
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-events-mouseover-sticky/
+     * @sample {highcharts} highcharts/plotoptions/series-events-mouseover-sticky/
      *         With sticky tracking by default
-     * @sample {highcharts}
-     *         highcharts/plotoptions/series-events-mouseover-no-sticky/
+     * @sample {highcharts} highcharts/plotoptions/series-events-mouseover-no-sticky/
      *         Without sticky tracking
+     *
+     * @type      {Function}
+     * @context   Series
      * @apioption plotOptions.series.events.mouseOver
      */
 
@@ -932,16 +900,14 @@ H.Series = H.seriesType('line', null, { // base series options
      * Fires when the series is shown after chart generation time, either
      * by clicking the legend item or by calling `.show()`.
      *
-     * @type {Function}
-     * @context Series
      * @sample {highcharts} highcharts/plotoptions/series-events-show/
      *         Alert when the series is shown by clicking the legend item.
-     * @since 1.2.0
+     *
+     * @type      {Function}
+     * @since     1.2.0
+     * @context   Series
      * @apioption plotOptions.series.events.show
      */
-    events: {},
-
-
 
     /**
      * Options for the point markers of line-like series. Properties like
@@ -954,22 +920,24 @@ H.Series = H.seriesType('line', null, { // base series options
      * class names.
      */
     marker: {
+
         
 
         /**
-         * Enable or disable the point marker. If `null`, the markers are hidden
-         * when the data is dense, and shown for more widespread data points.
+         * Enable or disable the point marker. If `undefined`, the markers are
+         * hidden when the data is dense, and shown for more widespread data
+         * points.
          *
-         * @type {Boolean}
          * @sample {highcharts} highcharts/plotoptions/series-marker-enabled/
          *         Disabled markers
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-marker-enabled-false/
+         * @sample {highcharts} highcharts/plotoptions/series-marker-enabled-false/
          *         Disabled in normal state but enabled on hover
          * @sample {highstock} stock/plotoptions/series-marker/
          *         Enabled markers
-         * @default {highcharts} null
-         * @default {highstock} false
+         *
+         * @type      {boolean}
+         * @default   {highcharts} undefined
+         * @default   {highstock} false
          * @apioption plotOptions.series.marker.enabled
          */
 
@@ -977,22 +945,20 @@ H.Series = H.seriesType('line', null, { // base series options
          * Image markers only. Set the image width explicitly. When using this
          * option, a `width` must also be set.
          *
-         * @type {Number}
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-marker-width-height/
+         * @sample {highcharts} highcharts/plotoptions/series-marker-width-height/
          *         Fixed width and height
-         * @sample {highstock}
-         *         highcharts/plotoptions/series-marker-width-height/
+         * @sample {highstock} highcharts/plotoptions/series-marker-width-height/
          *         Fixed width and height
-         * @default null
-         * @since 4.0.4
+         *
+         * @type      {number}
+         * @since     4.0.4
          * @apioption plotOptions.series.marker.height
          */
 
         /**
-         * A predefined shape or symbol for the marker. When null, the symbol
-         * is pulled from options.symbols. Other possible values are "circle",
-         * "square", "diamond", "triangle" and "triangle-down".
+         * A predefined shape or symbol for the marker. When undefined, the
+         * symbol is pulled from options.symbols. Other possible values are
+         * "circle", "square", "diamond", "triangle" and "triangle-down".
          *
          * Additionally, the URL to a graphic can be given on this form:
          * "url(graphic.png)". Note that for the image to be applied to exported
@@ -1002,14 +968,12 @@ H.Series = H.seriesType('line', null, { // base series options
          * `Highcharts.SVGRenderer.prototype.symbols`. The callback is then
          * used by its method name, as shown in the demo.
          *
-         * @validvalue [null, "circle", "square", "diamond", "triangle",
-         *         "triangle-down"]
-         * @type {String}
          * @sample {highcharts} highcharts/plotoptions/series-marker-symbol/
          *         Predefined, graphic and custom markers
          * @sample {highstock} highcharts/plotoptions/series-marker-symbol/
          *         Predefined, graphic and custom markers
-         * @default null
+         *
+         * @type      {string}
          * @apioption plotOptions.series.marker.symbol
          */
 
@@ -1020,9 +984,10 @@ H.Series = H.seriesType('line', null, { // base series options
          * as multiples of the `marker.radius`. In other words, the default
          * value of 2 means points are hidden if overlapping horizontally.
          *
-         * @since  6.0.5
          * @sample highcharts/plotoptions/series-marker-enabledthreshold
          *         A higher threshold
+         *
+         * @since 6.0.5
          */
         enabledThreshold: 2,
 
@@ -1038,19 +1003,16 @@ H.Series = H.seriesType('line', null, { // base series options
          * Image markers only. Set the image width explicitly. When using this
          * option, a `height` must also be set.
          *
-         * @type {Number}
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-marker-width-height/
+         * @sample {highcharts} highcharts/plotoptions/series-marker-width-height/
          *         Fixed width and height
-         * @sample {highstock}
-         *         highcharts/plotoptions/series-marker-width-height/
+         * @sample {highstock} highcharts/plotoptions/series-marker-width-height/
          *         Fixed width and height
-         * @default null
-         * @since 4.0.4
+         *
+         * @type      {number}
+         * @since     4.0.4
          * @apioption plotOptions.series.marker.width
          */
 
-
         /**
          * States for a single point marker.
          */
@@ -1059,73 +1021,68 @@ H.Series = H.seriesType('line', null, { // base series options
             /**
              * The normal state of a single point marker. Currently only used
              * for setting animation when returning to normal state from hover.
-             *
-             * @type {Object}
              */
             normal: {
                 /**
                  * Animation when returning to normal state after hovering.
                  *
-                 * @type {Boolean|Object}
+                 * @type {boolean|Highcharts.AnimationOptionsObject}
                  */
                 animation: true
             },
 
             /**
              * The hover state for a single point marker.
-             *
-             * @type {Object}
              */
             hover: {
 
                 /**
                  * Animation when hovering over the marker.
                  *
-                 * @type {Boolean|Object}
+                 * @type {boolean|Highcharts.AnimationOptionsObject}
                  */
                 animation: {
+
                     duration: 50
+
                 },
 
                 /**
                  * Enable or disable the point marker.
                  *
-                 * @sample {highcharts}
-                 *         highcharts/plotoptions/series-marker-states-hover-enabled/
+                 * @sample {highcharts} highcharts/plotoptions/series-marker-states-hover-enabled/
                  *         Disabled hover state
                  */
                 enabled: true,
 
                 /**
-                 * The fill color of the marker in hover state. When `null`, the
-                 * series' or point's fillColor for normal state is used.
+                 * The fill color of the marker in hover state. When
+                 * `undefined`, the series' or point's fillColor for normal
+                 * state is used.
                  *
-                 * @type      {Color}
-                 * @default   null
+                 * @type      {Highcharts.ColorString}
                  * @apioption plotOptions.series.marker.states.hover.fillColor
                  */
 
                 /**
-                 * The color of the point marker's outline. When `null`, the
-                 * series' or point's lineColor for normal state is used.
+                 * The color of the point marker's outline. When `undefined`,
+                 * the series' or point's lineColor for normal state is used.
+                 *
+                 * @sample {highcharts} highcharts/plotoptions/series-marker-states-hover-linecolor/
+                 *         White fill color, black line color
                  *
-                 * @type      {Color}
-                 * @sample    {highcharts}
-                 *            highcharts/plotoptions/series-marker-states-hover-linecolor/
-                 *            White fill color, black line color
-                 * @default   null
+                 * @type      {Highcharts.ColorString}
                  * @apioption plotOptions.series.marker.states.hover.lineColor
                  */
 
                 /**
-                 * The width of the point marker's outline. When `null`, the
-                 * series' or point's lineWidth for normal state is used.
+                 * The width of the point marker's outline. When `undefined`,
+                 * the series' or point's lineWidth for normal state is used.
+                 *
+                 * @sample {highcharts} highcharts/plotoptions/series-marker-states-hover-linewidth/
+                 *         3px line width
                  *
-                 * @type      {Number}
-                 * @sample    {highcharts}
-                 *            highcharts/plotoptions/series-marker-states-hover-linewidth/
-                 *            3px line width
-                 * @default   null
+                 * @type      {number}
                  * @apioption plotOptions.series.marker.states.hover.lineWidth
                  */
 
@@ -1135,10 +1092,10 @@ H.Series = H.seriesType('line', null, { // base series options
                  * #plotOptions.series.marker.states.hover.radiusPlus)
                  * option.
                  *
-                 * @type {Number}
-                 * @sample {highcharts}
-                 *         highcharts/plotoptions/series-marker-states-hover-radius/
+                 * @sample {highcharts} highcharts/plotoptions/series-marker-states-hover-radius/
                  *         10px radius
+                 *
+                 * @type      {number}
                  * @apioption plotOptions.series.marker.states.hover.radius
                  */
 
@@ -1146,30 +1103,29 @@ H.Series = H.seriesType('line', null, { // base series options
                  * The number of pixels to increase the radius of the hovered
                  * point.
                  *
-                 * @sample {highcharts}
-                 *         highcharts/plotoptions/series-states-hover-linewidthplus/
+                 * @sample {highcharts} highcharts/plotoptions/series-states-hover-linewidthplus/
                  *         5 pixels greater radius on hover
-                 * @sample {highstock}
-                 *         highcharts/plotoptions/series-states-hover-linewidthplus/
+                 * @sample {highstock} highcharts/plotoptions/series-states-hover-linewidthplus/
                  *         5 pixels greater radius on hover
+                 *
                  * @since 4.0.3
                  */
                 radiusPlus: 2
 
                 
+
             }
+
             
+
         }
     },
 
-
-
     /**
      * Properties for each single point.
      */
     point: {
 
-
         /**
          * Fires when a point is clicked. One parameter, `event`, is passed
          * to the function, containing common event information.
@@ -1178,23 +1134,19 @@ H.Series = H.seriesType('line', null, { // base series options
          * action for the point's click event is to toggle the point's
          * select state. Returning `false` cancels this action.
          *
-         * @type {Function}
-         * @context Point
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-click/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-click/
          *         Click marker to alert values
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-click-column/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-click-column/
          *         Click column
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-click-url/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-click-url/
          *         Go to URL
-         * @sample {highmaps}
-         *         maps/plotoptions/series-point-events-click/
+         * @sample {highmaps} maps/plotoptions/series-point-events-click/
          *         Click marker to display values
-         * @sample {highmaps}
-         *         maps/plotoptions/series-point-events-click-url/
+         * @sample {highmaps} maps/plotoptions/series-point-events-click-url/
          *         Go to URL
+         *
+         * @type      {Function}
+         * @context   Point
          * @apioption plotOptions.series.point.events.click
          */
 
@@ -1203,11 +1155,11 @@ H.Series = H.seriesType('line', null, { // base series options
          * parameter, `event`, is passed to the function, containing common
          * event information.
          *
-         * @type {Function}
-         * @context Point
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-mouseover/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-mouseover/
          *         Show values in the chart's corner on mouse over
+         *
+         * @type      {Function}
+         * @context   Point
          * @apioption plotOptions.series.point.events.mouseOut
          */
 
@@ -1216,11 +1168,11 @@ H.Series = H.seriesType('line', null, { // base series options
          * parameter, `event`, is passed to the function, containing common
          * event information.
          *
-         * @type {Function}
-         * @context Point
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-mouseover/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-mouseover/
          *         Show values in the chart's corner on mouse over
+         *
+         * @type      {Function}
+         * @context   Point
          * @apioption plotOptions.series.point.events.mouseOver
          */
 
@@ -1229,12 +1181,12 @@ H.Series = H.seriesType('line', null, { // base series options
          * parameter, `event`, is passed to the function. Returning `false`
          * cancels the operation.
          *
-         * @type {Function}
-         * @context Point
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-remove/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-remove/
          *         Remove point and confirm
-         * @since 1.2.0
+         *
+         * @type      {Function}
+         * @since     1.2.0
+         * @context   Point
          * @apioption plotOptions.series.point.events.remove
          */
 
@@ -1243,15 +1195,14 @@ H.Series = H.seriesType('line', null, { // base series options
          * following a click on the point. One parameter, `event`, is passed
          * to the function. Returning `false` cancels the operation.
          *
-         * @type {Function}
-         * @context Point
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-select/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-select/
          *         Report the last selected point
-         * @sample {highmaps}
-         *         maps/plotoptions/series-allowpointselect/
+         * @sample {highmaps} maps/plotoptions/series-allowpointselect/
          *         Report select and unselect
-         * @since 1.2.0
+         *
+         * @type      {Function}
+         * @since     1.2.0
+         * @context   Point
          * @apioption plotOptions.series.point.events.select
          */
 
@@ -1261,15 +1212,14 @@ H.Series = H.seriesType('line', null, { // base series options
          * to the function.
          *  Returning `false` cancels the operation.
          *
-         * @type {Function}
-         * @context Point
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-unselect/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-unselect/
          *         Report the last unselected point
-         * @sample {highmaps}
-         *         maps/plotoptions/series-allowpointselect/
+         * @sample {highmaps} maps/plotoptions/series-allowpointselect/
          *         Report select and unselect
-         * @since 1.2.0
+         *
+         * @type      {Function}
+         * @since     1.2.0
+         * @context   Point
          * @apioption plotOptions.series.point.events.unselect
          */
 
@@ -1279,12 +1229,12 @@ H.Series = H.seriesType('line', null, { // base series options
          * function. The new point options can be accessed through
          * `event.options`. Returning `false` cancels the operation.
          *
-         * @type {Function}
-         * @context Point
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-point-events-update/
+         * @sample {highcharts} highcharts/plotoptions/series-point-events-update/
          *         Confirm point updating
-         * @since 1.2.0
+         *
+         * @type      {Function}
+         * @since     1.2.0
+         * @context   Point
          * @apioption plotOptions.series.point.events.update
          */
 
@@ -1297,12 +1247,19 @@ H.Series = H.seriesType('line', null, { // base series options
 
 
     /**
-     * Options for the series data labels, appearing next to each data
-     * point.
+     * Options for the series data labels, appearing next to each data point.
      *
-     * In styled mode, the data labels can be styled wtih the
+     * Since v6.2.0, multiple data labels can be applied to each single point by
+     * defining them as an array of configs.
+     *
+     * In styled mode, the data labels can be styled with the
      * `.highcharts-data-label-box` and `.highcharts-data-label` class names
-     * ([see example](http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/series-datalabels)).
+     * ([see example](https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/series-datalabels)).
+     *
+     * @sample highcharts/plotoptions/series-datalabels-enabled
+     *         Data labels enabled
+     * @sample highcharts/plotoptions/series-datalabels-multiple
+     *         Multiple data labels on a bar series
      */
     dataLabels: {
 
@@ -1315,12 +1272,10 @@ H.Series = H.seriesType('line', null, { // base series options
          * [inside](#plotOptions.column.dataLabels.inside) option. Can be one of
          * `left`, `center` or `right`.
          *
-         * @validvalue ["left", "center", "right"]
-         * @type {String}
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-datalabels-align-left/
+         * @sample {highcharts} highcharts/plotoptions/series-datalabels-align-left/
          *         Left aligned
-         * @default center
+         *
+         * @validvalue ["left", "center", "right"]
          */
         align: 'center',
 
@@ -1330,11 +1285,12 @@ H.Series = H.seriesType('line', null, { // base series options
          * sensitive for overlapping, the [dataLabels.padding](
          * #plotOptions.series.dataLabels.padding) can be set to 0.
          *
-         * @type {Boolean}
          * @sample highcharts/plotoptions/series-datalabels-allowoverlap-false/
          *         Don't allow overlap
-         * @default false
-         * @since 4.1.0
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     4.1.0
          * @apioption plotOptions.series.dataLabels.allowOverlap
          */
 
@@ -1342,15 +1298,16 @@ H.Series = H.seriesType('line', null, { // base series options
         /**
          * The border radius in pixels for the data label.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/plotoptions/series-datalabels-box/
          *         Data labels box options
          * @sample {highstock} highcharts/plotoptions/series-datalabels-box/
          *         Data labels box options
          * @sample {highmaps} maps/plotoptions/series-datalabels-box/
          *         Data labels box options
-         * @default 0
-         * @since 2.2.1
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.2.1
          * @apioption plotOptions.series.dataLabels.borderRadius
          */
 
@@ -1358,13 +1315,14 @@ H.Series = H.seriesType('line', null, { // base series options
         /**
          * The border width in pixels for the data label.
          *
-         * @type {Number}
          * @sample {highcharts} highcharts/plotoptions/series-datalabels-box/
          *         Data labels box options
          * @sample {highstock} highcharts/plotoptions/series-datalabels-box/
          *         Data labels box options
-         * @default 0
-         * @since 2.2.1
+         *
+         * @type      {number}
+         * @default   0
+         * @since     2.2.1
          * @apioption plotOptions.series.dataLabels.borderWidth
          */
 
@@ -1373,30 +1331,35 @@ H.Series = H.seriesType('line', null, { // base series options
          * can be used to give each series' or point's data label unique
          * styling. In addition to this option, a default color class name is
          * added so that we can give the labels a
-         * [contrast text shadow](http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/data-label-contrast/).
+         * [contrast text shadow](https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/data-label-contrast/).
+         *
+         * @sample {highcharts} highcharts/css/series-datalabels/
+         *         Styling by CSS
+         * @sample {highstock} highcharts/css/series-datalabels/
+         *         Styling by CSS
+         * @sample {highmaps} highcharts/css/series-datalabels/
+         *         Styling by CSS
          *
-         * @type {String}
-         * @sample {highcharts} highcharts/css/series-datalabels/ Styling by CSS
-         * @sample {highstock} highcharts/css/series-datalabels/ Styling by CSS
-         * @sample {highmaps} highcharts/css/series-datalabels/ Styling by CSS
-         * @since 5.0.0
+         * @type      {string}
+         * @since     5.0.0
          * @apioption plotOptions.series.dataLabels.className
          */
 
         /**
-         * The text color for the data labels. Defaults to `null`. For certain
-         * series types, like column or map, the data labels can be drawn inside
-         * the points. In this case the data label will be drawn with maximum
-         * contrast by default. Additionally, it will be given a `text-outline`
-         * style with the opposite color, to further increase the contrast. This
-         * can be overridden by setting the `text-outline` style to `none` in
-         * the `dataLabels.style` option.
+         * The text color for the data labels. Defaults to `undefined`. For
+         * certain series types, like column or map, the data labels can be
+         * drawn inside the points. In this case the data label will be drawn
+         * with maximum contrast by default. Additionally, it will be given a
+         * `text-outline` style with the opposite color, to further increase the
+         * contrast. This can be overridden by setting the `text-outline` style
+         * to `none` in the `dataLabels.style` option.
          *
-         * @type {Color}
          * @sample {highcharts} highcharts/plotoptions/series-datalabels-color/
          *         Red data labels
          * @sample {highmaps} maps/demo/color-axis/
          *         White data labels
+         *
+         * @type      {Highcharts.ColorString}
          * @apioption plotOptions.series.dataLabels.color
          */
 
@@ -1405,9 +1368,9 @@ H.Series = H.seriesType('line', null, { // base series options
          * default, the data label is moved inside the plot area according to
          * the [overflow](#plotOptions.series.dataLabels.overflow) option.
          *
-         * @type {Boolean}
-         * @default true
-         * @since 2.3.3
+         * @type      {boolean}
+         * @default   true
+         * @since     2.3.3
          * @apioption plotOptions.series.dataLabels.crop
          */
 
@@ -1415,41 +1378,41 @@ H.Series = H.seriesType('line', null, { // base series options
          * Whether to defer displaying the data labels until the initial series
          * animation has finished.
          *
-         * @type {Boolean}
-         * @default true
-         * @since 4.0
-         * @product highcharts highstock
+         * @type      {boolean}
+         * @default   true
+         * @since     4.0
+         * @product   highcharts highstock gantt
          * @apioption plotOptions.series.dataLabels.defer
          */
 
         /**
          * Enable or disable the data labels.
          *
-         * @type {Boolean}
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-datalabels-enabled/
+         * @sample {highcharts} highcharts/plotoptions/series-datalabels-enabled/
          *         Data labels enabled
-         * @sample {highmaps} maps/demo/color-axis/ Data labels enabled
-         * @default false
+         * @sample {highmaps} maps/demo/color-axis/
+         *         Data labels enabled
+         *
+         * @type      {boolean}
+         * @default   false
          * @apioption plotOptions.series.dataLabels.enabled
          */
 
         /**
-         * A [format string](http://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting)
+         * A [format string](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting)
          * for the data label. Available variables are the same as for
          * `formatter`.
          *
-         * @type {String}
-         * @sample {highcharts|highstock}
-         *         highcharts/plotoptions/series-datalabels-format/
+         * @sample {highcharts|highstock} highcharts/plotoptions/series-datalabels-format/
          *         Add a unit
-         * @sample {highmaps}
-         *         maps/plotoptions/series-datalabels-format/
+         * @sample {highmaps} maps/plotoptions/series-datalabels-format/
          *         Formatted value in the data label
-         * @default {highcharts} {y}
-         * @default {highstock} {y}
-         * @default {highmaps} {point.value}
-         * @since 3.0
+         *
+         * @type      {string}
+         * @default   {highcharts} {y}
+         * @default   {highstock} {y}
+         * @default   {highmaps} {point.value}
+         * @since     3.0
          * @apioption plotOptions.series.dataLabels.format
          */
 
@@ -1518,13 +1481,16 @@ H.Series = H.seriesType('line', null, { // base series options
          *
          * </table>
          *
-         * @type {Function}
          * @sample {highmaps} maps/plotoptions/series-datalabels-format/
          *         Formatted value
+         *
+         * @type    {Highcharts.FormatterCallbackFunction}
+         * @default function () { return this.y; }
          */
         formatter: function () {
             return this.y === null ? '' : H.numberFormat(this.y, -1);
         },
+
         
 
         /**
@@ -1532,23 +1498,23 @@ H.Series = H.seriesType('line', null, { // base series options
          * align the data label inside the box or to the actual value point.
          * Defaults to `false` in most cases, `true` in stacked columns.
          *
-         * @type {Boolean}
-         * @since 3.0
+         * @type      {boolean}
+         * @since     3.0
          * @apioption plotOptions.series.dataLabels.inside
          */
 
         /**
          * How to handle data labels that flow outside the plot area. The
-         * default is `justify`, which aligns them inside the plot area. For
+         * default is `"justify"`, which aligns them inside the plot area. For
          * columns and bars, this means it will be moved inside the bar. To
          * display data labels outside the plot area, set `crop` to `false` and
-         * `overflow` to `"none"`.
+         * `overflow` to `"allow"`.
          *
-         * @validvalue ["justify", "none"]
-         * @type {String}
-         * @default justify
-         * @since 3.0.6
-         * @apioption plotOptions.series.dataLabels.overflow
+         * @type       {string}
+         * @default    justify
+         * @since      3.0.6
+         * @validvalue ["allow", "justify"]
+         * @apioption  plotOptions.series.dataLabels.overflow
          */
 
         /**
@@ -1556,21 +1522,21 @@ H.Series = H.seriesType('line', null, { // base series options
          * backgrounds, borders and padding will be lost on a rotated data
          * label.
          *
-         * @type {Number}
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-datalabels-rotation/
+         * @sample {highcharts} highcharts/plotoptions/series-datalabels-rotation/
          *         Vertical labels
-         * @default 0
+         *
+         * @type      {number}
+         * @default   0
          * @apioption plotOptions.series.dataLabels.rotation
          */
 
         /**
          * Whether to
-         * [use HTML](http://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting#html)
+         * [use HTML](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting#html)
          * to render the labels.
          *
-         * @type {Boolean}
-         * @default false
+         * @type      {boolean}
+         * @default   false
          * @apioption plotOptions.series.dataLabels.useHTML
          */
 
@@ -1580,9 +1546,8 @@ H.Series = H.seriesType('line', null, { // base series options
          * in a column chart, the label is above positive values and below
          * negative values.
          *
+         * @since      2.3.3
          * @validvalue ["top", "middle", "bottom"]
-         * @type {String}
-         * @since 2.3.3
          */
         verticalAlign: 'bottom', // above singular point
 
@@ -1590,11 +1555,8 @@ H.Series = H.seriesType('line', null, { // base series options
         /**
          * The x position offset of the label relative to the point in pixels.
          *
-         * @type {Number}
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-datalabels-rotation/
+         * @sample {highcharts} highcharts/plotoptions/series-datalabels-rotation/
          *         Vertical and positioned
-         * @default 0
          */
         x: 0,
 
@@ -1602,11 +1564,8 @@ H.Series = H.seriesType('line', null, { // base series options
         /**
          * The y position offset of the label relative to the point in pixels.
          *
-         * @type {Number}
-         * @sample {highcharts}
-         *         highcharts/plotoptions/series-datalabels-rotation/
+         * @sample {highcharts} highcharts/plotoptions/series-datalabels-rotation/
          *         Vertical and positioned
-         * @default -6
          */
         y: 0,
 
@@ -1615,17 +1574,15 @@ H.Series = H.seriesType('line', null, { // base series options
          * When either the `borderWidth` or the `backgroundColor` is set,
          * this is the padding within the box.
          *
-         * @type {Number}
-         * @sample {highcharts|highstock}
-         *         highcharts/plotoptions/series-datalabels-box/
+         * @sample {highcharts|highstock} highcharts/plotoptions/series-datalabels-box/
          *         Data labels box options
-         * @sample {highmaps}
-         *         maps/plotoptions/series-datalabels-box/
+         * @sample {highmaps} maps/plotoptions/series-datalabels-box/
          *         Data labels box options
+         *
          * @default {highcharts} 5
          * @default {highstock} 5
          * @default {highmaps} 0
-         * @since 2.2.1
+         * @since   2.2.1
          */
         padding: 5
     },
@@ -1640,9 +1597,7 @@ H.Series = H.seriesType('line', null, { // base series options
      * that fall within the plot area. The advantage of cropping away invisible
      * points is to increase performance on large series.
      *
-     * @type {Number}
-     * @default 300
-     * @since 2.2
+     * @since   2.2
      * @product highcharts highstock
      */
     cropThreshold: 300,
@@ -1655,8 +1610,6 @@ H.Series = H.seriesType('line', null, { // base series options
      * * 1000 milliseconds). This is normally computed automatically, but
      * this option can be used to override the automatic value.
      *
-     * @type {Number}
-     * @default 0
      * @product highstock
      */
     pointRange: 0,
@@ -1670,9 +1623,7 @@ H.Series = H.seriesType('line', null, { // base series options
      * 3 will make the Y axis show negative values according to the `minPadding`
      * option. If `softThreshold` is `true`, the Y axis starts at 0.
      *
-     * @type {Boolean}
-     * @default true
-     * @since 4.1.9
+     * @since   4.1.9
      * @product highcharts highstock
      */
     softThreshold: true,
@@ -1681,8 +1632,6 @@ H.Series = H.seriesType('line', null, { // base series options
 
     /**
      * A wrapper object for all the series options in specific states.
-     *
-     * @type {plotOptions.series.states}
      */
     states: {
 
@@ -1690,12 +1639,12 @@ H.Series = H.seriesType('line', null, { // base series options
          * The normal state of a series, or for point items in column, pie and
          * similar series. Currently only used for setting animation when
          * returning to normal state from hover.
-         * @type {Object}
          */
         normal: {
             /**
              * Animation when returning to normal state after hovering.
-             * @type {Boolean|Object}
+             *
+             * @type {boolean|Highcharts.AnimationOptionsObject}
              */
             animation: true
         },
@@ -1703,7 +1652,6 @@ H.Series = H.seriesType('line', null, { // base series options
         /**
          * Options for the hovered series. These settings override the normal
          * state options when a series is moused over or touched.
-         *
          */
         hover: {
 
@@ -1711,18 +1659,16 @@ H.Series = H.seriesType('line', null, { // base series options
              * Enable separate styles for the hovered series to visualize that
              * the user hovers either the series itself or the legend. .
              *
-             * @type {Boolean}
-             * @sample {highcharts}
-             *         highcharts/plotoptions/series-states-hover-enabled/
+             * @sample {highcharts} highcharts/plotoptions/series-states-hover-enabled/
              *         Line
-             * @sample {highcharts}
-             *         highcharts/plotoptions/series-states-hover-enabled-column/
+             * @sample {highcharts} highcharts/plotoptions/series-states-hover-enabled-column/
              *         Column
-             * @sample {highcharts}
-             *         highcharts/plotoptions/series-states-hover-enabled-pie/
+             * @sample {highcharts} highcharts/plotoptions/series-states-hover-enabled-pie/
              *         Pie
-             * @default true
-             * @since 1.2
+             *
+             * @type      {boolean}
+             * @default   true
+             * @since     1.2
              * @apioption plotOptions.series.states.hover.enabled
              */
 
@@ -1730,12 +1676,12 @@ H.Series = H.seriesType('line', null, { // base series options
             /**
              * Animation setting for hovering the graph in line-type series.
              *
-             * @type {Boolean|Object}
-             * @default { "duration": 50 }
-             * @since 5.0.8
+             * @type    {boolean|Highcharts.AnimationOptionsObject}
+             * @since   5.0.8
              * @product highcharts
              */
             animation: {
+
                 /**
                  * The duration of the hover animation in milliseconds. By
                  * default the hover state animates quickly in, and slowly back
@@ -1749,12 +1695,11 @@ H.Series = H.seriesType('line', null, { // base series options
              * undefined, and the `lineWidthPlus` property dictates how much
              * to increase the linewidth from normal state.
              *
-             * @type {Number}
-             * @sample {highcharts}
-             *         highcharts/plotoptions/series-states-hover-linewidth/
+             * @sample {highcharts} highcharts/plotoptions/series-states-hover-linewidth/
              *         5px line on hover
-             * @default undefined
-             * @product highcharts highstock
+             *
+             * @type      {number}
+             * @product   highcharts highstock
              * @apioption plotOptions.series.states.hover.lineWidth
              */
 
@@ -1762,29 +1707,25 @@ H.Series = H.seriesType('line', null, { // base series options
             /**
              * The additional line width for the graph of a hovered series.
              *
-             * @type {Number}
-             * @sample {highcharts}
-             *         highcharts/plotoptions/series-states-hover-linewidthplus/
+             * @sample {highcharts} highcharts/plotoptions/series-states-hover-linewidthplus/
              *         5 pixels wider
-             * @sample {highstock}
-             *         highcharts/plotoptions/series-states-hover-linewidthplus/
+             * @sample {highstock} highcharts/plotoptions/series-states-hover-linewidthplus/
              *         5 pixels wider
-             * @default 1
-             * @since 4.0.3
+             *
+             * @since   4.0.3
              * @product highcharts highstock
              */
             lineWidthPlus: 1,
 
-
-
             /**
              * In Highcharts 1.0, the appearance of all markers belonging to the
              * hovered series. For settings on the hover state of the individual
              * point, see
              * [marker.states.hover](#plotOptions.series.marker.states.hover).
              *
-             * @extends plotOptions.series.marker
              * @deprecated
+             *
+             * @extends plotOptions.series.marker
              * @product highcharts highstock
              */
             marker: {
@@ -1792,8 +1733,6 @@ H.Series = H.seriesType('line', null, { // base series options
                 // radius: base + 1
             },
 
-
-
             /**
              * Options for the halo appearing around the hovered point in line-
              * type series as well as outside the hovered slice in pie charts.
@@ -1804,10 +1743,12 @@ H.Series = H.seriesType('line', null, { // base series options
              * In styled mode, the halo is styled with the `.highcharts-halo`
              * class, with colors inherited from `.highcharts-color-{n}`.
              *
-             * @type {Object}
-             * @sample {highcharts} highcharts/plotoptions/halo/ Halo options
-             * @sample {highstock} highcharts/plotoptions/halo/ Halo options
-             * @since 4.0
+             * @sample {highcharts} highcharts/plotoptions/halo/
+             *         Halo options
+             * @sample {highstock} highcharts/plotoptions/halo/
+             *         Halo options
+             *
+             * @since   4.0
              * @product highcharts highstock
              */
             halo: {
@@ -1816,9 +1757,9 @@ H.Series = H.seriesType('line', null, { // base series options
                  * A collection of SVG attributes to override the appearance of
                  * the halo, for example `fill`, `stroke` and `stroke-width`.
                  *
-                 * @type {Object}
-                 * @since 4.0
-                 * @product highcharts highstock
+                 * @type      {Highcharts.SVGAttributes}
+                 * @since     4.0
+                 * @product   highcharts highstock
                  * @apioption plotOptions.series.states.hover.halo.attributes
                  */
 
@@ -1829,13 +1770,13 @@ H.Series = H.seriesType('line', null, { // base series options
                  * halo outside the slice. For bubbles it defaults to 5 and is
                  * the width of the halo outside the bubble.
                  *
-                 * @type {Number}
-                 * @default 10
-                 * @since 4.0
+                 * @since   4.0
                  * @product highcharts highstock
                  */
                 size: 10
+
                 
+
             }
         },
 
@@ -1845,15 +1786,15 @@ H.Series = H.seriesType('line', null, { // base series options
          * by [allowPointSelect](#plotOptions.series.allowPointSelect) or
          * programmatically.
          *
-         * @type {Object}
-         * @extends plotOptions.series.states.hover
-         * @excluding brightness
          * @sample {highmaps} maps/plotoptions/series-allowpointselect/
          *         Allow point select demo
-         * @product highmaps
+         *
+         * @extends   plotOptions.series.states.hover
+         * @excluding brightness
+         * @product   highmaps
          */
         select: {
-            marker: {}
+            // marker: {}
         }
     },
 
@@ -1869,15 +1810,15 @@ H.Series = H.seriesType('line', null, { // base series options
      * be hidden when moving the mouse between series. Defaults to true for line
      * and area type series, but to false for columns, pies etc.
      *
-     * @type {Boolean}
      * @sample {highcharts} highcharts/plotoptions/series-stickytracking-true/
      *         True by default
      * @sample {highcharts} highcharts/plotoptions/series-stickytracking-false/
      *         False
+     *
      * @default {highcharts} true
      * @default {highstock} true
      * @default {highmaps} false
-     * @since 2.0
+     * @since   2.0
      */
     stickyTracking: true,
 
@@ -1886,12 +1827,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * Properties are inherited from [tooltip](#tooltip), but only the
      * following properties can be defined on a series level.
      *
-     * @type {Object}
-     * @extends tooltip
+     * @since     2.3
+     * @extends   tooltip
      * @excluding animation,backgroundColor,borderColor,borderRadius,
      *            borderWidth,crosshairs,enabled,formatter,positioner,shadow,
      *            shared,shape,snap,style,useHTML
-     * @since 2.3
      * @apioption plotOptions.series.tooltip
      */
 
@@ -1902,10 +1842,8 @@ H.Series = H.seriesType('line', null, { // base series options
      * and the rest are assumed to be the same format. This saves expensive
      * data checking and indexing in long series. Set it to `0` disable.
      *
-     * @type {Number}
-     * @default 1000
-     * @since 2.2
-     * @product highcharts highstock
+     * @since   2.2
+     * @product highcharts highstock gantt
      */
     turboThreshold: 1000,
 
@@ -1918,56 +1856,65 @@ H.Series = H.seriesType('line', null, { // base series options
      * In styled mode, the color zones are styled with the
      * `.highcharts-zone-{n}` class, or custom classed from the `className`
      * option
-     * ([view live demo](http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/color-zones/)).
+     * ([view live demo](https://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/color-zones/)).
      *
-     * @type {Array}
      * @see [zoneAxis](#plotOptions.series.zoneAxis)
-     * @sample {highcharts} highcharts/series/color-zones-simple/ Color zones
-     * @sample {highstock} highcharts/series/color-zones-simple/ Color zones
-     * @since 4.1.0
-     * @product highcharts highstock
+     *
+     * @sample {highcharts} highcharts/series/color-zones-simple/
+     *         Color zones
+     * @sample {highstock} highcharts/series/color-zones-simple/
+     *         Color zones
+     *
+     * @type      {Array<*>}
+     * @since     4.1.0
+     * @product   highcharts highstock
      * @apioption plotOptions.series.zones
      */
 
     /**
      * Styled mode only. A custom class name for the zone.
      *
-     * @type {String}
-     * @sample highcharts/css/color-zones/ Zones styled by class name
-     * @since 5.0.0
+     * @sample highcharts/css/color-zones/
+     *         Zones styled by class name
+     *
+     * @type      {string}
+     * @since     5.0.0
      * @apioption plotOptions.series.zones.className
      */
 
     /**
      * Defines the color of the series.
      *
-     * @type {Color}
      * @see [series color](#plotOptions.series.color)
-     * @since 4.1.0
-     * @product highcharts highstock
+     *
+     * @type      {Highcharts.ColorString}
+     * @since     4.1.0
+     * @product   highcharts highstock
      * @apioption plotOptions.series.zones.color
      */
 
     /**
      * A name for the dash style to use for the graph.
      *
-     * @type {String}
      * @see [series.dashStyle](#plotOptions.series.dashStyle)
-     * @sample {highcharts|highstock}
-     *         highcharts/series/color-zones-dashstyle-dot/
+     *
+     * @sample {highcharts|highstock} highcharts/series/color-zones-dashstyle-dot/
      *         Dashed line indicates prognosis
-     * @since 4.1.0
-     * @product highcharts highstock
+     *
+     * @type      {string}
+     * @since     4.1.0
+     * @product   highcharts highstock
      * @apioption plotOptions.series.zones.dashStyle
      */
 
     /**
      * Defines the fill color for the series (in area type series)
      *
-     * @type {Color}
      * @see [fillColor](#plotOptions.area.fillColor)
-     * @since 4.1.0
-     * @product highcharts highstock
+     *
+     * @type      {Highcharts.ColorString}
+     * @since     4.1.0
+     * @product   highcharts highstock
      * @apioption plotOptions.series.zones.fillColor
      */
 
@@ -1975,15 +1922,12 @@ H.Series = H.seriesType('line', null, { // base series options
      * The value up to where the zone extends, if undefined the zones stretches
      * to the last value in the series.
      *
-     * @type {Number}
-     * @default undefined
-     * @since 4.1.0
-     * @product highcharts highstock
+     * @type      {number}
+     * @since     4.1.0
+     * @product   highcharts highstock
      * @apioption plotOptions.series.zones.value
      */
 
-
-
     /**
      * Determines whether the series should look for the nearest point
      * in both dimensions or just the x-dimension when hovering the series.
@@ -1994,19 +1938,158 @@ H.Series = H.seriesType('line', null, { // base series options
      * Applies only to series types using nearest neighbor search (not
      * direct hover) for tooltip.
      *
-     * @validvalue ['x', 'xy']
-     * @type {String}
      * @sample {highcharts} highcharts/series/findnearestpointby/
      *         Different hover behaviors
      * @sample {highstock} highcharts/series/findnearestpointby/
      *         Different hover behaviors
      * @sample {highmaps} highcharts/series/findnearestpointby/
      *         Different hover behaviors
-     * @since 5.0.10
+     *
+     * @since      5.0.10
+     * @validvalue ["x", "xy"]
      */
     findNearestPointBy: 'x'
 
 }, /** @lends Highcharts.Series.prototype */ {
+
+    /**
+     * Series options for specific data and the data itself. In TypeScript you
+     * have to cast the series options to specific series types, to get all
+     * possible options for a series.
+     *
+     * @example
+     * // TypeScript example
+     * Highcharts.chart('container', {
+     *     series: [{
+     *         color: '#06C',
+     *         data: [[0, 1], [2, 3]]
+     *     } as Highcharts.SeriesLineOptions ]
+     * });
+     *
+     *
+     * @type      {Array<*>}
+     * @apioption series
+     */
+
+    /**
+     * An id for the series. This can be used after render time to get a pointer
+     * to the series object through `chart.get()`.
+     *
+     * @sample {highcharts} highcharts/plotoptions/series-id/
+     *         Get series by id
+     *
+     * @type      {string}
+     * @since     1.2.0
+     * @apioption series.id
+     */
+
+    /**
+     * The index of the series in the chart, affecting the internal index in the
+     * `chart.series` array, the visible Z index as well as the order in the
+     * legend.
+     *
+     * @type      {number}
+     * @since     2.3.0
+     * @apioption series.index
+     */
+
+    /**
+     * The sequential index of the series in the legend.
+     *
+     * @see [legend.reversed](#legend.reversed),
+     *      [yAxis.reversedStacks](#yAxis.reversedStacks)
+     *
+     * @sample {highcharts|highstock} highcharts/series/legendindex/
+     *         Legend in opposite order
+     *
+     * @type      {number}
+     * @apioption series.legendIndex
+     */
+    /**
+     * The name of the series as shown in the legend, tooltip etc.
+     *
+     * @sample {highcharts} highcharts/series/name/
+     *         Series name
+     * @sample {highmaps} maps/demo/category-map/
+     *         Series name
+     *
+     * @type      {string}
+     * @apioption series.name
+     */
+
+    /**
+     * This option allows grouping series in a stacked chart. The stack option
+     * can be a string or anything else, as long as the grouped series' stack
+     * options match each other after conversion into a string.
+     *
+     * @sample {highcharts} highcharts/series/stack/
+     *         Stacked and grouped columns
+     *
+     * @type      {string|*}
+     * @since     2.1
+     * @product   highcharts highstock
+     * @apioption series.stack
+     */
+
+    /**
+     * The type of series, for example `line` or `column`. By default, the
+     * series type is inherited from [chart.type](#chart.type), so unless the
+     * chart is a combination of series types, there is no need to set it on the
+     * series level.
+     *
+     * @sample {highcharts} highcharts/series/type/
+     *         Line and column in the same chart
+     * @sample {highmaps} maps/demo/mapline-mappoint/
+     *         Multiple types in the same map
+     *
+     * @type      {string}
+     * @apioption series.type
+     */
+
+    /**
+     * When using dual or multiple x axes, this number defines which xAxis the
+     * particular series is connected to. It refers to either the
+     * {@link #xAxis.id|axis id}
+     * or the index of the axis in the xAxis array, with 0 being the first.
+     *
+     * @type      {number|string}
+     * @default   0
+     * @product   highcharts highstock
+     * @apioption series.xAxis
+     */
+
+    /**
+     * When using dual or multiple y axes, this number defines which yAxis the
+     * particular series is connected to. It refers to either the
+     * {@link #yAxis.id|axis id}
+     * or the index of the axis in the yAxis array, with 0 being the first.
+     *
+     * @sample {highcharts} highcharts/series/yaxis/
+     *         Apply the column series to the secondary Y axis
+     *
+     * @type      {number|string}
+     * @default   0
+     * @product   highcharts highstock
+     * @apioption series.yAxis
+     */
+
+    /**
+     * Define the visual z index of the series.
+     *
+     * @sample {highcharts} highcharts/plotoptions/series-zindex-default/
+     *         With no z index, the series defined last are on top
+     * @sample {highcharts} highcharts/plotoptions/series-zindex/
+     *         With a z index, the series with the highest z index is on top
+     * @sample {highstock} highcharts/plotoptions/series-zindex-default/
+     *         With no z index, the series defined last are on top
+     * @sample {highstock} highcharts/plotoptions/series-zindex/
+     *         With a z index, the series with the highest z index is on top
+     *
+     * @type      {number}
+     * @product   highcharts highstock
+     * @apioption series.zIndex
+     */
+
     isCartesian: true,
     pointClass: Point,
     sorted: true, // requires the data to be sorted
@@ -2026,9 +2109,8 @@ H.Series = H.seriesType('line', null, { // base series options
         /**
          * Read only. The chart that the series belongs to.
          *
-         * @name chart
-         * @memberof Series
-         * @type {Chart}
+         * @name Highcharts.Series#chart
+         * @type {Highcharts.Chart}
          */
         series.chart = chart;
 
@@ -2037,18 +2119,16 @@ H.Series = H.seriesType('line', null, { // base series options
          * type in the series options anc can be altered using {@link
          * Series#update}.
          *
-         * @name type
-         * @memberof Series
-         * @type String
+         * @name Highcharts.Series#type
+         * @type {string}
          */
 
         /**
          * Read only. The series' current options. To update, use {@link
          * Series#update}.
          *
-         * @name options
-         * @memberof Series
-         * @type SeriesOptions
+         * @name Highcharts.Series#options
+         * @type {Highcharts.PlotSeriesOptions}
          */
         series.options = options = series.setOptions(options);
         series.linkedSeries = [];
@@ -2062,9 +2142,8 @@ H.Series = H.seriesType('line', null, { // base series options
              * The series name as given in the options. Defaults to
              * "Series {n}".
              *
-             * @name name
-             * @memberof Series
-             * @type {String}
+             * @name Highcharts.Series#name
+             * @type {string}
              */
             name: options.name,
             state: '',
@@ -2073,18 +2152,16 @@ H.Series = H.seriesType('line', null, { // base series options
              * Series#show}, {@link Series#hide}, or in the initial
              * configuration.
              *
-             * @name visible
-             * @memberof Series
-             * @type {Boolean}
+             * @name Highcharts.Series#visible
+             * @type {boolean}
              */
             visible: options.visible !== false, // true by default
             /**
              * Read only. The series' selected state as set by {@link
              * Highcharts.Series#select}.
              *
-             * @name selected
-             * @memberof Series
-             * @type {Boolean}
+             * @name Highcharts.Series#selected
+             * @type {boolean}
              */
             selected: options.selected === true // false by default
         });
@@ -2140,9 +2217,13 @@ H.Series = H.seriesType('line', null, { // base series options
      * option. Used internally when adding series.
      *
      * @private
-     * @param   {Array<Series>} collection
-     *          A collection of series, like `chart.series` or `xAxis.series`.
-     * @returns {Number} The index of the series in the collection.
+     * @function Highcharts.Series#insert
+     *
+     * @param {Array<Highcharts.Series>} collection
+     *        A collection of series, like `chart.series` or `xAxis.series`.
+     *
+     * @return {number}
+     *         The index of the series in the collection.
      */
     insert: function (collection) {
         var indexOption = this.options.index,
@@ -2176,6 +2257,9 @@ H.Series = H.seriesType('line', null, { // base series options
      * series in the `axis.series` array.
      *
      * @private
+     * @function Highcharts.Series#bindAxes
+     *
+     * @exception 18
      */
     bindAxes: function () {
         var series = this,
@@ -2212,17 +2296,15 @@ H.Series = H.seriesType('line', null, { // base series options
                      * Read only. The unique xAxis object associated with the
                      * series.
                      *
-                     * @name xAxis
-                     * @memberof Series
-                     * @type Axis
+                     * @name Highcharts.Series#xAxis
+                     * @type {Highcharts.Axis}
                      */
                     /**
                      * Read only. The unique yAxis object associated with the
                      * series.
                      *
-                     * @name yAxis
-                     * @memberof Series
-                     * @type Axis
+                     * @name Highcharts.Series#yAxis
+                     * @type {Highcharts.Axis}
                      */
                     series[AXIS] = axis;
 
@@ -2247,6 +2329,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * `series.parallelArrays` array.
      *
      * @private
+     * @function Highcharts.Series#updateParallelArrays
+     *
+     * @param {Highcharts.Point} point
+     *
+     * @param {number|string} i
      */
     updateParallelArrays: function (point, i) {
         var series = point.series,
@@ -2277,6 +2364,9 @@ H.Series = H.seriesType('line', null, { // base series options
      * the point that calls autoIncrement.
      *
      * @private
+     * @function Highcharts.Series#autoIncrement
+     *
+     * @return {number}
      */
     autoIncrement: function () {
 
@@ -2332,8 +2422,14 @@ H.Series = H.seriesType('line', null, { // base series options
      * internally on initiating and updating series. This function will not
      * redraw the series. For API usage, use {@link Series#update}.
      *
-     * @param  {Options.plotOptions.series} itemOptions
-     *         The series options.
+     * @function Highcharts.Series#setOptions
+     *
+     * @param {Highcharts.PlotSeriesOptions} itemOptions
+     *        The series options.
+     *
+     * @return {Highcharts.PlotSeriesOptions}
+     *
+     * @fires Highcharts.Series#event:afterSetOptions
      */
     setOptions: function (itemOptions) {
         var chart = this.chart,
@@ -2427,12 +2523,25 @@ H.Series = H.seriesType('line', null, { // base series options
      * user. This method can be simply overridden as series name format can
      * vary (e.g. technical indicators).
      *
-     * @return  {String} The series name.
+     * @function Highcharts.Series#getName
+     *
+     * @return {string}
+     *         The series name.
      */
     getName: function () {
         return this.name || 'Series ' + (this.index + 1);
     },
 
+    /**
+     * @private
+     * @function Highcharts.Series#getCyclic
+     *
+     * @param {string} prop
+     *
+     * @param {*} value
+     *
+     * @param {*} [defaults]
+     */
     getCyclic: function (prop, value, defaults) {
         var i,
             chart = this.chart,
@@ -2477,21 +2586,21 @@ H.Series = H.seriesType('line', null, { // base series options
      * Get the series' color based on either the options or pulled from global
      * options.
      *
-     * @return  {Color} The series color.
+     * @function Highcharts.Series#getColor
      */
     
     getColor: function () {
         this.getCyclic('color');
     },
-
     
     /**
      * Get the series' symbol based on either the options or pulled from global
      * options.
+     *
+     * @function Highcharts.Series#getSymbol
      */
     getSymbol: function () {
         var seriesMarkerOption = this.options.marker;
-
         this.getCyclic(
             'symbol',
             seriesMarkerOption.symbol,
@@ -2499,6 +2608,10 @@ H.Series = H.seriesType('line', null, { // base series options
         );
     },
 
+    /**
+     * @private
+     * @borrows LegendSymbolMixin.drawLineMarker as Highcharts.Series#drawLegendSymbol
+     */
     drawLegendSymbol: LegendSymbolMixin.drawLineMarker,
 
     /**
@@ -2508,6 +2621,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * allows adding or removing points if the X-es don't match.
      *
      * @private
+     * @function Highcharts.Series#updateData
+     *
+     * @param {Array<*>} data
+     *
+     * @return {boolean}
      */
     updateData: function (data) {
         var options = this.options,
@@ -2537,8 +2655,10 @@ H.Series = H.seriesType('line', null, { // base series options
                 // Search for the same X in the existing data set
                 pointIndex = H.inArray(x, this.xData, lastIndex);
 
-                // Matching X not found, add point (but later)
-                if (pointIndex === -1) {
+                // Matching X not found
+                // or used already due to ununique x values (#8995),
+                // add point (but later)
+                if (pointIndex === -1 || oldData[pointIndex].touched) {
                     pointsToAdd.push(pointOptions);
 
                 // Matching X found, update
@@ -2554,10 +2674,10 @@ H.Series = H.seriesType('line', null, { // base series options
                     // are not touched.
                     oldData[pointIndex].touched = true;
 
-                    // Speed optimize by only searching from last known index.
+                    // Speed optimize by only searching after last known index.
                     // Performs ~20% bettor on large data sets.
                     if (requireSorting) {
-                        lastIndex = pointIndex;
+                        lastIndex = pointIndex + 1;
                     }
                 // Point exists, no changes, don't remove it
                 } else if (oldData[pointIndex]) {
@@ -2610,25 +2730,6 @@ H.Series = H.seriesType('line', null, { // base series options
      * or a different amount of points, as handled by the `updatePoints`
      * parameter.
      *
-     * @param  {SeriesDataOptions} data
-     *         Takes an array of data in the same format as described under
-     *         `series.typedata` for the given series type.
-     * @param  {Boolean} [redraw=true]
-     *         Whether to redraw the chart after the series is altered. If doing
-     *         more operations on the chart, it is a good idea to set redraw to
-     *         false and call {@link Chart#redraw} after.
-     * @param  {AnimationOptions} [animation]
-     *         When the updated data is the same length as the existing data,
-     *         points will be updated by default, and animation visualizes how
-     *         the points are changed. Set false to disable animation, or a
-     *         configuration object to set duration or easing.
-     * @param  {Boolean} [updatePoints=true]
-     *         When the updated data is the same length as the existing data, or
-     *         points can be matched by X values, points will be updated instead
-     *         of replaced. This allows updating with animation and performs
-     *         better. In this case, the original array is not passed by
-     *         reference. Set `false` to prevent.
-     *
      * @sample highcharts/members/series-setdata/
      *         Set new data from a button
      * @sample highcharts/members/series-setdata-pie/
@@ -2637,6 +2738,32 @@ H.Series = H.seriesType('line', null, { // base series options
      *         Set new data in Highstock
      * @sample maps/members/series-setdata/
      *         Set new data in Highmaps
+     *
+     * @function Highcharts.Series#setData
+     *
+     * @param {Array<*>} data
+     *        Takes an array of data in the same format as described under
+     *        `series.{type}.data` for the given series type, for example a
+     *        line series would take data in the form described under
+     *        [series.line.data](https://api.highcharts.com/highcharts/series.line.data).
+     *
+     * @param {boolean} [redraw=true]
+     *        Whether to redraw the chart after the series is altered. If doing
+     *        more operations on the chart, it is a good idea to set redraw to
+     *        false and call {@link Chart#redraw} after.
+     *
+     * @param {Highcharts.AnimationOptionsObject} [animation]
+     *        When the updated data is the same length as the existing data,
+     *        points will be updated by default, and animation visualizes how
+     *        the points are changed. Set false to disable animation, or a
+     *        configuration object to set duration or easing.
+     *
+     * @param {boolean} [updatePoints=true]
+     *        When the updated data is the same length as the existing data, or
+     *        points can be matched by X values, points will be updated instead
+     *        of replaced. This allows updating with animation and performs
+     *        better. In this case, the original array is not passed by
+     *        reference. Set `false` to prevent.
      */
     setData: function (data, redraw, animation, updatePoints) {
         var series = this,
@@ -2668,7 +2795,10 @@ H.Series = H.seriesType('line', null, { // base series options
             oldDataLength &&
             !series.cropped &&
             !series.hasGroupedData &&
-            series.visible
+            series.visible &&
+            // Soft updating has no benefit in boost, and causes JS error
+            // (#8355)
+            !series.isSeriesBoosting
         ) {
             updatedData = this.updateData(data);
         }
@@ -2786,8 +2916,12 @@ H.Series = H.seriesType('line', null, { // base series options
      * provide data grouping.
      *
      * @private
-     * @param  {Boolean} force
-     *         Force data grouping.
+     * @function Highcharts.Series#processData
+     *
+     * @param {boolean} force
+     *        Force data grouping.
+     *
+     * @return {boolean|undefined}
      */
     processData: function (force) {
         var series = this,
@@ -2851,8 +2985,10 @@ H.Series = H.seriesType('line', null, { // base series options
 
             // only crop if it's actually spilling out
             } else if (
-                processedXData[0] < min ||
-                processedXData[dataLength - 1] > max
+                series.yData && (
+                    processedXData[0] < min ||
+                    processedXData[dataLength - 1] > max
+                )
             ) {
                 croppedData = this.cropData(
                     series.xData,
@@ -2909,6 +3045,19 @@ H.Series = H.seriesType('line', null, { // base series options
      * dataMin and dataMax within the cropped range.
      *
      * @private
+     * @function Highcharts.Series#cropData
+     *
+     * @param {Array<number>} xData
+     *
+     * @param {Array<number>} yData
+     *
+     * @param {number} min
+     *
+     * @param {number} max
+     *
+     * @param {number} [cropShoulder]
+     *
+     * @return {*}
      */
     cropData: function (xData, yData, min, max, cropShoulder) {
         var dataLength = xData.length,
@@ -2950,6 +3099,7 @@ H.Series = H.seriesType('line', null, { // base series options
      * away unused points and optionally grouped in Highcharts Stock.
      *
      * @private
+     * @function Highcharts.Series#generatePoints
      */
     generatePoints: function () {
         var series = this,
@@ -3008,12 +3158,16 @@ H.Series = H.seriesType('line', null, { // base series options
                  * in the group.
                  * - `dataGroup.length` is the amount of points in the group.
                  *
-                 * @name dataGroup
-                 * @memberof Point
-                 * @type {Object}
+                 * @name Highcharts.Point#dataGroup
+                 * @type {Highcharts.SVGElement|undefined}
                  *
+                 * @product highstock
                  */
                 point.dataGroup = series.groupMap[i];
+                if (point.dataGroup.options) {
+                    point.options = point.dataGroup.options;
+                    extend(point, point.dataGroup.options);
+                }
             }
             if (point) { // #6279
                 point.index = cursor; // For faster access in Point.update
@@ -3056,9 +3210,9 @@ H.Series = H.seriesType('line', null, { // base series options
          * demand. To modify the data, use {@link Highcharts.Series#setData} or
          * {@link Highcharts.Point#update}.
          *
-         * @name data
-         * @memberof Highcharts.Series
-         * @see  Series.points
+         * @see Series.points
+         *
+         * @name Highcharts.Series#data
          * @type {Array<Point>}
          */
         series.data = data;
@@ -3071,9 +3225,9 @@ H.Series = H.seriesType('line', null, { // base series options
          * is grouped, these can't be correlated one to one. To
          * modify the data, use {@link Highcharts.Series#setData} or {@link
          * Highcharts.Point#update}.
-         * @name points
-         * @memberof Series
-         * @type {Array<Point>}
+         *
+         * @name Highcharts.Series#points
+         * @type {Array<Highcharts.Point>}
          */
         series.points = points;
     },
@@ -3082,10 +3236,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * Calculate Y extremes for the visible data. The result is set as
      * `dataMin` and `dataMax` on the Series item.
      *
-     * @param  {Array<Number>} [yData]
-     *         The data to inspect. Defaults to the current data within the
-     *         visible range.
+     * @function Highcharts.Series#getExtremes
      *
+     * @param {Array<number>} [yData]
+     *        The data to inspect. Defaults to the current data within the
+     *        visible range.
      */
     getExtremes: function (yData) {
         var xAxis = this.xAxis,
@@ -3156,6 +3311,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * data needed later in the `drawPoints` and `drawGraph` functions. This
      * function can be overridden in plugins and custom series type
      * implementations.
+     *
+     * @function Highcharts.Series#translate
+     *
+     * @todo
+     * Make events official: Fires the event `afterTranslate`.
      */
     translate: function () {
         if (!this.processedXData) { // hidden series
@@ -3333,13 +3493,14 @@ H.Series = H.seriesType('line', null, { // base series options
     /**
      * Return the series points with null points filtered out.
      *
-     * @param  {Array<Point>} [points]
-     *         The points to inspect, defaults to {@link Series.points}.
-     * @param  {Boolean} [insideOnly=false]
-     *         Whether to inspect only the points that are inside the visible
-     *         view.
+     * @param {Array<Highcharts.Point>} [points]
+     *        The points to inspect, defaults to {@link Series.points}.
      *
-     * @return {Array<Point>}
+     * @param {boolean} [insideOnly=false]
+     *        Whether to inspect only the points that are inside the visible
+     *        view.
+     *
+     * @return {Array<Highcharts.Point>}
      *         The valid points.
      */
     getValidPoints: function (points, insideOnly) {
@@ -3363,6 +3524,9 @@ H.Series = H.seriesType('line', null, { // base series options
      * animation to set the final clip.
      *
      * @private
+     * @function Highcharts.Series#setClip
+     *
+     * @param {boolean} [animation]
      */
     setClip: function (animation) {
         var chart = this.chart,
@@ -3453,8 +3617,10 @@ H.Series = H.seriesType('line', null, { // base series options
      * order to perform the actual animation. After the second run, the function
      * is removed.
      *
-     * @param  {Boolean} init
-     *         Initialize the animation.
+     * @function Highcharts.Series#animate
+     *
+     * @param {boolean} init
+     *        Initialize the animation.
      */
     animate: function (init) {
         var series = this,
@@ -3495,6 +3661,10 @@ H.Series = H.seriesType('line', null, { // base series options
      * This runs after animation to land on the final plot clipping.
      *
      * @private
+     * @function Highcharts.Series#afterAnimate
+     *
+     * @todo
+     * Make events official: Fires the event `afterAnimate`.
      */
     afterAnimate: function () {
         this.setClip();
@@ -3508,6 +3678,8 @@ H.Series = H.seriesType('line', null, { // base series options
      * types. The resulting element is typically stored as {@link
      * Point.graphic}, and is created on the first call and updated and moved on
      * subsequent calls.
+     *
+     * @function Highcharts.Series#drawPoints
      */
     drawPoints: function () {
         var series = this,
@@ -3615,14 +3787,15 @@ H.Series = H.seriesType('line', null, { // base series options
      * Get non-presentational attributes for a point. Used internally for both
      * styled mode and classic. Can be overridden for different series types.
      *
-     * @see    Series#pointAttribs
+     * @see Series#pointAttribs
+     *
+     * @param {Highcharts.Point} point
+     *        The Point to inspect.
      *
-     * @param  {Point} point
-     *         The Point to inspect.
-     * @param  {String} [state]
-     *         The state, can be either `hover`, `select` or undefined.
+     * @param {string} [state]
+     *        The state, can be either `hover`, `select` or undefined.
      *
-     * @return {SVGAttributes}
+     * @return {Highcharts.SVGAttributes}
      *         A hash containing those attributes that are not settable from
      *         CSS.
      */
@@ -3674,10 +3847,15 @@ H.Series = H.seriesType('line', null, { // base series options
     },
 
     
+
     /**
      * Clear DOM objects and free up memory.
      *
      * @private
+     * @function Highcharts.Series#destroy
+     *
+     * @todo
+     * Make events official: Fires the event `destroy`.
      */
     destroy: function () {
         var series = this,
@@ -3754,6 +3932,15 @@ H.Series = H.seriesType('line', null, { // base series options
      * Get the graph path.
      *
      * @private
+     * @function Highcharts.Series#getGraphPath
+     *
+     * @param {Array<*>} points
+     *
+     * @param {boolean} nullsAsZeroes
+     *
+     * @param {boolean} connectCliffs
+     *
+     * @return {Array<number|string>}
      */
     getGraphPath: function (points, nullsAsZeroes, connectCliffs) {
         var series = this,
@@ -3879,6 +4066,8 @@ H.Series = H.seriesType('line', null, { // base series options
      * The first time it generates the `series.graph` item and optionally other
      * series-wide items like `series.area` for area charts. On subsequent calls
      * these items are updated with new positions and attributes.
+     *
+     * @function Highcharts.Series#drawGraph
      */
     drawGraph: function () {
         var series = this,
@@ -3927,6 +4116,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * Extendable by series with multiple lines within one series.
      *
      * @private
+     * @function Highcharts.Series#getZonesGraphs
+     *
+     * @param {Array<Array<string>>} props
+     *
+     * @return {Array<Array<string>>}
      */
     getZonesGraphs: function (props) {
         // Add the zone properties if any
@@ -3946,6 +4140,7 @@ H.Series = H.seriesType('line', null, { // base series options
      * Clip the graphs into zones for colors and styling.
      *
      * @private
+     * @function Highcharts.Series#applyZones
      */
     applyZones: function () {
         var series = this,
@@ -4070,6 +4265,9 @@ H.Series = H.seriesType('line', null, { // base series options
      * series.markerGroup.
      *
      * @private
+     * @function Highcharts.Series#invertGroups
+     *
+     * @param {boolean} inverted
      */
     invertGroups: function (inverted) {
         var series = this,
@@ -4118,6 +4316,19 @@ H.Series = H.seriesType('line', null, { // base series options
      * group will only be adjusted to the updated plot size.
      *
      * @private
+     * @function Highcharts.Series#plotGroup
+     *
+     * @param {string} prop
+     *
+     * @param {string} name
+     *
+     * @param {string} visibility
+     *
+     * @param {number} zIndex
+     *
+     * @param {Highcharts.SVGElement} parent
+     *
+     * @return {Highcharts.SVGElement}
      */
     plotGroup: function (prop, name, visibility, zIndex, parent) {
         var group = this[prop],
@@ -4164,6 +4375,10 @@ H.Series = H.seriesType('line', null, { // base series options
 
     /**
      * Get the translation and scale for the plot area of this series.
+     *
+     * @function Highcharts.Series#getPlotBox
+     *
+     * @return {Highcharts.SeriesPlotBoxObject}
      */
     getPlotBox: function () {
         var chart = this.chart,
@@ -4187,6 +4402,11 @@ H.Series = H.seriesType('line', null, { // base series options
      * Render the graph and markers. Called internally when first rendering and
      * later when redrawing the chart. This function can be extended in plugins,
      * but normally shouldn't be called directly.
+     *
+     * @function Highcharts.Series#render
+     *
+     * @todo
+     * Make events official: Fires the event `afterRender`.
      */
     render: function () {
         var series = this,
@@ -4298,6 +4518,7 @@ H.Series = H.seriesType('line', null, { // base series options
      * and normally shouldn't be called directly.
      *
      * @private
+     * @function Highcharts.Series#redraw
      */
     redraw: function () {
         var series = this,
@@ -4332,6 +4553,16 @@ H.Series = H.seriesType('line', null, { // base series options
 
     kdAxisArray: ['clientX', 'plotY'],
 
+    /**
+     * @private
+     * @function Highcharts.Series#searchPoint
+     *
+     * @param {*} e
+     *
+     * @param {*} compareX
+     *
+     * @return {Highcharts.Point}
+     */
     searchPoint: function (e, compareX) {
         var series = this,
             xAxis = series.xAxis,
@@ -4355,6 +4586,7 @@ H.Series = H.seriesType('line', null, { // base series options
      * typically search in two dimensions, X and Y.
      *
      * @private
+     * @function Highcharts.Series#buildKDTree
      */
     buildKDTree: function () {
 
@@ -4418,6 +4650,16 @@ H.Series = H.seriesType('line', null, { // base series options
         syncTimeout(startRecursive, series.options.kdNow ? 0 : 1);
     },
 
+    /**
+     * @private
+     * @function Highcharts.Series#searchKDTree
+     *
+     * @param {*} point
+     *
+     * @param {*} compareX
+     *
+     * @return {Highcharts.Point}
+     */
     searchKDTree: function (point, compareX) {
         var series = this,
             kdX = this.kdAxisArray[0],
@@ -4496,22 +4738,25 @@ H.Series = H.seriesType('line', null, { // base series options
  * A line series displays information as a series of data points connected by
  * straight line segments.
  *
- * @sample {highcharts} highcharts/demo/line-basic/ Line chart
- * @sample {highstock} stock/demo/basic-line/ Line chart
+ * @sample {highcharts} highcharts/demo/line-basic/
+ *         Line chart
+ * @sample {highstock} stock/demo/basic-line/
+ *         Line chart
  *
- * @extends plotOptions.series
- * @product highcharts highstock
+ * @extends   plotOptions.series
+ * @product   highcharts highstock
  * @apioption plotOptions.line
  */
 
+
+
 /**
  * A `line` series. If the [type](#series.line.type) option is not
  * specified, it is inherited from [chart.type](#chart.type).
  *
- * @type {Object}
- * @extends series,plotOptions.line
+ * @extends   series,plotOptions.line
  * @excluding dataParser,dataURL
- * @product highcharts highstock
+ * @product   highcharts highstock
  * @apioption series.line
  */
 
@@ -4541,8 +4786,8 @@ H.Series = H.seriesType('line', null, { // base series options
  *     ]
  *  ```
  *
- * 3.  An array of objects with named values. The objects are point
- * configuration objects as seen below. If the total number of data
+ * 3.  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.line.turboThreshold),
  * this option is not available.
  *
@@ -4560,7 +4805,6 @@ H.Series = H.seriesType('line', null, { // base series options
  *     }]
  *  ```
  *
- * @type {Array<Object|Array|Number>}
  * @sample {highcharts} highcharts/chart/reflow-true/
  *         Numerical values
  * @sample {highcharts} highcharts/series/data-array-of-arrays/
@@ -4571,6 +4815,8 @@ H.Series = H.seriesType('line', null, { // base series options
  *         Arrays of point.name and y
  * @sample {highcharts} highcharts/series/data-array-of-objects/
  *         Config objects
+ *
+ * @type      {Array<number|Array<number|string|Date>|*>}
  * @apioption series.line.data
  */
 
@@ -4578,9 +4824,9 @@ H.Series = H.seriesType('line', null, { // base series options
  * An additional, individual class name for the data point's graphic
  * representation.
  *
- * @type {String}
- * @since 5.0.0
- * @product highcharts
+ * @type      {string}
+ * @since     5.0.0
+ * @product   highcharts
  * @apioption series.line.data.className
  */
 
@@ -4591,10 +4837,11 @@ H.Series = H.seriesType('line', null, { // base series options
  * In styled mode, the `color` option doesn't take effect. Instead, use
  * `colorIndex`.
  *
- * @type {Color}
- * @sample {highcharts} highcharts/point/color/ Mark the highest point
- * @default undefined
- * @product highcharts highstock
+ * @sample {highcharts} highcharts/point/color/
+ *         Mark the highest point
+ *
+ * @type      {Highcharts.ColorString}
+ * @product   highcharts highstock
  * @apioption series.line.data.color
  */
 
@@ -4605,9 +4852,9 @@ H.Series = H.seriesType('line', null, { // base series options
  * the `fill` attribute, so the change in class name won't have a visual effect
  * by default.
  *
- * @type {Number}
- * @since 5.0.0
- * @product highcharts
+ * @type      {number}
+ * @since     5.0.0
+ * @product   highcharts
  * @apioption series.line.data.colorIndex
  */
 
@@ -4616,10 +4863,11 @@ H.Series = H.seriesType('line', null, { // base series options
  * the ones for [plotOptions.series.dataLabels](
  * #plotOptions.series.dataLabels).
  *
- * @type {Object}
  * @sample highcharts/point/datalabels/
  *         Show a label for the last value
- * @product highcharts highstock
+ *
+ * @type      {Highcharts.PlotSeriesDataLabelsOptions}
+ * @product   highcharts highstock
  * @apioption series.line.data.dataLabels
  */
 
@@ -4627,9 +4875,8 @@ H.Series = H.seriesType('line', null, { // base series options
  * A description of the point to add to the screen reader information
  * about the point. Requires the Accessibility module.
  *
- * @type {String}
- * @default undefined
- * @since 5.0.0
+ * @type      {string}
+ * @since     5.0.0
  * @apioption series.line.data.description
  */
 
@@ -4637,11 +4884,12 @@ H.Series = H.seriesType('line', null, { // base series options
  * An id for the point. This can be used after render time to get a
  * pointer to the point object through `chart.get()`.
  *
- * @type {String}
- * @sample {highcharts} highcharts/point/id/ Remove an id'd point
- * @default null
- * @since 1.2.0
- * @product highcharts highstock
+ * @sample {highcharts} highcharts/point/id/
+ *         Remove an id'd point
+ *
+ * @type      {string}
+ * @since     1.2.0
+ * @product   highcharts highstock
  * @apioption series.line.data.id
  */
 
@@ -4650,7 +4898,7 @@ H.Series = H.seriesType('line', null, { // base series options
  * data labels are about to overlap, only the one with the highest `labelrank`
  * will be drawn.
  *
- * @type {Number}
+ * @type      {number}
  * @apioption series.line.data.labelrank
  */
 
@@ -4658,18 +4906,21 @@ H.Series = H.seriesType('line', null, { // base series options
  * The name of the point as shown in the legend, tooltip, dataLabel
  * etc.
  *
- * @type {String}
- * @sample {highcharts} highcharts/series/data-array-of-objects/ Point names
  * @see [xAxis.uniqueNames](#xAxis.uniqueNames)
+ *
+ * @sample {highcharts} highcharts/series/data-array-of-objects/
+ *         Point names
+ *
+ * @type      {string}
  * @apioption series.line.data.name
  */
 
 /**
  * Whether the data point is selected initially.
  *
- * @type {Boolean}
- * @default false
- * @product highcharts highstock
+ * @type      {boolean}
+ * @default   false
+ * @product   highcharts highstock
  * @apioption series.line.data.selected
  */
 
@@ -4677,30 +4928,29 @@ H.Series = H.seriesType('line', null, { // base series options
  * The x value of the point. For datetime axes, the X value is the timestamp
  * in milliseconds since 1970.
  *
- * @type {Number}
- * @product highcharts highstock
+ * @type      {number}
+ * @product   highcharts highstock
  * @apioption series.line.data.x
  */
 
 /**
  * The y value of the point.
  *
- * @type {Number}
- * @default null
- * @product highcharts highstock
+ * @type      {number}
+ * @product   highcharts highstock
  * @apioption series.line.data.y
  */
 
 /**
  * Individual point events
  *
- * @extends plotOptions.series.point.events
- * @product highcharts highstock
+ * @extends   plotOptions.series.point.events
+ * @product   highcharts highstock
  * @apioption series.line.data.events
  */
 
 /**
- * @extends plotOptions.series.marker
- * @product highcharts highstock
+ * @extends   plotOptions.series.marker
+ * @product   highcharts highstock
  * @apioption series.line.data.marker
  */