highcharts 6.1.4 → 6.2.0

package/es-modules/parts/DateTimeAxis.js

@@ -1,28 +1,40 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
 
 'use strict';
+
 import H from './Globals.js';
 import './Utilities.js';
+
 var Axis = H.Axis,
     getMagnitude = H.getMagnitude,
     normalizeTickInterval = H.normalizeTickInterval,
     timeUnits = H.timeUnits;
+
 /**
  * Set the tick positions to a time unit that makes sense, for example
  * on the first of each month or on every Monday. Return an array
  * with the time positions. Used in datetime axes as well as for grouping
  * data on a datetime axis.
  *
- * @param {Object} normalizedInterval
+ * @private
+ * @function Highcharts.Axis#getTimeTicks
+ *
+ * @param {*} normalizedInterval
  *        The interval in axis values (ms) and thecount
- * @param {Number} min The minimum in axis values
- * @param {Number} max The maximum in axis values
- * @param {Number} startOfWeek
- * @ignore
+ *
+ * @param {number} min
+ *        The minimum in axis values
+ *
+ * @param {number} max
+ *        The maximum in axis values
+ *
+ * @param {number} startOfWeek
+ *
+ * @return {number}
  */
 Axis.prototype.getTimeTicks = function () {
     return this.chart.time.getTimeTicks.apply(this.chart.time, arguments);
@@ -36,7 +48,14 @@ Axis.prototype.getTimeTicks = function () {
  * prevent it for running over again for each segment having the same interval.
  * #662, #697.
  *
- * @ignore
+ * @private
+ * @function Highcharts.Axis#normalizeTimeTickInterval
+ *
+ * @param {number} tickInterval
+ *
+ * @param {Array<Array<number|string>>} [unitsOption]
+ *
+ * @return {*}
  */
 Axis.prototype.normalizeTimeTickInterval = function (
     tickInterval,

package/es-modules/parts/Dynamics.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
@@ -528,7 +528,9 @@ extend(Chart.prototype, /** @lends Highcharts.Chart.prototype */ {
         });
 
         each(itemsForRemoval, function (item) {
-            item.remove(false);
+            if (item.remove) {
+                item.remove(false);
+            }
         });
 
         if (updateAllAxes) {
@@ -940,6 +942,7 @@ extend(Series.prototype, /** @lends Series.prototype */ {
 
             // Destroy elements
             series.destroy();
+            series.remove = null; // Prevent from doing again (#9097)
 
             // Redraw
             chart.isDirtyLegend = chart.isDirtyBox = true;

package/es-modules/parts/FlagsSeries.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */

package/es-modules/parts/Globals.js

@@ -1,5 +1,5 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */

package/es-modules/parts/Html.js

@@ -1,13 +1,15 @@
 /**
- * (c) 2010-2017 Torstein Honsi
+ * (c) 2010-2018 Torstein Honsi
  *
  * License: www.highcharts.com/license
  */
 
 'use strict';
+
 import H from './Globals.js';
 import './Utilities.js';
 import './SvgRenderer.js';
+
 var attr = H.attr,
     createElement = H.createElement,
     css = H.css,
@@ -24,11 +26,19 @@ var attr = H.attr,
     win = H.win,
     wrap = H.wrap;
 
-// Extend SvgElement for useHTML option
+// Extend SvgElement for useHTML option.
 extend(SVGElement.prototype, /** @lends SVGElement.prototype */ {
+
     /**
      * Apply CSS to HTML elements. This is used in text within SVG rendering and
      * by the VML renderer
+     *
+     * @private
+     * @function Highcharts.SVGElement#htmlCss
+     *
+     * @param {Highcharts.CSSObject} styles
+     *
+     * @return {Highcharts.SVGElement}
      */
     htmlCss: function (styles) {
         var wrapper = this,
@@ -61,13 +71,18 @@ extend(SVGElement.prototype, /** @lends SVGElement.prototype */ {
     },
 
     /**
-     * VML and useHTML method for calculating the bounding box based on offsets
-     * @param {Boolean} refresh Whether to force a fresh value from the DOM or
-     * to use the cached value.
+     * VML and useHTML method for calculating the bounding box based on offsets.
+     *
+     * @private
+     * @function Highcharts.SVGElement#htmlGetBBox
      *
-     * @return {Object} A hash containing values for x, y, width and height
+     * @param {boolean} refresh
+     *        Whether to force a fresh value from the DOM or to use the cached
+     *        value.
+     *
+     * @return {Highcharts.BBoxObject}
+     *         A hash containing values for x, y, width and height.
      */
-
     htmlGetBBox: function () {
         var wrapper = this,
             element = wrapper.element;
@@ -82,7 +97,10 @@ extend(SVGElement.prototype, /** @lends SVGElement.prototype */ {
 
     /**
      * VML override private method to update elements based on internal
-     * properties based on SVG transform
+     * properties based on SVG transform.
+     *
+     * @private
+     * @function Highcharts.SVGElement#htmlUpdateTransform
      */
     htmlUpdateTransform: function () {
         // aligning non added elements is expensive
@@ -221,7 +239,16 @@ extend(SVGElement.prototype, /** @lends SVGElement.prototype */ {
     },
 
     /**
-     * Set the rotation of an individual HTML span
+     * Set the rotation of an individual HTML span.
+     *
+     * @private
+     * @function Highcharts.SVGElement#setSpanRotation
+     *
+     * @param {number} rotation
+     *
+     * @param {number} alignCorrection
+     *
+     * @param {number} baseline
      */
     setSpanRotation: function (rotation, alignCorrection, baseline) {
         var rotationStyle = {},
@@ -237,6 +264,15 @@ extend(SVGElement.prototype, /** @lends SVGElement.prototype */ {
 
     /**
      * Get the correction in X and Y positioning as the element is rotated.
+     *
+     * @private
+     * @function Highcharts.SVGElement#getSpanCorrection
+     *
+     * @param {number} width
+     *
+     * @param {number} baseline
+     *
+     * @param {number} alignCorrection
      */
     getSpanCorrection: function (width, baseline, alignCorrection) {
         this.xCorr = -width * alignCorrection;
@@ -247,6 +283,12 @@ extend(SVGElement.prototype, /** @lends SVGElement.prototype */ {
 // Extend SvgRenderer for useHTML option.
 extend(SVGRenderer.prototype, /** @lends SVGRenderer.prototype */ {
 
+    /**
+     * @private
+     * @function Highcharts.SVGRenderer#getTransformKey
+     *
+     * @return {string}
+     */
     getTransformKey: function () {
         return isMS && !/Edge/.test(win.navigator.userAgent) ?
             '-ms-transform' :
@@ -263,9 +305,19 @@ extend(SVGRenderer.prototype, /** @lends SVGRenderer.prototype */ {
      * Create HTML text node. This is used by the VML renderer as well as the
      * SVG renderer through the useHTML option.
      *
-     * @param {String} str
-     * @param {Number} x
-     * @param {Number} y
+     * @private
+     * @function Highcharts.SVGRenderer#html
+     *
+     * @param {string} str
+     *        The text of (subset) HTML to draw.
+     *
+     * @param {number} x
+     *        The x position of the text's lower left corner.
+     *
+     * @param {number} y
+     *        The y position of the text's lower left corner.
+     *
+     * @return {Highcharts.HTMLDOMElement}
      */
     html: function (str, x, y) {
         var wrapper = this.createElement('span'),