highcharts 10.2.0 → 10.2.1

package/es-modules/Extensions/ExportData/ExportDataDefaults.js

@@ -0,0 +1,272 @@
+/* *
+ *
+ *  Experimental data export module for Highcharts
+ *
+ *  (c) 2010-2021 Torstein Honsi
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
+'use strict';
+/* *
+ *
+ *  Constants
+ *
+ * */
+/**
+ * @optionparent exporting
+ * @private
+ */
+var exporting = {
+    /**
+     * Caption for the data table. Same as chart title by default. Set to
+     * `false` to disable.
+     *
+     * @sample highcharts/export-data/multilevel-table
+     *         Multiple table headers
+     *
+     * @type      {boolean|string}
+     * @since     6.0.4
+     * @requires  modules/export-data
+     * @apioption exporting.tableCaption
+     */
+    /**
+     * Options for exporting data to CSV or ExCel, or displaying the data
+     * in a HTML table or a JavaScript structure.
+     *
+     * This module adds data export options to the export menu and provides
+     * functions like `Chart.getCSV`, `Chart.getTable`, `Chart.getDataRows`
+     * and `Chart.viewData`.
+     *
+     * The XLS converter is limited and only creates a HTML string that is
+     * passed for download, which works but creates a warning before
+     * opening. The workaround for this is to use a third party XLSX
+     * converter, as demonstrated in the sample below.
+     *
+     * @sample  highcharts/export-data/categorized/ Categorized data
+     * @sample  highcharts/export-data/stock-timeaxis/ Highcharts Stock time axis
+     * @sample  highcharts/export-data/xlsx/
+     *          Using a third party XLSX converter
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    csv: {
+        /**
+         *
+         * Options for annotations in the export-data table.
+         *
+         * @since 8.2.0
+         * @requires modules/export-data
+         * @requires modules/annotations
+         *
+         *
+         */
+        annotations: {
+            /**
+            * The way to mark the separator for annotations
+            * combined in one export-data table cell.
+            *
+            * @since 8.2.0
+            * @requires modules/annotations
+            */
+            itemDelimiter: '; ',
+            /**
+            * When several labels are assigned to a specific point,
+            * they will be displayed in one field in the table.
+            *
+            * @sample highcharts/export-data/join-annotations/
+            *         Concatenate point annotations with itemDelimiter set.
+            *
+            * @since 8.2.0
+            * @requires modules/annotations
+            */
+            join: false
+        },
+        /**
+         * Formatter callback for the column headers. Parameters are:
+         * - `item` - The series or axis object)
+         * - `key` -  The point key, for example y or z
+         * - `keyLength` - The amount of value keys for this item, for
+         *   example a range series has the keys `low` and `high` so the
+         *   key length is 2.
+         *
+         * If [useMultiLevelHeaders](#exporting.useMultiLevelHeaders) is
+         * true, columnHeaderFormatter by default returns an object with
+         * columnTitle and topLevelColumnTitle for each key. Columns with
+         * the same topLevelColumnTitle have their titles merged into a
+         * single cell with colspan for table/Excel export.
+         *
+         * If `useMultiLevelHeaders` is false, or for CSV export, it returns
+         * the series name, followed by the key if there is more than one
+         * key.
+         *
+         * For the axis it returns the axis title or "Category" or
+         * "DateTime" by default.
+         *
+         * Return `false` to use Highcharts' proposed header.
+         *
+         * @sample highcharts/export-data/multilevel-table
+         *         Multiple table headers
+         *
+         * @type {Function|null}
+         */
+        columnHeaderFormatter: null,
+        /**
+         * Which date format to use for exported dates on a datetime X axis.
+         * See `Highcharts.dateFormat`.
+         */
+        dateFormat: '%Y-%m-%d %H:%M:%S',
+        /**
+         * Which decimal point to use for exported CSV. Defaults to the same
+         * as the browser locale, typically `.` (English) or `,` (German,
+         * French etc).
+         *
+         * @type  {string|null}
+         * @since 6.0.4
+         */
+        decimalPoint: null,
+        /**
+         * The item delimiter in the exported data. Use `;` for direct
+         * exporting to Excel. Defaults to a best guess based on the browser
+         * locale. If the locale _decimal point_ is `,`, the `itemDelimiter`
+         * defaults to `;`, otherwise the `itemDelimiter` defaults to `,`.
+         *
+         * @type {string|null}
+         */
+        itemDelimiter: null,
+        /**
+         * The line delimiter in the exported data, defaults to a newline.
+         */
+        lineDelimiter: '\n'
+    },
+    /**
+     * Show a HTML table below the chart with the chart's current data.
+     *
+     * @sample highcharts/export-data/showtable/
+     *         Show the table
+     * @sample highcharts/studies/exporting-table-html
+     *         Experiment with putting the table inside the subtitle to
+     *         allow exporting it.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    showTable: false,
+    /**
+     * Use multi level headers in data table. If [csv.columnHeaderFormatter
+     * ](#exporting.csv.columnHeaderFormatter) is defined, it has to return
+     * objects in order for multi level headers to work.
+     *
+     * @sample highcharts/export-data/multilevel-table
+     *         Multiple table headers
+     *
+     * @since    6.0.4
+     * @requires modules/export-data
+     */
+    useMultiLevelHeaders: true,
+    /**
+     * If using multi level table headers, use rowspans for headers that
+     * have only one level.
+     *
+     * @sample highcharts/export-data/multilevel-table
+     *         Multiple table headers
+     *
+     * @since    6.0.4
+     * @requires modules/export-data
+     */
+    useRowspanHeaders: true
+};
+/**
+ * @optionparent lang
+ * @private
+ */
+var lang = {
+    /**
+     * The text for the menu item.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    downloadCSV: 'Download CSV',
+    /**
+     * The text for the menu item.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    downloadXLS: 'Download XLS',
+    /**
+     * The text for exported table.
+     *
+     * @since 8.1.0
+     * @requires modules/export-data
+     */
+    exportData: {
+        /**
+         * The annotation column title.
+         */
+        annotationHeader: 'Annotations',
+        /**
+         * The category column title.
+         */
+        categoryHeader: 'Category',
+        /**
+         * The category column title when axis type set to "datetime".
+         */
+        categoryDatetimeHeader: 'DateTime'
+    },
+    /**
+     * The text for the menu item.
+     *
+     * @since    6.0.0
+     * @requires modules/export-data
+     */
+    viewData: 'View data table',
+    /**
+     * The text for the menu item.
+     *
+     * @since 8.2.0
+     * @requires modules/export-data
+     */
+    hideData: 'Hide data table'
+};
+/* *
+ *
+ *  Default Export
+ *
+ * */
+var ExportDataDefaults = {
+    exporting: exporting,
+    lang: lang
+};
+export default ExportDataDefaults;
+/* *
+ *
+ *  API Options
+ *
+ * */
+/**
+ * Callback that fires while exporting data. This allows the modification of
+ * data rows before processed into the final format.
+ *
+ * @type      {Highcharts.ExportDataCallbackFunction}
+ * @context   Highcharts.Chart
+ * @requires  modules/export-data
+ * @apioption chart.events.exportData
+ */
+/**
+ * When set to `false` will prevent the series data from being included in
+ * any form of data export.
+ *
+ * Since version 6.0.0 until 7.1.0 the option was existing undocumented
+ * as `includeInCSVExport`.
+ *
+ * @type      {boolean}
+ * @since     7.1.0
+ * @requires  modules/export-data
+ * @apioption plotOptions.series.includeInDataExport
+ */
+(''); // keep doclets above in JS file

package/es-modules/Extensions/Exporting/Exporting.js

@@ -17,6 +17,7 @@ import D from '../../Core/DefaultOptions.js';
 var defaultOptions = D.defaultOptions;
 import ExportingDefaults from './ExportingDefaults.js';
 import ExportingSymbols from './ExportingSymbols.js';
+import Fullscreen from './Fullscreen.js';
 import G from '../../Core/Globals.js';
 var doc = G.doc, SVG_NS = G.SVG_NS, win = G.win;
 import HU from '../../Core/HttpUtilities.js';
@@ -307,6 +308,7 @@ var Exporting;
      */
     function compose(ChartClass, SVGRendererClass) {
         ExportingSymbols.compose(SVGRendererClass);
+        Fullscreen.compose(ChartClass);
         if (composedClasses.indexOf(ChartClass) === -1) {
             composedClasses.push(ChartClass);
             var chartProto = ChartClass.prototype;
@@ -1013,7 +1015,7 @@ var Exporting;
                 update('exporting', options, redraw);
             }
         };
-        // Register update() method for navigation. Can not be set the same way
+        // Register update() method for navigation. Cannot be set the same way
         // as for exporting, because navigation options are shared with bindings
         // which has separate update() logic.
         ChartNavigationComposition
@@ -1157,6 +1159,8 @@ defaultOptions.lang = merge(ExportingDefaults.lang, defaultOptions.lang);
  *
  * @requires     modules/exporting
  * @optionparent navigation
+ *
+ * @private
  */
 defaultOptions.navigation = merge(ExportingDefaults.navigation, defaultOptions.navigation);
 /* *

package/es-modules/Extensions/Exporting/ExportingDefaults.js

@@ -429,7 +429,9 @@ var exporting = {
         viewFullscreen: {
             textKey: 'viewFullscreen',
             onclick: function () {
-                this.fullscreen.toggle();
+                if (this.fullscreen) {
+                    this.fullscreen.toggle();
+                }
             }
         },
         /**

package/es-modules/Extensions/{FullScreen.js → Exporting/Fullscreen.js}

@@ -1,24 +1,55 @@
 /* *
- * (c) 2009-2021 Rafal Sebestjanski
  *
- * Full screen for Highcharts
+ *  (c) 2009-2021 Rafal Sebestjanski
  *
- * License: www.highcharts.com/license
- */
-'use strict';
-import Chart from '../Core/Chart/Chart.js';
-import H from '../Core/Globals.js';
-var doc = H.doc;
-import AST from '../Core/Renderer/HTML/AST.js';
-import U from '../Core/Utilities.js';
-var addEvent = U.addEvent, fireEvent = U.fireEvent;
+ *  Full screen for Highcharts
+ *
+ *  License: www.highcharts.com/license
+ *
+ *  !!!!!!! SOURCE GETS TRANSPILED BY TYPESCRIPT. EDIT TS FILE ONLY. !!!!!!!
+ *
+ * */
 /**
  * The module allows user to enable display chart in full screen mode.
  * Used in StockTools too.
  * Based on default solutions in browsers.
+ */
+'use strict';
+/* *
  *
+ *  Imports
+ *
+ * */
+import AST from '../../Core/Renderer/HTML/AST.js';
+import U from '../../Core/Utilities.js';
+var addEvent = U.addEvent, fireEvent = U.fireEvent;
+/* *
+ *
+ *  Constants
+ *
+ * */
+var composedClasses = [];
+/* *
+ *
+ *  Functions
+ *
+ * */
+/**
+ * @private
  */
-/* eslint-disable no-invalid-this, valid-jsdoc */
+function onChartBeforeRender() {
+    /**
+     * @name Highcharts.Chart#fullscreen
+     * @type {Highcharts.Fullscreen}
+     * @requires modules/full-screen
+     */
+    this.fullscreen = new Fullscreen(this);
+}
+/* *
+ *
+ *  Class
+ *
+ * */
 /**
  * Handles displaying chart's container in the fullscreen mode.
  *
@@ -26,8 +57,8 @@ var addEvent = U.addEvent, fireEvent = U.fireEvent;
  *
  * @class
  * @name Highcharts.Fullscreen
- * @hideconstructor
- * @requires modules/full-screen
+ *
+ * @requires modules/exporting
  */
 var Fullscreen = /** @class */ (function () {
     /* *
@@ -84,6 +115,24 @@ var Fullscreen = /** @class */ (function () {
             }
         }
     }
+    /* *
+     *
+     *  Static Functions
+     *
+     * */
+    /**
+     * Prepares the chart class to support fullscreen.
+     *
+     * @param {typeof_Highcharts.Chart} ChartClass
+     * The chart class to decorate with fullscreen support.
+     */
+    Fullscreen.compose = function (ChartClass) {
+        if (composedClasses.indexOf(ChartClass) === -1) {
+            composedClasses.push(ChartClass);
+            // Initialize fullscreen
+            addEvent(ChartClass, 'beforeRender', onChartBeforeRender);
+        }
+    };
     /* *
      *
      *  Functions
@@ -234,17 +283,12 @@ var Fullscreen = /** @class */ (function () {
     };
     return Fullscreen;
 }());
-H.Fullscreen = Fullscreen;
-export default H.Fullscreen;
-// Initialize fullscreen
-addEvent(Chart, 'beforeRender', function () {
-    /**
-     * @name Highcharts.Chart#fullscreen
-     * @type {Highcharts.Fullscreen}
-     * @requires modules/full-screen
-     */
-    this.fullscreen = new H.Fullscreen(this);
-});
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default Fullscreen;
 /* *
  *
  *  API Declarations
@@ -272,6 +316,7 @@ addEvent(Chart, 'beforeRender', function () {
  * @param {global.Event} event
  *        The event that occured.
  */
+(''); // keeps doclets above separated from following code
 /* *
  *
  *  API Options
@@ -286,7 +331,7 @@ addEvent(Chart, 'beforeRender', function () {
  *         Title size change on fullscreen open
  *
  * @type      {Highcharts.FullScreenfullscreenCloseCallbackFunction}
- * @since 10.1.0
+ * @since     10.1.0
  * @context   Highcharts.Chart
  * @requires  modules/full-screen
  * @apioption chart.events.fullscreenClose
@@ -299,7 +344,7 @@ addEvent(Chart, 'beforeRender', function () {
  *         Title size change on fullscreen open
  *
  * @type      {Highcharts.FullScreenfullscreenOpenCallbackFunction}
- * @since 10.1.0
+ * @since     10.1.0
  * @context   Highcharts.Chart
  * @requires  modules/full-screen
  * @apioption chart.events.fullscreenOpen

package/es-modules/Extensions/MarkerClusters.js

@@ -346,6 +346,8 @@ var clusterDefaultOptions = {
          * @sample maps/marker-clusters/europe/
          *         Format tooltip for clusters using tooltip.formatter
          *
+         * @type      {string}
+         * @default   Clustered points: {point.clusterPointsAmount}
          * @apioption tooltip.clusterFormat
          */
         clusterFormat: '<span>Clustered points: ' +

package/es-modules/Extensions/OfflineExporting/OfflineExportingDefaults.js

@@ -14,7 +14,7 @@
  *
  * */
 var OfflineExportingDefaults = {
-    libURL: 'https://code.highcharts.com/10.2.0/lib/',
+    libURL: 'https://code.highcharts.com/10.2.1/lib/',
     // When offline-exporting is loaded, redefine the menu item definitions
     // related to download.
     menuItemDefinitions: {

package/es-modules/Extensions/Oldie/Oldie.js

@@ -36,7 +36,7 @@ var VMLRenderer, VMLElement;
  * @apioption global.VMLRadialGradientURL
  */
 getOptions().global.VMLRadialGradientURL =
-    'http://code.highcharts.com/10.2.0/gfx/vml-radial-gradient.png';
+    'http://code.highcharts.com/10.2.1/gfx/vml-radial-gradient.png';
 // Utilites
 if (doc && !doc.defaultView) {
     H.getStyle = U.getStyle = function getStyle(el, prop) {

package/es-modules/Extensions/ParallelCoordinates.js

@@ -19,7 +19,7 @@ import D from '../Core/DefaultOptions.js';
 var setOptions = D.setOptions;
 import Series from '../Core/Series/Series.js';
 import U from '../Core/Utilities.js';
-var addEvent = U.addEvent, arrayMax = U.arrayMax, arrayMin = U.arrayMin, defined = U.defined, erase = U.erase, extend = U.extend, merge = U.merge, pick = U.pick, splat = U.splat, wrap = U.wrap;
+var addEvent = U.addEvent, arrayMax = U.arrayMax, arrayMin = U.arrayMin, defined = U.defined, erase = U.erase, extend = U.extend, isArray = U.isArray, isNumber = U.isNumber, merge = U.merge, pick = U.pick, splat = U.splat, wrap = U.wrap;
 /* *
  *
  *  Constants
@@ -87,7 +87,7 @@ var defaultParallelOptions = {
      *            gridLineDashStyle, gridLineWidth, minorGridLineColor,
      *            minorGridLineDashStyle, minorGridLineWidth, plotBands,
      *            plotLines, angle, gridLineInterpolation, maxColor, maxZoom,
-     *            minColor, scrollbar, stackLabels, stops
+     *            minColor, scrollbar, stackLabels, stops,
      * @requires  modules/parallel-coordinates
      */
     parallelAxes: {
@@ -436,14 +436,18 @@ var ParallelAxis;
             return;
         }
         if (chart && chart.hasParallelCoordinates && !axis.isXAxis) {
-            var index_1 = parallelCoordinates.position, currentPoints_1 = [];
+            var index_1 = parallelCoordinates.position;
+            var currentPoints_1 = [];
             axis.series.forEach(function (series) {
-                if (series.visible &&
-                    defined(series.yData[index_1])) {
-                    // We need to use push() beacause of null points
-                    currentPoints_1.push(series.yData[index_1]);
+                if (series.yData &&
+                    series.visible &&
+                    isNumber(index_1)) {
+                    var y = series.yData[index_1];
+                    // Take into account range series points as well (#15752)
+                    currentPoints_1.push.apply(currentPoints_1, splat(y));
                 }
             });
+            currentPoints_1 = currentPoints_1.filter(isNumber);
             axis.dataMin = arrayMin(currentPoints_1);
             axis.dataMax = arrayMax(currentPoints_1);
             e.preventDefault();

package/es-modules/Extensions/ScrollablePlotArea.js

@@ -336,7 +336,7 @@ addEvent(Series, 'show', function () {
  *         Scrollable plot area
  * @sample highcharts/chart/scrollable-plotarea-vertical
  *         Vertically scrollable plot area
- * @sample {gantt} highcharts/chart/scrollable-plotarea-vertical
+ * @sample {gantt} gantt/chart/scrollable-plotarea-vertical
  *         Gantt chart with vertically scrollable plot area
  *
  * @since     6.1.0

package/es-modules/Extensions/SeriesLabel/SeriesLabel.js

@@ -216,7 +216,7 @@ function drawSeriesLabels(chart) {
                 series.labelBySeries = label.destroy();
             }
         }
-        if (series.visible && !series.isSeriesBoosting && points) {
+        if (series.visible && !series.boosted && points) {
             if (!label) {
                 var labelText = series.name;
                 if (typeof labelOptions.format === 'string') {
@@ -539,7 +539,7 @@ function onChartRedraw(e) {
             if (options.enabled &&
                 series.visible &&
                 (series.graph || series.area) &&
-                !series.isSeriesBoosting) {
+                !series.boosted) {
                 chart_1.labelSeries.push(series);
                 if (options.minFontSize && options.maxFontSize) {
                     series.sum = series.yData.reduce(function (pv, cv) {

package/es-modules/Extensions/Sonification/ChartSonify.js

@@ -604,7 +604,7 @@ export default ChartSonify;
 * receives the point as argument, and should return a numeric value. The points
 * with the lowest numeric values are then played first, and the time between
 * points will be proportional to the distance between the numeric values. This
-* option can not be overridden per series.
+* option cannot be overridden per series.
 * @name Highcharts.SonificationOptions#pointPlayTime
 * @type {string|Function}
 */ /**

package/es-modules/Maps/MapPointer.js

@@ -83,7 +83,7 @@ wrap(Pointer.prototype, 'zoomOption', function (proceed) {
     var mapNavigation = this.chart.options.mapNavigation;
     // Pinch status
     if (pick(mapNavigation.enableTouchZoom, mapNavigation.enabled)) {
-        this.chart.options.chart.pinchType = 'xy';
+        this.chart.options.chart.zooming.pinchType = 'xy';
     }
     proceed.apply(this, [].slice.call(arguments, 1));
 });

package/es-modules/Maps/MapView.js

@@ -45,7 +45,8 @@ import U from '../Core/Utilities.js';
 var addEvent = U.addEvent, clamp = U.clamp, fireEvent = U.fireEvent, isArray = U.isArray, isNumber = U.isNumber, isObject = U.isObject, isString = U.isString, merge = U.merge, pick = U.pick, relativeLength = U.relativeLength;
 /**
  * The world size in terms of 10k meters in the Web Mercator projection, to
- * match a 256 square tile to zoom level 0
+ * match a 256 square tile to zoom level 0.
+ * @private
  */
 var worldSize = 400.979322;
 var tileSize = 256;