highcharts 9.3.1 → 10.0.0

package/es-modules/Core/Renderer/SVG/SVGRenderer.js

@@ -193,7 +193,7 @@ var SVGRenderer = /** @class */ (function () {
         this.url = this.getReferenceURL();
         // Add description
         var desc = this.createElement('desc').add();
-        desc.element.appendChild(doc.createTextNode('Created with Highcharts 9.3.1'));
+        desc.element.appendChild(doc.createTextNode('Created with Highcharts 10.0.0'));
         renderer.defs = this.createElement('defs').add();
         renderer.allowHTML = allowHTML;
         renderer.forExport = forExport;
@@ -384,6 +384,7 @@ var SVGRenderer = /** @class */ (function () {
      * @function Highcharts.SVGRenderer#destroy
      *
      * @return {null}
+     * Pass through value.
      */
     SVGRenderer.prototype.destroy = function () {
         var renderer = this, rendererDefs = renderer.defs;
@@ -522,29 +523,26 @@ var SVGRenderer = /** @class */ (function () {
         // Make a copy of normalState (#13798)
         // (reference to options.rangeSelector.buttonTheme)
         normalState = theme ? merge(theme) : {};
-        var userNormalStyle = normalState && normalState.style || {};
+        var normalStyle = merge({
+            color: "#333333" /* neutralColor80 */,
+            cursor: 'pointer',
+            fontWeight: 'normal'
+        }, normalState.style);
+        delete normalState.style;
         // Remove stylable attributes
         normalState = AST.filterUserAttributes(normalState);
         // Default, non-stylable attributes
         label.attr(merge({ padding: 8, r: 2 }, normalState));
-        // Presentational
-        var normalStyle, hoverStyle, pressedStyle, disabledStyle;
+        // Presentational. The string type is a mistake, it is just for
+        // compliance with SVGAttribute and is not used in button theme.
+        var hoverStyle, pressedStyle, disabledStyle;
         if (!styledMode) {
             // Normal state - prepare the attributes
             normalState = merge({
                 fill: "#f7f7f7" /* neutralColor3 */,
                 stroke: "#cccccc" /* neutralColor20 */,
-                'stroke-width': 1,
-                style: {
-                    color: "#333333" /* neutralColor80 */,
-                    cursor: 'pointer',
-                    fontWeight: 'normal'
-                }
-            }, {
-                style: userNormalStyle
+                'stroke-width': 1
             }, normalState);
-            normalStyle = normalState.style;
-            delete normalState.style;
             // Hover state
             hoverState = merge(normalState, {
                 fill: "#e6e6e6" /* neutralColor10 */
@@ -599,13 +597,16 @@ var SVGRenderer = /** @class */ (function () {
                     hoverState,
                     pressedState,
                     disabledState
-                ][state || 0])
-                    .css([
+                ][state || 0]);
+                var css_1 = [
                     normalStyle,
                     hoverStyle,
                     pressedStyle,
                     disabledStyle
-                ][state || 0]);
+                ][state || 0];
+                if (isObject(css_1)) {
+                    label.css(css_1);
+                }
             }
         };
         // Presentational attributes
@@ -1041,6 +1042,7 @@ var SVGRenderer = /** @class */ (function () {
      * Additional options, depending on the actual symbol drawn.
      *
      * @return {Highcharts.SVGElement}
+     * SVG symbol.
      */
     SVGRenderer.prototype.symbol = function (symbol, x, y, width, height, options) {
         var ren = this, imageRegex = /^url\((.*?)\)$/, isImage = imageRegex.test(symbol), sym = (!isImage && (this.symbols[symbol] ? symbol : 'circle')), 
@@ -1262,8 +1264,8 @@ var SVGRenderer = /** @class */ (function () {
                 var tspans = element.getElementsByTagName('tspan'), parentVal = element.getAttribute(key);
                 for (var i = 0, tspan = void 0; i < tspans.length; i++) {
                     tspan = tspans[i];
-                    // If the x values are equal, the tspan represents a
-                    // linebreak
+                    // If the x values are equal, the tspan represents a line
+                    // break
                     if (tspan.getAttribute(key) === parentVal) {
                         tspan.setAttribute(key, value);
                     }
@@ -1326,14 +1328,6 @@ var SVGRenderer = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.SVGRenderer#rotCorr
-     *
-     * @param {number} baseline
-     *
-     * @param {number} rotation
-     *
-     * @param {boolean} [alterY]
-     *
-     * @param {Highcharts.PositionObject}
      */
     SVGRenderer.prototype.rotCorr = function (baseline, rotation, alterY) {
         var y = baseline;
@@ -1637,7 +1631,6 @@ var SVGRenderer = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.SVGRenderer#alignElements
-     * @return {void}
      */
     SVGRenderer.prototype.alignElements = function () {
         this.alignedObjects.forEach(function (el) { return el.align(); });

package/es-modules/Core/Renderer/SVG/SVGRenderer3D.js

@@ -164,7 +164,8 @@ var SVGRenderer3D = /** @class */ (function (_super) {
                 delete hash.insidePlotArea;
                 var chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = shapeArea(vertexes2d);
                 hash.d = path;
-                hash.visibility = (this.enabled && area > 0) ? 'visible' : 'hidden';
+                hash.visibility = (this.enabled && area > 0) ?
+                    'visible' : 'hidden';
             }
             return SVGElement.prototype.attr.apply(this, arguments);
         };
@@ -179,7 +180,8 @@ var SVGRenderer3D = /** @class */ (function (_super) {
                 delete params.enabled;
                 delete params.vertexes;
                 delete params.insidePlotArea;
-                var chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = shapeArea(vertexes2d), visibility = (this.enabled && area > 0) ? 'visible' : 'hidden';
+                var chart = charts[renderer.chartIndex], vertexes2d = perspective(this.vertexes, chart, this.insidePlotArea), path = renderer.toLinePath(vertexes2d, true), area = shapeArea(vertexes2d), visibility = (this.enabled && area > 0) ?
+                    'visible' : 'hidden';
                 params.d = path;
                 this.attr('visibility', visibility);
             }
@@ -584,7 +586,7 @@ var SVGRenderer3D = /** @class */ (function (_super) {
         // related to the shapes directly, and update the shapes from the
         // animation step.
         wrapper.animate = function (params, animation, complete) {
-            var paramArr, from = this.attribs, to, anim, randomProp = 'data-' + Math.random().toString(26).substring(2, 9);
+            var paramArr, from = this.attribs, to, anim, randomProp = ('data-' + Math.random().toString(26).substring(2, 9));
             // Attribute-line properties connected to 3D. These shouldn't have
             // been in the attribs collection in the first place.
             delete params.center;
@@ -763,7 +765,9 @@ var SVGRenderer3D = /** @class */ (function (_super) {
             out = out.concat(SVGRenderer3D.curveTo(cx, cy, rx, ry, end, end2, 0, 0));
         }
         out.push([
-            'L', cx + (rx * Math.cos(end2)) + dx, cy + (ry * Math.sin(end2)) + dy
+            'L',
+            cx + (rx * Math.cos(end2)) + dx,
+            cy + (ry * Math.sin(end2)) + dy
         ]);
         out = out.concat(SVGRenderer3D.curveTo(cx, cy, rx, ry, end2, start2, dx, dy));
         out.push(['Z']);
@@ -773,7 +777,9 @@ var SVGRenderer3D = /** @class */ (function (_super) {
         ];
         inn = inn.concat(SVGRenderer3D.curveTo(cx, cy, irx, iry, start, end, 0, 0));
         inn.push([
-            'L', cx + (irx * Math.cos(end)) + dx, cy + (iry * Math.sin(end)) + dy
+            'L',
+            cx + (irx * Math.cos(end)) + dx,
+            cy + (iry * Math.sin(end)) + dy
         ]);
         inn = inn.concat(SVGRenderer3D.curveTo(cx, cy, irx, iry, end, start, dx, dy));
         inn.push(['Z']);
@@ -820,6 +826,7 @@ var SVGRenderer3D = /** @class */ (function (_super) {
             inn: inn,
             zInn: Math.max(a1, a2, a3),
             side1: side1,
+            // to keep below zOut and zInn in case of same values
             zSide1: a3 * 0.99,
             side2: side2,
             zSide2: a2 * 0.99

package/es-modules/Core/Renderer/SVG/TextBuilder.js

@@ -12,7 +12,7 @@ import AST from '../HTML/AST.js';
 import H from '../../Globals.js';
 var doc = H.doc, SVG_NS = H.SVG_NS, win = H.win;
 import U from '../../Utilities.js';
-var attr = U.attr, isString = U.isString, objectEach = U.objectEach, pick = U.pick;
+var attr = U.attr, extend = U.extend, isString = U.isString, objectEach = U.objectEach, pick = U.pick;
 /* *
  *
  *  Class
@@ -112,7 +112,6 @@ var TextBuilder = /** @class */ (function () {
      *
      * @private
      *
-     * @return {void}
      */
     TextBuilder.prototype.modifyDOM = function () {
         var _this = this;
@@ -255,7 +254,7 @@ var TextBuilder = /** @class */ (function () {
     TextBuilder.prototype.getLineHeight = function (node) {
         var fontSizeStyle;
         // If the node is a text node, use its parent
-        var element = node.nodeType === win.Node.TEXT_NODE ?
+        var element = (node.nodeType === win.Node.TEXT_NODE) ?
             node.parentElement :
             node;
         if (!this.renderer.styledMode) {
@@ -277,35 +276,35 @@ var TextBuilder = /** @class */ (function () {
      *
      * @param {ASTNode[]} nodes The AST nodes
      *
-     * @return {void}
      */
     TextBuilder.prototype.modifyTree = function (nodes) {
         var _this = this;
         var modifyChild = function (node, i) {
-            var tagName = node.tagName;
-            var styledMode = _this.renderer.styledMode;
-            var attributes = node.attributes || {};
+            var _a = node.attributes, attributes = _a === void 0 ? {} : _a, children = node.children, _b = node.style, style = _b === void 0 ? {} : _b, tagName = node.tagName, styledMode = _this.renderer.styledMode;
             // Apply styling to text tags
             if (tagName === 'b' || tagName === 'strong') {
                 if (styledMode) {
-                    attributes['class'] = 'highcharts-strong'; // eslint-disable-line dot-notation
+                    // eslint-disable-next-line dot-notation
+                    attributes['class'] = 'highcharts-strong';
                 }
                 else {
-                    attributes.style = 'font-weight:bold;' + (attributes.style || '');
+                    style.fontWeight = 'bold';
                 }
             }
             else if (tagName === 'i' || tagName === 'em') {
                 if (styledMode) {
-                    attributes['class'] = 'highcharts-emphasized'; // eslint-disable-line dot-notation
+                    // eslint-disable-next-line dot-notation
+                    attributes['class'] = 'highcharts-emphasized';
                 }
                 else {
-                    attributes.style = 'font-style:italic;' + (attributes.style || '');
+                    style.fontStyle = 'italic';
                 }
             }
-            // Modify attributes
-            if (isString(attributes.style)) {
-                attributes.style = attributes.style.replace(/(;| |^)color([ :])/, '$1fill$2');
+            // Modify styling
+            if (style && style.color) {
+                style.fill = style.color;
             }
+            // Handle breaks
             if (tagName === 'br') {
                 attributes['class'] = 'highcharts-br'; // eslint-disable-line dot-notation
                 node.textContent = '\u200B'; // zero-width space
@@ -315,14 +314,23 @@ var TextBuilder = /** @class */ (function () {
                     nextNode.textContent =
                         nextNode.textContent.replace(/^ +/gm, '');
                 }
+                // If an anchor has direct text node children, the text is unable to
+                // wrap because there is no `getSubStringLength` function on the
+                // element. Therefore we need to wrap the child text node or nodes
+                // in a tspan. #16173.
+            }
+            else if (tagName === 'a' &&
+                children &&
+                children.some(function (child) { return child.tagName === '#text'; })) {
+                node.children = [{ children: children, tagName: 'tspan' }];
             }
             if (tagName !== '#text' && tagName !== 'a') {
                 node.tagName = 'tspan';
             }
-            node.attributes = attributes;
+            extend(node, { attributes: attributes, style: style });
             // Recurse
-            if (node.children) {
-                node.children
+            if (children) {
+                children
                     .filter(function (c) { return c.tagName !== '#text'; })
                     .forEach(modifyChild);
             }

package/es-modules/Core/Responsive.js

@@ -130,8 +130,7 @@ var Responsive;
         Additions.prototype.matchResponsiveRule = function (rule, matches) {
             var condition = rule.condition, fn = condition.callback || function () {
                 return (this.chartWidth <= pick(condition.maxWidth, Number.MAX_VALUE) &&
-                    this.chartHeight <=
-                        pick(condition.maxHeight, Number.MAX_VALUE) &&
+                    this.chartHeight <= pick(condition.maxHeight, Number.MAX_VALUE) &&
                     this.chartWidth >= pick(condition.minWidth, 0) &&
                     this.chartHeight >= pick(condition.minHeight, 0));
             };
@@ -169,7 +168,7 @@ var Responsive;
             mergedOptions.isResponsiveOptions = true;
             // Stringified key for the rules that currently apply.
             ruleIds = (ruleIds.toString() || void 0);
-            var currentRuleIds = currentResponsive && currentResponsive.ruleIds;
+            var currentRuleIds = (currentResponsive && currentResponsive.ruleIds);
             // Changes in what rules apply
             if (ruleIds !== currentRuleIds) {
                 // Undo previous rules. Before we apply a new set of rules, we

package/es-modules/Core/Scrollbar.js

@@ -124,8 +124,16 @@ var Scrollbar = /** @class */ (function () {
         var buttonsOrder = this.options.inverted ? [1, 0] : [0, 1], buttons = this.scrollbarButtons, bar = this.scrollbarGroup.element, track = this.track.element, mouseDownHandler = this.mouseDownHandler.bind(this), mouseMoveHandler = this.mouseMoveHandler.bind(this), mouseUpHandler = this.mouseUpHandler.bind(this);
         // Mouse events
         var _events = [
-            [buttons[buttonsOrder[0]].element, 'click', this.buttonToMinClick.bind(this)],
-            [buttons[buttonsOrder[1]].element, 'click', this.buttonToMaxClick.bind(this)],
+            [
+                buttons[buttonsOrder[0]].element,
+                'click',
+                this.buttonToMinClick.bind(this)
+            ],
+            [
+                buttons[buttonsOrder[1]].element,
+                'click',
+                this.buttonToMaxClick.bind(this)
+            ],
             [track, 'click', this.trackClick.bind(this)],
             [bar, 'mousedown', mouseDownHandler],
             [bar.ownerDocument, 'mousemove', mouseMoveHandler],
@@ -143,7 +151,8 @@ var Scrollbar = /** @class */ (function () {
     };
     Scrollbar.prototype.buttonToMaxClick = function (e) {
         var scroller = this;
-        var range = (scroller.to - scroller.from) * pick(scroller.options.step, 0.2);
+        var range = ((scroller.to - scroller.from) *
+            pick(scroller.options.step, 0.2));
         scroller.updatePosition(scroller.from + range, scroller.to + range);
         fireEvent(scroller, 'changed', {
             from: scroller.from,
@@ -194,7 +203,6 @@ var Scrollbar = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Scrollbar#destroy
-     * @return {void}
      */
     Scrollbar.prototype.destroy = function () {
         var scroller = this, navigator = scroller.chart.scroller;
@@ -226,7 +234,6 @@ var Scrollbar = /** @class */ (function () {
      * @function Highcharts.Scrollbar#drawScrollbarButton
      * @param {number} index
      *        0 is left, 1 is right
-     * @return {void}
      */
     Scrollbar.prototype.drawScrollbarButton = function (index) {
         var scroller = this, renderer = scroller.renderer, scrollbarButtons = scroller.scrollbarButtons, options = scroller.options, size = scroller.size, group = renderer.g().add(scroller.group);
@@ -309,7 +316,8 @@ var Scrollbar = /** @class */ (function () {
      * @private
      */
     Scrollbar.prototype.mouseMoveHandler = function (e) {
-        var scroller = this, normalizedEvent = scroller.chart.pointer.normalize(e), options = scroller.options, direction = options.vertical ? 'chartY' : 'chartX', initPositions = scroller.initPositions || [];
+        var scroller = this, normalizedEvent = scroller.chart.pointer.normalize(e), options = scroller.options, direction = options.vertical ?
+            'chartY' : 'chartX', initPositions = scroller.initPositions || [];
         var scrollPosition, chartPosition, change;
         // In iOS, a mousemove event with e.pageX === 0 is fired when
         // holding the finger down in the center of the scrollbar. This
@@ -367,7 +375,6 @@ var Scrollbar = /** @class */ (function () {
      *        width of the scrollbar
      * @param {number} height
      *        height of the scorllbar
-     * @return {void}
      */
     Scrollbar.prototype.position = function (x, y, width, height) {
         var scroller = this, options = scroller.options, vertical = options.vertical, method = scroller.rendered ? 'animate' : 'attr';
@@ -412,7 +419,6 @@ var Scrollbar = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Scrollbar#removeEvents
-     * @return {void}
      */
     Scrollbar.prototype.removeEvents = function () {
         this._events.forEach(function (args) {
@@ -499,7 +505,6 @@ var Scrollbar = /** @class */ (function () {
      *        scale (0-1) where bar should start
      * @param {number} to
      *        scale (0-1) where bar should end
-     * @return {void}
      */
     Scrollbar.prototype.setRange = function (from, to) {
         var scroller = this, options = scroller.options, vertical = options.vertical, minWidth = options.minWidth, fullWidth = scroller.barWidth, method = (this.rendered &&
@@ -572,8 +577,6 @@ var Scrollbar = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Scrollbar#shouldUpdateExtremes
-     * @param {string} [eventType]
-     * @return {boolean}
      */
     Scrollbar.prototype.shouldUpdateExtremes = function (eventType) {
         return (pick(this.options.liveRedraw, H.svg && !H.isTouchDevice && !this.chart.isBoosting) ||
@@ -620,7 +623,6 @@ var Scrollbar = /** @class */ (function () {
      * @function Highcharts.Scrollbar#updatePosition
      * @param  {number} from
      * @param  {number} to
-     * @return {void}
      */
     Scrollbar.prototype.updatePosition = function (from, to) {
         if (to > 1) {

package/es-modules/Core/Series/DataLabel.js

@@ -245,8 +245,10 @@ var DataLabel;
                 // Merge in series options for the point.
                 // @note dataLabelAttribs (like pointAttribs) would eradicate
                 // the need for dlOptions, and simplify the section below.
-                pointOptions = splat(mergeArrays(seriesDlOptions, point.dlOptions || // dlOptions is used in treemaps
-                    (point.options && point.options.dataLabels)));
+                pointOptions = splat(mergeArrays(seriesDlOptions, 
+                // dlOptions is used in treemaps
+                (point.dlOptions ||
+                    (point.options && point.options.dataLabels))));
                 // Handle each individual data label for this point
                 pointOptions.forEach(function (labelOptions, i) {
                     // Options for one datalabel
@@ -256,9 +258,9 @@ var DataLabel;
                         applyFilter(point, labelOptions)), connector = point.connectors ?
                         point.connectors[i] :
                         point.connector;
-                    var labelConfig, formatString, labelText, style, rotation, attr, dataLabel = point.dataLabels ? point.dataLabels[i] :
-                        point.dataLabel;
-                    var labelDistance = pick(labelOptions.distance, point.labelDistance), isNew = !dataLabel;
+                    var labelConfig, formatString, labelText, style, rotation, attr, dataLabel = point.dataLabels ?
+                        point.dataLabels[i] : point.dataLabel, isNew = !dataLabel;
+                    var labelDistance = pick(labelOptions.distance, point.labelDistance);
                     if (labelEnabled) {
                         // Create individual options structure that can be
                         // extended without affecting others
@@ -310,8 +312,18 @@ var DataLabel;
                     }
                     // If the point is outside the plot area, destroy it. #678,
                     // #820
-                    if (dataLabel && (!labelEnabled || !defined(labelText))) {
-                        point.dataLabel =
+                    if (dataLabel && (!labelEnabled ||
+                        !defined(labelText) ||
+                        !!dataLabel.div !== !!labelOptions.useHTML ||
+                        (
+                        // Change from no rotation to rotation and
+                        // vice versa. Don't use defined() because
+                        // rotation = 0 means also rotation = undefined
+                        (!dataLabel.rotation ||
+                            !labelOptions.rotation) &&
+                            dataLabel.rotation !== labelOptions.rotation))) {
+                        isNew = true;
+                        point.dataLabel = dataLabel =
                             point.dataLabel && point.dataLabel.destroy();
                         if (point.dataLabels) {
                             // Remove point.dataLabels if this was the last one
@@ -338,11 +350,11 @@ var DataLabel;
                                 }
                             }
                         }
-                        // Individual labels are disabled if the are explicitly
-                        // disabled in the point options, or if they fall outside
-                        // the plot area.
                     }
-                    else if (labelEnabled && defined(labelText)) {
+                    // Individual labels are disabled if the are explicitly
+                    // disabled in the point options, or if they fall outside
+                    // the plot area.
+                    if (labelEnabled && defined(labelText)) {
                         if (!dataLabel) {
                             // Create new label element
                             point.dataLabels = point.dataLabels || [];
@@ -356,7 +368,8 @@ var DataLabel;
                             if (!i) {
                                 point.dataLabel = dataLabel;
                             }
-                            dataLabel.addClass(' highcharts-data-label-color-' + point.colorIndex +
+                            dataLabel.addClass(' highcharts-data-label-color-' +
+                                point.colorIndex +
                                 ' ' + (labelOptions.className || '') +
                                 ( // #3398
                                 labelOptions.useHTML ?
@@ -384,7 +397,7 @@ var DataLabel;
                             if (point.dataLabelPath &&
                                 !labelOptions.textPath.enabled) {
                                 // clean the DOM
-                                point.dataLabelPath = point.dataLabelPath.destroy();
+                                point.dataLabelPath = (point.dataLabelPath.destroy());
                             }
                         }
                         // Now the data label is created and placed at 0,0, so

package/es-modules/Core/Series/Point.js

@@ -186,7 +186,9 @@ var Point = /** @class */ (function () {
         options = Point.prototype.optionsToObject.call(this, options);
         // copy options directly to point
         extend(point, options);
-        point.options = point.options ? extend(point.options, options) : options;
+        point.options = point.options ?
+            extend(point.options, options) :
+            options;
         // Since options are copied into the Point instance, some accidental
         // options must be shielded (#5681)
         if (options.group) {
@@ -321,7 +323,7 @@ var Point = /** @class */ (function () {
      * @param {Highcharts.EventCallbackFunction<Highcharts.Point>|Function} [defaultFunction]
      *        Default event handler.
      *
-     * @fires Highcharts.Point#event:*
+     * @emits Highcharts.Point#event:*
      */
     Point.prototype.firePointEvent = function (eventType, eventArgs, defaultFunction) {
         var point = this, series = this.series, seriesOptions = series.options;
@@ -370,8 +372,6 @@ var Point = /** @class */ (function () {
      *
      * @private
      * @function Highcharts.Point#getGraphicalProps
-     * @param {Highcharts.Dictionary<number>} [kinds]
-     * @return {Highcharts.PointGraphicalProps}
      */
     Point.prototype.getGraphicalProps = function (kinds) {
         var point = this, props = [], graphicalProps = { singular: [], plural: [] };
@@ -463,8 +463,7 @@ var Point = /** @class */ (function () {
     /**
      * Utility to check if point has new shape type. Used in column series and
      * all others that are based on column series.
-     *
-     * @return boolean|undefined
+     * @private
      */
     Point.prototype.hasNewShapeType = function () {
         var point = this;
@@ -490,7 +489,7 @@ var Point = /** @class */ (function () {
      * @return {Highcharts.Point}
      *         The Point instance.
      *
-     * @fires Highcharts.Point#event:afterInit
+     * @emits Highcharts.Point#event:afterInit
      */
     Point.prototype.init = function (series, options, x) {
         this.series = series;
@@ -570,7 +569,6 @@ var Point = /** @class */ (function () {
     /**
      * @private
      * @function Highcharts.Point#resolveColor
-     * @return {void}
      */
     Point.prototype.resolveColor = function () {
         var series = this.series, optionsChart = series.chart.options.chart, styledMode = series.chart.styledMode;
@@ -700,7 +698,7 @@ var Point = /** @class */ (function () {
      *        Whether to apply animation, and optionally animation
      *        configuration.
      *
-     * @fires Highcharts.Point#event:update
+     * @emits Highcharts.Point#event:update
      */
     Point.prototype.update = function (options, redraw, animation, runEvent) {
         var point = this, series = point.series, graphic = point.graphic, chart = series.chart, seriesOptions = series.options;
@@ -714,7 +712,9 @@ var Point = /** @class */ (function () {
             // Update visuals, #4146
             // Handle dummy graphic elements for a11y, #12718
             var hasDummyGraphic = graphic && point.hasDummyGraphic;
-            var shouldDestroyGraphic = point.y === null ? !hasDummyGraphic : hasDummyGraphic;
+            var shouldDestroyGraphic = point.y === null ?
+                !hasDummyGraphic :
+                hasDummyGraphic;
             if (graphic && shouldDestroyGraphic) {
                 point.graphic = graphic.destroy();
                 delete point.hasDummyGraphic;
@@ -817,8 +817,8 @@ var Point = /** @class */ (function () {
      * is `true`, selected points are accumulated on Control, Shift or Cmd
      * clicking the point.
      *
-     * @fires Highcharts.Point#event:select
-     * @fires Highcharts.Point#event:unselect
+     * @emits Highcharts.Point#event:select
+     * @emits Highcharts.Point#event:unselect
      */
     Point.prototype.select = function (selected, accumulate) {
         var point = this, series = point.series, chart = series.chart;
@@ -882,7 +882,7 @@ var Point = /** @class */ (function () {
      * events.
      *
      * @function Highcharts.Point#onMouseOut
-     * @fires Highcharts.Point#event:mouseOut
+     * @emits Highcharts.Point#event:mouseOut
      */
     Point.prototype.onMouseOut = function () {
         var point = this, chart = point.series.chart;
@@ -925,7 +925,7 @@ var Point = /** @class */ (function () {
      * @param {boolean} [move]
      *        State for animation.
      *
-     * @fires Highcharts.Point#event:afterSetState
+     * @emits Highcharts.Point#event:afterSetState
      */
     Point.prototype.setState = function (state, move) {
         var point = this, series = point.series, previousState = point.state, stateOptions = (series.options.states[state || 'normal'] ||
@@ -971,8 +971,9 @@ var Point = /** @class */ (function () {
                 pointAttribs = series.pointAttribs(point, state);
                 pointAttribsAnimation = pick(chart.options.chart.animation, stateOptions.animation);
                 // Some inactive points (e.g. slices in pie) should apply
-                // oppacity also for it's labels
-                if (series.options.inactiveOtherPoints && isNumber(pointAttribs.opacity)) {
+                // opacity also for their labels
+                if (series.options.inactiveOtherPoints &&
+                    isNumber(pointAttribs.opacity)) {
                     (point.dataLabels || []).forEach(function (label) {
                         if (label) {
                             label.animate({
@@ -1132,7 +1133,7 @@ export default Point;
 * @type {Highcharts.Point}
 */
 /**
- * Configuration hash for the data label and tooltip formatters.
+ * Configuration for the data label and tooltip formatters.
  *
  * @interface Highcharts.PointLabelObject
  */ /**
@@ -1174,7 +1175,7 @@ export default Point;
 */ /**
 * The y value of the point.
 * @name Highcharts.PointLabelObject#y
-* @type {number|undefined}
+* @type {number|null|undefined}
 */
 /**
  * Gets fired when the mouse leaves the area close to the point.