highcharts 11.4.6 → 11.4.7

package/es-modules/Data/DataTable.js

@@ -10,11 +10,12 @@
  *  - Sophie Bremer
  *  - Gøran Slettemark
  *  - Jomar Hønsi
+ *  - Dawid Dragula
  *
  * */
 'use strict';
 import U from '../Core/Utilities.js';
-const { addEvent, fireEvent, uniqueKey } = U;
+const { addEvent, defined, fireEvent, uniqueKey } = U;
 /* *
  *
  *  Class
@@ -95,17 +96,6 @@ class DataTable {
      * Options to initialize the new DataTable instance.
      */
     constructor(options = {}) {
-        /**
-         * Dictionary of all column aliases and their mapped column. If a column
-         * for one of the get-methods matches an column alias, this column will
-         * be replaced with the mapped column by the column alias.
-         *
-         * @name Highcharts.DataTable#aliases
-         * @type {Highcharts.Dictionary<string>}
-         */
-        this.aliases = (options.aliases ?
-            JSON.parse(JSON.stringify(options.aliases)) :
-            {});
         /**
          * Whether the ID was automatic generated or given in the constructor.
          *
@@ -124,7 +114,6 @@ class DataTable {
         this.modified = this;
         this.rowCount = 0;
         this.versionTag = uniqueKey();
-        this.rowKeysId = options.rowKeysId;
         const columns = options.columns || {}, columnNames = Object.keys(columns), thisColumns = this.columns;
         let rowCount = 0;
         for (let i = 0, iEnd = columnNames.length, column, columnName; i < iEnd; ++i) {
@@ -137,12 +126,6 @@ class DataTable {
             thisColumns[columnNames[i]].length = rowCount;
         }
         this.rowCount = rowCount;
-        const aliases = options.aliases || {}, aliasKeys = Object.keys(aliases), thisAliases = this.aliases;
-        for (let i = 0, iEnd = aliasKeys.length, alias; i < iEnd; ++i) {
-            alias = aliasKeys[i];
-            thisAliases[alias] = aliases[alias];
-        }
-        this.setRowKeysColumn(rowCount);
     }
     /* *
      *
@@ -172,18 +155,16 @@ class DataTable {
         const table = this, tableOptions = {};
         table.emit({ type: 'cloneTable', detail: eventDetail });
         if (!skipColumns) {
-            tableOptions.aliases = table.aliases;
             tableOptions.columns = table.columns;
         }
         if (!table.autoId) {
             tableOptions.id = table.id;
         }
-        if (table.rowKeysId) {
-            tableOptions.rowKeysId = table.rowKeysId;
-        }
         const tableClone = new DataTable(tableOptions);
         if (!skipColumns) {
             tableClone.versionTag = table.versionTag;
+            tableClone.originalRowIndexes = table.originalRowIndexes;
+            tableClone.localRowIndexes = table.localRowIndexes;
         }
         table.emit({
             type: 'afterCloneTable',
@@ -192,36 +173,13 @@ class DataTable {
         });
         return tableClone;
     }
-    /**
-     * Deletes a column alias and returns the original column name. If the alias
-     * is not found, the method returns `undefined`. Deleting an alias does not
-     * affect the data in the table, only the way columns are accessed.
-     *
-     * @function Highcharts.DataTable#deleteColumnAlias
-     *
-     * @param {string} alias
-     * The alias to delete.
-     *
-     * @return {string|undefined}
-     * Returns the original column name, if found.
-     */
-    deleteColumnAlias(alias) {
-        const table = this, aliases = table.aliases, deletedAlias = aliases[alias], modifier = table.modifier;
-        if (deletedAlias) {
-            delete table.aliases[alias];
-            if (modifier) {
-                modifier.modifyColumns(table, { [deletedAlias]: new Array(table.rowCount) }, 0);
-            }
-        }
-        return deletedAlias;
-    }
     /**
      * Deletes columns from the table.
      *
      * @function Highcharts.DataTable#deleteColumns
      *
      * @param {Array<string>} [columnNames]
-     * Names (no alias) of columns to delete. If no array is provided, all
+     * Names of columns to delete. If no array is provided, all
      * columns will be deleted.
      *
      * @param {Highcharts.DataTableEventDetail} [eventDetail]
@@ -251,14 +209,9 @@ class DataTable {
                 }
                 delete columns[columnName];
             }
-            let nColumns = Object.keys(columns).length;
-            if (table.rowKeysId && nColumns === 1) {
-                // All columns deleted, remove row keys column
-                delete columns[table.rowKeysId];
-                nColumns = 0;
-            }
-            if (!nColumns) {
+            if (!Object.keys(columns).length) {
                 table.rowCount = 0;
+                this.deleteRowIndexReferences();
             }
             if (modifier) {
                 modifier.modifyColumns(table, modifiedColumns, 0, eventDetail);
@@ -272,6 +225,18 @@ class DataTable {
             return deletedColumns;
         }
     }
+    /**
+     * Deletes the row index references. This is useful when the original table
+     * is deleted, and the references are no longer needed. This table is
+     * then considered an original table or a table that has the same row's
+     * order as the original table.
+     */
+    deleteRowIndexReferences() {
+        delete this.originalRowIndexes;
+        delete this.localRowIndexes;
+        // Here, in case of future need, can be implemented updating of the
+        // modified tables' row indexes references.
+    }
     /**
      * Deletes rows in this table.
      *
@@ -359,8 +324,8 @@ class DataTable {
      *
      * @function Highcharts.DataTable#getCell
      *
-     * @param {string} columnNameOrAlias
-     * Column name or alias of the cell to retrieve.
+     * @param {string} columnName
+     * Column name of the cell to retrieve.
      *
      * @param {number} rowIndex
      * Row index of the cell to retrieve.
@@ -368,11 +333,9 @@ class DataTable {
      * @return {Highcharts.DataTableCellType|undefined}
      * Returns the cell value or `undefined`.
      */
-    getCell(columnNameOrAlias, rowIndex) {
+    getCell(columnName, rowIndex) {
         const table = this;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        const column = table.columns[columnNameOrAlias];
+        const column = table.columns[columnName];
         if (column) {
             return column[rowIndex];
         }
@@ -382,8 +345,8 @@ class DataTable {
      *
      * @function Highcharts.DataTable#getCellAsBoolean
      *
-     * @param {string} columnNameOrAlias
-     * Column name or alias to fetch.
+     * @param {string} columnName
+     * Column name to fetch.
      *
      * @param {number} rowIndex
      * Row index to fetch.
@@ -391,11 +354,9 @@ class DataTable {
      * @return {boolean}
      * Returns the cell value of the row as a boolean.
      */
-    getCellAsBoolean(columnNameOrAlias, rowIndex) {
+    getCellAsBoolean(columnName, rowIndex) {
         const table = this;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        const column = table.columns[columnNameOrAlias];
+        const column = table.columns[columnName];
         return !!(column && column[rowIndex]);
     }
     /**
@@ -403,8 +364,8 @@ class DataTable {
      *
      * @function Highcharts.DataTable#getCellAsNumber
      *
-     * @param {string} columnNameOrAlias
-     * Column name or alias to fetch.
+     * @param {string} columnName
+     * Column name or to fetch.
      *
      * @param {number} rowIndex
      * Row index to fetch.
@@ -415,11 +376,9 @@ class DataTable {
      * @return {number|null}
      * Returns the cell value of the row as a number.
      */
-    getCellAsNumber(columnNameOrAlias, rowIndex, useNaN) {
+    getCellAsNumber(columnName, rowIndex, useNaN) {
         const table = this;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        const column = table.columns[columnNameOrAlias];
+        const column = table.columns[columnName];
         let cellValue = (column && column[rowIndex]);
         switch (typeof cellValue) {
             case 'boolean':
@@ -435,8 +394,8 @@ class DataTable {
      *
      * @function Highcharts.DataTable#getCellAsString
      *
-     * @param {string} columnNameOrAlias
-     * Column name or alias to fetch.
+     * @param {string} columnName
+     * Column name to fetch.
      *
      * @param {number} rowIndex
      * Row index to fetch.
@@ -444,22 +403,20 @@ class DataTable {
      * @return {string}
      * Returns the cell value of the row as a string.
      */
-    getCellAsString(columnNameOrAlias, rowIndex) {
+    getCellAsString(columnName, rowIndex) {
         const table = this;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        const column = table.columns[columnNameOrAlias];
+        const column = table.columns[columnName];
         // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
         return `${(column && column[rowIndex])}`;
     }
     /**
-     * Fetches the given column by the canonical column name or by an alias.
+     * Fetches the given column by the canonical column name.
      * This function is a simplified wrap of {@link getColumns}.
      *
      * @function Highcharts.DataTable#getColumn
      *
-     * @param {string} columnNameOrAlias
-     * Name or alias of the column to get, alias takes precedence.
+     * @param {string} columnName
+     * Name of the column to get.
      *
      * @param {boolean} [asReference]
      * Whether to return the column as a readonly reference.
@@ -467,11 +424,11 @@ class DataTable {
      * @return {Highcharts.DataTableColumn|undefined}
      * A copy of the column, or `undefined` if not found.
      */
-    getColumn(columnNameOrAlias, asReference) {
-        return this.getColumns([columnNameOrAlias], asReference)[columnNameOrAlias];
+    getColumn(columnName, asReference) {
+        return this.getColumns([columnName], asReference)[columnName];
     }
     /**
-     * Fetches the given column by the canonical column name or by an alias, and
+     * Fetches the given column by the canonical column name, and
      * validates the type of the first few cells. If the first defined cell is
      * of type number, it assumes for performance reasons, that all cells are of
      * type number or `null`. Otherwise it will convert all cells to number
@@ -479,8 +436,8 @@ class DataTable {
      *
      * @function Highcharts.DataTable#getColumnAsNumbers
      *
-     * @param {string} columnNameOrAlias
-     * Name or alias of the column to get, alias takes precedence.
+     * @param {string} columnName
+     * Name of the column to get.
      *
      * @param {boolean} [useNaN]
      * Whether to use NaN instead of `null` and `undefined`.
@@ -488,16 +445,14 @@ class DataTable {
      * @return {Array<(number|null)>}
      * A copy of the column, or an empty array if not found.
      */
-    getColumnAsNumbers(columnNameOrAlias, useNaN) {
+    getColumnAsNumbers(columnName, useNaN) {
         const table = this, columns = table.columns;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        const column = columns[columnNameOrAlias], columnAsNumber = [];
+        const column = columns[columnName], columnAsNumber = [];
         if (column) {
             const columnLength = column.length;
             if (useNaN) {
                 for (let i = 0; i < columnLength; ++i) {
-                    columnAsNumber.push(table.getCellAsNumber(columnNameOrAlias, i, true));
+                    columnAsNumber.push(table.getCellAsNumber(columnName, i, true));
                 }
             }
             else {
@@ -513,7 +468,7 @@ class DataTable {
                     }
                 }
                 for (let i = 0; i < columnLength; ++i) {
-                    columnAsNumber.push(table.getCellAsNumber(columnNameOrAlias, i));
+                    columnAsNumber.push(table.getCellAsNumber(columnName, i));
                 }
             }
         }
@@ -529,7 +484,6 @@ class DataTable {
      */
     getColumnNames() {
         const table = this, columnNames = Object.keys(table.columns);
-        this.removeRowKeysColumn(columnNames);
         return columnNames;
     }
     /**
@@ -537,8 +491,8 @@ class DataTable {
      *
      * @function Highcharts.DataTable#getColumns
      *
-     * @param {Array<string>} [columnNamesOrAliases]
-     * Column names or aliases to retrieve. Aliases taking precedence.
+     * @param {Array<string>} [columnNames]
+     * Column names to retrieve.
      *
      * @param {boolean} [asReference]
      * Whether to return columns as a readonly reference.
@@ -547,19 +501,35 @@ class DataTable {
      * Collection of columns. If a requested column was not found, it is
      * `undefined`.
      */
-    getColumns(columnNamesOrAliases, asReference) {
-        const table = this, tableAliasMap = table.aliases, tableColumns = table.columns, columns = {};
-        columnNamesOrAliases = (columnNamesOrAliases || Object.keys(tableColumns));
-        this.removeRowKeysColumn(columnNamesOrAliases);
-        for (let i = 0, iEnd = columnNamesOrAliases.length, column, columnName; i < iEnd; ++i) {
-            columnName = columnNamesOrAliases[i];
-            column = tableColumns[(tableAliasMap[columnName] || columnName)];
+    getColumns(columnNames, asReference) {
+        const table = this, tableColumns = table.columns, columns = {};
+        columnNames = (columnNames || Object.keys(tableColumns));
+        for (let i = 0, iEnd = columnNames.length, column, columnName; i < iEnd; ++i) {
+            columnName = columnNames[i];
+            column = tableColumns[columnName];
             if (column) {
                 columns[columnName] = (asReference ? column : column.slice());
             }
         }
         return columns;
     }
+    /**
+     * Takes the original row index and returns the local row index in the
+     * modified table for which this function is called.
+     *
+     * @param {number} originalRowIndex
+     * Original row index to get the local row index for.
+     *
+     * @return {number|undefined}
+     * Returns the local row index or `undefined` if not found.
+     */
+    getLocalRowIndex(originalRowIndex) {
+        const { localRowIndexes } = this;
+        if (localRowIndexes) {
+            return localRowIndexes[originalRowIndex];
+        }
+        return originalRowIndex;
+    }
     /**
      * Retrieves the modifier for the table.
      * @private
@@ -570,6 +540,23 @@ class DataTable {
     getModifier() {
         return this.modifier;
     }
+    /**
+     * Takes the local row index and returns the index of the corresponding row
+     * in the original table.
+     *
+     * @param {number} rowIndex
+     * Local row index to get the original row index for.
+     *
+     * @return {number|undefined}
+     * Returns the original row index or `undefined` if not found.
+     */
+    getOriginalRowIndex(rowIndex) {
+        const { originalRowIndexes } = this;
+        if (originalRowIndexes) {
+            return originalRowIndexes[rowIndex];
+        }
+        return rowIndex;
+    }
     /**
      * Retrieves the row at a given index. This function is a simplified wrap of
      * {@link getRows}.
@@ -579,14 +566,14 @@ class DataTable {
      * @param {number} rowIndex
      * Row index to retrieve. First row has index 0.
      *
-     * @param {Array<string>} [columnNamesOrAliases]
-     * Column names or aliases in order to retrieve.
+     * @param {Array<string>} [columnNames]
+     * Column names in order to retrieve.
      *
      * @return {Highcharts.DataTableRow}
      * Returns the row values, or `undefined` if not found.
      */
-    getRow(rowIndex, columnNamesOrAliases) {
-        return this.getRows(rowIndex, 1, columnNamesOrAliases)[0];
+    getRow(rowIndex, columnNames) {
+        return this.getRows(rowIndex, 1, columnNames)[0];
     }
     /**
      * Returns the number of rows in this table.
@@ -605,7 +592,7 @@ class DataTable {
      *
      * @function Highcharts.DataTable#getRowIndexBy
      *
-     * @param {string} columnNameOrAlias
+     * @param {string} columnName
      * Column to search in.
      *
      * @param {Highcharts.DataTableCellType} cellValue
@@ -617,11 +604,9 @@ class DataTable {
      * @return {number|undefined}
      * Index of the first row matching the cell value.
      */
-    getRowIndexBy(columnNameOrAlias, cellValue, rowIndexOffset) {
+    getRowIndexBy(columnName, cellValue, rowIndexOffset) {
         const table = this;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        const column = table.columns[columnNameOrAlias];
+        const column = table.columns[columnName];
         if (column) {
             const rowIndex = column.indexOf(cellValue, rowIndexOffset);
             if (rowIndex !== -1) {
@@ -638,14 +623,14 @@ class DataTable {
      * @param {number} rowIndex
      * Row index.
      *
-     * @param {Array<string>} [columnNamesOrAliases]
-     * Column names or aliases and their order to retrieve.
+     * @param {Array<string>} [columnNames]
+     * Column names and their order to retrieve.
      *
      * @return {Highcharts.DataTableRowObject}
      * Returns the row values, or `undefined` if not found.
      */
-    getRowObject(rowIndex, columnNamesOrAliases) {
-        return this.getRowObjects(rowIndex, 1, columnNamesOrAliases)[0];
+    getRowObject(rowIndex, columnNames) {
+        return this.getRowObjects(rowIndex, 1, columnNames)[0];
     }
     /**
      * Fetches all or a number of rows.
@@ -658,20 +643,19 @@ class DataTable {
      * @param {number} [rowCount]
      * Number of rows to fetch. Defaults to maximal number of rows.
      *
-     * @param {Array<string>} [columnNamesOrAliases]
-     * Column names or aliases and their order to retrieve.
+     * @param {Array<string>} [columnNames]
+     * Column names and their order to retrieve.
      *
      * @return {Highcharts.DataTableRowObject}
      * Returns retrieved rows.
      */
-    getRowObjects(rowIndex = 0, rowCount = (this.rowCount - rowIndex), columnNamesOrAliases) {
-        const table = this, aliases = table.aliases, columns = table.columns, rows = new Array(rowCount);
-        columnNamesOrAliases = (columnNamesOrAliases || Object.keys(columns));
-        this.removeRowKeysColumn(columnNamesOrAliases);
+    getRowObjects(rowIndex = 0, rowCount = (this.rowCount - rowIndex), columnNames) {
+        const table = this, columns = table.columns, rows = new Array(rowCount);
+        columnNames = (columnNames || Object.keys(columns));
         for (let i = rowIndex, i2 = 0, iEnd = Math.min(table.rowCount, (rowIndex + rowCount)), column, row; i < iEnd; ++i, ++i2) {
             row = rows[i2] = {};
-            for (const columnName of columnNamesOrAliases) {
-                column = columns[(aliases[columnName] || columnName)];
+            for (const columnName of columnNames) {
+                column = columns[columnName];
                 row[columnName] = (column ? column[i] : void 0);
             }
         }
@@ -688,19 +672,19 @@ class DataTable {
      * @param {number} [rowCount]
      * Number of rows to fetch. Defaults to maximal number of rows.
      *
-     * @param {Array<string>} [columnNamesOrAliases]
-     * Column names or aliases and their order to retrieve.
+     * @param {Array<string>} [columnNames]
+     * Column names and their order to retrieve.
      *
      * @return {Highcharts.DataTableRow}
      * Returns retrieved rows.
      */
-    getRows(rowIndex = 0, rowCount = (this.rowCount - rowIndex), columnNamesOrAliases) {
-        const table = this, aliases = table.aliases, columns = table.columns, rows = new Array(rowCount);
-        columnNamesOrAliases = (columnNamesOrAliases || Object.keys(columns));
+    getRows(rowIndex = 0, rowCount = (this.rowCount - rowIndex), columnNames) {
+        const table = this, columns = table.columns, rows = new Array(rowCount);
+        columnNames = (columnNames || Object.keys(columns));
         for (let i = rowIndex, i2 = 0, iEnd = Math.min(table.rowCount, (rowIndex + rowCount)), column, row; i < iEnd; ++i, ++i2) {
             row = rows[i2] = [];
-            for (const columnName of columnNamesOrAliases) {
-                column = columns[(aliases[columnName] || columnName)];
+            for (const columnName of columnNames) {
+                column = columns[columnName];
                 row.push(column ? column[i] : void 0);
             }
         }
@@ -718,21 +702,21 @@ class DataTable {
         return this.versionTag;
     }
     /**
-     * Checks for given column names or aliases.
+     * Checks for given column names.
      *
      * @function Highcharts.DataTable#hasColumns
      *
-     * @param {Array<string>} columnNamesOrAliases
-     * Column names of aliases to check.
+     * @param {Array<string>} columnNames
+     * Column names to check.
      *
      * @return {boolean}
      * Returns `true` if all columns have been found, otherwise `false`.
      */
-    hasColumns(columnNamesOrAliases) {
-        const table = this, aliases = table.aliases, columns = table.columns;
-        for (let i = 0, iEnd = columnNamesOrAliases.length, columnName; i < iEnd; ++i) {
-            columnName = columnNamesOrAliases[i];
-            if (!columns[columnName] && !aliases[columnName]) {
+    hasColumns(columnNames) {
+        const table = this, columns = table.columns;
+        for (let i = 0, iEnd = columnNames.length, columnName; i < iEnd; ++i) {
+            columnName = columnNames[i];
+            if (!columns[columnName]) {
                 return false;
             }
         }
@@ -743,7 +727,7 @@ class DataTable {
      *
      * @function Highcharts.DataTable#hasRowWith
      *
-     * @param {string} columnNameOrAlias
+     * @param {string} columnName
      * Column to search in.
      *
      * @param {Highcharts.DataTableCellType} cellValue
@@ -752,11 +736,9 @@ class DataTable {
      * @return {boolean}
      * True, if a row has been found, otherwise false.
      */
-    hasRowWith(columnNameOrAlias, cellValue) {
+    hasRowWith(columnName, cellValue) {
         const table = this;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        const column = table.columns[columnNameOrAlias];
+        const column = table.columns[columnName];
         if (column) {
             return (column.indexOf(cellValue) !== -1);
         }
@@ -798,29 +780,21 @@ class DataTable {
         const table = this, columns = table.columns;
         if (columns[columnName]) {
             if (columnName !== newColumnName) {
-                const aliases = table.aliases;
-                if (aliases[newColumnName]) {
-                    delete aliases[newColumnName];
-                }
                 columns[newColumnName] = columns[columnName];
                 delete columns[columnName];
-                if (table.rowKeysId) {
-                    // Ensure that row keys column is last
-                    this.moveRowKeysColumnToLast(columns, table.rowKeysId);
-                }
             }
             return true;
         }
         return false;
     }
     /**
-     * Sets a cell value based on the row index and column name or alias.  Will
+     * Sets a cell value based on the row index and column.  Will
      * insert a new column, if not found.
      *
      * @function Highcharts.DataTable#setCell
      *
-     * @param {string} columnNameOrAlias
-     * Column name or alias to set.
+     * @param {string} columnName
+     * Column name to set.
      *
      * @param {number|undefined} rowIndex
      * Row index to set.
@@ -834,35 +808,33 @@ class DataTable {
      * @emits #setCell
      * @emits #afterSetCell
      */
-    setCell(columnNameOrAlias, rowIndex, cellValue, eventDetail) {
+    setCell(columnName, rowIndex, cellValue, eventDetail) {
         const table = this, columns = table.columns, modifier = table.modifier;
-        columnNameOrAlias = (table.aliases[columnNameOrAlias] ||
-            columnNameOrAlias);
-        let column = columns[columnNameOrAlias];
+        let column = columns[columnName];
         if (column && column[rowIndex] === cellValue) {
             return;
         }
         table.emit({
             type: 'setCell',
             cellValue,
-            columnName: columnNameOrAlias,
+            columnName: columnName,
             detail: eventDetail,
             rowIndex
         });
         if (!column) {
-            column = columns[columnNameOrAlias] = new Array(table.rowCount);
+            column = columns[columnName] = new Array(table.rowCount);
         }
         if (rowIndex >= table.rowCount) {
             table.rowCount = (rowIndex + 1);
         }
         column[rowIndex] = cellValue;
         if (modifier) {
-            modifier.modifyCell(table, columnNameOrAlias, rowIndex, cellValue);
+            modifier.modifyCell(table, columnName, rowIndex, cellValue);
         }
         table.emit({
             type: 'afterSetCell',
             cellValue,
-            columnName: columnNameOrAlias,
+            columnName: columnName,
             detail: eventDetail,
             rowIndex
         });
@@ -872,8 +844,8 @@ class DataTable {
      *
      * @function Highcharts.DataTable#setColumn
      *
-     * @param {string} columnNameOrAlias
-     * Column name or alias to set.
+     * @param {string} columnName
+     * Column name to set.
      *
      * @param {Highcharts.DataTableColumn} [column]
      * Values to set in the column.
@@ -887,8 +859,8 @@ class DataTable {
      * @emits #setColumns
      * @emits #afterSetColumns
      */
-    setColumn(columnNameOrAlias, column = [], rowIndex = 0, eventDetail) {
-        this.setColumns({ [columnNameOrAlias]: column }, rowIndex, eventDetail);
+    setColumn(columnName, column = [], rowIndex = 0, eventDetail) {
+        this.setColumns({ [columnName]: column }, rowIndex, eventDetail);
     }
     /**
      * Sets cell values for multiple columns. Will insert new columns, if not
@@ -897,7 +869,7 @@ class DataTable {
      * @function Highcharts.DataTable#setColumns
      *
      * @param {Highcharts.DataTableColumnCollection} columns
-     * Columns as a collection, where the keys are the column names or aliases.
+     * Columns as a collection, where the keys are the column names.
      *
      * @param {number} [rowIndex]
      * Index of the first row to change. Keep undefined to reset.
@@ -920,8 +892,6 @@ class DataTable {
         for (let i = 0, iEnd = columnNames.length, column, columnName; i < iEnd; ++i) {
             columnName = columnNames[i];
             column = columns[columnName];
-            columnName = (table.aliases[columnName] ||
-                columnName);
             if (reset) {
                 tableColumns[columnName] = column.slice();
                 table.rowCount = column.length;
@@ -943,10 +913,6 @@ class DataTable {
         if (tableModifier) {
             tableModifier.modifyColumns(table, columns, (rowIndex || 0));
         }
-        if (table.rowKeysId) {
-            // Ensure that the row keys column is always last
-            this.moveRowKeysColumnToLast(tableColumns, table.rowKeysId);
-        }
         table.emit({
             type: 'afterSetColumns',
             columns,
@@ -955,63 +921,6 @@ class DataTable {
             rowIndex
         });
     }
-    /**
-     * Sets the row key column. This column is invisible and the cells
-     * serve as identifiers to the rows they are contained in. Accessing
-     * rows by keys instead of indexes is necessary in cases where rows
-     * are rearranged by a DataModifier (e.g. SortModifier or RangeModifier).
-     *
-     * @function Highcharts.DataTable#setRowKeysColumn
-     *
-     * @param {number} nRows
-     * Number of rows to add to the column.
-     *
-     */
-    setRowKeysColumn(nRows) {
-        const id = this.rowKeysId;
-        if (!id) {
-            return;
-        }
-        this.columns[id] = [];
-        const keysArray = this.columns[id];
-        for (let i = 0; i < nRows; i++) {
-            keysArray.push(id + '_' + i);
-        }
-    }
-    /**
-     * Get the row key column.
-     *
-     * @function Highcharts.DataTable#getRowKeysColumn
-     *     *
-     * @return {DataTable.Column|undefined}
-     * Returns row keys if rowKeysId is defined, else undefined.
-     */
-    getRowKeysColumn() {
-        const id = this.rowKeysId;
-        if (id) {
-            return this.columns[id];
-        }
-    }
-    /**
-     * Get the row index in the original (unmodified) data table.
-     *
-     * @function Highcharts.DataTable#getRowIndexOriginal
-     *
-     * @param {number} idx
-     * Row index in the modified data table.
-     *
-     * @return {string}
-     * Row index in the original data table.
-     */
-    getRowIndexOriginal(idx) {
-        const id = this.rowKeysId;
-        if (id) {
-            const rowKeyCol = this.columns[id];
-            const idxOrig = '' + rowKeyCol[idx];
-            return idxOrig.split('_')[1];
-        }
-        return String(idx);
-    }
     /**
      * Sets or unsets the modifier for the table.
      *
@@ -1063,6 +972,29 @@ class DataTable {
             throw error;
         });
     }
+    /**
+     * Sets the original row indexes for the table. It is used to keep the
+     * reference to the original rows when modifying the table.
+     *
+     * @param {Array<number|undefined>} originalRowIndexes
+     * Original row indexes array.
+     *
+     * @param {boolean} omitLocalRowIndexes
+     * Whether to omit the local row indexes calculation. Defaults to `false`.
+     */
+    setOriginalRowIndexes(originalRowIndexes, omitLocalRowIndexes = false) {
+        this.originalRowIndexes = originalRowIndexes;
+        if (omitLocalRowIndexes) {
+            return;
+        }
+        const modifiedIndexes = this.localRowIndexes = [];
+        for (let i = 0, iEnd = originalRowIndexes.length, originalIndex; i < iEnd; ++i) {
+            originalIndex = originalRowIndexes[i];
+            if (defined(originalIndex)) {
+                modifiedIndexes[originalIndex] = i;
+            }
+        }
+    }
     /**
      * Sets cell values of a row. Will insert a new row, if no index was
      * provided, or if the index is higher than the total number of table rows.
@@ -1107,7 +1039,7 @@ class DataTable {
      * @emits #afterSetRows
      */
     setRows(rows, rowIndex = this.rowCount, eventDetail) {
-        const table = this, aliases = table.aliases, columns = table.columns, columnNames = Object.keys(columns), modifier = table.modifier, rowCount = rows.length;
+        const table = this, columns = table.columns, columnNames = Object.keys(columns), modifier = table.modifier, rowCount = rows.length;
         table.emit({
             type: 'setRows',
             detail: eventDetail,
@@ -1131,7 +1063,6 @@ class DataTable {
                 const rowColumnNames = Object.keys(row);
                 for (let j = 0, jEnd = rowColumnNames.length, rowColumnName; j < jEnd; ++j) {
                     rowColumnName = rowColumnNames[j];
-                    rowColumnName = (aliases[rowColumnName] || rowColumnName);
                     if (!columns[rowColumnName]) {
                         columns[rowColumnName] = new Array(i2 + 1);
                     }
@@ -1146,9 +1077,6 @@ class DataTable {
                 columns[columnNames[i]].length = indexRowCount;
             }
         }
-        if (this.rowKeysId && !columnNames.includes(this.rowKeysId)) {
-            this.setRowKeysColumn(rowCount);
-        }
         if (modifier) {
             modifier.modifyRows(table, rows, rowIndex);
         }
@@ -1160,23 +1088,6 @@ class DataTable {
             rows
         });
     }
-    // The row keys column must always be the last column
-    moveRowKeysColumnToLast(columns, id) {
-        const rowKeyColumn = columns[id];
-        delete columns[id];
-        columns[id] = rowKeyColumn;
-    }
-    // The row keys column must be removed in some methods
-    // (API backwards compatibility)
-    removeRowKeysColumn(columnNamesOrAliases) {
-        if (this.rowKeysId) {
-            const pos = columnNamesOrAliases.indexOf(this.rowKeysId);
-            if (pos !== -1) {
-                // Always the last column
-                columnNamesOrAliases.pop();
-            }
-        }
-    }
 }
 /* *
  *