highcharts 7.1.1 → 7.1.2

package/es-modules/parts/Color.js

@@ -1,9 +1,14 @@
 /* *
- * (c) 2010-2019 Torstein Honsi
  *
- * License: www.highcharts.com/license
- */
-
+ *  (c) 2010-2019 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+import H from './Globals.js';
 /**
  * A valid color to be parsed and handled by Highcharts. Highcharts internally
  * supports hex colors like `#ffffff`, rgb colors like `rgb(255,255,255)` and
@@ -13,24 +18,89 @@
  *
  * @typedef {string} Highcharts.ColorString
  */
-
-'use strict';
-
-import H from './Globals.js';
+/**
+ * Gradient options instead of a solid color.
+ *
+ * @example
+ * // Linear gradient used as a color option
+ * color: {
+ *     linearGradient: { x1: 0, x2: 0, y1: 0, y2: 1 },
+ *         stops: [
+ *             [0, '#003399'], // start
+ *             [0.5, '#ffffff'], // middle
+ *             [1, '#3366AA'] // end
+ *         ]
+ *     }
+ * }
+ *
+ * @interface Highcharts.GradientColorObject
+ */ /**
+* Holds an object that defines the start position and the end position relative
+* to the shape.
+* @name Highcharts.GradientColorObject#linearGradient
+* @type {Highcharts.LinearGradientColorObject|undefined}
+*/ /**
+* Holds an object that defines the center position and the radius.
+* @name Highcharts.GradientColorObject#radialGradient
+* @type {Highcharts.RadialGradientColorObject|undefined}
+*/ /**
+* The first item in each tuple is the position in the gradient, where 0 is the
+* start of the gradient and 1 is the end of the gradient. Multiple stops can be
+* applied. The second item is the color for each stop. This color can also be
+* given in the rgba format.
+* @name Highcharts.GradientColorObject#stops
+* @type {Array<Array<number,Highcharts.ColorString>>|undefined}
+*/
+/**
+ * Defines the start position and the end position for a gradient relative
+ * to the shape. Start position (x1, y1) and end position (x2, y2) are relative
+ * to the shape, where 0 means top/left and 1 is bottom/right.
+ *
+ * @interface Highcharts.LinearGradientColorObject
+ */ /**
+* Start horizontal position of the gradient. Float ranges 0-1.
+* @name Highcharts.LinearGradientColorObject#x1
+* @type {number}
+*/ /**
+* End horizontal position of the gradient. Float ranges 0-1.
+* @name Highcharts.LinearGradientColorObject#x2
+* @type {number}
+*/ /**
+* Start vertical position of the gradient. Float ranges 0-1.
+* @name Highcharts.LinearGradientColorObject#y1
+* @type {number}
+*/ /**
+* End vertical position of the gradient. Float ranges 0-1.
+* @name Highcharts.LinearGradientColorObject#y2
+* @type {number}
+*/
+/**
+ * Defines the center position and the radius for a gradient.
+ *
+ * @interface Highcharts.RadialGradientColorObject
+ */ /**
+* Center horizontal position relative to the shape. Float ranges 0-1.
+* @name Highcharts.RadialGradientColorObject#cx
+* @type {number}
+*/ /**
+* Center vertical position relative to the shape. Float ranges 0-1.
+* @name Highcharts.RadialGradientColorObject#cy
+* @type {number}
+*/ /**
+* Radius relative to the shape. Float ranges 0-1.
+* @name Highcharts.RadialGradientColorObject#r
+* @type {number}
+*/
 import './Utilities.js';
-
-var isNumber = H.isNumber,
-    merge = H.merge,
-    pInt = H.pInt;
-
+var isNumber = H.isNumber, merge = H.merge, pInt = H.pInt;
+/* eslint-disable no-invalid-this, valid-jsdoc */
 /**
- * Handle color operations. The object methods are chainable.
+ * Handle color operations. Some object methods are chainable.
  *
- * @private
  * @class
  * @name Highcharts.Color
  *
- * @param {Highcharts.ColorString} input
+ * @param {Highcharts.ColorString|Highcharts.GradientColorObject} input
  *        The input color in either rbga or hex format
  */
 H.Color = function (input) {
@@ -42,97 +112,85 @@ H.Color = function (input) {
     this.init(input);
 };
 H.Color.prototype = {
-
     // Collection of parsers. This can be extended from the outside by pushing
     // parsers to Highcharts.Color.prototype.parsers.
     parsers: [{
-        // RGBA color
-        regex: /rgba\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]?(?:\.[0-9]+)?)\s*\)/, // eslint-disable-line security/detect-unsafe-regex
-        parse: function (result) {
-            return [
-                pInt(result[1]),
-                pInt(result[2]),
-                pInt(result[3]),
-                parseFloat(result[4], 10)
-            ];
-        }
-    }, {
-        // RGB color
-        regex:
-            /rgb\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*\)/,
-        parse: function (result) {
-            return [pInt(result[1]), pInt(result[2]), pInt(result[3]), 1];
-        }
-    }],
-
+            // RGBA color
+            regex: /rgba\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]?(?:\.[0-9]+)?)\s*\)/,
+            parse: function (result) {
+                return [
+                    pInt(result[1]),
+                    pInt(result[2]),
+                    pInt(result[3]),
+                    parseFloat(result[4], 10)
+                ];
+            }
+        }, {
+            // RGB color
+            regex: /rgb\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*\)/,
+            parse: function (result) {
+                return [pInt(result[1]), pInt(result[2]), pInt(result[3]), 1];
+            }
+        }],
     // Collection of named colors. Can be extended from the outside by adding
     // colors to Highcharts.Color.prototype.names.
     names: {
         white: '#ffffff',
         black: '#000000'
     },
-
     /**
      * Parse the input color to rgba array
      *
      * @private
      * @function Highcharts.Color#init
      *
-     * @param {Highcharts.ColorString} input
+     * @param {Highcharts.ColorString|Highcharts.GradientColorObject} input
      *        The input color in either rbga or hex format
+     *
+     * @return {void}
      */
     init: function (input) {
-        var result,
-            rgba,
-            i,
-            parser,
-            len;
-
-        this.input = input = this.names[
-            input && input.toLowerCase ?
-                input.toLowerCase() :
-                ''
-        ] || input;
-
+        var result, rgba, i, parser, len;
+        this.input = input = this.names[input && input.toLowerCase ?
+            input.toLowerCase() :
+            ''] || input;
         // Gradients
         if (input && input.stops) {
             this.stops = input.stops.map(function (stop) {
                 return new H.Color(stop[1]);
             });
-
-        // Solid colors
-        } else {
-
+            // Solid colors
+        }
+        else {
             // Bitmasking as input[0] is not working for legacy IE.
-            if (input && input.charAt && input.charAt() === '#') {
-
+            if (input &&
+                input.charAt &&
+                input.charAt() === '#') {
                 len = input.length;
                 input = parseInt(input.substr(1), 16);
-
                 // Handle long-form, e.g. #AABBCC
                 if (len === 7) {
-
                     rgba = [
                         (input & 0xFF0000) >> 16,
                         (input & 0xFF00) >> 8,
                         (input & 0xFF),
                         1
                     ];
-
-                // Handle short-form, e.g. #ABC
-                // In short form, the value is assumed to be the same
-                // for both nibbles for each component. e.g. #ABC = #AABBCC
-                } else if (len === 4) {
-
+                    // Handle short-form, e.g. #ABC
+                    // In short form, the value is assumed to be the same
+                    // for both nibbles for each component. e.g. #ABC = #AABBCC
+                }
+                else if (len === 4) {
                     rgba = [
-                        ((input & 0xF00) >> 4) | (input & 0xF00) >> 8,
-                        ((input & 0xF0) >> 4) | (input & 0xF0),
+                        (((input & 0xF00) >> 4) |
+                            (input & 0xF00) >> 8),
+                        (((input & 0xF0) >> 4) |
+                            (input & 0xF0)),
                         ((input & 0xF) << 4) | (input & 0xF),
                         1
                     ];
                 }
             }
-
             // Otherwise, check regex parsers
             if (!rgba) {
                 i = this.parsers.length;
@@ -147,45 +205,46 @@ H.Color.prototype = {
         }
         this.rgba = rgba || [];
     },
-
     /**
-     * Return the color in the specified format
+     * Return the color or gradient stops in the specified format
      *
      * @function Highcharts.Color#get
      *
-     * @param {string} format
-     *        Possible values are 'a', 'rgb', undefined
+     * @param {string} [format]
+     *        Possible values are 'a', 'rgb', 'rgba' (default).
      *
-     * @return {Highcharts.ColorString}
-     *         This color as a string.
+     * @return {Highcharts.ColorString|Highcharts.GradientColorObject}
+     *         This color as a string or gradient stops.
      */
     get: function (format) {
-        var input = this.input,
-            rgba = this.rgba,
-            ret;
-
+        var input = this.input, rgba = this.rgba, ret;
         if (this.stops) {
             ret = merge(input);
             ret.stops = [].concat(ret.stops);
             this.stops.forEach(function (stop, i) {
-                ret.stops[i] = [ret.stops[i][0], stop.get(format)];
+                ret.stops[i] = [
+                    ret.stops[i][0],
+                    stop.get(format)
+                ];
             });
-
-        // it's NaN if gradient colors on a column chart
-        } else if (rgba && isNumber(rgba[0])) {
+            // it's NaN if gradient colors on a column chart
+        }
+        else if (rgba && isNumber(rgba[0])) {
             if (format === 'rgb' || (!format && rgba[3] === 1)) {
                 ret = 'rgb(' + rgba[0] + ',' + rgba[1] + ',' + rgba[2] + ')';
-            } else if (format === 'a') {
+            }
+            else if (format === 'a') {
                 ret = rgba[3];
-            } else {
+            }
+            else {
                 ret = 'rgba(' + rgba.join(',') + ')';
             }
-        } else {
+        }
+        else {
             ret = input;
         }
         return ret;
     },
-
     /**
      * Brighten the color instance.
      *
@@ -194,22 +253,19 @@ H.Color.prototype = {
      * @param {number} alpha
      *        The alpha value.
      *
-     * @return {Highcharts.ColorString}
+     * @return {Highcharts.Color}
      *         This color with modifications.
      */
     brighten: function (alpha) {
-        var i,
-            rgba = this.rgba;
-
+        var i, rgba = this.rgba;
         if (this.stops) {
             this.stops.forEach(function (stop) {
                 stop.brighten(alpha);
             });
-
-        } else if (isNumber(alpha) && alpha !== 0) {
+        }
+        else if (isNumber(alpha) && alpha !== 0) {
             for (i = 0; i < 3; i++) {
                 rgba[i] += pInt(alpha * 255);
-
                 if (rgba[i] < 0) {
                     rgba[i] = 0;
                 }
@@ -220,7 +276,6 @@ H.Color.prototype = {
         }
         return this;
     },
-
     /**
      * Set the color's opacity to a given alpha value.
      *
@@ -229,14 +284,13 @@ H.Color.prototype = {
      * @param {number} alpha
      *        Opacity between 0 and 1.
      *
-     * @return {Highcharts.ColorString}
+     * @return {Highcharts.Color}
      *         Color with modifications.
      */
     setOpacity: function (alpha) {
         this.rgba[3] = alpha;
         return this;
     },
-
     /**
      * Return an intermediate color between two colors.
      *
@@ -255,17 +309,13 @@ H.Color.prototype = {
     tweenTo: function (to, pos) {
         // Check for has alpha, because rgba colors perform worse due to lack of
         // support in WebKit.
-        var fromRgba = this.rgba,
-            toRgba = to.rgba,
-            hasAlpha,
-            ret;
-
+        var fromRgba = this.rgba, toRgba = to.rgba, hasAlpha, ret;
         // Unsupported color, return to-color (#3920, #7034)
         if (!toRgba.length || !fromRgba || !fromRgba.length) {
             ret = to.input || 'none';
-
-        // Interpolate
-        } else {
+            // Interpolate
+        }
+        else {
             hasAlpha = (toRgba[3] !== 1 || fromRgba[3] !== 1);
             ret = (hasAlpha ? 'rgba(' : 'rgb(') +
                 Math.round(toRgba[0] + (fromRgba[0] - toRgba[0]) * (1 - pos)) +
@@ -273,28 +323,25 @@ H.Color.prototype = {
                 Math.round(toRgba[1] + (fromRgba[1] - toRgba[1]) * (1 - pos)) +
                 ',' +
                 Math.round(toRgba[2] + (fromRgba[2] - toRgba[2]) * (1 - pos)) +
-                (
-                    hasAlpha ?
-                        (
-                            ',' +
-                            (toRgba[3] + (fromRgba[3] - toRgba[3]) * (1 - pos))
-                        ) :
-                        ''
-                ) +
+                (hasAlpha ?
+                    (',' +
+                        (toRgba[3] + (fromRgba[3] - toRgba[3]) * (1 - pos))) :
+                    '') +
                 ')';
         }
         return ret;
     }
 };
-
 /**
  * Creates a color instance out of a color string.
  *
- * @private
  * @function Highcharts.color
  *
  * @param {Highcharts.ColorString} input
  *        The input color in either rbga or hex format
+ *
+ * @return {Highcharts.Color}
+ *         Color instance
  */
 H.color = function (input) {
     return new H.Color(input);

package/es-modules/parts/ColumnSeries.js

@@ -664,7 +664,9 @@ seriesType(
                 // postprocessed for border width
                 seriesBarW = series.barW =
                 Math.max(seriesPointWidth, 1 + 2 * borderWidth),
-                seriesXOffset = series.pointXOffset = metrics.offset;
+                seriesXOffset = series.pointXOffset = metrics.offset,
+                dataMin = series.dataMin,
+                dataMax = series.dataMax;
 
             if (chart.inverted) {
                 translatedThreshold -= 0.5; // #3355
@@ -707,8 +709,12 @@ seriesType(
                     // in visible range (#7046)
                     if (
                         point.y === threshold &&
-                    series.dataMax <= threshold &&
-                    yAxis.min < threshold // and if there's room for it (#7311)
+                        series.dataMax <= threshold &&
+                        // and if there's room for it (#7311)
+                        yAxis.min < threshold &&
+                        // if all points are the same value (i.e zero) not draw
+                        // as negative points (#10646)
+                        dataMin !== dataMax
                     ) {
                         up = !up;
                     }

package/es-modules/parts/DataLabels.js

@@ -408,6 +408,14 @@
  * @default {"color": "contrast", "fontSize": "11px", "fontWeight": "bold", "textOutline": "1px contrast" }
  * @since 4.1.0
  *//**
+ * Options for a label text which should follow marker's shape. Border and
+ * background are disabled for a label that follows a path.
+ * **Note:** Only SVG-based renderer supports this option. Setting `useHTML` to
+ * true will disable this option.
+ * @name Highcharts.DataLabelsOptionsObject#textPath
+ * @type {Highcharts.DataLabelsTextPath|undefined}
+ * @since 7.1.0
+ *//**
  * Whether to
  * [use HTML](https://www.highcharts.com/docs/chart-concepts/labels-and-string-formatting#html)
  * to render the labels.
@@ -457,6 +465,27 @@
  * @typedef {"allow"|"justify"} Highcharts.DataLabelsOverflowValue
  */
 
+/**
+ * Options for a label text which should follow marker's shape.
+ * **Note:** Only SVG-based renderer supports this option.
+ *
+ * @see {@link Highcharts.SeriesNetworkDataLabelsTextPath#linkTextPath}
+ * @see {@link Highcharts.SeriesNetworkDataLabelsTextPath#textPath}
+ *
+ * @interface Highcharts.DataLabelsTextPath
+ * @since 7.1.0
+ *//**
+ * Presentation attributes for the text path.
+ * @name Highcharts.DataLabelsTextPath#attributes
+ * @type {Highcharts.SVGAttributes}
+ * @since 7.1.0
+ *//**
+ * Enable or disable `textPath` option for link's or marker's data labels.
+ * @name Highcharts.DataLabelsTextPath#enabled
+ * @type {boolean|undefined}
+ * @since 7.1.0
+ */
+
 'use strict';
 
 import H from './Globals.js';
@@ -654,7 +683,7 @@ Series.prototype.drawDataLabels = function () {
         dataLabelsGroup,
         seriesAnimDuration = H.animObject(seriesOptions.animation).duration,
         fadeInDuration = Math.min(seriesAnimDuration, 200),
-        defer = pick(
+        defer = !chart.renderer.forExport && pick(
             seriesDlOptions.defer,
             fadeInDuration > 0
         ),
@@ -953,7 +982,7 @@ Series.prototype.drawDataLabels = function () {
                         dataLabel.add(dataLabelsGroup);
                     }
 
-                    if (labelOptions.textPath) {
+                    if (labelOptions.textPath && !labelOptions.useHTML) {
                         dataLabel.setTextPath(
                             (
                                 point.getDataLabelPath &&