highcharts 9.3.3 → 10.2.0

package/modules/data.src.js

@@ -1,5 +1,5 @@
 /**
- * @license Highcharts JS v9.3.3 (2022-02-01)
+ * @license Highcharts JS v10.2.0 (2022-07-05)
  *
  * Data module
  *
@@ -7,7 +7,6 @@
  *
  * License: www.highcharts.com/license
  */
-'use strict';
 (function (factory) {
     if (typeof module === 'object' && module.exports) {
         factory['default'] = factory;
@@ -22,10 +21,20 @@
         factory(typeof Highcharts !== 'undefined' ? Highcharts : undefined);
     }
 }(function (Highcharts) {
+    'use strict';
     var _modules = Highcharts ? Highcharts._modules : {};
     function _registerModule(obj, path, args, fn) {
         if (!obj.hasOwnProperty(path)) {
             obj[path] = fn.apply(null, args);
+
+            if (typeof CustomEvent === 'function') {
+                window.dispatchEvent(
+                    new CustomEvent(
+                        'HighchartsModuleLoaded',
+                        { detail: { path: path, module: obj[path] }
+                    })
+                );
+            }
         }
     }
     _registerModule(_modules, 'Core/HttpUtilities.js', [_modules['Core/Globals.js'], _modules['Core/Utilities.js']], function (G, U) {
@@ -43,29 +52,24 @@
             discardElement = U.discardElement,
             merge = U.merge,
             objectEach = U.objectEach;
+        /* *
+         *
+         *  Functions
+         *
+         * */
         /**
          * Perform an Ajax call.
          *
          * @function Highcharts.ajax
          *
-         * @param {Partial<Highcharts.AjaxSettingsObject>} attr
+         * @param {Highcharts.AjaxSettingsObject} settings
          *        The Ajax settings to use.
          *
          * @return {false|undefined}
          *         Returns false, if error occured.
          */
-        function ajax(attr) {
-            var options = merge(true, {
-                    url: false,
-                    type: 'get',
-                    dataType: 'json',
-                    success: false,
-                    error: false,
-                    data: false,
-                    headers: {}
-                },
-                attr),
-                headers = {
+        function ajax(settings) {
+            var headers = {
                     json: 'application/json',
                     xml: 'application/xml',
                     text: 'text/plain',
@@ -73,6 +77,7 @@
                 },
                 r = new XMLHttpRequest();
             /**
+             * Private error handler.
              * @private
              * @param {XMLHttpRequest} xhr
              * Internal request object.
@@ -80,49 +85,53 @@
              * Occured error.
              */
             function handleError(xhr, err) {
-                if (options.error) {
-                    options.error(xhr, err);
+                if (settings.error) {
+                    settings.error(xhr, err);
                 }
                 else {
                     // @todo Maybe emit a highcharts error event here
                 }
             }
-            if (!options.url) {
+            if (!settings.url) {
                 return false;
             }
-            r.open(options.type.toUpperCase(), options.url, true);
-            if (!options.headers['Content-Type']) {
-                r.setRequestHeader('Content-Type', headers[options.dataType] || headers.text);
+            r.open((settings.type || 'get').toUpperCase(), settings.url, true);
+            if (!settings.headers || !settings.headers['Content-Type']) {
+                r.setRequestHeader('Content-Type', headers[settings.dataType || 'json'] || headers.text);
             }
-            objectEach(options.headers, function (val, key) {
+            objectEach(settings.headers, function (val, key) {
                 r.setRequestHeader(key, val);
             });
+            if (settings.responseType) {
+                r.responseType = settings.responseType;
+            }
             // @todo lacking timeout handling
             r.onreadystatechange = function () {
                 var res;
                 if (r.readyState === 4) {
                     if (r.status === 200) {
-                        res = r.responseText;
-                        if (options.dataType === 'json') {
-                            try {
-                                res = JSON.parse(res);
-                            }
-                            catch (e) {
-                                return handleError(r, e);
+                        if (settings.responseType !== 'blob') {
+                            res = r.responseText;
+                            if (settings.dataType === 'json') {
+                                try {
+                                    res = JSON.parse(res);
+                                }
+                                catch (e) {
+                                    if (e instanceof Error) {
+                                        return handleError(r, e);
+                                    }
+                                }
                             }
                         }
-                        return options.success && options.success(res);
+                        return settings.success && settings.success(res, r);
                     }
                     handleError(r, r.responseText);
                 }
             };
-            try {
-                options.data = JSON.stringify(options.data);
+            if (settings.data && typeof settings.data !== 'string') {
+                settings.data = JSON.stringify(settings.data);
             }
-            catch (e) {
-                // empty
-            }
-            r.send(options.data || true);
+            r.send(settings.data);
         }
         /**
          * Get a JSON resource over XHR, also supporting CORS without preflight.
@@ -179,7 +188,7 @@
                     type: 'hidden',
                     name: name,
                     value: val
-                }, null, form);
+                }, void 0, form);
             });
             // submit
             form.submit();
@@ -196,33 +205,38 @@
                 getJSON: getJSON,
                 post: post
             };
+        /* *
+         *
+         *  API Declarations
+         *
+         * */
         /**
          * @interface Highcharts.AjaxSettingsObject
          */ /**
         * The payload to send.
         *
         * @name Highcharts.AjaxSettingsObject#data
-        * @type {string|Highcharts.Dictionary<any>}
+        * @type {string|Highcharts.Dictionary<any>|undefined}
         */ /**
         * The data type expected.
         * @name Highcharts.AjaxSettingsObject#dataType
-        * @type {"json"|"xml"|"text"|"octet"}
+        * @type {"json"|"xml"|"text"|"octet"|undefined}
         */ /**
         * Function to call on error.
         * @name Highcharts.AjaxSettingsObject#error
-        * @type {Function}
+        * @type {Function|undefined}
         */ /**
         * The headers; keyed on header name.
         * @name Highcharts.AjaxSettingsObject#headers
-        * @type {Highcharts.Dictionary<string>}
+        * @type {Highcharts.Dictionary<string>|undefined}
         */ /**
         * Function to call on success.
         * @name Highcharts.AjaxSettingsObject#success
-        * @type {Function}
+        * @type {Function|undefined}
         */ /**
         * The HTTP method to use. For example GET or POST.
         * @name Highcharts.AjaxSettingsObject#type
-        * @type {string}
+        * @type {string|undefined}
         */ /**
         * The URL to call.
         * @name Highcharts.AjaxSettingsObject#url
@@ -232,7 +246,7 @@
 
         return HttpUtilities;
     });
-    _registerModule(_modules, 'Extensions/Data.js', [_modules['Core/Chart/Chart.js'], _modules['Core/Globals.js'], _modules['Core/HttpUtilities.js'], _modules['Core/Series/Point.js'], _modules['Core/Series/SeriesRegistry.js'], _modules['Core/Utilities.js']], function (Chart, G, HU, Point, SeriesRegistry, U) {
+    _registerModule(_modules, 'Extensions/Data.js', [_modules['Core/Chart/Chart.js'], _modules['Core/Globals.js'], _modules['Core/HttpUtilities.js'], _modules['Core/Series/Point.js'], _modules['Core/Series/SeriesRegistry.js'], _modules['Core/Utilities.js'], _modules['Core/DefaultOptions.js']], function (Chart, G, HU, Point, SeriesRegistry, U, D) {
         /* *
          *
          *  Data module
@@ -247,6 +261,7 @@
         var doc = G.doc;
         var ajax = HU.ajax;
         var seriesTypes = SeriesRegistry.seriesTypes;
+        var getOptions = D.getOptions;
         var addEvent = U.addEvent,
             defined = U.defined,
             extend = U.extend,
@@ -256,492 +271,61 @@
             objectEach = U.objectEach,
             pick = U.pick,
             splat = U.splat;
-        /**
-         * Callback function to modify the CSV before parsing it by the data module.
-         *
-         * @callback Highcharts.DataBeforeParseCallbackFunction
-         *
-         * @param {string} csv
-         *        The CSV to modify.
-         *
-         * @return {string}
-         *         The CSV to parse.
-         */
-        /**
-         * Callback function that gets called after parsing data.
-         *
-         * @callback Highcharts.DataCompleteCallbackFunction
-         *
-         * @param {Highcharts.Options} chartOptions
-         *        The chart options that were used.
-         */
-        /**
-         * Callback function that returns the correspondig Date object to a match.
-         *
-         * @callback Highcharts.DataDateFormatCallbackFunction
-         *
-         * @param {Array<number>} match
-         *
-         * @return {number}
-         */
-        /**
-         * Structure for alternative date formats to parse.
-         *
-         * @interface Highcharts.DataDateFormatObject
-         */ /**
-        * @name Highcharts.DataDateFormatObject#alternative
-        * @type {string|undefined}
-        */ /**
-        * @name Highcharts.DataDateFormatObject#parser
-        * @type {Highcharts.DataDateFormatCallbackFunction}
-        */ /**
-        * @name Highcharts.DataDateFormatObject#regex
-        * @type {global.RegExp}
-        */
-        /**
-         * Possible types for a data item in a column or row.
-         *
-         * @typedef {number|string|null} Highcharts.DataValueType
-         */
-        /**
-         * Callback function to parse string representations of dates into
-         * JavaScript timestamps (milliseconds since 1.1.1970).
-         *
-         * @callback Highcharts.DataParseDateCallbackFunction
-         *
-         * @param {string} dateValue
-         *
-         * @return {number}
-         *         Timestamp (milliseconds since 1.1.1970) as integer for Date class.
-         */
-        /**
-         * Callback function to access the parsed columns, the two-dimentional
-         * input data array directly, before they are interpreted into series
-         * data and categories.
-         *
-         * @callback Highcharts.DataParsedCallbackFunction
-         *
-         * @param {Array<Array<*>>} columns
-         *        The parsed columns by the data module.
-         *
-         * @return {boolean|undefined}
-         *         Return `false` to stop completion, or call `this.complete()` to
-         *         continue async.
-         */
-        /**
-         * The Data module provides a simplified interface for adding data to
-         * a chart from sources like CVS, HTML tables or grid views. See also
-         * the [tutorial article on the Data module](
-         * https://www.highcharts.com/docs/working-with-data/data-module).
-         *
-         * It requires the `modules/data.js` file to be loaded.
-         *
-         * Please note that the default way of adding data in Highcharts, without
-         * the need of a module, is through the [series._type_.data](#series.line.data)
-         * option.
-         *
-         * @sample {highcharts} highcharts/demo/column-parsed/
-         *         HTML table
-         * @sample {highcharts} highcharts/data/csv/
-         *         CSV
-         *
-         * @since     4.0
-         * @requires  modules/data
-         * @apioption data
-         */
-        /**
-         * A callback function to modify the CSV before parsing it. Return the modified
-         * string.
-         *
-         * @sample {highcharts} highcharts/demo/line-ajax/
-         *         Modify CSV before parse
-         *
-         * @type      {Highcharts.DataBeforeParseCallbackFunction}
-         * @since     6.1
-         * @apioption data.beforeParse
-         */
-        /**
-         * A two-dimensional array representing the input data on tabular form.
-         * This input can be used when the data is already parsed, for example
-         * from a grid view component. Each cell can be a string or number.
-         * If not switchRowsAndColumns is set, the columns are interpreted as
-         * series.
-         *
-         * @see [data.rows](#data.rows)
-         *
-         * @sample {highcharts} highcharts/data/columns/
-         *         Columns
-         *
-         * @type      {Array<Array<Highcharts.DataValueType>>}
-         * @since     4.0
-         * @apioption data.columns
-         */
-        /**
-         * The callback that is evaluated when the data is finished loading,
-         * optionally from an external source, and parsed. The first argument
-         * passed is a finished chart options object, containing the series.
-         * These options can be extended with additional options and passed
-         * directly to the chart constructor.
-         *
-         * @see [data.parsed](#data.parsed)
-         *
-         * @sample {highcharts} highcharts/data/complete/
-         *         Modify data on complete
-         *
-         * @type      {Highcharts.DataCompleteCallbackFunction}
-         * @since     4.0
-         * @apioption data.complete
-         */
-        /**
-         * A comma delimited string to be parsed. Related options are [startRow](
-         * #data.startRow), [endRow](#data.endRow), [startColumn](#data.startColumn)
-         * and [endColumn](#data.endColumn) to delimit what part of the table
-         * is used. The [lineDelimiter](#data.lineDelimiter) and [itemDelimiter](
-         * #data.itemDelimiter) options define the CSV delimiter formats.
-         *
-         * The built-in CSV parser doesn't support all flavours of CSV, so in
-         * some cases it may be necessary to use an external CSV parser. See
-         * [this example](https://jsfiddle.net/highcharts/u59176h4/) of parsing
-         * CSV through the MIT licensed [Papa Parse](http://papaparse.com/)
-         * library.
+        /* *
          *
-         * @sample {highcharts} highcharts/data/csv/
-         *         Data from CSV
+         *  Functions
          *
-         * @type      {string}
-         * @since     4.0
-         * @apioption data.csv
-         */
+         * */
         /**
-         * Which of the predefined date formats in Date.prototype.dateFormats
-         * to use to parse date values. Defaults to a best guess based on what
-         * format gives valid and ordered dates. Valid options include: `YYYY/mm/dd`,
-         * `dd/mm/YYYY`, `mm/dd/YYYY`, `dd/mm/YY`, `mm/dd/YY`.
-         *
-         * @see [data.parseDate](#data.parseDate)
-         *
-         * @sample {highcharts} highcharts/data/dateformat-auto/
-         *         Best guess date format
-         *
-         * @type       {string}
-         * @since      4.0
-         * @validvalue ["YYYY/mm/dd", "dd/mm/YYYY", "mm/dd/YYYY", "dd/mm/YYYY",
-         *             "dd/mm/YY", "mm/dd/YY"]
-         * @apioption  data.dateFormat
+         * @private
          */
-        /**
-         * The decimal point used for parsing numbers in the CSV.
-         *
-         * If both this and data.delimiter is set to `undefined`, the parser will
-         * attempt to deduce the decimal point automatically.
+        function getFreeIndexes(numberOfColumns, seriesBuilders) {
+            var freeIndexes = [],
+                freeIndexValues = [];
+            var s,
+                i,
+                referencedIndexes;
+            // Add all columns as free
+            for (i = 0; i < numberOfColumns; i = i + 1) {
+                freeIndexes.push(true);
+            }
+            // Loop all defined builders and remove their referenced columns
+            for (s = 0; s < seriesBuilders.length; s = s + 1) {
+                referencedIndexes = seriesBuilders[s].getReferencedColumnIndexes();
+                for (i = 0; i < referencedIndexes.length; i = i + 1) {
+                    freeIndexes[referencedIndexes[i]] = false;
+                }
+            }
+            // Collect the values for the free indexes
+            for (i = 0; i < freeIndexes.length; i = i + 1) {
+                if (freeIndexes[i]) {
+                    freeIndexValues.push(i);
+                }
+            }
+            return freeIndexValues;
+        }
+        function hasURLOption(options) {
+            return Boolean(options &&
+                (options.rowsURL || options.csvURL || options.columnsURL));
+        }
+        /* *
          *
-         * @sample {highcharts} highcharts/data/delimiters/
-         *         Comma as decimal point
+         *  Class
          *
-         * @type      {string}
-         * @default   .
-         * @since     4.1.0
-         * @apioption data.decimalPoint
-         */
+         * */
         /**
-         * In tabular input data, the last column (indexed by 0) to use. Defaults
-         * to the last column containing data.
-         *
-         * @sample {highcharts} highcharts/data/start-end/
-         *         Limited data
+         * The Data class
          *
-         * @type      {number}
-         * @since     4.0
-         * @apioption data.endColumn
-         */
-        /**
-         * In tabular input data, the last row (indexed by 0) to use. Defaults
-         * to the last row containing data.
+         * @requires module:modules/data
          *
-         * @sample {highcharts} highcharts/data/start-end/
-         *         Limited data
+         * @class
+         * @name Highcharts.Data
          *
-         * @type      {number}
-         * @since     4.0.4
-         * @apioption data.endRow
-         */
-        /**
-         * Whether to use the first row in the data set as series names.
+         * @param {Highcharts.DataOptions} dataOptions
          *
-         * @sample {highcharts} highcharts/data/start-end/
-         *         Don't get series names from the CSV
-         * @sample {highstock} highcharts/data/start-end/
-         *         Don't get series names from the CSV
+         * @param {Highcharts.Options} [chartOptions]
          *
-         * @type      {boolean}
-         * @default   true
-         * @since     4.1.0
-         * @product   highcharts highstock gantt
-         * @apioption data.firstRowAsNames
-         */
-        /**
-         * The Google Spreadsheet API key required for access generated at [API Services
-         * / Credentials](https://console.cloud.google.com/apis/credentials). See a
-         * comprehensive tutorial for setting up the key at the
-         * [Hands-On Data Visualization](https://handsondataviz.org/google-sheets-api-key.html)
-         * book website.
-         *
-         * @sample {highcharts} highcharts/data/google-spreadsheet/
-         *         Load a Google Spreadsheet
-         *
-         * @type      {string}
-         * @since     9.2.2
-         * @apioption data.googleAPIKey
-         */
-        /**
-         * The key or `spreadsheetId` value for a Google Spreadsheet to load. See
-         * [developers.google.com](https://developers.google.com/sheets/api/guides/concepts)
-         * for how to find the `spreadsheetId`.
-         *
-         * In order for Google Sheets to load, a valid [googleAPIKey](#data.googleAPIKey)
-         * must also be given.
-         *
-         * @sample {highcharts} highcharts/data/google-spreadsheet/
-         *         Load a Google Spreadsheet
-         *
-         * @type      {string}
-         * @since     4.0
-         * @apioption data.googleSpreadsheetKey
-         */
-        /**
-         * The Google Spreadsheet `range` to use in combination with
-         * [googleSpreadsheetKey](#data.googleSpreadsheetKey). See
-         * [developers.google.com](https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get)
-         * for details.
-         *
-         * If given, it takes precedence over `startColumn`, `endColumn`, `startRow` and
-         * `endRow`.
-         *
-         * @example
-         * googleSpreadsheetRange: 'Fruit Consumption' // Load a named worksheet
-         * googleSpreadsheetRange: 'A:Z' // Load columns A to Z
-         *
-         * @sample {highcharts} highcharts/data/google-spreadsheet/
-         *         Load a Google Spreadsheet
-         *
-         * @type      {string|undefined}
-         * @since     9.2.2
-         * @apioption data.googleSpreadsheetRange
-         */
-        /**
-         * No longer works since v9.2.2, that uses Google Sheets API v4. Instead, use
-         * the [googleSpreadsheetRange](#data.googleSpreadsheetRange) option to load a
-         * specific sheet.
-         *
-         * @deprecated
-         * @type      {string}
-         * @since     4.0
-         * @apioption data.googleSpreadsheetWorksheet
-         */
-        /**
-         * Item or cell delimiter for parsing CSV. Defaults to the tab character
-         * `\t` if a tab character is found in the CSV string, if not it defaults
-         * to `,`.
-         *
-         * If this is set to false or undefined, the parser will attempt to deduce
-         * the delimiter automatically.
-         *
-         * @sample {highcharts} highcharts/data/delimiters/
-         *         Delimiters
-         *
-         * @type      {string}
-         * @since     4.0
-         * @apioption data.itemDelimiter
-         */
-        /**
-         * Line delimiter for parsing CSV.
-         *
-         * @sample {highcharts} highcharts/data/delimiters/
-         *         Delimiters
-         *
-         * @type      {string}
-         * @default   \n
-         * @since     4.0
-         * @apioption data.lineDelimiter
-         */
-        /**
-         * A callback function to access the parsed columns, the two-dimentional
-         * input data array directly, before they are interpreted into series
-         * data and categories. Return `false` to stop completion, or call
-         * `this.complete()` to continue async.
-         *
-         * @see [data.complete](#data.complete)
-         *
-         * @sample {highcharts} highcharts/data/parsed/
-         *         Modify data after parse
-         *
-         * @type      {Highcharts.DataParsedCallbackFunction}
-         * @since     4.0
-         * @apioption data.parsed
-         */
-        /**
-         * A callback function to parse string representations of dates into
-         * JavaScript timestamps. Should return an integer timestamp on success.
-         *
-         * @see [dateFormat](#data.dateFormat)
-         *
-         * @type      {Highcharts.DataParseDateCallbackFunction}
-         * @since     4.0
-         * @apioption data.parseDate
-         */
-        /**
-         * The same as the columns input option, but defining rows intead of
-         * columns.
-         *
-         * @see [data.columns](#data.columns)
-         *
-         * @sample {highcharts} highcharts/data/rows/
-         *         Data in rows
-         *
-         * @type      {Array<Array<Highcharts.DataValueType>>}
-         * @since     4.0
-         * @apioption data.rows
-         */
-        /**
-         * An array containing dictionaries for each series. A dictionary exists of
-         * Point property names as the key and the CSV column index as the value.
-         *
-         * @sample {highcharts} highcharts/data/seriesmapping-label/
-         *         Label from data set
-         *
-         * @type      {Array<Highcharts.Dictionary<number>>}
-         * @since     4.0.4
-         * @apioption data.seriesMapping
-         */
-        /**
-         * In tabular input data, the first column (indexed by 0) to use.
-         *
-         * @sample {highcharts} highcharts/data/start-end/
-         *         Limited data
-         *
-         * @type      {number}
-         * @default   0
-         * @since     4.0
-         * @apioption data.startColumn
-         */
-        /**
-         * In tabular input data, the first row (indexed by 0) to use.
-         *
-         * @sample {highcharts} highcharts/data/start-end/
-         *         Limited data
-         *
-         * @type      {number}
-         * @default   0
-         * @since     4.0
-         * @apioption data.startRow
-         */
-        /**
-         * Switch rows and columns of the input data, so that `this.columns`
-         * effectively becomes the rows of the data set, and the rows are interpreted
-         * as series.
-         *
-         * @sample {highcharts} highcharts/data/switchrowsandcolumns/
-         *         Switch rows and columns
-         *
-         * @type      {boolean}
-         * @default   false
-         * @since     4.0
-         * @apioption data.switchRowsAndColumns
-         */
-        /**
-         * An HTML table or the id of such to be parsed as input data. Related
-         * options are `startRow`, `endRow`, `startColumn` and `endColumn` to
-         * delimit what part of the table is used.
-         *
-         * @sample {highcharts} highcharts/demo/column-parsed/
-         *         Parsed table
-         *
-         * @type      {string|global.HTMLElement}
-         * @since     4.0
-         * @apioption data.table
-         */
-        /**
-         * An URL to a remote CSV dataset. Will be fetched when the chart is created
-         * using Ajax.
-         *
-         * @sample highcharts/data/livedata-columns
-         *         Categorized bar chart with CSV and live polling
-         * @sample highcharts/data/livedata-csv
-         *         Time based line chart with CSV and live polling
-         *
-         * @type      {string}
-         * @apioption data.csvURL
-         */
-        /**
-         * A URL to a remote JSON dataset, structured as a row array.
-         * Will be fetched when the chart is created using Ajax.
-         *
-         * @sample highcharts/data/livedata-rows
-         *         Rows with live polling
-         *
-         * @type      {string}
-         * @apioption data.rowsURL
-         */
-        /**
-         * A URL to a remote JSON dataset, structured as a column array.
-         * Will be fetched when the chart is created using Ajax.
-         *
-         * @sample highcharts/data/livedata-columns
-         *         Columns with live polling
-         *
-         * @type      {string}
-         * @apioption data.columnsURL
-         */
-        /**
-         * Sets the refresh rate for data polling when importing remote dataset by
-         * setting [data.csvURL](data.csvURL), [data.rowsURL](data.rowsURL),
-         * [data.columnsURL](data.columnsURL), or
-         * [data.googleSpreadsheetKey](data.googleSpreadsheetKey).
-         *
-         * Note that polling must be enabled by setting
-         * [data.enablePolling](data.enablePolling) to true.
-         *
-         * The value is the number of seconds between pollings.
-         * It cannot be set to less than 1 second.
-         *
-         * @sample highcharts/demo/live-data
-         *         Live data with user set refresh rate
-         *
-         * @default   1
-         * @type      {number}
-         * @apioption data.dataRefreshRate
-         */
-        /**
-         * Enables automatic refetching of remote datasets every _n_ seconds (defined by
-         * setting [data.dataRefreshRate](data.dataRefreshRate)).
-         *
-         * Only works when either [data.csvURL](data.csvURL),
-         * [data.rowsURL](data.rowsURL), [data.columnsURL](data.columnsURL), or
-         * [data.googleSpreadsheetKey](data.googleSpreadsheetKey).
-         *
-         * @sample highcharts/demo/live-data
-         *         Live data
-         * @sample highcharts/data/livedata-columns
-         *         Categorized bar chart with CSV and live polling
-         *
-         * @type      {boolean}
-         * @default   false
-         * @apioption data.enablePolling
-         */
-        /* eslint-disable valid-jsdoc */
-        /**
-         * The Data class
-         *
-         * @requires module:modules/data
-         *
-         * @class
-         * @name Highcharts.Data
-         *
-         * @param {Highcharts.DataOptions} dataOptions
-         *
-         * @param {Highcharts.Options} [chartOptions]
-         *
-         * @param {Highcharts.Chart} [chart]
+         * @param {Highcharts.Chart} [chart]
          */
         var Data = /** @class */ (function () {
                 /* *
@@ -750,25 +334,22 @@
                  *
                  * */
                 function Data(dataOptions, chartOptions, chart) {
-                    this.chart = void 0;
-                this.chartOptions = void 0;
-                this.firstRowAsNames = void 0;
-                this.rawColumns = void 0;
-                this.options = void 0;
-                /**
-                 * A collection of available date formats, extendable from the outside to
-                 * support custom date formats.
-                 *
-                 * @name Highcharts.Data#dateFormats
-                 * @type {Highcharts.Dictionary<Highcharts.DataDateFormatObject>}
-                 */
-                this.dateFormats = {
-                    'YYYY/mm/dd': {
-                        regex: /^([0-9]{4})[\-\/\.]([0-9]{1,2})[\-\/\.]([0-9]{1,2})$/,
-                        parser: function (match) {
-                            return (match ?
-                                Date.UTC(+match[1], match[2] - 1, +match[3]) :
-                                NaN);
+                    if (chartOptions === void 0) { chartOptions = {}; }
+                    this.rowsToColumns = Data.rowsToColumns; // backwards compatibility
+                    /**
+                     * A collection of available date formats, extendable from the outside to
+                     * support custom date formats.
+                     *
+                     * @name Highcharts.Data#dateFormats
+                     * @type {Highcharts.Dictionary<Highcharts.DataDateFormatObject>}
+                     */
+                    this.dateFormats = {
+                        'YYYY/mm/dd': {
+                            regex: /^([0-9]{4})[\-\/\.]([0-9]{1,2})[\-\/\.]([0-9]{1,2})$/,
+                            parser: function (match) {
+                                return (match ?
+                                    Date.UTC(+match[1], match[2] - 1, +match[3]) :
+                                    NaN);
                         }
                     },
                     'dd/mm/YYYY': {
@@ -794,8 +375,8 @@
                             if (!match) {
                                 return NaN;
                             }
-                            var year = +match[3],
-                                d = new Date();
+                            var d = new Date();
+                            var year = +match[3];
                             if (year > (d.getFullYear() - 2000)) {
                                 year += 1900;
                             }
@@ -815,8 +396,52 @@
                         }
                     }
                 };
+                this.chart = chart;
+                this.chartOptions = chartOptions;
+                this.options = dataOptions;
+                this.rawColumns = [];
                 this.init(dataOptions, chartOptions, chart);
             }
+            /* *
+             *
+             *  Static Properties
+             *
+             * */
+            /**
+             * Creates a data object to parse data for a chart.
+             *
+             * @function Highcharts.data
+             */
+            Data.data = function (dataOptions, chartOptions, chart) {
+                if (chartOptions === void 0) { chartOptions = {}; }
+                return new Data(dataOptions, chartOptions, chart);
+            };
+            /**
+             * Reorganize rows into columns.
+             *
+             * @function Highcharts.Data.rowsToColumns
+             */
+            Data.rowsToColumns = function (rows) {
+                var row,
+                    rowsLength,
+                    col,
+                    colsLength,
+                    columns;
+                if (rows) {
+                    columns = [];
+                    rowsLength = rows.length;
+                    for (row = 0; row < rowsLength; row++) {
+                        colsLength = rows[row].length;
+                        for (col = 0; col < colsLength; col++) {
+                            if (!columns[col]) {
+                                columns[col] = [];
+                            }
+                            columns[col][row] = rows[row][col];
+                        }
+                    }
+                }
+                return columns;
+            };
             /* *
              *
              *  Functions
@@ -828,8 +453,8 @@
              * @private
              * @function Highcharts.Data#init
              */
-            Data.prototype.init = function (options, chartOptions, chart) {
-                var decimalPoint = options.decimalPoint,
+            Data.prototype.init = function (dataOptions, chartOptions, chart) {
+                var decimalPoint = dataOptions.decimalPoint,
                     hasData;
                 if (chartOptions) {
                     this.chartOptions = chartOptions;
@@ -840,13 +465,17 @@
                 if (decimalPoint !== '.' && decimalPoint !== ',') {
                     decimalPoint = void 0;
                 }
-                this.options = options;
-                this.columns = (options.columns ||
-                    this.rowsToColumns(options.rows) ||
+                this.options = dataOptions;
+                this.columns = (dataOptions.columns ||
+                    this.rowsToColumns(dataOptions.rows) ||
                     []);
-                this.firstRowAsNames = pick(options.firstRowAsNames, this.firstRowAsNames, true);
+                this.firstRowAsNames = pick(dataOptions.firstRowAsNames, this.firstRowAsNames, true);
                 this.decimalRegex = (decimalPoint &&
                     new RegExp('^(-?[0-9]+)' + decimalPoint + '([0-9]+)$'));
+                // Always stop old polling when we have new options
+                if (this.liveDataTimeout !== void 0) {
+                    clearTimeout(this.liveDataTimeout);
+                }
                 // This is a two-dimensional array holding the raw, trimmed string
                 // values with the same organisation as the columns array. It makes it
                 // possible for example to revert from interpreted timestamps to
@@ -855,11 +484,7 @@
                 // No need to parse or interpret anything
                 if (this.columns.length) {
                     this.dataFound();
-                    hasData = true;
-                }
-                if (this.hasURLOption(options)) {
-                    clearTimeout(this.liveDataTimeout);
-                    hasData = false;
+                    hasData = !hasURLOption(dataOptions);
                 }
                 if (!hasData) {
                     // Fetch live data
@@ -878,14 +503,10 @@
                     // Parse a Google Spreadsheet
                     hasData = this.parseGoogleSpreadsheet();
                 }
-                if (!hasData && options.afterComplete) {
-                    options.afterComplete();
+                if (!hasData && dataOptions.afterComplete) {
+                    dataOptions.afterComplete();
                 }
             };
-            Data.prototype.hasURLOption = function (options) {
-                return Boolean(options &&
-                    (options.rowsURL || options.csvURL || options.columnsURL));
-            };
             /**
              * Get the column distribution. For example, a line series takes a single
              * column for Y values. A range series takes two columns for low and high
@@ -903,7 +524,7 @@
                     return seriesTypes[type || 'line'].prototype.pointArrayMap;
                 }, globalType = (chartOptions &&
                     chartOptions.chart &&
-                    chartOptions.chart.type), individualCounts = [], seriesBuilders = [], seriesIndex = 0, 
+                    chartOptions.chart.type), individualCounts = [], seriesBuilders = [], 
                 // If no series mapping is defined, check if the series array is
                 // defined with types.
                 seriesMapping = ((options && options.seriesMapping) ||
@@ -912,7 +533,9 @@
                         chartOptions.series.map(function () {
                             return { x: 0 };
                         })) ||
-                    []), i;
+                    []);
+                var seriesIndex = 0,
+                    i;
                 ((chartOptions && chartOptions.series) || []).forEach(function (series) {
                     individualCounts.push(getValueCount(series.type || globalType));
                 });
@@ -1003,12 +626,8 @@
              * @function Highcharts.Data#parseCSV
              */
             Data.prototype.parseCSV = function (inOptions) {
-                var self = this, options = inOptions || this.options, csv = options.csv, columns, startRow = (typeof options.startRow !== 'undefined' && options.startRow ?
-                        options.startRow :
-                        0), endRow = options.endRow || Number.MAX_VALUE, startColumn = (typeof options.startColumn !== 'undefined' &&
-                        options.startColumn) ? options.startColumn : 0, endColumn = options.endColumn || Number.MAX_VALUE, itemDelimiter, lines, rowIt = 0, 
-                    // activeRowNo = 0,
-                    dataTypes = [], 
+                var self = this, columns = this.columns = [], options = inOptions || this.options, startColumn = (typeof options.startColumn !== 'undefined' &&
+                        options.startColumn) ? options.startColumn : 0, endColumn = options.endColumn || Number.MAX_VALUE, dataTypes = [], 
                     // We count potential delimiters in the prepass, and use the
                     // result as the basis of half-intelligent guesses.
                     potDelimiters = {
@@ -1016,7 +635,15 @@
                         ';': 0,
                         '\t': 0
                     };
-                columns = this.columns = [];
+                var csv = options.csv,
+                    startRow = (typeof options.startRow !== 'undefined' && options.startRow ?
+                        options.startRow :
+                        0),
+                    endRow = options.endRow || Number.MAX_VALUE,
+                    itemDelimiter,
+                    lines, 
+                    // activeRowNo = 0,
+                    rowIt = 0;
                 /*
                     This implementation is quite verbose. It will be shortened once
                     it's stable and passes all the test.
@@ -1258,14 +885,14 @@
                  */
                 function deduceDateFormat(data, limit) {
                     var format = 'YYYY/mm/dd',
-                        thing,
+                        stable = [],
+                        max = [];
+                    var thing,
                         guessedFormat = [],
                         calculatedFormat,
                         i = 0,
                         madeDeduction = false, 
                         // candidates = {},
-                        stable = [],
-                        max = [],
                         j;
                     if (!limit || limit > data.length) {
                         limit = data.length;
@@ -1439,13 +1066,13 @@
              */
             Data.prototype.parseTable = function () {
                 var options = this.options,
-                    table = options.table,
                     columns = this.columns || [],
                     startRow = options.startRow || 0,
                     endRow = options.endRow || Number.MAX_VALUE,
                     startColumn = options.startColumn || 0,
                     endColumn = options.endColumn || Number.MAX_VALUE;
-                if (table) {
+                if (options.table) {
+                    var table = options.table;
                     if (typeof table === 'string') {
                         table = doc.getElementById(table);
                     }
@@ -1490,11 +1117,11 @@
                     chart = this.chart,
                     options = this.options,
                     maxRetries = 3,
-                    currentRetries = 0,
                     pollingEnabled = options.enablePolling,
-                    updateIntervalMs = (options.dataRefreshRate || 2) * 1000,
                     originalOptions = merge(options);
-                if (!this.hasURLOption(options)) {
+                var currentRetries = 0,
+                    updateIntervalMs = (options.dataRefreshRate || 2) * 1000;
+                if (!hasURLOption(options)) {
                     return false;
                 }
                 // Do not allow polling more than once a second
@@ -1578,7 +1205,7 @@
                     }
                 }
                 performFetch(true);
-                return this.hasURLOption(options);
+                return hasURLOption(options);
             };
             /**
              * Parse a Google spreadsheet.
@@ -1609,7 +1236,7 @@
                     if (defined(options.endRow)) {
                         end += options.endRow + 1;
                     }
-                    return start + ":" + end;
+                    return "" + start + ":".concat(end);
                 };
                 /**
                  * Fetch the actual spreadsheet using XMLHttpRequest.
@@ -1633,7 +1260,7 @@
                         success: function (json) {
                             fn(json);
                             if (options.enablePolling) {
-                                setTimeout(function () {
+                                data.liveDataTimeout = setTimeout(function () {
                                     fetchSheet(fn);
                                 }, refreshRate);
                             }
@@ -1712,8 +1339,8 @@
              * @function Highcharts.Data#parseTypes
              */
             Data.prototype.parseTypes = function () {
-                var columns = this.columns,
-                    col = columns.length;
+                var columns = this.columns || [];
+                var col = columns.length;
                 while (col--) {
                     this.parseColumn(columns[col], col);
                 }
@@ -1732,23 +1359,24 @@
             Data.prototype.parseColumn = function (column, col) {
                 var rawColumns = this.rawColumns,
                     columns = this.columns,
-                    row = column.length,
-                    val,
-                    floatVal,
-                    trimVal,
-                    trimInsideVal,
                     firstRowAsNames = this.firstRowAsNames,
                     isXColumn = this.valueCount.xColumns.indexOf(col) !== -1,
-                    dateVal,
                     backup = [],
-                    diff,
                     chartOptions = this.chartOptions,
-                    descending,
                     columnTypes = this.options.columnTypes || [],
                     columnType = columnTypes[col],
                     forceCategory = isXColumn && ((chartOptions &&
                         chartOptions.xAxis &&
-                        splat(chartOptions.xAxis)[0].type === 'category') || columnType === 'string');
+                        splat(chartOptions.xAxis)[0].type === 'category') || columnType === 'string'),
+                    columnHasName = defined(column.name);
+                var row = column.length,
+                    val,
+                    floatVal,
+                    trimVal,
+                    trimInsideVal,
+                    dateVal,
+                    diff,
+                    descending;
                 if (!rawColumns[col]) {
                     rawColumns[col] = [];
                 }
@@ -1763,7 +1391,8 @@
                     }
                     // Disable number or date parsing by setting the X axis type to
                     // category
-                    if (forceCategory || (row === 0 && firstRowAsNames)) {
+                    if (forceCategory ||
+                        (row === 0 && firstRowAsNames && !columnHasName)) {
                         column[row] = '' + trimVal;
                     }
                     else if (+trimInsideVal === floatVal) { // is numeric
@@ -1910,32 +1539,6 @@
                 }
                 return ret;
             };
-            /**
-             * Reorganize rows into columns.
-             *
-             * @function Highcharts.Data#rowsToColumns
-             */
-            Data.prototype.rowsToColumns = function (rows) {
-                var row,
-                    rowsLength,
-                    col,
-                    colsLength,
-                    columns;
-                if (rows) {
-                    columns = [];
-                    rowsLength = rows.length;
-                    for (row = 0; row < rowsLength; row++) {
-                        colsLength = rows[row].length;
-                        for (col = 0; col < colsLength; col++) {
-                            if (!columns[col]) {
-                                columns[col] = [];
-                            }
-                            columns[col][row] = rows[row][col];
-                        }
-                    }
-                }
-                return columns;
-            };
             /**
              * Get the parsed data in a form that we can apply directly to the
              * `series.data` config. Array positions can be mapped using the
@@ -1965,35 +1568,6 @@
                     return this.options.parsed.call(this, this.columns);
                 }
             };
-            /**
-             * @private
-             * @function Highcharts.Data#getFreeIndexes
-             */
-            Data.prototype.getFreeIndexes = function (numberOfColumns, seriesBuilders) {
-                var s,
-                    i,
-                    freeIndexes = [],
-                    freeIndexValues = [],
-                    referencedIndexes;
-                // Add all columns as free
-                for (i = 0; i < numberOfColumns; i = i + 1) {
-                    freeIndexes.push(true);
-                }
-                // Loop all defined builders and remove their referenced columns
-                for (s = 0; s < seriesBuilders.length; s = s + 1) {
-                    referencedIndexes = seriesBuilders[s].getReferencedColumnIndexes();
-                    for (i = 0; i < referencedIndexes.length; i = i + 1) {
-                        freeIndexes[referencedIndexes[i]] = false;
-                    }
-                }
-                // Collect the values for the free indexes
-                for (i = 0; i < freeIndexes.length; i = i + 1) {
-                    if (freeIndexes[i]) {
-                        freeIndexValues.push(i);
-                    }
-                }
-                return freeIndexValues;
-            };
             /**
              * If a complete callback function is provided in the options, interpret the
              * columns into a Highcharts options object.
@@ -2003,8 +1577,9 @@
             Data.prototype.complete = function () {
                 var columns = this.columns,
                     xColumns = [],
-                    type,
                     options = this.options,
+                    allSeriesBuilders = [];
+                var type,
                     series,
                     data,
                     i,
@@ -2012,7 +1587,6 @@
                     r,
                     seriesIndex,
                     chartOptions,
-                    allSeriesBuilders = [],
                     builder,
                     freeIndexes,
                     typeCol,
@@ -2030,7 +1604,7 @@
                     }
                     // Use the next columns for series
                     series = [];
-                    freeIndexes = this.getFreeIndexes(columns.length, this.valueCount.seriesBuilders);
+                    freeIndexes = getFreeIndexes(columns.length, this.valueCount.seriesBuilders);
                     // Populate defined series
                     for (seriesIndex = 0; seriesIndex < this.valueCount.seriesBuilders.length; seriesIndex++) {
                         builder = this.valueCount.seriesBuilders[seriesIndex];
@@ -2137,7 +1711,8 @@
              * @param {boolean} [redraw=true]
              */
             Data.prototype.update = function (options, redraw) {
-                var chart = this.chart;
+                var chart = this.chart,
+                    chartOptions = chart.options;
                 if (options) {
                     // Set the complete handler
                     options.afterComplete = function (dataOptions) {
@@ -2156,223 +1731,708 @@
                         }
                     };
                     // Apply it
-                    merge(true, chart.options.data, options);
-                    this.init(chart.options.data);
+                    merge(true, chartOptions.data, options);
+                    // Reset columns if fetching spreadsheet, to force a re-fetch
+                    if (chartOptions.data && chartOptions.data.googleSpreadsheetKey &&
+                        !options.columns) {
+                        delete chartOptions.data.columns;
+                    }
+                    this.init(chartOptions.data);
                 }
             };
             return Data;
         }());
-        // Register the Data prototype and data function on Highcharts
-        // Highcharts.Data = Data as any;
+        // Extend Chart.init so that the Chart constructor accepts a new configuration
+        // option group, data.
+        addEvent(Chart, 'init', function (e) {
+            var chart = this,
+                callback = e.args[1],
+                defaultDataOptions = getOptions().data;
+            var userOptions = (e.args[0] || {});
+            if ((defaultDataOptions || userOptions && userOptions.data) &&
+                !chart.hasDataDef) {
+                chart.hasDataDef = true;
+                /**
+                 * The data parser for this chart.
+                 *
+                 * @name Highcharts.Chart#data
+                 * @type {Highcharts.Data|undefined}
+                 */
+                var dataOptions = merge(defaultDataOptions,
+                    userOptions.data);
+                chart.data = new Data(extend(dataOptions, {
+                    afterComplete: function (dataOptions) {
+                        var i,
+                            series;
+                        // Merge series configs
+                        if (Object.hasOwnProperty.call(userOptions, 'series')) {
+                            if (typeof userOptions.series === 'object') {
+                                i = Math.max(userOptions.series.length, dataOptions && dataOptions.series ?
+                                    dataOptions.series.length :
+                                    0);
+                                while (i--) {
+                                    series = userOptions.series[i] || {};
+                                    userOptions.series[i] = merge(series, dataOptions && dataOptions.series ?
+                                        dataOptions.series[i] :
+                                        {});
+                                }
+                            }
+                            else { // Allow merging in dataOptions.series (#2856)
+                                delete userOptions.series;
+                            }
+                        }
+                        // Do the merge
+                        userOptions = merge(dataOptions, userOptions);
+                        // Run chart.init again
+                        chart.init(userOptions, callback);
+                    }
+                }), userOptions, chart);
+                e.preventDefault();
+            }
+        });
+        /**
+         * Creates a new SeriesBuilder. A SeriesBuilder consists of a number
+         * of ColumnReaders that reads columns and give them a name.
+         * Ex: A series builder can be constructed to read column 3 as 'x' and
+         * column 7 and 8 as 'y1' and 'y2'.
+         * The output would then be points/rows of the form {x: 11, y1: 22, y2: 33}
+         *
+         * The name of the builder is taken from the second column. In the above
+         * example it would be the column with index 7.
+         *
+         * @private
+         * @class
+         * @name SeriesBuilder
+         */
+        var SeriesBuilder = /** @class */ (function () {
+                function SeriesBuilder() {
+                    /* eslint-disable no-invalid-this */
+                    this.readers = [];
+                this.pointIsArray = true;
+            }
+            /**
+             * Populates readers with column indexes. A reader can be added without
+             * a specific index and for those readers the index is taken sequentially
+             * from the free columns (this is handled by the ColumnCursor instance).
+             *
+             * @function SeriesBuilder#populateColumns
+             */
+            SeriesBuilder.prototype.populateColumns = function (freeIndexes) {
+                var builder = this;
+                var enoughColumns = true;
+                // Loop each reader and give it an index if its missing.
+                // The freeIndexes.shift() will return undefined if there
+                // are no more columns.
+                builder.readers.forEach(function (reader) {
+                    if (typeof reader.columnIndex === 'undefined') {
+                        reader.columnIndex = freeIndexes.shift();
+                    }
+                });
+                // Now, all readers should have columns mapped. If not
+                // then return false to signal that this series should
+                // not be added.
+                builder.readers.forEach(function (reader) {
+                    if (typeof reader.columnIndex === 'undefined') {
+                        enoughColumns = false;
+                    }
+                });
+                return enoughColumns;
+            };
+            /**
+             * Reads a row from the dataset and returns a point or array depending
+             * on the names of the readers.
+             *
+             * @function SeriesBuilder#read<T>
+             */
+            SeriesBuilder.prototype.read = function (columns, rowIndex) {
+                var builder = this,
+                    pointIsArray = builder.pointIsArray,
+                    point = pointIsArray ? [] : {};
+                var columnIndexes;
+                // Loop each reader and ask it to read its value.
+                // Then, build an array or point based on the readers names.
+                builder.readers.forEach(function (reader) {
+                    var value = columns[reader.columnIndex][rowIndex];
+                    if (pointIsArray) {
+                        point.push(value);
+                    }
+                    else {
+                        if (reader.configName.indexOf('.') > 0) {
+                            // Handle nested property names
+                            Point.prototype.setNestedProperty(point, value, reader.configName);
+                        }
+                        else {
+                            point[reader.configName] = value;
+                        }
+                    }
+                });
+                // The name comes from the first column (excluding the x column)
+                if (typeof this.name === 'undefined' && builder.readers.length >= 2) {
+                    columnIndexes = builder.getReferencedColumnIndexes();
+                    if (columnIndexes.length >= 2) {
+                        // remove the first one (x col)
+                        columnIndexes.shift();
+                        // Sort the remaining
+                        columnIndexes.sort(function (a, b) {
+                            return a - b;
+                        });
+                        // Now use the lowest index as name column
+                        this.name = columns[columnIndexes.shift()].name;
+                    }
+                }
+                return point;
+            };
+            /**
+             * Creates and adds ColumnReader from the given columnIndex and configName.
+             * ColumnIndex can be undefined and in that case the reader will be given
+             * an index when columns are populated.
+             *
+             * @function SeriesBuilder#addColumnReader
+             */
+            SeriesBuilder.prototype.addColumnReader = function (columnIndex, configName) {
+                this.readers.push({
+                    columnIndex: columnIndex,
+                    configName: configName
+                });
+                if (!(configName === 'x' ||
+                    configName === 'y' ||
+                    typeof configName === 'undefined')) {
+                    this.pointIsArray = false;
+                }
+            };
+            /**
+             * Returns an array of column indexes that the builder will use when
+             * reading data.
+             *
+             * @function SeriesBuilder#getReferencedColumnIndexes
+             */
+            SeriesBuilder.prototype.getReferencedColumnIndexes = function () {
+                var referencedColumnIndexes = [];
+                var i,
+                    columnReader;
+                for (i = 0; i < this.readers.length; i = i + 1) {
+                    columnReader = this.readers[i];
+                    if (typeof columnReader.columnIndex !== 'undefined') {
+                        referencedColumnIndexes.push(columnReader.columnIndex);
+                    }
+                }
+                return referencedColumnIndexes;
+            };
+            /**
+             * Returns true if the builder has a reader for the given configName.
+             *
+             * @function SeriesBuider#hasReader
+             */
+            SeriesBuilder.prototype.hasReader = function (configName) {
+                var i,
+                    columnReader;
+                for (i = 0; i < this.readers.length; i = i + 1) {
+                    columnReader = this.readers[i];
+                    if (columnReader.configName === configName) {
+                        return true;
+                    }
+                }
+                // Else return undefined
+            };
+            return SeriesBuilder;
+        }());
+        /* *
+         *
+         *  Default Export
+         *
+         * */
+        /* *
+         *
+         *  API Declarations
+         *
+         * */
+        /**
+         * Callback function to modify the CSV before parsing it by the data module.
+         *
+         * @callback Highcharts.DataBeforeParseCallbackFunction
+         *
+         * @param {string} csv
+         *        The CSV to modify.
+         *
+         * @return {string}
+         *         The CSV to parse.
+         */
+        /**
+         * Callback function that gets called after parsing data.
+         *
+         * @callback Highcharts.DataCompleteCallbackFunction
+         *
+         * @param {Highcharts.Options} chartOptions
+         *        The chart options that were used.
+         */
+        /**
+         * Callback function that returns the correspondig Date object to a match.
+         *
+         * @callback Highcharts.DataDateFormatCallbackFunction
+         *
+         * @param {Array<number>} match
+         *
+         * @return {number}
+         */
+        /**
+         * Structure for alternative date formats to parse.
+         *
+         * @interface Highcharts.DataDateFormatObject
+         */ /**
+        * @name Highcharts.DataDateFormatObject#alternative
+        * @type {string|undefined}
+        */ /**
+        * @name Highcharts.DataDateFormatObject#parser
+        * @type {Highcharts.DataDateFormatCallbackFunction}
+        */ /**
+        * @name Highcharts.DataDateFormatObject#regex
+        * @type {global.RegExp}
+        */
+        /**
+         * Possible types for a data item in a column or row.
+         *
+         * @typedef {number|string|null} Highcharts.DataValueType
+         */
+        /**
+         * Callback function to parse string representations of dates into
+         * JavaScript timestamps (milliseconds since 1.1.1970).
+         *
+         * @callback Highcharts.DataParseDateCallbackFunction
+         *
+         * @param {string} dateValue
+         *
+         * @return {number}
+         *         Timestamp (milliseconds since 1.1.1970) as integer for Date class.
+         */
+        /**
+         * Callback function to access the parsed columns, the two-dimentional
+         * input data array directly, before they are interpreted into series
+         * data and categories.
+         *
+         * @callback Highcharts.DataParsedCallbackFunction
+         *
+         * @param {Array<Array<*>>} columns
+         *        The parsed columns by the data module.
+         *
+         * @return {boolean|undefined}
+         *         Return `false` to stop completion, or call `this.complete()` to
+         *         continue async.
+         */
+        /* *
+         *
+         *  API Options
+         *
+         * */
+        /**
+         * The Data module provides a simplified interface for adding data to
+         * a chart from sources like CVS, HTML tables or grid views. See also
+         * the [tutorial article on the Data module](
+         * https://www.highcharts.com/docs/working-with-data/data-module).
+         *
+         * It requires the `modules/data.js` file to be loaded.
+         *
+         * Please note that the default way of adding data in Highcharts, without
+         * the need of a module, is through the [series._type_.data](#series.line.data)
+         * option.
+         *
+         * @sample {highcharts} highcharts/demo/column-parsed/
+         *         HTML table
+         * @sample {highcharts} highcharts/data/csv/
+         *         CSV
+         *
+         * @since     4.0
+         * @requires  modules/data
+         * @apioption data
+         */
+        /**
+         * A callback function to modify the CSV before parsing it. Return the modified
+         * string.
+         *
+         * @sample {highcharts} highcharts/demo/line-ajax/
+         *         Modify CSV before parse
+         *
+         * @type      {Highcharts.DataBeforeParseCallbackFunction}
+         * @since     6.1
+         * @apioption data.beforeParse
+         */
+        /**
+         * A two-dimensional array representing the input data on tabular form.
+         * This input can be used when the data is already parsed, for example
+         * from a grid view component. Each cell can be a string or number.
+         * If not switchRowsAndColumns is set, the columns are interpreted as
+         * series.
+         *
+         * @see [data.rows](#data.rows)
+         *
+         * @sample {highcharts} highcharts/data/columns/
+         *         Columns
+         *
+         * @type      {Array<Array<Highcharts.DataValueType>>}
+         * @since     4.0
+         * @apioption data.columns
+         */
+        /**
+         * The callback that is evaluated when the data is finished loading,
+         * optionally from an external source, and parsed. The first argument
+         * passed is a finished chart options object, containing the series.
+         * These options can be extended with additional options and passed
+         * directly to the chart constructor.
+         *
+         * @see [data.parsed](#data.parsed)
+         *
+         * @sample {highcharts} highcharts/data/complete/
+         *         Modify data on complete
+         *
+         * @type      {Highcharts.DataCompleteCallbackFunction}
+         * @since     4.0
+         * @apioption data.complete
+         */
+        /**
+         * A comma delimited string to be parsed. Related options are [startRow](
+         * #data.startRow), [endRow](#data.endRow), [startColumn](#data.startColumn)
+         * and [endColumn](#data.endColumn) to delimit what part of the table
+         * is used. The [lineDelimiter](#data.lineDelimiter) and [itemDelimiter](
+         * #data.itemDelimiter) options define the CSV delimiter formats.
+         *
+         * The built-in CSV parser doesn't support all flavours of CSV, so in
+         * some cases it may be necessary to use an external CSV parser. See
+         * [this example](https://jsfiddle.net/highcharts/u59176h4/) of parsing
+         * CSV through the MIT licensed [Papa Parse](http://papaparse.com/)
+         * library.
+         *
+         * @sample {highcharts} highcharts/data/csv/
+         *         Data from CSV
+         *
+         * @type      {string}
+         * @since     4.0
+         * @apioption data.csv
+         */
+        /**
+         * Which of the predefined date formats in Date.prototype.dateFormats
+         * to use to parse date values. Defaults to a best guess based on what
+         * format gives valid and ordered dates. Valid options include: `YYYY/mm/dd`,
+         * `dd/mm/YYYY`, `mm/dd/YYYY`, `dd/mm/YY`, `mm/dd/YY`.
+         *
+         * @see [data.parseDate](#data.parseDate)
+         *
+         * @sample {highcharts} highcharts/data/dateformat-auto/
+         *         Best guess date format
+         *
+         * @type       {string}
+         * @since      4.0
+         * @validvalue ["YYYY/mm/dd", "dd/mm/YYYY", "mm/dd/YYYY", "dd/mm/YYYY",
+         *             "dd/mm/YY", "mm/dd/YY"]
+         * @apioption  data.dateFormat
+         */
+        /**
+         * The decimal point used for parsing numbers in the CSV.
+         *
+         * If both this and data.delimiter is set to `undefined`, the parser will
+         * attempt to deduce the decimal point automatically.
+         *
+         * @sample {highcharts} highcharts/data/delimiters/
+         *         Comma as decimal point
+         *
+         * @type      {string}
+         * @default   .
+         * @since     4.1.0
+         * @apioption data.decimalPoint
+         */
+        /**
+         * In tabular input data, the last column (indexed by 0) to use. Defaults
+         * to the last column containing data.
+         *
+         * @sample {highcharts} highcharts/data/start-end/
+         *         Limited data
+         *
+         * @type      {number}
+         * @since     4.0
+         * @apioption data.endColumn
+         */
+        /**
+         * In tabular input data, the last row (indexed by 0) to use. Defaults
+         * to the last row containing data.
+         *
+         * @sample {highcharts} highcharts/data/start-end/
+         *         Limited data
+         *
+         * @type      {number}
+         * @since     4.0.4
+         * @apioption data.endRow
+         */
+        /**
+         * Whether to use the first row in the data set as series names.
+         *
+         * @sample {highcharts} highcharts/data/start-end/
+         *         Don't get series names from the CSV
+         * @sample {highstock} highcharts/data/start-end/
+         *         Don't get series names from the CSV
+         *
+         * @type      {boolean}
+         * @default   true
+         * @since     4.1.0
+         * @product   highcharts highstock gantt
+         * @apioption data.firstRowAsNames
+         */
+        /**
+         * The Google Spreadsheet API key required for access generated at [API Services
+         * / Credentials](https://console.cloud.google.com/apis/credentials). See a
+         * comprehensive tutorial for setting up the key at the
+         * [Hands-On Data Visualization](https://handsondataviz.org/google-sheets-api-key.html)
+         * book website.
+         *
+         * @sample {highcharts} highcharts/data/google-spreadsheet/
+         *         Load a Google Spreadsheet
+         *
+         * @type      {string}
+         * @since     9.2.2
+         * @apioption data.googleAPIKey
+         */
+        /**
+         * The key or `spreadsheetId` value for a Google Spreadsheet to load. See
+         * [developers.google.com](https://developers.google.com/sheets/api/guides/concepts)
+         * for how to find the `spreadsheetId`.
+         *
+         * In order for Google Sheets to load, a valid [googleAPIKey](#data.googleAPIKey)
+         * must also be given.
+         *
+         * @sample {highcharts} highcharts/data/google-spreadsheet/
+         *         Load a Google Spreadsheet
+         *
+         * @type      {string}
+         * @since     4.0
+         * @apioption data.googleSpreadsheetKey
+         */
+        /**
+         * The Google Spreadsheet `range` to use in combination with
+         * [googleSpreadsheetKey](#data.googleSpreadsheetKey). See
+         * [developers.google.com](https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get)
+         * for details.
+         *
+         * If given, it takes precedence over `startColumn`, `endColumn`, `startRow` and
+         * `endRow`.
+         *
+         * @example
+         * googleSpreadsheetRange: 'Fruit Consumption' // Load a named worksheet
+         * googleSpreadsheetRange: 'A:Z' // Load columns A to Z
+         *
+         * @sample {highcharts} highcharts/data/google-spreadsheet/
+         *         Load a Google Spreadsheet
+         *
+         * @type      {string|undefined}
+         * @since     9.2.2
+         * @apioption data.googleSpreadsheetRange
+         */
+        /**
+         * No longer works since v9.2.2, that uses Google Sheets API v4. Instead, use
+         * the [googleSpreadsheetRange](#data.googleSpreadsheetRange) option to load a
+         * specific sheet.
+         *
+         * @deprecated
+         * @type      {string}
+         * @since     4.0
+         * @apioption data.googleSpreadsheetWorksheet
+         */
+        /**
+         * Item or cell delimiter for parsing CSV. Defaults to the tab character
+         * `\t` if a tab character is found in the CSV string, if not it defaults
+         * to `,`.
+         *
+         * If this is set to false or undefined, the parser will attempt to deduce
+         * the delimiter automatically.
+         *
+         * @sample {highcharts} highcharts/data/delimiters/
+         *         Delimiters
+         *
+         * @type      {string}
+         * @since     4.0
+         * @apioption data.itemDelimiter
+         */
+        /**
+         * Line delimiter for parsing CSV.
+         *
+         * @sample {highcharts} highcharts/data/delimiters/
+         *         Delimiters
+         *
+         * @type      {string}
+         * @default   \n
+         * @since     4.0
+         * @apioption data.lineDelimiter
+         */
+        /**
+         * A callback function to access the parsed columns, the two-dimentional
+         * input data array directly, before they are interpreted into series
+         * data and categories. Return `false` to stop completion, or call
+         * `this.complete()` to continue async.
+         *
+         * @see [data.complete](#data.complete)
+         *
+         * @sample {highcharts} highcharts/data/parsed/
+         *         Modify data after parse
+         *
+         * @type      {Highcharts.DataParsedCallbackFunction}
+         * @since     4.0
+         * @apioption data.parsed
+         */
+        /**
+         * A callback function to parse string representations of dates into
+         * JavaScript timestamps. Should return an integer timestamp on success.
+         *
+         * @see [dateFormat](#data.dateFormat)
+         *
+         * @type      {Highcharts.DataParseDateCallbackFunction}
+         * @since     4.0
+         * @apioption data.parseDate
+         */
+        /**
+         * The same as the columns input option, but defining rows intead of
+         * columns.
+         *
+         * @see [data.columns](#data.columns)
+         *
+         * @sample {highcharts} highcharts/data/rows/
+         *         Data in rows
+         *
+         * @type      {Array<Array<Highcharts.DataValueType>>}
+         * @since     4.0
+         * @apioption data.rows
+         */
+        /**
+         * An array containing dictionaries for each series. A dictionary exists of
+         * Point property names as the key and the CSV column index as the value.
+         *
+         * @sample {highcharts} highcharts/data/seriesmapping-label/
+         *         Label from data set
+         *
+         * @type      {Array<Highcharts.Dictionary<number>>}
+         * @since     4.0.4
+         * @apioption data.seriesMapping
+         */
+        /**
+         * In tabular input data, the first column (indexed by 0) to use.
+         *
+         * @sample {highcharts} highcharts/data/start-end/
+         *         Limited data
+         *
+         * @type      {number}
+         * @default   0
+         * @since     4.0
+         * @apioption data.startColumn
+         */
+        /**
+         * In tabular input data, the first row (indexed by 0) to use.
+         *
+         * @sample {highcharts} highcharts/data/start-end/
+         *         Limited data
+         *
+         * @type      {number}
+         * @default   0
+         * @since     4.0
+         * @apioption data.startRow
+         */
+        /**
+         * Switch rows and columns of the input data, so that `this.columns`
+         * effectively becomes the rows of the data set, and the rows are interpreted
+         * as series.
+         *
+         * @sample {highcharts} highcharts/data/switchrowsandcolumns/
+         *         Switch rows and columns
+         *
+         * @type      {boolean}
+         * @default   false
+         * @since     4.0
+         * @apioption data.switchRowsAndColumns
+         */
         /**
-         * Creates a data object to parse data for a chart.
+         * An HTML table or the id of such to be parsed as input data. Related
+         * options are `startRow`, `endRow`, `startColumn` and `endColumn` to
+         * delimit what part of the table is used.
+         *
+         * @sample {highcharts} highcharts/demo/column-parsed/
+         *         Parsed table
          *
-         * @function Highcharts.data
+         * @type      {string|global.HTMLElement}
+         * @since     4.0
+         * @apioption data.table
          */
-        G.data = function (dataOptions, chartOptions, chart) {
-            return new G.Data(dataOptions, chartOptions, chart);
-        };
-        // Extend Chart.init so that the Chart constructor accepts a new configuration
-        // option group, data.
-        addEvent(Chart, 'init', function (e) {
-            var chart = this, // eslint-disable-line no-invalid-this
-                userOptions = (e.args[0] || {}),
-                callback = e.args[1];
-            if (userOptions && userOptions.data && !chart.hasDataDef) {
-                chart.hasDataDef = true;
-                /**
-                 * The data parser for this chart.
-                 *
-                 * @name Highcharts.Chart#data
-                 * @type {Highcharts.Data|undefined}
-                 */
-                chart.data = new G.Data(extend(userOptions.data, {
-                    afterComplete: function (dataOptions) {
-                        var i,
-                            series;
-                        // Merge series configs
-                        if (Object.hasOwnProperty.call(userOptions, 'series')) {
-                            if (typeof userOptions.series === 'object') {
-                                i = Math.max(userOptions.series.length, dataOptions && dataOptions.series ?
-                                    dataOptions.series.length :
-                                    0);
-                                while (i--) {
-                                    series = userOptions.series[i] || {};
-                                    userOptions.series[i] = merge(series, dataOptions && dataOptions.series ?
-                                        dataOptions.series[i] :
-                                        {});
-                                }
-                            }
-                            else { // Allow merging in dataOptions.series (#2856)
-                                delete userOptions.series;
-                            }
-                        }
-                        // Do the merge
-                        userOptions = merge(dataOptions, userOptions);
-                        // Run chart.init again
-                        chart.init(userOptions, callback);
-                    }
-                }), userOptions, chart);
-                e.preventDefault();
-            }
-        });
         /**
-         * Creates a new SeriesBuilder. A SeriesBuilder consists of a number
-         * of ColumnReaders that reads columns and give them a name.
-         * Ex: A series builder can be constructed to read column 3 as 'x' and
-         * column 7 and 8 as 'y1' and 'y2'.
-         * The output would then be points/rows of the form {x: 11, y1: 22, y2: 33}
+         * An URL to a remote CSV dataset. Will be fetched when the chart is created
+         * using Ajax.
          *
-         * The name of the builder is taken from the second column. In the above
-         * example it would be the column with index 7.
+         * @sample highcharts/data/livedata-columns
+         *         Categorized bar chart with CSV and live polling
+         * @sample highcharts/data/livedata-csv
+         *         Time based line chart with CSV and live polling
          *
-         * @private
-         * @class
-         * @name SeriesBuilder
+         * @type      {string}
+         * @apioption data.csvURL
          */
-        var SeriesBuilder = /** @class */ (function () {
-                function SeriesBuilder() {
-                    /* eslint-disable no-invalid-this */
-                    this.readers = [];
-                this.pointIsArray = true;
-                /* eslint-enable no-invalid-this */
-                this.name = void 0;
-            }
-            /**
-             * Populates readers with column indexes. A reader can be added without
-             * a specific index and for those readers the index is taken sequentially
-             * from the free columns (this is handled by the ColumnCursor instance).
-             *
-             * @function SeriesBuilder#populateColumns
-             */
-            SeriesBuilder.prototype.populateColumns = function (freeIndexes) {
-                var builder = this,
-                    enoughColumns = true;
-                // Loop each reader and give it an index if its missing.
-                // The freeIndexes.shift() will return undefined if there
-                // are no more columns.
-                builder.readers.forEach(function (reader) {
-                    if (typeof reader.columnIndex === 'undefined') {
-                        reader.columnIndex = freeIndexes.shift();
-                    }
-                });
-                // Now, all readers should have columns mapped. If not
-                // then return false to signal that this series should
-                // not be added.
-                builder.readers.forEach(function (reader) {
-                    if (typeof reader.columnIndex === 'undefined') {
-                        enoughColumns = false;
-                    }
-                });
-                return enoughColumns;
-            };
-            /**
-             * Reads a row from the dataset and returns a point or array depending
-             * on the names of the readers.
-             *
-             * @function SeriesBuilder#read<T>
-             */
-            SeriesBuilder.prototype.read = function (columns, rowIndex) {
-                var builder = this,
-                    pointIsArray = builder.pointIsArray,
-                    point = pointIsArray ? [] : {},
-                    columnIndexes;
-                // Loop each reader and ask it to read its value.
-                // Then, build an array or point based on the readers names.
-                builder.readers.forEach(function (reader) {
-                    var value = columns[reader.columnIndex][rowIndex];
-                    if (pointIsArray) {
-                        point.push(value);
-                    }
-                    else {
-                        if (reader.configName.indexOf('.') > 0) {
-                            // Handle nested property names
-                            Point.prototype.setNestedProperty(point, value, reader.configName);
-                        }
-                        else {
-                            point[reader.configName] = value;
-                        }
-                    }
-                });
-                // The name comes from the first column (excluding the x column)
-                if (typeof this.name === 'undefined' && builder.readers.length >= 2) {
-                    columnIndexes = builder.getReferencedColumnIndexes();
-                    if (columnIndexes.length >= 2) {
-                        // remove the first one (x col)
-                        columnIndexes.shift();
-                        // Sort the remaining
-                        columnIndexes.sort(function (a, b) {
-                            return a - b;
-                        });
-                        // Now use the lowest index as name column
-                        this.name = columns[columnIndexes.shift()].name;
-                    }
-                }
-                return point;
-            };
-            /**
-             * Creates and adds ColumnReader from the given columnIndex and configName.
-             * ColumnIndex can be undefined and in that case the reader will be given
-             * an index when columns are populated.
-             *
-             * @function SeriesBuilder#addColumnReader
-             */
-            SeriesBuilder.prototype.addColumnReader = function (columnIndex, configName) {
-                this.readers.push({
-                    columnIndex: columnIndex,
-                    configName: configName
-                });
-                if (!(configName === 'x' ||
-                    configName === 'y' ||
-                    typeof configName === 'undefined')) {
-                    this.pointIsArray = false;
-                }
-            };
-            /**
-             * Returns an array of column indexes that the builder will use when
-             * reading data.
-             *
-             * @function SeriesBuilder#getReferencedColumnIndexes
-             */
-            SeriesBuilder.prototype.getReferencedColumnIndexes = function () {
-                var i,
-                    referencedColumnIndexes = [],
-                    columnReader;
-                for (i = 0; i < this.readers.length; i = i + 1) {
-                    columnReader = this.readers[i];
-                    if (typeof columnReader.columnIndex !== 'undefined') {
-                        referencedColumnIndexes.push(columnReader.columnIndex);
-                    }
-                }
-                return referencedColumnIndexes;
-            };
-            /**
-             * Returns true if the builder has a reader for the given configName.
-             *
-             * @function SeriesBuider#hasReader
-             */
-            SeriesBuilder.prototype.hasReader = function (configName) {
-                var i,
-                    columnReader;
-                for (i = 0; i < this.readers.length; i = i + 1) {
-                    columnReader = this.readers[i];
-                    if (columnReader.configName === configName) {
-                        return true;
-                    }
-                }
-                // Else return undefined
-            };
-            return SeriesBuilder;
-        }());
-        G.Data = Data;
+        /**
+         * A URL to a remote JSON dataset, structured as a row array.
+         * Will be fetched when the chart is created using Ajax.
+         *
+         * @sample highcharts/data/livedata-rows
+         *         Rows with live polling
+         *
+         * @type      {string}
+         * @apioption data.rowsURL
+         */
+        /**
+         * A URL to a remote JSON dataset, structured as a column array.
+         * Will be fetched when the chart is created using Ajax.
+         *
+         * @sample highcharts/data/livedata-columns
+         *         Columns with live polling
+         *
+         * @type      {string}
+         * @apioption data.columnsURL
+         */
+        /**
+         * Sets the refresh rate for data polling when importing remote dataset by
+         * setting [data.csvURL](data.csvURL), [data.rowsURL](data.rowsURL),
+         * [data.columnsURL](data.columnsURL), or
+         * [data.googleSpreadsheetKey](data.googleSpreadsheetKey).
+         *
+         * Note that polling must be enabled by setting
+         * [data.enablePolling](data.enablePolling) to true.
+         *
+         * The value is the number of seconds between pollings.
+         * It cannot be set to less than 1 second.
+         *
+         * @sample highcharts/demo/live-data
+         *         Live data with user set refresh rate
+         *
+         * @default   1
+         * @type      {number}
+         * @apioption data.dataRefreshRate
+         */
+        /**
+         * Enables automatic refetching of remote datasets every _n_ seconds (defined by
+         * setting [data.dataRefreshRate](data.dataRefreshRate)).
+         *
+         * Only works when either [data.csvURL](data.csvURL),
+         * [data.rowsURL](data.rowsURL), [data.columnsURL](data.columnsURL), or
+         * [data.googleSpreadsheetKey](data.googleSpreadsheetKey).
+         *
+         * @sample highcharts/demo/live-data
+         *         Live data
+         * @sample highcharts/data/livedata-columns
+         *         Categorized bar chart with CSV and live polling
+         *
+         * @type      {boolean}
+         * @default   false
+         * @apioption data.enablePolling
+         */
+        (''); // keeps doclets above in JS file
 
-        return G.Data;
+        return Data;
     });
     _registerModule(_modules, 'masters/modules/data.src.js', [_modules['Core/Globals.js'], _modules['Core/HttpUtilities.js'], _modules['Extensions/Data.js']], function (Highcharts, HttpUtilities, Data) {
 
         var G = Highcharts;
         // Functions
         G.ajax = HttpUtilities.ajax;
+        G.data = Data.data;
         G.getJSON = HttpUtilities.getJSON;
         G.post = HttpUtilities.post;
         // Classes