highcharts 9.3.3 → 10.2.0

package/es-modules/Extensions/Data.js

@@ -19,493 +19,61 @@ import Point from '../Core/Series/Point.js';
 import SeriesRegistry from '../Core/Series/SeriesRegistry.js';
 var seriesTypes = SeriesRegistry.seriesTypes;
 import U from '../Core/Utilities.js';
+import D from '../Core/DefaultOptions.js';
+var getOptions = D.getOptions;
 var addEvent = U.addEvent, defined = U.defined, extend = U.extend, fireEvent = U.fireEvent, isNumber = U.isNumber, merge = U.merge, 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
- *
- * @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
+ *  Functions
  *
- * @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
+ * @private
  */
-/**
- * Whether to use the first row in the data set as series names.
+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/start-end/
- *         Don't get series names from the CSV
- * @sample {highstock} highcharts/data/start-end/
- *         Don't get series names from the CSV
+ *  Class
  *
- * @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.
+ * The Data class
  *
- * @sample {highcharts} highcharts/data/google-spreadsheet/
- *         Load a Google Spreadsheet
+ * @requires module:modules/data
  *
- * @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`.
+ * @class
+ * @name Highcharts.Data
  *
- * In order for Google Sheets to load, a valid [googleAPIKey](#data.googleAPIKey)
- * must also be given.
+ * @param {Highcharts.DataOptions} dataOptions
  *
- * @sample {highcharts} highcharts/data/google-spreadsheet/
- *         Load a Google Spreadsheet
+ * @param {Highcharts.Options} [chartOptions]
  *
- * @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 () {
     /* *
@@ -514,11 +82,8 @@ var Data = /** @class */ (function () {
      *
      * */
     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;
+        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.
@@ -558,7 +123,8 @@ var Data = /** @class */ (function () {
                     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;
                     }
@@ -578,50 +144,90 @@ var Data = /** @class */ (function () {
                 }
             }
         };
+        this.chart = chart;
+        this.chartOptions = chartOptions;
+        this.options = dataOptions;
+        this.rawColumns = [];
         this.init(dataOptions, chartOptions, chart);
     }
     /* *
      *
-     *  Functions
+     *  Static Properties
      *
      * */
     /**
-     * Initialize the Data object with the given options
+     * Creates a data object to parse data for a chart.
      *
-     * @private
-     * @function Highcharts.Data#init
+     * @function Highcharts.data
      */
-    Data.prototype.init = function (options, chartOptions, chart) {
-        var decimalPoint = options.decimalPoint, hasData;
-        if (chartOptions) {
-            this.chartOptions = chartOptions;
-        }
-        if (chart) {
-            this.chart = chart;
-        }
-        if (decimalPoint !== '.' && decimalPoint !== ',') {
-            decimalPoint = void 0;
-        }
-        this.options = options;
-        this.columns = (options.columns ||
-            this.rowsToColumns(options.rows) ||
-            []);
-        this.firstRowAsNames = pick(options.firstRowAsNames, this.firstRowAsNames, true);
-        this.decimalRegex = (decimalPoint &&
-            new RegExp('^(-?[0-9]+)' + decimalPoint + '([0-9]+)$'));
-        // 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
-        // string-based categories.
-        this.rawColumns = [];
+    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
+     *
+     * */
+    /**
+     * Initialize the Data object with the given options
+     *
+     * @private
+     * @function Highcharts.Data#init
+     */
+    Data.prototype.init = function (dataOptions, chartOptions, chart) {
+        var decimalPoint = dataOptions.decimalPoint, hasData;
+        if (chartOptions) {
+            this.chartOptions = chartOptions;
+        }
+        if (chart) {
+            this.chart = chart;
+        }
+        if (decimalPoint !== '.' && decimalPoint !== ',') {
+            decimalPoint = void 0;
+        }
+        this.options = dataOptions;
+        this.columns = (dataOptions.columns ||
+            this.rowsToColumns(dataOptions.rows) ||
+            []);
+        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
+        // string-based categories.
+        this.rawColumns = [];
         // 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
@@ -640,14 +246,10 @@ var Data = /** @class */ (function () {
             // 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
@@ -662,7 +264,7 @@ var Data = /** @class */ (function () {
             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) ||
@@ -671,7 +273,8 @@ var Data = /** @class */ (function () {
                 chartOptions.series.map(function () {
                     return { x: 0 };
                 })) ||
-            []), i;
+            []);
+        var seriesIndex = 0, i;
         ((chartOptions && chartOptions.series) || []).forEach(function (series) {
             individualCounts.push(getValueCount(series.type || globalType));
         });
@@ -757,12 +360,8 @@ var Data = /** @class */ (function () {
      * @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 = {
@@ -770,7 +369,11 @@ var Data = /** @class */ (function () {
             ';': 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.
@@ -1005,9 +608,10 @@ var Data = /** @class */ (function () {
          * @private
          */
         function deduceDateFormat(data, limit) {
-            var format = 'YYYY/mm/dd', thing, guessedFormat = [], calculatedFormat, i = 0, madeDeduction = false, 
+            var format = 'YYYY/mm/dd', stable = [], max = [];
+            var thing, guessedFormat = [], calculatedFormat, i = 0, madeDeduction = false, 
             // candidates = {},
-            stable = [], max = [], j;
+            j;
             if (!limit || limit > data.length) {
                 limit = data.length;
             }
@@ -1179,8 +783,9 @@ var Data = /** @class */ (function () {
      * @function Highcharts.Data#parseTable
      */
     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) {
+        var options = this.options, columns = this.columns || [], startRow = options.startRow || 0, endRow = options.endRow || Number.MAX_VALUE, startColumn = options.startColumn || 0, endColumn = options.endColumn || Number.MAX_VALUE;
+        if (options.table) {
+            var table = options.table;
             if (typeof table === 'string') {
                 table = doc.getElementById(table);
             }
@@ -1221,8 +826,9 @@ var Data = /** @class */ (function () {
      *         The URLs that were tried can be found in the options
      */
     Data.prototype.fetchLiveData = function () {
-        var data = this, 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 data = this, chart = this.chart, options = this.options, maxRetries = 3, pollingEnabled = options.enablePolling, originalOptions = merge(options);
+        var currentRetries = 0, updateIntervalMs = (options.dataRefreshRate || 2) * 1000;
+        if (!hasURLOption(options)) {
             return false;
         }
         // Do not allow polling more than once a second
@@ -1306,7 +912,7 @@ var Data = /** @class */ (function () {
             }
         }
         performFetch(true);
-        return this.hasURLOption(options);
+        return hasURLOption(options);
     };
     /**
      * Parse a Google spreadsheet.
@@ -1333,7 +939,7 @@ var Data = /** @class */ (function () {
             if (defined(options.endRow)) {
                 end += options.endRow + 1;
             }
-            return start + ":" + end;
+            return "".concat(start, ":").concat(end);
         };
         /**
          * Fetch the actual spreadsheet using XMLHttpRequest.
@@ -1357,7 +963,7 @@ var Data = /** @class */ (function () {
                 success: function (json) {
                     fn(json);
                     if (options.enablePolling) {
-                        setTimeout(function () {
+                        data.liveDataTimeout = setTimeout(function () {
                             fetchSheet(fn);
                         }, refreshRate);
                     }
@@ -1434,7 +1040,8 @@ var Data = /** @class */ (function () {
      * @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);
         }
@@ -1451,9 +1058,10 @@ var Data = /** @class */ (function () {
      *        Column index
      */
     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 &&
+        var rawColumns = this.rawColumns, columns = this.columns, firstRowAsNames = this.firstRowAsNames, isXColumn = this.valueCount.xColumns.indexOf(col) !== -1, backup = [], chartOptions = this.chartOptions, 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] = [];
         }
@@ -1468,7 +1076,8 @@ var Data = /** @class */ (function () {
             }
             // 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
@@ -1611,28 +1220,6 @@ var Data = /** @class */ (function () {
         }
         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
@@ -1662,31 +1249,6 @@ var Data = /** @class */ (function () {
             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.
@@ -1694,7 +1256,8 @@ var Data = /** @class */ (function () {
      * @function Highcharts.Data#complete
      */
     Data.prototype.complete = function () {
-        var columns = this.columns, xColumns = [], type, options = this.options, series, data, i, j, r, seriesIndex, chartOptions, allSeriesBuilders = [], builder, freeIndexes, typeCol, index;
+        var columns = this.columns, xColumns = [], options = this.options, allSeriesBuilders = [];
+        var type, series, data, i, j, r, seriesIndex, chartOptions, builder, freeIndexes, typeCol, index;
         xColumns.length = columns.length;
         if (options.complete || options.afterComplete) {
             // Get the names and shift the top row
@@ -1708,7 +1271,7 @@ var Data = /** @class */ (function () {
             }
             // 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];
@@ -1815,7 +1378,7 @@ var Data = /** @class */ (function () {
      * @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) {
@@ -1834,28 +1397,24 @@ var Data = /** @class */ (function () {
                 }
             };
             // 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;
-/**
- * Creates a data object to parse data for a chart.
- *
- * @function Highcharts.data
- */
-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) {
+    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.
@@ -1863,7 +1422,8 @@ addEvent(Chart, 'init', function (e) {
          * @name Highcharts.Chart#data
          * @type {Highcharts.Data|undefined}
          */
-        chart.data = new G.Data(extend(userOptions.data, {
+        var dataOptions = merge(defaultDataOptions, userOptions.data);
+        chart.data = new Data(extend(dataOptions, {
             afterComplete: function (dataOptions) {
                 var i, series;
                 // Merge series configs
@@ -1911,8 +1471,6 @@ var SeriesBuilder = /** @class */ (function () {
         /* 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
@@ -1922,7 +1480,8 @@ var SeriesBuilder = /** @class */ (function () {
      * @function SeriesBuilder#populateColumns
      */
     SeriesBuilder.prototype.populateColumns = function (freeIndexes) {
-        var builder = this, enoughColumns = true;
+        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.
@@ -1948,7 +1507,8 @@ var SeriesBuilder = /** @class */ (function () {
      * @function SeriesBuilder#read<T>
      */
     SeriesBuilder.prototype.read = function (columns, rowIndex) {
-        var builder = this, pointIsArray = builder.pointIsArray, point = pointIsArray ? [] : {}, columnIndexes;
+        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) {
@@ -2007,7 +1567,8 @@ var SeriesBuilder = /** @class */ (function () {
      * @function SeriesBuilder#getReferencedColumnIndexes
      */
     SeriesBuilder.prototype.getReferencedColumnIndexes = function () {
-        var i, referencedColumnIndexes = [], columnReader;
+        var referencedColumnIndexes = [];
+        var i, columnReader;
         for (i = 0; i < this.readers.length; i = i + 1) {
             columnReader = this.readers[i];
             if (typeof columnReader.columnIndex !== 'undefined') {
@@ -2033,5 +1594,492 @@ var SeriesBuilder = /** @class */ (function () {
     };
     return SeriesBuilder;
 }());
-G.Data = Data;
-export default G.Data;
+/* *
+ *
+ *  Default Export
+ *
+ * */
+export default Data;
+/* *
+ *
+ *  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
+ */
+/**
+ * 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
+ */
+(''); // keeps doclets above in JS file