handsontable 14.0.0-next-0f92d92-20231130 → 14.1.0-next-514dcd3-20240109

package/cellTypes/dropdownType/dropdownType.js

@@ -2,13 +2,13 @@
 
 exports.__esModule = true;
 var _dropdownEditor = require("../../editors/dropdownEditor");
-var _autocompleteRenderer = require("../../renderers/autocompleteRenderer");
-var _autocompleteValidator = require("../../validators/autocompleteValidator");
+var _dropdownRenderer = require("../../renderers/dropdownRenderer");
+var _dropdownValidator = require("../../validators/dropdownValidator");
 const CELL_TYPE = exports.CELL_TYPE = 'dropdown';
 const DropdownCellType = exports.DropdownCellType = {
   CELL_TYPE,
   editor: _dropdownEditor.DropdownEditor,
   // displays small gray arrow on right side of the cell
-  renderer: _autocompleteRenderer.autocompleteRenderer,
-  validator: _autocompleteValidator.autocompleteValidator
+  renderer: _dropdownRenderer.dropdownRenderer,
+  validator: _dropdownValidator.dropdownValidator
 };

package/cellTypes/dropdownType/dropdownType.mjs

@@ -1,11 +1,11 @@
 import { DropdownEditor } from "../../editors/dropdownEditor/index.mjs";
-import { autocompleteRenderer } from "../../renderers/autocompleteRenderer/index.mjs";
-import { autocompleteValidator } from "../../validators/autocompleteValidator/index.mjs";
+import { dropdownRenderer } from "../../renderers/dropdownRenderer/index.mjs";
+import { dropdownValidator } from "../../validators/dropdownValidator/index.mjs";
 export const CELL_TYPE = 'dropdown';
 export const DropdownCellType = {
   CELL_TYPE,
   editor: DropdownEditor,
   // displays small gray arrow on right side of the cell
-  renderer: autocompleteRenderer,
-  validator: autocompleteValidator
+  renderer: dropdownRenderer,
+  validator: dropdownValidator
 };

package/core/focusCatcher/index.js

@@ -12,14 +12,15 @@ var _focusDetector = require("./focusDetector");
  * @param {Core} hot The Handsontable instance.
  */
 function installFocusCatcher(hot) {
+  const clampCoordsIfNeeded = normalizeCoordsIfNeeded(hot);
   let recentlyAddedFocusCoords;
   const {
     activate,
     deactivate
   } = (0, _focusDetector.installFocusDetector)(hot, {
     onFocusFromTop() {
-      var _recentlyAddedFocusCo;
-      const mostTopStartCoords = (_recentlyAddedFocusCo = recentlyAddedFocusCoords) !== null && _recentlyAddedFocusCo !== void 0 ? _recentlyAddedFocusCo : getMostTopStartPosition(hot);
+      var _clampCoordsIfNeeded;
+      const mostTopStartCoords = (_clampCoordsIfNeeded = clampCoordsIfNeeded(recentlyAddedFocusCoords)) !== null && _clampCoordsIfNeeded !== void 0 ? _clampCoordsIfNeeded : getMostTopStartPosition(hot);
       if (mostTopStartCoords) {
         hot.runHooks('modifyFocusOnTabNavigation', 'from_above', mostTopStartCoords);
         hot.selectCell(mostTopStartCoords.row, mostTopStartCoords.col);
@@ -27,8 +28,8 @@ function installFocusCatcher(hot) {
       hot.listen();
     },
     onFocusFromBottom() {
-      var _recentlyAddedFocusCo2;
-      const mostBottomEndCoords = (_recentlyAddedFocusCo2 = recentlyAddedFocusCoords) !== null && _recentlyAddedFocusCo2 !== void 0 ? _recentlyAddedFocusCo2 : getMostBottomEndPosition(hot);
+      var _clampCoordsIfNeeded2;
+      const mostBottomEndCoords = (_clampCoordsIfNeeded2 = clampCoordsIfNeeded(recentlyAddedFocusCoords)) !== null && _clampCoordsIfNeeded2 !== void 0 ? _clampCoordsIfNeeded2 : getMostBottomEndPosition(hot);
       if (mostBottomEndCoords) {
         hot.runHooks('modifyFocusOnTabNavigation', 'from_below', mostBottomEndCoords);
         hot.selectCell(mostBottomEndCoords.row, mostBottomEndCoords.col);
@@ -42,10 +43,12 @@ function installFocusCatcher(hot) {
   };
   let isSavingCoordsEnabled = true;
   let isTabOrShiftTabPressed = false;
+  let preventViewportScroll = false;
   hot.addHook('afterListen', () => deactivate());
   hot.addHook('afterUnlisten', () => activate());
   hot.addHook('afterSelection', (row, column, row2, column2, preventScrolling) => {
-    if (isTabOrShiftTabPressed && rowWrapState.wrapped && rowWrapState.flipped) {
+    if (isTabOrShiftTabPressed && (rowWrapState.wrapped && rowWrapState.flipped || preventViewportScroll)) {
+      preventViewportScroll = false;
       preventScrolling.value = true;
     }
     if (isSavingCoordsEnabled) {
@@ -77,10 +80,16 @@ function installFocusCatcher(hot) {
   hot.getShortcutManager().getContext('grid').addShortcuts([{
     ...shortcutOptions,
     callback: () => {
+      const {
+        tabNavigation
+      } = hot.getSettings();
       isTabOrShiftTabPressed = true;
-      if (hot.getSelectedRangeLast() && !hot.getSettings().tabNavigation) {
+      if (hot.getSelectedRangeLast() && !tabNavigation) {
         isSavingCoordsEnabled = false;
       }
+      if (!tabNavigation) {
+        preventViewportScroll = true;
+      }
     },
     position: 'before'
   }, {
@@ -165,4 +174,33 @@ function getMostBottomEndPosition(hot) {
     endColumn = -1;
   }
   return hot._createCellCoords((_rowIndexMapper$getVi = rowIndexMapper.getVisualFromRenderableIndex(bottomRow)) !== null && _rowIndexMapper$getVi !== void 0 ? _rowIndexMapper$getVi : bottomRow, (_columnIndexMapper$ge = columnIndexMapper.getVisualFromRenderableIndex(endColumn)) !== null && _columnIndexMapper$ge !== void 0 ? _columnIndexMapper$ge : endColumn);
+}
+
+/**
+ * Normalizes the coordinates (clamps to nearest visible cell position within dataset range).
+ *
+ * @param {Core} hot The Handsontable instance.
+ * @returns {function(Coords | undefined): Coords | null}
+ */
+function normalizeCoordsIfNeeded(hot) {
+  return coords => {
+    if (!coords) {
+      return null;
+    }
+    const mostTopStartCoords = getMostTopStartPosition(hot);
+    const mostBottomEndCoords = getMostBottomEndPosition(hot);
+    if (coords.col < mostTopStartCoords.col) {
+      coords.col = mostTopStartCoords.col;
+    }
+    if (coords.col > mostBottomEndCoords.col) {
+      coords.col = mostBottomEndCoords.col;
+    }
+    if (coords.row < mostTopStartCoords.row) {
+      coords.row = mostTopStartCoords.row;
+    }
+    if (coords.row > mostBottomEndCoords.row) {
+      coords.row = mostBottomEndCoords.row;
+    }
+    return coords;
+  };
 }

package/core/focusCatcher/index.mjs

@@ -8,14 +8,15 @@ import { installFocusDetector } from "./focusDetector.mjs";
  * @param {Core} hot The Handsontable instance.
  */
 export function installFocusCatcher(hot) {
+  const clampCoordsIfNeeded = normalizeCoordsIfNeeded(hot);
   let recentlyAddedFocusCoords;
   const {
     activate,
     deactivate
   } = installFocusDetector(hot, {
     onFocusFromTop() {
-      var _recentlyAddedFocusCo;
-      const mostTopStartCoords = (_recentlyAddedFocusCo = recentlyAddedFocusCoords) !== null && _recentlyAddedFocusCo !== void 0 ? _recentlyAddedFocusCo : getMostTopStartPosition(hot);
+      var _clampCoordsIfNeeded;
+      const mostTopStartCoords = (_clampCoordsIfNeeded = clampCoordsIfNeeded(recentlyAddedFocusCoords)) !== null && _clampCoordsIfNeeded !== void 0 ? _clampCoordsIfNeeded : getMostTopStartPosition(hot);
       if (mostTopStartCoords) {
         hot.runHooks('modifyFocusOnTabNavigation', 'from_above', mostTopStartCoords);
         hot.selectCell(mostTopStartCoords.row, mostTopStartCoords.col);
@@ -23,8 +24,8 @@ export function installFocusCatcher(hot) {
       hot.listen();
     },
     onFocusFromBottom() {
-      var _recentlyAddedFocusCo2;
-      const mostBottomEndCoords = (_recentlyAddedFocusCo2 = recentlyAddedFocusCoords) !== null && _recentlyAddedFocusCo2 !== void 0 ? _recentlyAddedFocusCo2 : getMostBottomEndPosition(hot);
+      var _clampCoordsIfNeeded2;
+      const mostBottomEndCoords = (_clampCoordsIfNeeded2 = clampCoordsIfNeeded(recentlyAddedFocusCoords)) !== null && _clampCoordsIfNeeded2 !== void 0 ? _clampCoordsIfNeeded2 : getMostBottomEndPosition(hot);
       if (mostBottomEndCoords) {
         hot.runHooks('modifyFocusOnTabNavigation', 'from_below', mostBottomEndCoords);
         hot.selectCell(mostBottomEndCoords.row, mostBottomEndCoords.col);
@@ -38,10 +39,12 @@ export function installFocusCatcher(hot) {
   };
   let isSavingCoordsEnabled = true;
   let isTabOrShiftTabPressed = false;
+  let preventViewportScroll = false;
   hot.addHook('afterListen', () => deactivate());
   hot.addHook('afterUnlisten', () => activate());
   hot.addHook('afterSelection', (row, column, row2, column2, preventScrolling) => {
-    if (isTabOrShiftTabPressed && rowWrapState.wrapped && rowWrapState.flipped) {
+    if (isTabOrShiftTabPressed && (rowWrapState.wrapped && rowWrapState.flipped || preventViewportScroll)) {
+      preventViewportScroll = false;
       preventScrolling.value = true;
     }
     if (isSavingCoordsEnabled) {
@@ -73,10 +76,16 @@ export function installFocusCatcher(hot) {
   hot.getShortcutManager().getContext('grid').addShortcuts([{
     ...shortcutOptions,
     callback: () => {
+      const {
+        tabNavigation
+      } = hot.getSettings();
       isTabOrShiftTabPressed = true;
-      if (hot.getSelectedRangeLast() && !hot.getSettings().tabNavigation) {
+      if (hot.getSelectedRangeLast() && !tabNavigation) {
         isSavingCoordsEnabled = false;
       }
+      if (!tabNavigation) {
+        preventViewportScroll = true;
+      }
     },
     position: 'before'
   }, {
@@ -161,4 +170,33 @@ function getMostBottomEndPosition(hot) {
     endColumn = -1;
   }
   return hot._createCellCoords((_rowIndexMapper$getVi = rowIndexMapper.getVisualFromRenderableIndex(bottomRow)) !== null && _rowIndexMapper$getVi !== void 0 ? _rowIndexMapper$getVi : bottomRow, (_columnIndexMapper$ge = columnIndexMapper.getVisualFromRenderableIndex(endColumn)) !== null && _columnIndexMapper$ge !== void 0 ? _columnIndexMapper$ge : endColumn);
+}
+
+/**
+ * Normalizes the coordinates (clamps to nearest visible cell position within dataset range).
+ *
+ * @param {Core} hot The Handsontable instance.
+ * @returns {function(Coords | undefined): Coords | null}
+ */
+function normalizeCoordsIfNeeded(hot) {
+  return coords => {
+    if (!coords) {
+      return null;
+    }
+    const mostTopStartCoords = getMostTopStartPosition(hot);
+    const mostBottomEndCoords = getMostBottomEndPosition(hot);
+    if (coords.col < mostTopStartCoords.col) {
+      coords.col = mostTopStartCoords.col;
+    }
+    if (coords.col > mostBottomEndCoords.col) {
+      coords.col = mostBottomEndCoords.col;
+    }
+    if (coords.row < mostTopStartCoords.row) {
+      coords.row = mostTopStartCoords.row;
+    }
+    if (coords.row > mostBottomEndCoords.row) {
+      coords.row = mostBottomEndCoords.row;
+    }
+    return coords;
+  };
 }

package/core.d.ts

@@ -32,7 +32,7 @@ export default class Core {
   batchRender<R>(wrappedOperations: () => R): R;
   clear(): void;
   clearUndo(): void;
-  colToProp(col: number): string | number;
+  colToProp(column: number): string | number;
   columnIndexMapper: IndexMapper;
   constructor(element: Element, options: GridSettings);
   container: HTMLElement;
@@ -54,22 +54,22 @@ export default class Core {
   emptySelectedCells(): void;
   forceFullRender: boolean;
   getActiveEditor(): BaseEditor | undefined;
-  getCell(row: number, col: number, topmost?: boolean): HTMLTableCellElement | null;
+  getCell(row: number, column: number, topmost?: boolean): HTMLTableCellElement | null;
   getCellEditor(cellMeta: CellMeta): BaseEditor;
-  getCellEditor(row: number, col: number): BaseEditor;
-  getCellMeta(row: number, col: number): CellProperties;
+  getCellEditor(row: number, column: number): BaseEditor;
+  getCellMeta(row: number, column: number): CellProperties;
   getCellMetaAtRow(row: number): CellProperties[];
   getCellRenderer(cellMeta: CellMeta): BaseRenderer;
-  getCellRenderer(row: number, col: number): BaseRenderer;
+  getCellRenderer(row: number, column: number): BaseRenderer;
   getCellsMeta(): CellProperties[];
   getCellValidator(cellMeta: CellMeta): BaseValidator | RegExp | undefined;
-  getCellValidator(row: number, col: number): BaseValidator | RegExp | undefined;
+  getCellValidator(row: number, column: number): BaseValidator | RegExp | undefined;
   getColHeader(): Array<number | string>;
   getColHeader(column: number, headerLevel?: number): number | string;
-  getColWidth(col: number): number;
-  getCoords(elem: Element | null): CellCoords;
+  getColWidth(column: number): number;
+  getCoords(element: Element | null): CellCoords;
   getCopyableData(row: number, column: number): string;
-  getCopyableText(startRow: number, startCol: number, endRow: number, endCol: number): string;
+  getCopyableText(startRow: number, startColumn: number, endRow: number, endColumn: number): string;
   getData(row?: number, column?: number, row2?: number, column2?: number): CellValue[];
   getDataAtCell(row: number, column: number): CellValue;
   getDataAtCol(column: number): CellValue[];
@@ -105,7 +105,7 @@ export default class Core {
   init(): () => void;
   isColumnModificationAllowed(): boolean;
   isDestroyed: boolean;
-  isEmptyCol(col: number): boolean;
+  isEmptyCol(column: number): boolean;
   isEmptyRow(row: number): boolean;
   isExecutionSuspended(): boolean;
   isListening(): boolean;
@@ -116,12 +116,12 @@ export default class Core {
   isUndoAvailable(): boolean;
   listen(): void;
   loadData(data: CellValue[][] | RowObject[], source?: string): void;
-  populateFromArray(row: number, col: number, input: CellValue[][], endRow?: number,
-    endCol?: number, source?: string, method?: 'shift_down' | 'shift_right' | 'overwrite'): void;
+  populateFromArray(row: number, column: number, input: CellValue[][], endRow?: number,
+    endColumn?: number, source?: string, method?: 'shift_down' | 'shift_right' | 'overwrite'): void;
   propToCol(prop: string | number): string | number;
   redo(): void;
   refreshDimensions(): void;
-  removeCellMeta(row: number, col: number, key: (keyof CellMeta) | string): void;
+  removeCellMeta(row: number, column: number, key: (keyof CellMeta) | string): void;
   removeHook<K extends keyof Events>(key: K, callback: Events[K]): void;
   render(): void;
   renderCall: boolean;
@@ -136,21 +136,21 @@ export default class Core {
   scrollViewportTo(row?: number, column?: number, snapToBottom?: boolean, snapToRight?: boolean, considerHiddenIndexes?: boolean): boolean;
   scrollToFocusedCell(callback?: () => void): void;
   selectAll(includeRowHeaders?: boolean, includeColumnHeaders?: boolean, options?: { focusPosition?: { row: number, col: number }, disableHeadersHighlight?: boolean }): void;
-  selectCell(row: number, col: number, endRow?: number, endCol?: number, scrollToCell?: boolean, changeListener?: boolean): boolean;
+  selectCell(row: number, column: number, endRow?: number, endColumn?: number, scrollToCell?: boolean, changeListener?: boolean): boolean;
   selectCellByProp(row: number, prop: string, endRow?: number, endProp?: string, scrollToCell?: boolean): boolean;
   selectCells(coords: Array<[number, number | string, number, number | string]> | CellRange[], scrollToCell?: boolean, changeListener?: boolean): boolean;
   selectColumns(startColumn: number | string, endColumn?: number | string, focusPosition?: number): boolean;
   selectRows(startRow: number, endRow?: number, focusPosition?: number): boolean;
-  setCellMeta(row: number, col: number, key: string, val: any): void;
-  setCellMeta<K extends keyof CellMeta>(row: number, col: number, key: K, val: CellMeta[K]): void;
-  setCellMetaObject(row: number, col: number, prop: CellMeta): void;
+  setCellMeta(row: number, column: number, key: string, val: any): void;
+  setCellMeta<K extends keyof CellMeta>(row: number, column: number, key: K, val: CellMeta[K]): void;
+  setCellMetaObject(row: number, column: number, prop: CellMeta): void;
   setDataAtCell(changes: Array<[number, number, CellValue]>, source?: string): void;
-  setDataAtCell(row: number, col: number, value: CellValue, source?: string): void;
+  setDataAtCell(row: number, column: number, value: CellValue, source?: string): void;
   setDataAtRowProp(changes: Array<[number, string | number, CellValue]>, source?: string): void;
   setDataAtRowProp(row: number, prop: string, value: CellValue, source?: string): void;
   setSourceDataAtCell(changes: Array<[number, string | number, CellValue]>, source?: string): void;
   setSourceDataAtCell(row: number, column: number | string, value: CellValue, source?: string): void;
-  spliceCol(col: number, index: number, amount: number, ...elements: CellValue[]): void;
+  spliceCol(column: number, index: number, amount: number, ...elements: CellValue[]): void;
   spliceRow(row: number, index: number, amount: number, ...elements: CellValue[]): void;
   suspendExecution(): void;
   suspendRender(): void;

package/core.js

@@ -254,7 +254,6 @@ function Core(rootElement, userSettings) {
   if (!this.rootElement.id || this.rootElement.id.substring(0, 3) === 'ht_') {
     this.rootElement.id = this.guid; // if root element does not have an id, assign a random id
   }
-
   const visualToRenderableCoords = coords => {
     const {
       row: visualRow,
@@ -274,7 +273,6 @@ function Core(rootElement, userSettings) {
     renderableRow >= 0 ? instance.rowIndexMapper.getVisualFromRenderableIndex(renderableRow) : renderableRow, renderableColumn >= 0 ? instance.columnIndexMapper.getVisualFromRenderableIndex(renderableColumn) : renderableColumn // eslint-disable-line max-len
     );
   };
-
   let selection = new _selection.Selection(tableMeta, {
     rowIndexMapper: instance.rowIndexMapper,
     columnIndexMapper: instance.columnIndexMapper,
@@ -577,7 +575,6 @@ function Core(rootElement, userSettings) {
               instance._refreshBorders(); // it will call render and prepare methods
             }
           }
-
           break;
         case 'insert_col_start':
         case 'insert_col_end':
@@ -600,7 +597,6 @@ function Core(rootElement, userSettings) {
               spliceArray.length += colDelta; // inserts empty (undefined) elements at the end of an array
               Array.prototype.splice.apply(tableMeta.colHeaders, spliceArray); // inserts empty (undefined) elements into the colHeader array
             }
-
             const currentSelectedRange = selection.selectedRange.current();
             const currentFromRange = currentSelectedRange === null || currentSelectedRange === void 0 ? void 0 : currentSelectedRange.from;
             const currentFromColumn = currentFromRange === null || currentFromRange === void 0 ? void 0 : currentFromRange.col;
@@ -634,7 +630,6 @@ function Core(rootElement, userSettings) {
               instance._refreshBorders(); // it will call render and prepare methods
             }
           }
-
           break;
         case 'remove_row':
           const removeRow = indexes => {
@@ -730,7 +725,6 @@ function Core(rootElement, userSettings) {
         grid.adjustRowsAndCols(); // makes sure that we did not add rows that will be removed in next refresh
       }
     },
-
     /**
      * Makes sure there are empty rows at the bottom of the table.
      *
@@ -841,7 +835,13 @@ function Core(rootElement, userSettings) {
             }
           }
           if (selectionChanged) {
-            instance.selectCell(fromRow, fromCol, toRow, toCol);
+            if (fromCol < 0) {
+              instance.selectRows(fromRow, toRow, fromCol);
+            } else if (fromRow < 0) {
+              instance.selectColumns(fromCol, toCol, fromRow);
+            } else {
+              instance.selectCell(fromRow, fromCol, toRow, toCol);
+            }
           }
         });
       }
@@ -1186,7 +1186,6 @@ function Core(rootElement, userSettings) {
       }
       callback(isValid); // called when async validators are resolved and beforeChange was not async
     };
-
     for (let i = changes.length - 1; i >= 0; i--) {
       const [row, prop,, newValue] = changes[i];
       const col = datamap.propToCol(prop);
@@ -1456,7 +1455,6 @@ function Core(rootElement, userSettings) {
       if (typeof input[i][1] !== 'number') {
         throw new Error('Method `setDataAtCell` accepts row and column number as its parameters. If you want to use object property name, use method `setDataAtRowProp`'); // eslint-disable-line max-len
       }
-
       if (input[i][1] >= this.countCols()) {
         prop = input[i][1];
       } else {
@@ -1587,7 +1585,6 @@ function Core(rootElement, userSettings) {
     if (!(typeof input === 'object' && typeof input[0] === 'object')) {
       throw new Error('populateFromArray parameter `input` must be an array of arrays'); // API changed in 0.9-beta2, let's check if you use it correctly
     }
-
     const c = typeof endRow === 'number' ? instance._createCellCoords(endRow, endCol) : null;
     return grid.populateFromArray(instance._createCellCoords(row, column), input, c, source, method);
   };
@@ -3488,7 +3485,6 @@ function Core(rootElement, userSettings) {
     } else if (tableMeta.colHeaders && typeof tableMeta.colHeaders !== 'string' && typeof tableMeta.colHeaders !== 'number') {
       result = (0, _data.spreadsheetColumnLabel)(columnIndex); // see #1458
     }
-
     result = instance.runHooks('modifyColumnHeaderValue', result, column, headerLevel);
     return result;
   };
@@ -4119,7 +4115,6 @@ function Core(rootElement, userSettings) {
       };
       /* eslint-enable prefer-rest-params */
     }
-
     const {
       row,
       col,

package/core.mjs

@@ -249,7 +249,6 @@ export default function Core(rootElement, userSettings) {
   if (!this.rootElement.id || this.rootElement.id.substring(0, 3) === 'ht_') {
     this.rootElement.id = this.guid; // if root element does not have an id, assign a random id
   }
-
   const visualToRenderableCoords = coords => {
     const {
       row: visualRow,
@@ -269,7 +268,6 @@ export default function Core(rootElement, userSettings) {
     renderableRow >= 0 ? instance.rowIndexMapper.getVisualFromRenderableIndex(renderableRow) : renderableRow, renderableColumn >= 0 ? instance.columnIndexMapper.getVisualFromRenderableIndex(renderableColumn) : renderableColumn // eslint-disable-line max-len
     );
   };
-
   let selection = new Selection(tableMeta, {
     rowIndexMapper: instance.rowIndexMapper,
     columnIndexMapper: instance.columnIndexMapper,
@@ -572,7 +570,6 @@ export default function Core(rootElement, userSettings) {
               instance._refreshBorders(); // it will call render and prepare methods
             }
           }
-
           break;
         case 'insert_col_start':
         case 'insert_col_end':
@@ -595,7 +592,6 @@ export default function Core(rootElement, userSettings) {
               spliceArray.length += colDelta; // inserts empty (undefined) elements at the end of an array
               Array.prototype.splice.apply(tableMeta.colHeaders, spliceArray); // inserts empty (undefined) elements into the colHeader array
             }
-
             const currentSelectedRange = selection.selectedRange.current();
             const currentFromRange = currentSelectedRange === null || currentSelectedRange === void 0 ? void 0 : currentSelectedRange.from;
             const currentFromColumn = currentFromRange === null || currentFromRange === void 0 ? void 0 : currentFromRange.col;
@@ -629,7 +625,6 @@ export default function Core(rootElement, userSettings) {
               instance._refreshBorders(); // it will call render and prepare methods
             }
           }
-
           break;
         case 'remove_row':
           const removeRow = indexes => {
@@ -725,7 +720,6 @@ export default function Core(rootElement, userSettings) {
         grid.adjustRowsAndCols(); // makes sure that we did not add rows that will be removed in next refresh
       }
     },
-
     /**
      * Makes sure there are empty rows at the bottom of the table.
      *
@@ -836,7 +830,13 @@ export default function Core(rootElement, userSettings) {
             }
           }
           if (selectionChanged) {
-            instance.selectCell(fromRow, fromCol, toRow, toCol);
+            if (fromCol < 0) {
+              instance.selectRows(fromRow, toRow, fromCol);
+            } else if (fromRow < 0) {
+              instance.selectColumns(fromCol, toCol, fromRow);
+            } else {
+              instance.selectCell(fromRow, fromCol, toRow, toCol);
+            }
           }
         });
       }
@@ -1181,7 +1181,6 @@ export default function Core(rootElement, userSettings) {
       }
       callback(isValid); // called when async validators are resolved and beforeChange was not async
     };
-
     for (let i = changes.length - 1; i >= 0; i--) {
       const [row, prop,, newValue] = changes[i];
       const col = datamap.propToCol(prop);
@@ -1451,7 +1450,6 @@ export default function Core(rootElement, userSettings) {
       if (typeof input[i][1] !== 'number') {
         throw new Error('Method `setDataAtCell` accepts row and column number as its parameters. If you want to use object property name, use method `setDataAtRowProp`'); // eslint-disable-line max-len
       }
-
       if (input[i][1] >= this.countCols()) {
         prop = input[i][1];
       } else {
@@ -1582,7 +1580,6 @@ export default function Core(rootElement, userSettings) {
     if (!(typeof input === 'object' && typeof input[0] === 'object')) {
       throw new Error('populateFromArray parameter `input` must be an array of arrays'); // API changed in 0.9-beta2, let's check if you use it correctly
     }
-
     const c = typeof endRow === 'number' ? instance._createCellCoords(endRow, endCol) : null;
     return grid.populateFromArray(instance._createCellCoords(row, column), input, c, source, method);
   };
@@ -3483,7 +3480,6 @@ export default function Core(rootElement, userSettings) {
     } else if (tableMeta.colHeaders && typeof tableMeta.colHeaders !== 'string' && typeof tableMeta.colHeaders !== 'number') {
       result = spreadsheetColumnLabel(columnIndex); // see #1458
     }
-
     result = instance.runHooks('modifyColumnHeaderValue', result, column, headerLevel);
     return result;
   };
@@ -4114,7 +4110,6 @@ export default function Core(rootElement, userSettings) {
       };
       /* eslint-enable prefer-rest-params */
     }
-
     const {
       row,
       col,

package/dataMap/dataMap.js

@@ -10,8 +10,8 @@ var _array = require("../helpers/array");
 var _number = require("../helpers/number");
 var _mixed = require("../helpers/mixed");
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /*
 This class contains open-source contributions covered by the MIT license.
 
@@ -33,6 +33,7 @@ The above copyright notice and this permission notice shall be included in all c
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
+
 /**
  * Utility class that gets and saves data from/to the data source using mapping of columns numbers to object property names.
  *

package/dataMap/dataMap.mjs

@@ -1,8 +1,8 @@
 import "core-js/modules/es.error.cause.js";
 import "core-js/modules/es.array.push.js";
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { stringify } from "../3rdparty/SheetClip/index.mjs";
 import { countFirstRowKeys } from "../helpers/data.mjs";
 import { createObjectPropListener, deepClone, deepExtend, deepObjectSize, duckSchema, hasOwnProperty, isObject, objectEach } from "../helpers/object.mjs";

package/dataMap/dataSource.js

@@ -9,8 +9,8 @@ var _array = require("../helpers/array");
 var _number = require("../helpers/number");
 var _function = require("../helpers/function");
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /**
  * @class DataSource
  * @private

package/dataMap/dataSource.mjs

@@ -1,8 +1,8 @@
 import "core-js/modules/es.array.push.js";
 import "core-js/modules/es.error.cause.js";
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { createObjectPropListener, getProperty, isObject, objectEach, setProperty } from "../helpers/object.mjs";
 import { countFirstRowKeys } from "../helpers/data.mjs";
 import { arrayEach } from "../helpers/array.mjs";

package/dataMap/metaManager/lazyFactoryMap.js

@@ -7,8 +7,8 @@ var _array = require("../../helpers/array");
 var _utils = require("./utils");
 let _Symbol$iterator;
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * @class LazyFactoryMap

package/dataMap/metaManager/lazyFactoryMap.mjs

@@ -2,8 +2,8 @@ import "core-js/modules/es.error.cause.js";
 let _Symbol$iterator;
 import "core-js/modules/es.array.push.js";
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { arrayFilter } from "../../helpers/array.mjs";
 import { assert, isUnsignedNumber, isNullish } from "./utils.mjs";
 /* eslint-disable jsdoc/require-description-complete-sentence */

package/dataMap/metaManager/metaLayers/cellMeta.js

@@ -8,8 +8,8 @@ var _utils = require("../utils");
 var _lazyFactoryMap = _interopRequireDefault(require("../lazyFactoryMap"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 /* eslint-disable jsdoc/require-description-complete-sentence */
 /**
  * @class CellMeta

package/dataMap/metaManager/metaLayers/cellMeta.mjs

@@ -1,8 +1,8 @@
 import "core-js/modules/es.array.push.js";
 import "core-js/modules/es.error.cause.js";
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { extend } from "../../../helpers/object.mjs";
 import { extendByMetaType, assert, isUnsignedNumber } from "../utils.mjs";
 import LazyFactoryMap from "../lazyFactoryMap.mjs";