highcharts 6.1.1 → 6.2.0

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

@@ -1,16 +1,58 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
 
+/**
+ * Callback for chart constructors.
+ *
+ * @callback Highcharts.ChartCallbackFunction
+ *
+ * @param {Highcharts.Chart} chart
+ *        Created chart.
+ */
+
+/**
+ * The chart title. The title has an `update` method that allows modifying the
+ * options directly or indirectly via `chart.update`.
+ *
+ * @interface Highcharts.TitleObject
+ * @extends Highcharts.SVGElement
+ *//**
+ * Modify options for the title.
+ *
+ * @function Highcharts.TitleObject#update
+ *
+ * @param {Highcharts.TitleOptions} titleOptions
+ *        Options to modify.
+ */
+
+/**
+ * The chart subtitle. The subtitle has an `update` method that
+ * allows modifying the options directly or indirectly via
+ * `chart.update`.
+ *
+ * @interface Highcharts.SubtitleObject
+ * @extends Highcharts.SVGElement
+ *//**
+ * Modify options for the subtitle.
+ *
+ * @function Highcharts.SubtitleObject#update
+ *
+ * @param {Highcharts.SubtitleOptions} subtitleOptions
+ *        Options to modify.
+ */
+
 'use strict';
+
 import H from './Globals.js';
 import './Utilities.js';
 import './Axis.js';
 import './Legend.js';
 import './Options.js';
 import './Pointer.js';
+
 var addEvent = H.addEvent,
     animate = H.animate,
     animObject = H.animObject,
@@ -43,18 +85,9 @@ var addEvent = H.addEvent,
     splat = H.splat,
     syncTimeout = H.syncTimeout,
     win = H.win;
+
 /**
  * The Chart class. The recommended constructor is {@link Highcharts#chart}.
- * @class Highcharts.Chart
- * @param  {String|HTMLDOMElement} renderTo
- *         The DOM element to render to, or its id.
- * @param  {Options} options
- *         The chart options structure.
- * @param  {Function} [callback]
- *         Function to run when the chart has loaded and and all external images
- *         are loaded. Defining a [chart.event.load](
- *         https://api.highcharts.com/highcharts/chart.events.load) handler is
- *         equivalent.
  *
  * @example
  * var chart = Highcharts.chart('container', {
@@ -65,6 +98,21 @@ var addEvent = H.addEvent,
  *            data: [1, 3, 2, 4]
  *        }]
  * })
+ *
+ * @class
+ * @name Highcharts.Chart
+ *
+ * @param {string|Highcharts.HTMLDOMElement} [renderTo]
+ *        The DOM element to render to, or its id.
+ *
+ * @param {Highcharts.Options} options
+ *        The chart options structure.
+ *
+ * @param {Highcharts.ChartCallbackFunction} [callback]
+ *        Function to run when the chart has loaded and and all external images
+ *        are loaded. Defining a
+ *        {@link https://api.highcharts.com/highcharts/chart.events.load|chart.event.load}
+ *        handler is equivalent.
  */
 var Chart = H.Chart = function () {
     this.getArgs.apply(this, arguments);
@@ -73,17 +121,6 @@ var Chart = H.Chart = function () {
 /**
  * Factory function for basic charts.
  *
- * @function #chart
- * @memberof Highcharts
- * @param  {String|HTMLDOMElement} renderTo - The DOM element to render to, or
- * its id.
- * @param  {Options} options - The chart options structure.
- * @param  {Function} [callback] - Function to run when the chart has loaded and
- * and all external images are loaded. Defining a {@link
- * https://api.highcharts.com/highcharts/chart.events.load|chart.event.load}
- * handler is equivalent.
- * @return {Highcharts.Chart} - Returns the Chart object.
- *
  * @example
  * // Render a chart in to div#container
  * var chart = Highcharts.chart('container', {
@@ -94,6 +131,23 @@ var Chart = H.Chart = function () {
  *         data: [1, 3, 2, 4]
  *     }]
  * });
+ *
+ * @function Highcharts.chart
+ *
+ * @param {string|Highcharts.HTMLDOMElement} [renderTo]
+ *        The DOM element to render to, or its id.
+ *
+ * @param {Highcharts.Options} options
+ *        The chart options structure.
+ *
+ * @param {Highcharts.ChartCallbackFunction} [callback]
+ *        Function to run when the chart has loaded and and all external images
+ *        are loaded. Defining a
+ *        {@link https://api.highcharts.com/highcharts/chart.events.load|chart.event.load}
+ *        handler is equivalent.
+ *
+ * @return {Highcharts.Chart}
+ *         Returns the Chart object.
  */
 H.chart = function (a, b, c) {
     return new Chart(a, b, c);
@@ -108,7 +162,16 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Handle the arguments passed to the constructor.
      *
      * @private
-     * @returns {Array} Arguments without renderTo
+     * @function Highcharts.Chart#getArgs
+     *
+     * @param {...Array<*>} arguments
+     *        All arguments for the constructor.
+     *
+     * @return {Array<*>}
+     *         Passed arguments without renderTo.
+     *
+     * @fires Highcharts.Chart#event:init
+     * @fires Highcharts.Chart#event:afterInit
      */
     getArgs: function () {
         var args = [].slice.call(arguments);
@@ -124,6 +187,18 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
     /**
      * Overridable function that initializes the chart. The constructor's
      * arguments are passed on directly.
+     *
+     * @function Highcharts.Chart#init
+     *
+     * @param {Highcharts.Options} userOptions
+     *        Custom options.
+     *
+     * @param {Function} [callback]
+     *        Function to run when the chart has loaded and and all external
+     *        images are loaded.
+     *
+     * @fires Highcharts.Chart#event:init
+     * @fires Highcharts.Chart#event:afterInit
      */
     init: function (userOptions, callback) {
 
@@ -181,63 +256,38 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
              * The options structure for the chart. It contains members for
              * the sub elements like series, legend, tooltip etc.
              *
-             * @memberof Highcharts.Chart
-             * @name options
-             * @type {Options}
+             * @name Highcharts.Chart#options
+             * @type {Highcharts.Options}
              */
             this.options = options;
+
             /**
              * All the axes in the chart.
              *
-             * @memberof Highcharts.Chart
-             * @name axes
              * @see  Highcharts.Chart.xAxis
              * @see  Highcharts.Chart.yAxis
-             * @type {Array<Axis>}
+             *
+             * @name Highcharts.Chart#axes
+             * @type {Array<Highcharts.Axis>}
              */
             this.axes = [];
 
             /**
              * All the current series in the chart.
              *
-             * @memberof Highcharts.Chart
-             * @name series
-             * @type {Array<Series>}
+             * @name Highcharts.Chart#series
+             * @type {Array<Highcharts.Series>}
              */
             this.series = [];
 
-            /**
-             * The chart title. The title has an `update` method that allows
-             * modifying the options directly or indirectly via
-             * `chart.update`.
-             *
-             * @memberof Highcharts.Chart
-             * @name title
-             * @type Object
-             *
-             * @sample highcharts/members/title-update/
-             *         Updating titles
-             */
-
-            /**
-             * The chart subtitle. The subtitle has an `update` method that
-             * allows modifying the options directly or indirectly via
-             * `chart.update`.
-             *
-             * @memberof Highcharts.Chart
-             * @name subtitle
-             * @type Object
-             */
-
             /**
              * The `Time` object associated with the chart. Since v6.0.5,
              * time settings can be applied individually for each chart. If
              * no individual settings apply, the `Time` object is shared by
              * all instances.
              *
-             * @memberof Highcharts.Chart
-             * @name time
-             * @type Highcharts.Time
+             * @name Highcharts.Chart#time
+             * @type {Highcharts.Time}
              */
             this.time =
                 userOptions.time && H.keys(userOptions.time).length ?
@@ -264,16 +314,20 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
 
             /**
              * A collection of the X axes in the chart.
-             * @type {Array<Axis>}
-             * @name xAxis
-             * @memberof Highcharts.Chart
+             *
+             * @name Highcharts.Chart#xAxis
+             * @type {Array<Highcharts.Axis>}
              */
             chart.xAxis = [];
+
             /**
              * A collection of the Y axes in the chart.
-             * @type {Array<Axis>}
-             * @name yAxis
-             * @memberof Highcharts.Chart
+             *
+             * @name Highcharts.Chart#yAxis
+             * @type {Array<Highcharts.Axis>}
+             *
+             * @todo
+             * Make events official: Fire the event `afterInit`.
              */
             chart.yAxis = [];
 
@@ -291,6 +345,11 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Internal function to unitialize an individual series.
      *
      * @private
+     * @function Highcharts.Chart#initSeries
+     *
+     * @param {Highcharts.ChartOptions} options
+     *
+     * @return {Highcharts.Series}
      */
     initSeries: function (options) {
         var chart = this,
@@ -319,9 +378,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * #6112). This function is called on series initialization and destroy.
      *
      * @private
+     * @function Highcharts.Series#orderSeries
      *
-     * @param  {number} fromIndex
-     *         If this is given, only the series above this index are handled.
+     * @param {number} fromIndex
+     *        If this is given, only the series above this index are handled.
      */
     orderSeries: function (fromIndex) {
         var series = this.series,
@@ -337,14 +397,18 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
     /**
      * Check whether a given point is within the plot area.
      *
-     * @param  {Number} plotX
-     *         Pixel x relative to the plot area.
-     * @param  {Number} plotY
-     *         Pixel y relative to the plot area.
-     * @param  {Boolean} inverted
-     *         Whether the chart is inverted.
+     * @function Highcharts.Chart#isInsidePlot
+     *
+     * @param {number} plotX
+     *        Pixel x relative to the plot area.
+     *
+     * @param {number} plotY
+     *        Pixel y relative to the plot area.
+     *
+     * @param {boolean} inverted
+     *        Whether the chart is inverted.
      *
-     * @return {Boolean}
+     * @return {boolean}
      *         Returns true if the given point is inside the plot area.
      */
     isInsidePlot: function (plotX, plotY, inverted) {
@@ -366,8 +430,17 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * cases it is a waste of resources to redraw the chart for each new point
      * added. So you add the points and call `chart.redraw()` after.
      *
-     * @param  {AnimationOptions} animation
-     *         If or how to apply animation to the redraw.
+     * @function Highcharts.Chart#redraw
+     *
+     * @param {boolean|Highcharts.AnimationOptionsObject} [animation]
+     *        If or how to apply animation to the redraw.
+     *
+     * @fires Highcharts.Chart#event:afterSetExtremes
+     * @fires Highcharts.Chart#event:beforeRedraw
+     * @fires Highcharts.Chart#event:predraw
+     * @fires Highcharts.Chart#event:redraw
+     * @fires Highcharts.Chart#event:render
+     * @fires Highcharts.Chart#event:updatedData
      */
     redraw: function (animation) {
 
@@ -378,6 +451,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
             series = chart.series,
             pointer = chart.pointer,
             legend = chart.legend,
+            legendUserOptions = chart.userOptions.legend,
             redrawLegend = chart.isDirtyLegend,
             hasStackedSeries,
             hasDirtyStacks,
@@ -435,6 +509,14 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
                         serie.updateTotals();
                     }
                     redrawLegend = true;
+                } else if (
+                    legendUserOptions &&
+                    (
+                        legendUserOptions.labelFormatter ||
+                        legendUserOptions.labelFormat
+                    )
+                ) {
+                    redrawLegend = true; // #2165
                 }
             }
             if (serie.isDirtyData) {
@@ -443,7 +525,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         });
 
         // handle added or removed series
-        if (redrawLegend && legend.options.enabled) {
+        if (redrawLegend && legend && legend.options.enabled) {
             // draw legend graphics
             legend.render();
 
@@ -460,6 +542,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
             // set axes scales
             each(axes, function (axis) {
                 axis.updateNames();
+                // Update categories in a Gantt chart
+                if (axis.updateYNames) {
+                    axis.updateYNames();
+                }
                 axis.setScale();
             });
         }
@@ -542,11 +628,17 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
     /**
      * Get an axis, series or point object by `id` as given in the configuration
      * options. Returns `undefined` if no item is found.
-     * @param id {String} The id as given in the configuration options.
-     * @return {Highcharts.Axis|Highcharts.Series|Highcharts.Point|undefined}
-     *         The retrieved item.
+     *
      * @sample highcharts/plotoptions/series-id/
      *         Get series by id
+     *
+     * @function Highcharts.Chart#get
+     *
+     * @param {string} id
+     *        The id as given in the configuration options.
+     *
+     * @return {Highcharts.Axis|Highcharts.Series|Highcharts.Point|undefined}
+     *         The retrieved item.
      */
     get: function (id) {
 
@@ -577,6 +669,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Create the Axis instances based on the config options.
      *
      * @private
+     * @function Highcharts.Chart#getAxes
+     *
+     * @fires Highcharts.Chart#event:afterGetAxes
+     * @fires Highcharts.Chart#event:getAxes
      */
     getAxes: function () {
         var chart = this,
@@ -610,14 +706,17 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
 
     /**
      * Returns an array of all currently selected points in the chart. Points
-     * can be selected by clicking or programmatically by the {@link
-     * Highcharts.Point#select} function.
-     *
-     * @return {Array<Point>}
-     *         The currently selected points.
+     * can be selected by clicking or programmatically by the
+     * {@link Highcharts.Point#select}
+     * function.
      *
      * @sample highcharts/plotoptions/series-allowpointselect-line/
      *         Get selected points
+     *
+     * @function Highcharts.Chart#getSelectedPoints
+     *
+     * @return {Array<Highcharts.Point>}
+     *         The currently selected points.
      */
     getSelectedPoints: function () {
         var points = [];
@@ -632,17 +731,19 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
 
     /**
      * Returns an array of all currently selected series in the chart. Series
-     * can be selected either programmatically by the {@link
-     * Highcharts.Series#select} function or by checking the checkbox next to
-     * the legend item if {@link
-     * https://api.highcharts.com/highcharts/plotOptions.series.showCheckbox|
-     * series.showCheckBox} is true.
-     *
-     * @return {Array<Series>}
-     *         The currently selected series.
+     * can be selected either programmatically by the
+     * {@link Highcharts.Series#select}
+     * function or by checking the checkbox next to the legend item if
+     * {@link https://api.highcharts.com/highcharts/plotOptions.series.showCheckbox| series.showCheckBox}
+     * is true.
      *
      * @sample highcharts/members/chart-getselectedseries/
      *         Get selected series
+     *
+     * @function Highcharts.Chart#getSelectedSeries
+     *
+     * @return {Array<Highcharts.Series>}
+     *         The currently selected series.
      */
     getSelectedSeries: function () {
         return grep(this.series, function (serie) {
@@ -653,18 +754,22 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
     /**
      * Set a new title or subtitle for the chart.
      *
-     * @param  titleOptions {TitleOptions}
-     *         New title options. The title text itself is set by the
-     *         `titleOptions.text` property.
-     * @param  subtitleOptions {SubtitleOptions}
-     *         New subtitle options. The subtitle text itself is set by the
-     *         `subtitleOptions.text` property.
-     * @param  redraw {Boolean}
-     *         Whether to redraw the chart or wait for a later call to
-     *         `chart.redraw()`.
+     * @sample highcharts/members/chart-settitle/
+     *         Set title text and styles
+     *
+     * @function Highcharts.Chart#setTitle
      *
-     * @sample highcharts/members/chart-settitle/ Set title text and styles
+     * @param {Highcharts.TitleOptions} titleOptions
+     *        New title options. The title text itself is set by the
+     *        `titleOptions.text` property.
      *
+     * @param {Highcharts.SubtitleOptions} subtitleOptions
+     *        New subtitle options. The subtitle text itself is set by the
+     *        `subtitleOptions.text` property.
+     *
+     * @param {boolean} redraw
+     *        Whether to redraw the chart or wait for a later call to
+     *        `chart.redraw()`.
      */
     setTitle: function (titleOptions, subtitleOptions, redraw) {
         var chart = this,
@@ -683,7 +788,30 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
             subtitleOptions
         );
 
+
         // add title and subtitle
+
+        /**
+         * The chart title. The title has an `update` method that allows
+         * modifying the options directly or indirectly via
+         * `chart.update`.
+         *
+         * @sample highcharts/members/title-update/
+         *         Updating titles
+         *
+         * @name Highcharts.Chart#title
+         * @type {Highcharts.TitleObject}
+         */
+
+        /**
+         * The chart subtitle. The subtitle has an `update` method that
+         * allows modifying the options directly or indirectly via
+         * `chart.update`.
+         *
+         * @name Highcharts.Chart#subtitle
+         * @type {Highcharts.SubtitleObject}
+         */
+
         each([
             ['title', titleOptions, chartTitleOptions],
             ['subtitle', subtitleOptions, chartSubtitleOptions]
@@ -729,6 +857,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * `this.titleOffset`.
      *
      * @private
+     * @function Highcharts.Chart#layOutTitles
+     *
+     * @param {boolean} [redraw=true]
      */
     layOutTitles: function (redraw) {
         var titleOffset = 0,
@@ -781,8 +912,11 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
 
     /**
      * Internal function to get the chart width and height according to options
-     * and container size. Sets {@link Chart.chartWidth} and {@link
-     * Chart.chartHeight}.
+     * and container size. Sets
+     * {@link Chart.chartWidth} and
+     * {@link Chart.chartHeight}.
+     *
+     * @function Highcharts.Chart#getChartSize
      */
     getChartSize: function () {
         var chart = this,
@@ -802,9 +936,8 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         /**
          * The current pixel width of the chart.
          *
-         * @name chartWidth
-         * @memberof Chart
-         * @type {Number}
+         * @name Highcharts.Chart#chartWidth
+         * @type {number}
          */
         chart.chartWidth = Math.max( // #1393
             0,
@@ -813,9 +946,8 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         /**
          * The current pixel height of the chart.
          *
-         * @name chartHeight
-         * @memberof Chart
-         * @type {Number}
+         * @name Highcharts.Chart#chartHeight
+         * @type {number}
          */
         chart.chartHeight = Math.max(
             0,
@@ -834,9 +966,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * size is retrieved, reset them. Used on first render and on redraws.
      *
      * @private
+     * @function Highcharts.Chart#temporaryDisplay
      *
-     * @param  {Boolean} revert
-     *         Revert to the saved original styles.
+     * @param {boolean} revert
+     *        Revert to the saved original styles.
      */
     temporaryDisplay: function (revert) {
         var node = this.renderTo,
@@ -901,6 +1034,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
     /**
      * Set the {@link Chart.container|chart container's} class name, in
      * addition to `highcharts-container`.
+     *
+     * @function Highcharts.Chart#setClassName
+     *
+     * @param {string} className
      */
     setClassName: function (className) {
         this.container.className = 'highcharts-container ' + (className || '');
@@ -911,6 +1048,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * container div to hold the chart.
      *
      * @private
+     * @function Highcharts.Chart#afterGetContainer
+     *
+     * @fires Highcharts.Chart#event:afterGetContainer
      */
     getContainer: function () {
         var chart = this,
@@ -980,10 +1120,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         /**
          * The containing HTML element of the chart. The container is
          * dynamically inserted into the element given as the `renderTo`
-         * parameterin the {@link Highcharts#chart} constructor.
+         * parameter in the {@link Highcharts#chart} constructor.
          *
-         * @memberof Highcharts.Chart
-         * @type {HTMLDOMElement}
+         * @name Highcharts.Chart#container
+         * @type {Highcharts.HTMLDOMElement}
          */
         container = createElement(
             'div',
@@ -1004,9 +1144,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         /**
          * The renderer instance of the chart. Each chart instance has only one
          * associated renderer.
-         * @type {SVGRenderer}
-         * @name renderer
-         * @memberof Chart
+         *
+         * @name Highcharts.Chart#renderer
+         * @type {Highcharts.SVGRenderer}
          */
         chart.renderer = new Ren(
             container,
@@ -1038,6 +1178,11 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * will be moved into their final positions.
      *
      * @private
+     * @function Highcharts.Chart#getMargins
+     *
+     * @param {boolean} skipAxes
+     *
+     * @fires Highcharts.Chart#event:getMargins
      */
     getMargins: function (skipAxes) {
         var chart = this,
@@ -1067,6 +1212,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         }
     },
 
+    /**
+     * @private
+     * @function Highcharts.Chart#getAxisMargins
+     */
     getAxisMargins: function () {
 
         var chart = this,
@@ -1102,14 +1251,16 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * container is resized without a window resize event, this must be called
      * explicitly.
      *
-     * @param  {Object} e
-     *         Event arguments. Used primarily when the function is called
-     *         internally as a response to window resize.
-     *
      * @sample highcharts/members/chart-reflow/
      *         Resize div and reflow
      * @sample highcharts/chart/events-container/
      *         Pop up and reflow
+     *
+     * @function Highcharts.Chart#reflow
+     *
+     * @param {global.Event} e
+     *        Event arguments. Used primarily when the function is called
+     *        internally as a response to window resize.
      */
     reflow: function (e) {
         var chart = this,
@@ -1157,6 +1308,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * `chart.reflow` option.
      *
      * @private
+     * @function Highcharts.Chart#setReflow
+     *
+     * @param {boolean} reflow
      */
     setReflow: function (reflow) {
 
@@ -1190,17 +1344,6 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Resize the chart to a given width and height. In order to set the width
      * only, the height argument may be skipped. To set the height only, pass
      * `undefined` for the width.
-     * @param  {Number|undefined|null} [width]
-     *         The new pixel width of the chart. Since v4.2.6, the argument can
-     *         be `undefined` in order to preserve the current value (when
-     *         setting height only), or `null` to adapt to the width of the
-     *         containing element.
-     * @param  {Number|undefined|null} [height]
-     *         The new pixel height of the chart. Since v4.2.6, the argument can
-     *         be `undefined` in order to preserve the current value, or `null`
-     *         in order to adapt to the height of the containing element.
-     * @param  {AnimationOptions} [animation=true]
-     *         Whether and how to apply animation.
      *
      * @sample highcharts/members/chart-setsize-button/
      *         Test resizing from buttons
@@ -1208,6 +1351,25 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      *         Add a jQuery UI resizable
      * @sample stock/members/chart-setsize/
      *         Highstock with UI resizable
+     *
+     * @function Highcharts.Chart#setSize
+     *
+     * @param {number|null} [width]
+     *        The new pixel width of the chart. Since v4.2.6, the argument can
+     *        be `undefined` in order to preserve the current value (when
+     *        setting height only), or `null` to adapt to the width of the
+     *        containing element.
+     *
+     * @param {number|null} [height]
+     *        The new pixel height of the chart. Since v4.2.6, the argument can
+     *        be `undefined` in order to preserve the current value, or `null`
+     *        in order to adapt to the height of the containing element.
+     *
+     * @param {Highcharts.AnimationOptionsObject} [animation=true]
+     *        Whether and how to apply animation.
+     *
+     * @fires Highcharts.Chart#event:endResize
+     * @fires Highcharts.Chart#event:resize
      */
     setSize: function (width, height, animation) {
         var chart = this,
@@ -1271,6 +1433,11 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * pre-render to determine margin sizes.
      *
      * @private
+     * @function Highcharts.Chart#setChartSize
+     *
+     * @param {boolean} skipAxes
+     *
+     * @fires Highcharts.Chart#event:afterSetChartSize
      */
     setChartSize: function (skipAxes) {
         var chart = this,
@@ -1292,27 +1459,24 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         /**
          * The current left position of the plot area in pixels.
          *
-         * @name plotLeft
-         * @memberof Chart
-         * @type {Number}
+         * @name Highcharts.Chart#plotLeft
+         * @type {number}
          */
         chart.plotLeft = plotLeft = Math.round(chart.plotLeft);
 
         /**
          * The current top position of the plot area in pixels.
          *
-         * @name plotTop
-         * @memberof Chart
-         * @type {Number}
+         * @name Highcharts.Chart#plotTop
+         * @type {number}
          */
         chart.plotTop = plotTop = Math.round(chart.plotTop);
 
         /**
          * The current width of the plot area in pixels.
          *
-         * @name plotWidth
-         * @memberof Chart
-         * @type {Number}
+         * @name Highcharts.Chart#plotWidth
+         * @type {number}
          */
         chart.plotWidth = plotWidth = Math.max(
             0,
@@ -1322,9 +1486,8 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         /**
          * The current height of the plot area in pixels.
          *
-         * @name plotHeight
-         * @memberof Chart
-         * @type {Number}
+         * @name Highcharts.Chart#plotHeight
+         * @type {number}
          */
         chart.plotHeight = plotHeight = Math.max(
             0,
@@ -1385,6 +1548,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Initial margins before auto size margins are applied.
      *
      * @private
+     * @function Highcharts.Chart#resetMargins
      */
     resetMargins: function () {
         var chart = this,
@@ -1417,6 +1581,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * and plot area.
      *
      * @private
+     * @function Highcharts.Chart#drawChartBox
+     *
+     * @fires Highcharts.Chart#event:afterDrawChartBox
      */
     drawChartBox: function () {
         var chart = this,
@@ -1514,6 +1681,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * and in extensions to the chart.angular and chart.polar properties.
      *
      * @private
+     * @function Highcharts.Chart#propFromSeries
      */
     propFromSeries: function () {
         var chart = this,
@@ -1557,6 +1725,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * `Chart.addSeries` and `Series.remove`.
      *
      * @private
+     * @function Highcharts.Chart#linkSeries
+     *
+     * @fires Highcharts.Chart#event:afterLinkSeries
      */
     linkSeries: function () {
         var chart = this,
@@ -1596,6 +1767,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Render series for the chart.
      *
      * @private
+     * @function Highcharts.Chart#renderSeries
      */
     renderSeries: function () {
         each(this.series, function (serie) {
@@ -1608,6 +1780,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Render labels for the chart.
      *
      * @private
+     * @function Highcharts.Chart#renderLabels
      */
     renderLabels: function () {
         var chart = this,
@@ -1639,6 +1812,7 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Render all graphics for the chart. Runs internally on initialization.
      *
      * @private
+     * @function Highcharts.Chart#render
      */
     render: function () {
         var chart = this,
@@ -1653,8 +1827,12 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         // Title
         chart.setTitle();
 
-
-        // Legend
+        /**
+         * The overview of the chart's series.
+         *
+         * @name Highcharts.Chart#legend
+         * @type {Highcharts.Legend}
+         */
         chart.legend = new Legend(chart, options.legend);
 
         // Get stacks
@@ -1738,9 +1916,13 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
     /**
      * Set a new credits label for the chart.
      *
-     * @param  {CreditOptions} options
-     *         A configuration object for the new credits.
-     * @sample highcharts/credits/credits-update/ Add and update credits
+     * @sample highcharts/credits/credits-update/
+     *         Add and update credits
+     *
+     * @function Highcharts.Chart#addCredits
+     *
+     * @param {Highcharts.CreditsOptions} options
+     *        A configuration object for the new credits.
      */
     addCredits: function (credits) {
         var chart = this;
@@ -1750,12 +1932,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
 
             /**
              * The chart's credits label. The label has an `update` method that
-             * allows setting new options as per the {@link
-             * https://api.highcharts.com/highcharts/credits|
-             * credits options set}.
+             * allows setting new options as per the
+             * {@link https://api.highcharts.com/highcharts/credits|credits options set}.
              *
-             * @memberof Highcharts.Chart
-             * @name credits
+             * @name Highcharts.Chart#credits
              * @type {Highcharts.SVGElement}
              */
             this.credits = this.renderer.text(
@@ -1794,6 +1974,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      *         Destroy the chart from a button
      * @sample stock/members/chart-destroy/
      *         Destroy with Highstock
+     *
+     * @function Highcharts.Chart#destroy
+     *
+     * @fires Highcharts.Chart#event:destroy
      */
     destroy: function () {
         var chart = this,
@@ -1872,6 +2056,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * Prepare for first rendering after all data are loaded.
      *
      * @private
+     * @function Highcharts.Chart#firstRender
+     *
+     * @fires Highcharts.Chart#event:beforeRender
      */
     firstRender: function () {
         var chart = this,
@@ -1913,9 +2100,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
             /**
              * The Pointer that keeps track of mouse and touch interaction.
              *
-             * @memberof Chart
+             * @memberof Highcharts.Chart
              * @name pointer
-             * @type Pointer
+             * @type {Highcharts.Pointer}
+             * @instance
              */
             chart.pointer = new Pointer(chart, options);
         }
@@ -1939,6 +2127,10 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
      * events.
      *
      * @private
+     * @function Highcharts.Chart#onload
+     *
+     * @fires Highcharts.Chart#event:load
+     * @fires Highcharts.Chart#event:render
      */
     onload: function () {