highcharts 11.4.3 → 11.4.4

package/es-modules/Series/PackedBubble/PackedBubbleSeries.js

@@ -23,6 +23,9 @@ import D from '../SimulationSeriesUtilities.js';
 const { initDataLabels, initDataLabelsDefer } = D;
 import U from '../../Core/Utilities.js';
 const { addEvent, clamp, defined, extend, fireEvent, isArray, isNumber, merge, pick } = U;
+import SVGElement from '../../Core/Renderer/SVG/SVGElement.js';
+import TextPath from '../../Extensions/TextPath.js';
+TextPath.compose(SVGElement);
 /* *
  *
  *  Class
@@ -52,8 +55,8 @@ class PackedBubbleSeries extends BubbleSeries {
      *  Static Functions
      *
      * */
-    static compose(AxisClass, ChartClass, LegendClass, SeriesClass) {
-        BubbleSeries.compose(AxisClass, ChartClass, LegendClass, SeriesClass);
+    static compose(AxisClass, ChartClass, LegendClass) {
+        BubbleSeries.compose(AxisClass, ChartClass, LegendClass);
         DragNodesComposition.compose(ChartClass);
         PackedBubbleLayout.compose(ChartClass);
     }
@@ -480,10 +483,10 @@ class PackedBubbleSeries extends BubbleSeries {
             // Create first bubble in the middle of the chart
             bubblePos.push([
                 [
+                    0, // Starting in 0,0 coordinates
                     0,
-                    0,
-                    sortedArr[0][2],
-                    sortedArr[0][3],
+                    sortedArr[0][2], // Radius
+                    sortedArr[0][3], // Series index
                     sortedArr[0][4]
                 ] // Point index
             ]); // 0 level bubble

package/es-modules/Series/Pie/PieDataLabel.js

@@ -131,7 +131,7 @@ var ColumnDataLabel;
      */
     function drawDataLabels() {
         const series = this, points = series.points, chart = series.chart, plotWidth = chart.plotWidth, plotHeight = chart.plotHeight, plotLeft = chart.plotLeft, maxWidth = Math.round(chart.chartWidth / 3), seriesCenter = series.center, radius = seriesCenter[2] / 2, centerY = seriesCenter[1], halves = [
-            [],
+            [], // Right
             [] // Left
         ], overflow = [0, 0, 0, 0], // Top, right, bottom, left
         dataLabelPositioners = series.dataLabelPositioners;
@@ -207,11 +207,12 @@ var ColumnDataLabel;
                             labelPosition.top = Math.max(0, centerY - radius - labelPosition.distance);
                             labelPosition.bottom = Math.min(centerY + radius + labelPosition.distance, chart.plotHeight);
                             size = dataLabel.getBBox().height || 21;
+                            dataLabel.lineHeight = chart.renderer.fontMetrics(dataLabel.text || dataLabel).h + 2 * dataLabel.padding;
                             point.distributeBox = {
                                 target: ((dataLabel.dataLabelPosition
                                     ?.natural.y || 0) -
                                     labelPosition.top +
-                                    size / 2),
+                                    dataLabel.lineHeight / 2),
                                 size,
                                 rank: point.y
                             };
@@ -226,7 +227,7 @@ var ColumnDataLabel;
             points.forEach((point) => {
                 (point.dataLabels || []).forEach((dataLabel) => {
                     const dataLabelOptions = (dataLabel.options || {}), distributeBox = point.distributeBox, labelPosition = dataLabel.dataLabelPosition, naturalY = labelPosition?.natural.y || 0, connectorPadding = dataLabelOptions
-                        .connectorPadding || 0;
+                        .connectorPadding || 0, lineHeight = dataLabel.lineHeight || 21, bBox = dataLabel.getBBox(), topOffset = (lineHeight - bBox.height) / 2;
                     let x = 0, y = naturalY, visibility = 'inherit';
                     if (labelPosition) {
                         if (positions &&
@@ -256,7 +257,7 @@ var ColumnDataLabel;
                                     x = dataLabelPositioners.alignToPlotEdges(dataLabel, halfIdx, plotWidth, plotLeft);
                                     break;
                                 default:
-                                    x = dataLabelPositioners.radialDistributionX(series, point, y, naturalY, dataLabel);
+                                    x = dataLabelPositioners.radialDistributionX(series, point, y - topOffset, naturalY, dataLabel);
                             }
                         }
                         // Record the placement and visibility
@@ -274,10 +275,10 @@ var ColumnDataLabel;
                             y: y +
                                 (dataLabelOptions.y || 0) - // (#12985)
                                 // Vertically center
-                                dataLabel.getBBox().height / 2
+                                lineHeight / 2
                         };
                         labelPosition.computed.x = x;
-                        labelPosition.computed.y = y;
+                        labelPosition.computed.y = y - topOffset;
                         // Detect overflowing data labels
                         if (pick(dataLabelOptions.crop, true)) {
                             dataLabelWidth = dataLabel.getBBox().width;

package/es-modules/Series/Pie/PiePoint.js

@@ -148,18 +148,18 @@ extend(PiePoint.prototype, {
         // Only one available before v7.0.0
         fixedOffset: function (labelPosition, connectorPosition, options) {
             const breakAt = connectorPosition.breakAt, touchingSliceAt = connectorPosition.touchingSliceAt, lineSegment = options.softConnector ? [
-                'C',
+                'C', // Soft break
                 // 1st control point (of the curve)
                 labelPosition.x +
                     // 5 gives the connector a little horizontal bend
                     (labelPosition.alignment === 'left' ? -5 : 5),
-                labelPosition.y,
-                2 * breakAt.x - touchingSliceAt.x,
-                2 * breakAt.y - touchingSliceAt.y,
-                breakAt.x,
+                labelPosition.y, //
+                2 * breakAt.x - touchingSliceAt.x, // 2nd control point
+                2 * breakAt.y - touchingSliceAt.y, //
+                breakAt.x, // End of the curve
                 breakAt.y //
             ] : [
-                'L',
+                'L', // Pointy break
                 breakAt.x,
                 breakAt.y
             ];

package/es-modules/Series/Pie/PieSeriesDefaults.js

@@ -74,13 +74,14 @@ const PieSeriesDefaults = {
      * event information. The default action is to toggle the visibility of
      * the point. This can be prevented by calling `event.preventDefault()`.
      *
-     * @sample {highcharts} highcharts/plotoptions/pie-point-events-legenditemclick/
-     *         Confirm toggle visibility
-     *
-     * @type      {Highcharts.PointLegendItemClickCallbackFunction}
-     * @since     1.2.0
-     * @product   highcharts highmaps
-     * @apioption plotOptions.pie.point.events.legendItemClick
+     *  **Note:** This option is deprecated in favor of
+     * [legend.events.itemClick](#legend.events.itemClick).
+     *
+     * @deprecated
+     * @type       {Highcharts.PointLegendItemClickCallbackFunction}
+     * @since      1.2.0
+     * @product    highcharts highmaps
+     * @apioption  plotOptions.pie.point.events.legendItemClick
      */
     /**
      * The center of the pie chart relative to the plot area. Can be
@@ -130,7 +131,7 @@ const PieSeriesDefaults = {
      *
      * @private
      */
-    colorByPoint: true,
+    colorByPoint: true, // Always true for pies
     /**
      * A series specific or series type specific color set to use instead
      * of the global [colors](#colors).
@@ -426,7 +427,7 @@ const PieSeriesDefaults = {
      *
      * @private
      */
-    marker: null,
+    marker: null, // Point options are specified in the base options
     /**
      * The minimum size for a pie in response to auto margins. The pie will
      * try to shrink to make room for data labels in side the plot area,
@@ -553,7 +554,7 @@ const PieSeriesDefaults = {
      * @ignore-option
      * @private
      */
-    lineWidth: void 0,
+    lineWidth: void 0, // #12222
     states: {
         /**
          * @extends   plotOptions.series.states.hover

package/es-modules/Series/Pie3D/Pie3DSeries.js

@@ -69,7 +69,7 @@ class Pie3DSeries extends PieSeries {
                 attribs = {
                     translateX: center[0],
                     translateY: center[1],
-                    scaleX: 0.001,
+                    scaleX: 0.001, // #1499
                     scaleY: 0.001
                 };
                 group.attr(attribs);

package/es-modules/Series/Sankey/SankeySeries.js

@@ -23,6 +23,9 @@ import TU from '../TreeUtilities.js';
 const { getLevelOptions, getNodeWidth } = TU;
 import U from '../../Core/Utilities.js';
 const { clamp, crisp, extend, isObject, merge, pick, relativeLength, stableSort } = U;
+import SVGElement from '../../Core/Renderer/SVG/SVGElement.js';
+import TextPath from '../../Extensions/TextPath.js';
+TextPath.compose(SVGElement);
 /* *
  *
  *  Class
@@ -214,18 +217,18 @@ class SankeySeries extends ColumnSeries {
             // should be the level of the root node.
             from: 1,
             levels: options.levels,
-            to: nodeColumns.length - 1,
+            to: nodeColumns.length - 1, // Height of the tree
             defaults: {
                 borderColor: options.borderColor,
-                borderRadius: options.borderRadius,
+                borderRadius: options.borderRadius, // Organization series
                 borderWidth: options.borderWidth,
                 color: series.color,
                 colorByPoint: options.colorByPoint,
                 // NOTE: if support for allowTraversingTree is added, then
                 // levelIsConstant should be optional.
                 levelIsConstant: true,
-                linkColor: options.linkColor,
-                linkLineWidth: options.linkLineWidth,
+                linkColor: options.linkColor, // Organization series
+                linkLineWidth: options.linkLineWidth, // Organization series
                 linkOpacity: options.linkOpacity,
                 states: options.states
             }

package/es-modules/Series/Sankey/SankeySeriesDefaults.js

@@ -66,7 +66,7 @@ const SankeySeriesDefaults = {
      */
     dataLabels: {
         enabled: true,
-        backgroundColor: 'none',
+        backgroundColor: 'none', // Enable padding
         crop: false,
         /**
          * The

package/es-modules/Series/Sunburst/SunburstSeries.js

@@ -26,6 +26,9 @@ import U from '../../Core/Utilities.js';
 import SunburstNode from './SunburstNode.js';
 import SunburstSeriesDefaults from './SunburstSeriesDefaults.js';
 const { defined, error, extend, fireEvent, isNumber, isObject, isString, merge, splat } = U;
+import SVGElement from '../../Core/Renderer/SVG/SVGElement.js';
+import TextPath from '../../Extensions/TextPath.js';
+TextPath.compose(SVGElement);
 /* *
  *
  *  Constants
@@ -333,7 +336,7 @@ class SunburstSeries extends TreemapSeries {
             attribs = {
                 translateX: center[0] + plotLeft,
                 translateY: center[1] + plotTop,
-                scaleX: 0.001,
+                scaleX: 0.001, // #1499
                 scaleY: 0.001,
                 rotation: 10,
                 opacity: 0.01
@@ -408,12 +411,12 @@ class SunburstSeries extends TreemapSeries {
                 };
             }
             extend(point, {
-                shapeExisting: shape,
+                shapeExisting: shape, // Store for use in animation
                 tooltipPos: [shape.plotX, shape.plotY],
                 drillId: getDrillId(point, idRoot, nodeMap),
                 name: '' + (point.name || point.id || point.index),
-                plotX: shape.plotX,
-                plotY: shape.plotY,
+                plotX: shape.plotX, // Used for data label position
+                plotY: shape.plotY, // Used for data label position
                 value: node.val,
                 isInside: visible,
                 isNull: !visible // Used for dataLabels & point.draw
@@ -615,7 +618,7 @@ class SunburstSeries extends TreemapSeries {
 SunburstSeries.defaultOptions = merge(TreemapSeries.defaultOptions, SunburstSeriesDefaults);
 extend(SunburstSeries.prototype, {
     axisTypes: [],
-    drawDataLabels: noop,
+    drawDataLabels: noop, // `drawDataLabels` is called in `drawPoints`
     getCenter: getCenter,
     isCartesian: false,
     // Mark that the sunburst is supported by the series on point feature.

package/es-modules/Series/Sunburst/SunburstSeriesDefaults.js

@@ -31,7 +31,7 @@
  *               ignoreHiddenPoint, innerSize, joinBy, legendType, linecap,
  *               minSize, navigatorOptions, pointRange
  * @product      highcharts
- * @requires     modules/sunburst.js
+ * @requires     modules/sunburst
  * @optionparent plotOptions.sunburst
  *
  * @private
@@ -299,7 +299,7 @@ const SunburstSeriesDefaults = {
  * @excluding dataParser, dataURL, stack, dataSorting, boostThreshold,
  *            boostBlending
  * @product   highcharts
- * @requires  modules/sunburst.js
+ * @requires  modules/sunburst
  * @apioption series.sunburst
  */
 /**

package/es-modules/Series/Tilemap/TilemapSeriesDefaults.js

@@ -38,7 +38,7 @@
  * @excluding    jitter, joinBy, shadow, allAreas, mapData, marker, data,
  *               dataSorting, boostThreshold, boostBlending
  * @product      highcharts highmaps
- * @requires     modules/tilemap.js
+ * @requires     modules/tilemap
  * @optionparent plotOptions.tilemap
  */
 const TilemapSeriesDefaults = {
@@ -114,7 +114,7 @@ const TilemapSeriesDefaults = {
  *            pointRange, shadow, stack, dataSorting, boostThreshold,
  *            boostBlending
  * @product   highcharts highmaps
- * @requires  modules/tilemap.js
+ * @requires  modules/tilemap
  * @apioption series.tilemap
  */
 /**

package/es-modules/Series/Treegraph/TreegraphSeries.js

@@ -23,6 +23,9 @@ const { arrayMax, crisp, extend, merge, pick, relativeLength, splat } = U;
 import TreegraphLink from './TreegraphLink.js';
 import TreegraphLayout from './TreegraphLayout.js';
 import TreegraphSeriesDefaults from './TreegraphSeriesDefaults.js';
+import SVGElement from '../../Core/Renderer/SVG/SVGElement.js';
+import TextPath from '../../Extensions/TextPath.js';
+TextPath.compose(SVGElement);
 /* *
  *
  *  Class
@@ -56,6 +59,24 @@ class TreegraphSeries extends TreemapSeries {
     init() {
         super.init.apply(this, arguments);
         this.layoutAlgorythm = new TreegraphLayout();
+        // Register the link data labels in the label collector for overlap
+        // detection.
+        const series = this, collectors = this.chart.labelCollectors, collectorFunc = function () {
+            const linkLabels = [];
+            // Check links for overlap
+            if (!splat(series.options.dataLabels)[0].allowOverlap) {
+                for (const link of series.links) {
+                    if (link.dataLabel) {
+                        linkLabels.push(link.dataLabel);
+                    }
+                }
+            }
+            return linkLabels;
+        };
+        // Only add the collector function if it is not present
+        if (!collectors.some((f) => f.name === 'collectorFunc')) {
+            collectors.push(collectorFunc);
+        }
     }
     /**
      * Calculate `a` and `b` parameters of linear transformation, where
@@ -445,8 +466,8 @@ export default TreegraphSeries;
  * relativeXValue, softThreshold, stack, stacking, step,
  * traverseUpButton, xAxis, yAxis, zoneAxis, zones
  * @product   highcharts
- * @requires  modules/treemap.js
- * @requires  modules/treegraph.js
+ * @requires  modules/treemap
+ * @requires  modules/treegraph
  * @apioption series.treegraph
  */
 /**

package/es-modules/Series/Treegraph/TreegraphSeriesDefaults.js

@@ -36,8 +36,8 @@
  *
  * @product      highcharts
  * @since 10.3.0
- * @requires     modules/treemap.js
- * @requires     modules/treegraph.js
+ * @requires     modules/treemap
+ * @requires     modules/treegraph
  * @optionparent plotOptions.treegraph
  */
 const TreegraphSeriesDefaults = {

package/es-modules/Series/Treemap/TreemapPoint.js

@@ -42,7 +42,8 @@ class TreemapPoint extends ScatterPoint {
         const series = this.series, options = series.options;
         let className = super.getClassName();
         // Above the current level
-        if (this.node.level <= series.nodeMap[series.rootNode].level) {
+        if (this.node.level <= series.nodeMap[series.rootNode].level &&
+            this.node.children.length) {
             className += ' highcharts-above-level';
         }
         else if (!this.node.isLeaf &&

package/es-modules/Series/Treemap/TreemapSeries.js

@@ -447,14 +447,22 @@ class TreemapSeries extends ScatterSeries {
      * @private
      */
     drillToByLeaf(point) {
+        const { traverseToLeaf } = point.series.options;
         let drillId = false, nodeParent;
         if ((point.node.parent !== this.rootNode) &&
             point.node.isLeaf) {
-            nodeParent = point.node;
-            while (!drillId) {
-                nodeParent = this.nodeMap[nodeParent.parent];
-                if (nodeParent.parent === this.rootNode) {
-                    drillId = nodeParent.id;
+            if (traverseToLeaf) {
+                drillId = point.id;
+            }
+            else {
+                nodeParent = point.node;
+                while (!drillId) {
+                    if (typeof nodeParent.parent !== 'undefined') {
+                        nodeParent = this.nodeMap[nodeParent.parent];
+                    }
+                    if (nodeParent.parent === this.rootNode) {
+                        drillId = nodeParent.id;
+                    }
                 }
             }
         }
@@ -874,7 +882,7 @@ class TreemapSeries extends ScatterSeries {
         const tree = series.tree = series.getTree();
         rootNode = series.nodeMap[rootId];
         if (rootId !== '' &&
-            (!rootNode || !rootNode.children.length)) {
+            (!rootNode)) {
             series.setRootNode('', false);
             rootId = series.rootNode;
             rootNode = series.nodeMap[rootId];
@@ -950,7 +958,7 @@ TreemapSeries.defaultOptions = merge(ScatterSeries.defaultOptions, TreemapSeries
 extend(TreemapSeries.prototype, {
     buildKDTree: noop,
     colorAttribs: ColorMapComposition.seriesMembers.colorAttribs,
-    colorKey: 'colorValue',
+    colorKey: 'colorValue', // Point color option key
     directTouch: true,
     getExtremesFromAll: true,
     getSymbol: noop,

package/es-modules/Series/Treemap/TreemapSeriesDefaults.js

@@ -459,7 +459,21 @@ const TreemapSeriesDefaults = {
             shadow: false
         }
     },
-    legendSymbol: 'rectangle'
+    legendSymbol: 'rectangle',
+    /**
+     * This option enables automatic traversing to the last child level upon
+     * node interaction. This feature simplifies navigation by immediately
+     * focusing on the deepest layer of the data structure without intermediate
+     * steps.
+     *
+     * @sample {highcharts} highcharts/plotoptions/treemap-traverse-to-leaf/
+     *         Traverse to leaf enabled
+     *
+     * @since   @next
+     *
+     * @product highcharts
+     */
+    traverseToLeaf: false
 };
 /**
  * A `treemap` series. If the [type](#series.treemap.type) option is

package/es-modules/Series/VariablePie/VariablePieSeriesDefaults.js

@@ -28,7 +28,7 @@
  * @excluding    dragDrop
  * @since        6.0.0
  * @product      highcharts
- * @requires     modules/variable-pie.js
+ * @requires     modules/variable-pie
  * @optionparent plotOptions.variablepie
  */
 const VariablePieSeriesDefaults = {
@@ -107,7 +107,7 @@ const VariablePieSeriesDefaults = {
  * @excluding dataParser, dataURL, stack, xAxis, yAxis, dataSorting,
  *            boostThreshold, boostBlending
  * @product   highcharts
- * @requires  modules/variable-pie.js
+ * @requires  modules/variable-pie
  * @apioption series.variablepie
  */
 /**

package/es-modules/Series/Variwide/VariwideComposition.js

@@ -47,7 +47,7 @@ function onAxisAfterDrawCrosshair(e) {
  */
 function onAxisAfterRender() {
     const axis = this;
-    if (!this.horiz && this.variwide) {
+    if (this.variwide) {
         this.chart.labelCollectors.push(function () {
             return axis.tickPositions
                 .filter((pos) => !!axis.ticks[pos].label)

package/es-modules/Series/Vector/VectorSeries.js

@@ -68,7 +68,7 @@ class VectorSeries extends ScatterSeries {
         // The stem and the arrow head. Draw the arrow first with rotation
         // 0, which is the arrow pointing down (vector from north to south).
         path = [
-            ['M', 0, 7 * u + o],
+            ['M', 0, 7 * u + o], // Base of arrow
             ['L', -1.5 * u, 7 * u + o],
             ['L', 0, 10 * u + o],
             ['L', 1.5 * u, 7 * u + o],

package/es-modules/Series/Windbarb/WindbarbSeries.js

@@ -99,7 +99,7 @@ class WindbarbSeries extends ColumnSeries {
         }
         // The stem and the arrow head
         const path = [
-            ['M', 0, 7 * u],
+            ['M', 0, 7 * u], // Base of arrow
             ['L', -1.5 * u, 7 * u],
             ['L', 0, 10 * u],
             ['L', 1.5 * u, 7 * u],
@@ -216,7 +216,7 @@ extend(WindbarbSeries.prototype, {
     beaufortFloor: [
         0, 0.3, 1.6, 3.4, 5.5, 8.0, 10.8, 13.9, 17.2, 20.8,
         24.5, 28.5, 32.7
-    ],
+    ], // @todo dictionary with names?
     beaufortName: [
         'Calm', 'Light air', 'Light breeze',
         'Gentle breeze', 'Moderate breeze', 'Fresh breeze',

package/es-modules/Series/Wordcloud/WordcloudSeries.js

@@ -120,7 +120,7 @@ class WordcloudSeries extends ColumnSeries {
             }), attr = extend(series.pointAttribs(point, (point.selected && 'select')), {
                 align: 'center',
                 'alignment-baseline': 'middle',
-                'dominant-baseline': 'middle',
+                'dominant-baseline': 'middle', // #15973: Firefox
                 x: placement.x,
                 y: placement.y,
                 text: point.name,
@@ -217,7 +217,7 @@ class WordcloudSeries extends ColumnSeries {
         return {
             translateX: x + (width / 2),
             translateY: y + (height / 2),
-            scaleX: 1,
+            scaleX: 1, // #1623
             scaleY: 1
         };
     }

package/es-modules/Series/Wordcloud/WordcloudSeriesDefaults.js

@@ -57,7 +57,7 @@ const WordcloudSeriesDefaults = {
     /**
      * @ignore-option
      */
-    clip: false,
+    clip: false, // Something goes wrong with clip. // @todo fix this
     colorByPoint: true,
     cropThreshold: Infinity,
     /**

package/es-modules/Stock/Indicators/AD/ADIndicator.js

@@ -99,7 +99,7 @@ ADIndicator.defaultOptions = merge(SMAIndicator.defaultOptions, {
      * @excluding index
      */
     params: {
-        index: void 0,
+        index: void 0, // Unused index, do not inherit (#15362)
         /**
          * The id of volume series which is mandatory.
          * For example using OHLC data, volumeSeriesID='volume' means

package/es-modules/Stock/Indicators/APO/APOIndicator.js

@@ -100,7 +100,7 @@ APOIndicator.defaultOptions = merge(EMAIndicator.defaultOptions, {
      * @excluding period
      */
     params: {
-        period: void 0,
+        period: void 0, // Unchangeable period, do not inherit (#15362)
         /**
          * Periods for Absolute Price Oscillator calculations.
          *

package/es-modules/Stock/Indicators/Aroon/AroonIndicator.js

@@ -113,7 +113,7 @@ AroonIndicator.defaultOptions = merge(SMAIndicator.defaultOptions, {
      * @excluding index
      */
     params: {
-        index: void 0,
+        index: void 0, // Unchangeable index, do not inherit (#15362)
         period: 25
     },
     marker: {

package/es-modules/Stock/Indicators/CMF/CMFIndicator.js

@@ -202,7 +202,7 @@ CMFIndicator.defaultOptions = merge(SMAIndicator.defaultOptions, {
      * @excluding index
      */
     params: {
-        index: void 0,
+        index: void 0, // Unused index, do not inherit (#15362)
         /**
          * The id of another series to use its data as volume data for the
          * indicator calculation.

package/es-modules/Stock/Indicators/Chaikin/ChaikinIndicator.js

@@ -108,7 +108,7 @@ ChaikinIndicator.defaultOptions = merge(EMAIndicator.defaultOptions, {
      * @excluding index
      */
     params: {
-        index: void 0,
+        index: void 0, // Unused index, do not inherit (#15362)
         /**
          * The id of volume series which is mandatory.
          * For example using OHLC data, volumeSeriesID='volume' means

package/es-modules/Stock/Indicators/IKH/IKHIndicator.js

@@ -226,13 +226,13 @@ class IKHIndicator extends SMAIndicator {
             senkouSpanOptions.styles.fill, negativeColor = senkouSpanOptions.negativeColor, 
         // Points to create color and negativeColor senkouSpan
         points = [
-            [],
+            [], // Points color
             [] // Points negative color
         ], 
         // For span, we need an access to the next points, used in
         // getGraphPath()
         nextPoints = [
-            [],
+            [], // Next points color
             [] // Next points negative color
         ];
         let pointsLength = mainLinePoints.length, lineIndex = 0, position, point, i, startIntersect, endIntersect, sectionPoints, sectionNextPoints, pointsPlotYSum, nextPointsPlotYSum, senkouSpanTempColor, concatArrIndex, j, k;
@@ -497,7 +497,7 @@ IKHIndicator.defaultOptions = merge(SMAIndicator.defaultOptions, {
      * @excluding index
      */
     params: {
-        index: void 0,
+        index: void 0, // Unused index, do not inherit (#15362)
         period: 26,
         /**
          * The base period for Tenkan calculations.

package/es-modules/Stock/Indicators/LinearRegression/LinearRegressionIndicator.js

@@ -132,7 +132,7 @@ class LinearRegressionIndicator extends SMAIndicator {
         const xData = baseSeries.xData, yData = baseSeries.yData, period = regressionSeriesParams.period, 
         // Format required to be returned
         indicatorData = {
-            xData: [],
+            xData: [], // By getValues() method
             yData: [],
             values: []
         }, xAxisUnit = this.options.params.xAxisUnit ||

package/es-modules/Stock/Indicators/MFI/MFIIndicator.js

@@ -154,7 +154,7 @@ MFIIndicator.defaultOptions = merge(SMAIndicator.defaultOptions, {
      * @excluding index
      */
     params: {
-        index: void 0,
+        index: void 0, // Unchangeable index, do not inherit (#15362)
         /**
          * The id of volume series which is mandatory.
          * For example using OHLC data, volumeSeriesID='volume' means

package/es-modules/Stock/Indicators/PC/PCIndicator.js

@@ -99,7 +99,7 @@ PCIndicator.defaultOptions = merge(SMAIndicator.defaultOptions, {
      * @excluding index
      */
     params: {
-        index: void 0,
+        index: void 0, // Unchangeable index, do not inherit (#15362)
         period: 20
     },
     lineWidth: 1,

package/es-modules/Stock/Indicators/PPO/PPOIndicator.js

@@ -103,7 +103,7 @@ PPOIndicator.defaultOptions = merge(EMAIndicator.defaultOptions, {
      * @excluding period
      */
     params: {
-        period: void 0,
+        period: void 0, // Unchangeable period, do not inherit (#15362)
         /**
          * Periods for Percentage Price Oscillator calculations.
          *