@carbon/ibm-products 1.12.0 → 1.15.0

package/lib/components/DataSpreadsheet/DataSpreadsheet.js

@@ -2,7 +2,7 @@
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 
-var _typeof = require("@babel/runtime/helpers/typeof");
+var _typeof3 = require("@babel/runtime/helpers/typeof");
 
 Object.defineProperty(exports, "__esModule", {
   value: true
@@ -11,7 +11,7 @@ exports.DataSpreadsheet = void 0;
 
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
 
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
@@ -43,11 +43,9 @@ var _hooks = require("../../global/js/hooks");
 
 var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
 
-var _useResetSpreadsheetFocus = require("./hooks/useResetSpreadsheetFocus");
+var _deepCloneObject = require("../../global/js/utils/deepCloneObject");
 
-var _useSpreadsheetOutsideClick = require("./hooks/useSpreadsheetOutsideClick");
-
-var _useMoveActiveCell = require("./hooks/useMoveActiveCell");
+var _hooks2 = require("./hooks");
 
 var _createActiveCellFn = require("./utils/createActiveCellFn");
 
@@ -57,11 +55,21 @@ var _handleMultipleKeys = require("./utils/handleMultipleKeys");
 
 var _handleHeaderCellSelection = require("./utils/handleHeaderCellSelection");
 
-var _excluded = ["cellSize", "className", "columns", "data", "onDataUpdate", "id", "onActiveCellChange", "onSelectionAreaChange"];
+var _removeCellSelections = require("./utils/removeCellSelections");
+
+var _selectAllCells = require("./utils/selectAllCells");
+
+var _handleEditSubmit = require("./utils/handleEditSubmit");
+
+var _handleActiveCellInSelectionEnter = require("./utils/handleActiveCellInSelectionEnter");
+
+var _handleActiveCellInSelectionTab = require("./utils/handleActiveCellInSelectionTab");
+
+var _excluded = ["cellSize", "className", "columns", "data", "defaultEmptyRowCount", "onDataUpdate", "id", "onActiveCellChange", "onSelectionAreaChange"];
 
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof3(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 
@@ -76,6 +84,7 @@ var defaults = {
   cellSize: 'standard',
   columns: Object.freeze([]),
   data: Object.freeze([]),
+  defaultEmptyRowCount: 16,
   onDataUpdate: Object.freeze(function () {}),
   onActiveCellChange: Object.freeze(function () {}),
   onSelectionAreaChange: Object.freeze(function () {})
@@ -92,6 +101,8 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       columns = _ref$columns === void 0 ? defaults.columns : _ref$columns,
       _ref$data = _ref.data,
       data = _ref$data === void 0 ? defaults.data : _ref$data,
+      _ref$defaultEmptyRowC = _ref.defaultEmptyRowCount,
+      defaultEmptyRowCount = _ref$defaultEmptyRowC === void 0 ? defaults.defaultEmptyRowCount : _ref$defaultEmptyRowC,
       _ref$onDataUpdate = _ref.onDataUpdate,
       onDataUpdate = _ref$onDataUpdate === void 0 ? defaults.onDataUpdate : _ref$onDataUpdate,
       id = _ref.id,
@@ -100,6 +111,7 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       _ref$onSelectionAreaC = _ref.onSelectionAreaChange,
       onSelectionAreaChange = _ref$onSelectionAreaC === void 0 ? defaults.onSelectionAreaChange : _ref$onSelectionAreaC,
       rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var multiKeyTrackingRef = (0, _react.useRef)();
   var localRef = (0, _react.useRef)();
   var spreadsheetRef = ref || localRef;
   var focusedElement = (0, _hooks.useActiveElement)();
@@ -144,19 +156,25 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       cellEditorValue = _useState16[0],
       setCellEditorValue = _useState16[1];
 
+  var _useState17 = (0, _react.useState)(false),
+      _useState18 = (0, _slicedToArray2.default)(_useState17, 2),
+      activeCellInsideSelectionArea = _useState18[0],
+      setActiveCellInsideSelectionArea = _useState18[1];
+
   var previousState = (0, _hooks.usePreviousValue)({
-    activeCellCoordinates: activeCellCoordinates
+    activeCellCoordinates: activeCellCoordinates,
+    isEditing: isEditing
   });
   var cellSizeValue = (0, _getCellSize.getCellSize)(cellSize);
   var cellEditorRef = (0, _react.useRef)();
 
-  var _useState17 = (0, _react.useState)(),
-      _useState18 = (0, _slicedToArray2.default)(_useState17, 2),
-      activeCellContent = _useState18[0],
-      setActiveCellContent = _useState18[1];
+  var _useState19 = (0, _react.useState)(),
+      _useState20 = (0, _slicedToArray2.default)(_useState19, 2),
+      activeCellContent = _useState20[0],
+      setActiveCellContent = _useState20[1];
 
-  var activeKeys = (0, _react.useRef)([]);
   var activeCellRef = (0, _react.useRef)();
+  var cellEditorRulerRef = (0, _react.useRef)();
   var defaultColumn = (0, _react.useMemo)(function () {
     return {
       width: 150,
@@ -164,6 +182,15 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       rowHeight: cellSizeValue
     };
   }, [cellSizeValue]);
+
+  var _useMultipleKeyTracki = (0, _hooks2.useMultipleKeyTracking)({
+    ref: multiKeyTrackingRef,
+    containerHasFocus: containerHasFocus,
+    isEditing: isEditing
+  }),
+      keysPressedList = _useMultipleKeyTracki.keysPressedList,
+      usingMac = _useMultipleKeyTracki.usingMac;
+
   var scrollBarSize = (0, _react.useMemo)(function () {
     return (0, _getScrollbarWidth.getScrollbarWidth)();
   }, []);
@@ -204,22 +231,7 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     setCellEditorValue('');
     setIsEditing(false);
     cellEditorRef.current.style.display = 'none';
-  }, []); // Removes the cell selection elements
-
-  var removeCellSelections = (0, _react.useCallback)(function (matcher) {
-    if (matcher && typeof matcher === 'string') {
-      var selectionToRemove = spreadsheetRef.current.querySelector("[data-matcher-id=\"".concat(matcher, "\"]"));
-
-      if (selectionToRemove) {
-        selectionToRemove.remove();
-      }
-    } else {
-      var cellSelections = spreadsheetRef.current.querySelectorAll(".".concat(blockClass, "__selection-area--element"));
-      (0, _toConsumableArray2.default)(cellSelections).forEach(function (element) {
-        return element.remove();
-      });
-    }
-  }, [spreadsheetRef]); // Remove cell editor if the active cell coordinates change and save with new cell data, this will
+  }, []); // Remove cell editor if the active cell coordinates change and save with new cell data, this will
   // happen if you click on another cell while isEditing is true
 
   (0, _react.useEffect)(function () {
@@ -229,6 +241,7 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       var cellProps = rows[prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.row].cells[prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.column];
       removeCellEditor();
       updateData(prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.row, cellProps.column.id);
+      cellEditorRulerRef.current.textContent = '';
     }
 
     if ((prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.row) !== (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) || (prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.column) !== (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column)) {
@@ -266,23 +279,21 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       });
     }
   }, [spreadsheetRef, rows, onActiveCellChange, previousState === null || previousState === void 0 ? void 0 : previousState.activeCellCoordinates, defaultColumn]);
-  (0, _useResetSpreadsheetFocus.useResetSpreadsheetFocus)({
-    activeKeys: activeKeys,
+  (0, _hooks2.useResetSpreadsheetFocus)({
     focusedElement: focusedElement,
     removeActiveCell: removeActiveCell,
     setContainerHasFocus: setContainerHasFocus
   });
-  (0, _useSpreadsheetOutsideClick.useSpreadsheetOutsideClick)({
+  (0, _hooks2.useSpreadsheetOutsideClick)({
     spreadsheetRef: spreadsheetRef,
     setActiveCellCoordinates: setActiveCellCoordinates,
     setSelectionAreas: setSelectionAreas,
     removeActiveCell: removeActiveCell,
-    removeCellSelections: removeCellSelections,
+    removeCellSelections: _removeCellSelections.removeCellSelections,
     setContainerHasFocus: setContainerHasFocus,
-    activeKeys: activeKeys,
     removeCellEditor: removeCellEditor
   });
-  (0, _useMoveActiveCell.useMoveActiveCell)({
+  (0, _hooks2.useMoveActiveCell)({
     spreadsheetRef: spreadsheetRef,
     activeCellCoordinates: activeCellCoordinates,
     containerHasFocus: containerHasFocus,
@@ -291,6 +302,8 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
   var handleInitialArrowPress = (0, _react.useCallback)(function () {
     // If activeCellCoordinates is null then we need to set an initial value
     // which will place the activeCell on the select all cell/button
+    setActiveCellInsideSelectionArea(false);
+
     if (!activeCellCoordinates) {
       setActiveCellCoordinates({
         column: 'header',
@@ -301,16 +314,20 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     return;
   }, [activeCellCoordinates]);
   var updateActiveCellCoordinates = (0, _react.useCallback)(function (_ref3) {
-    var coords = _ref3.coords,
-        updatedValue = _ref3.updatedValue;
+    var _ref3$coords = _ref3.coords,
+        coords = _ref3$coords === void 0 ? _objectSpread({}, activeCellCoordinates) : _ref3$coords,
+        updatedValue = _ref3.updatedValue,
+        _ref3$optOutOfSelecti = _ref3.optOutOfSelectionAreaUpdate,
+        optOutOfSelectionAreaUpdate = _ref3$optOutOfSelecti === void 0 ? false : _ref3$optOutOfSelecti;
 
     var newActiveCell = _objectSpread(_objectSpread({}, coords), updatedValue);
 
     setActiveCellCoordinates(newActiveCell); // Only run if the active cell is _not_ a header cell. This will add a point1 object
     // to selectionAreas every time the active cell changes, allowing us to create cell
-    // selections using keyboard
+    // selections using keyboard. Opting out of the selection area updates here means
+    // that the active cell is being moved within a selection area
 
-    if (newActiveCell.row !== 'header' && newActiveCell.column !== 'header') {
+    if (newActiveCell.row !== 'header' && newActiveCell.column !== 'header' && !optOutOfSelectionAreaUpdate) {
       var tempMatcher = (0, _uuidv.default)();
       setSelectionAreas([{
         point1: newActiveCell,
@@ -318,11 +335,29 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       }]);
       setCurrentMatcher(tempMatcher);
     }
-  }, []);
+  }, [activeCellCoordinates]);
+  var handleHomeEndKey = (0, _react.useCallback)(function (_ref4) {
+    var type = _ref4.type;
+
+    var coordinatesClone = _objectSpread({}, activeCellCoordinates);
+
+    updateActiveCellCoordinates({
+      coords: coordinatesClone,
+      updatedValue: {
+        column: type === 'home' ? 0 : columns.length - 1
+      }
+    });
+    (0, _removeCellSelections.removeCellSelections)({
+      spreadsheetRef: spreadsheetRef
+    });
+  }, [activeCellCoordinates, updateActiveCellCoordinates, spreadsheetRef, columns.length]);
   var handleKeyPress = (0, _react.useCallback)(function (event) {
-    var _activeKeys$current, _activeKeys$current2;
+    var key = event.key;
+
+    if (isEditing) {
+      return;
+    } // Command keys need to be returned as there is default browser behavior with these keys
 
-    var key = event.key; // Command keys need to be returned as there is default browser behavior with these keys
 
     if (key === 'Meta' || key === 'Control') {
       return;
@@ -339,43 +374,90 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
 
 
     if (['ArrowLeft', 'ArrowUp', 'ArrowRight', 'ArrowDown'].indexOf(key) > -1) {
-      if (isEditing) {
-        return;
-      }
-
-      if (selectionAreas !== null && selectionAreas !== void 0 && selectionAreas.length && key !== 'Shift' && !activeKeys.current.includes('Shift')) {
+      if (selectionAreas !== null && selectionAreas !== void 0 && selectionAreas.length && keysPressedList.length < 2 && !(0, _handleMultipleKeys.includesShift)(keysPressedList)) {
         setSelectionAreas([]);
         setSelectionAreaData([]);
-        removeCellSelections({
+        (0, _removeCellSelections.removeCellSelections)({
           spreadsheetRef: spreadsheetRef
         });
       }
-    } // Update list of activeKeys
-
-
-    if (!((_activeKeys$current = activeKeys.current) !== null && _activeKeys$current !== void 0 && _activeKeys$current.includes(key))) {
-      var activeClone = (0, _toConsumableArray2.default)(activeKeys.current);
-      activeKeys.current = [].concat((0, _toConsumableArray2.default)(activeClone), [key]);
     }
 
-    if (((_activeKeys$current2 = activeKeys.current) === null || _activeKeys$current2 === void 0 ? void 0 : _activeKeys$current2.length) > 1) {
+    if (!isEditing && (keysPressedList === null || keysPressedList === void 0 ? void 0 : keysPressedList.length) > 1) {
       (0, _handleMultipleKeys.handleMultipleKeys)({
-        activeKeys: activeKeys,
+        activeCellCoordinates: activeCellCoordinates,
+        event: event,
+        keysPressedList: keysPressedList,
         selectionAreas: selectionAreas,
         currentMatcher: currentMatcher,
         rows: rows,
         setSelectionAreas: setSelectionAreas,
-        columns: columns
+        columns: columns,
+        updateActiveCellCoordinates: updateActiveCellCoordinates,
+        spreadsheetRef: spreadsheetRef,
+        removeCellSelections: _removeCellSelections.removeCellSelections,
+        blockClass: blockClass,
+        setCurrentMatcher: setCurrentMatcher,
+        usingMac: usingMac
       });
     } // Allow arrow key navigation if there are less than two activeKeys OR
     // if one of the activeCellCoordinates is in a header position
 
 
-    if (!activeKeys.current.includes('Shift') || activeCellCoordinates.row === 'header' || activeCellCoordinates.column === 'header') {
+    if (keysPressedList.length < 2 && !(0, _handleMultipleKeys.includesShift)(keysPressedList) || activeCellCoordinates.row === 'header' || activeCellCoordinates.column === 'header') {
       switch (key) {
+        // Enter
+        case 'Enter':
+          {
+            (0, _handleActiveCellInSelectionEnter.handleActiveCellInSelectionEnter)({
+              activeCellInsideSelectionArea: activeCellInsideSelectionArea,
+              activeCellCoordinates: activeCellCoordinates,
+              activeCellRef: activeCellRef,
+              selectionAreas: selectionAreas,
+              updateActiveCellCoordinates: updateActiveCellCoordinates
+            });
+            break;
+          }
+        // HOME
+
+        case 'Home':
+          {
+            if ((0, _handleMultipleKeys.includesResourceKey)(keysPressedList, usingMac)) {
+              return;
+            }
+
+            handleHomeEndKey({
+              type: 'home'
+            });
+            break;
+          }
+
+        case 'End':
+          {
+            if ((0, _handleMultipleKeys.includesResourceKey)(keysPressedList, usingMac)) {
+              return;
+            }
+
+            handleHomeEndKey({
+              type: 'end'
+            });
+            break;
+          }
         // Tab
+
         case 'Tab':
           {
+            if (activeCellInsideSelectionArea) {
+              event.preventDefault();
+              return (0, _handleActiveCellInSelectionTab.handleActiveCellInSelectionTab)({
+                activeCellInsideSelectionArea: activeCellInsideSelectionArea,
+                activeCellCoordinates: activeCellCoordinates,
+                activeCellRef: activeCellRef,
+                selectionAreas: selectionAreas,
+                updateActiveCellCoordinates: updateActiveCellCoordinates
+              });
+            }
+
             setSelectionAreas([]);
             removeActiveCell();
             removeCellEditor();
@@ -522,24 +604,59 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
           }
       }
     }
-  }, [updateActiveCellCoordinates, handleInitialArrowPress, activeCellCoordinates, removeActiveCell, columns, rows, spreadsheetRef, currentMatcher, isEditing, removeCellEditor, removeCellSelections, selectionAreas]);
+  }, [activeCellInsideSelectionArea, updateActiveCellCoordinates, handleInitialArrowPress, activeCellCoordinates, removeActiveCell, columns, rows, spreadsheetRef, currentMatcher, isEditing, removeCellEditor, selectionAreas, handleHomeEndKey, keysPressedList, usingMac]);
 
   var startEditMode = function startEditMode() {
     setIsEditing(true);
     var activeCellFullData = typeof (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'number' && typeof (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'number' ? rows[activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row].cells[activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column] : null;
     var activeCellValue = activeCellFullData ? Object.values(activeCellFullData.row.values)[activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column] : null;
     setCellEditorValue(activeCellValue);
-  };
+    cellEditorRulerRef.current.textContent = activeCellValue;
+  }; // Sets the initial placement of the cell editor cursor at the end of the text area
+  // this is not done for us by default in Safari
+
+
+  (0, _react.useEffect)(function () {
+    if (isEditing && !(previousState !== null && previousState !== void 0 && previousState.isEditing)) {
+      cellEditorRef.current.setSelectionRange(cellEditorRulerRef.current.textContent.length, cellEditorRulerRef.current.textContent.length);
+      cellEditorRef.current.focus();
+    }
+  }, [isEditing, previousState === null || previousState === void 0 ? void 0 : previousState.isEditing]);
 
   var handleActiveCellClick = function handleActiveCellClick() {
     if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header' || (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header') {
       var indexValue = (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header' ? activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column : activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row;
+
+      if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header' && (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header') {
+        return;
+      }
+
       handleRowColumnHeaderClick({
         isKeyboard: false,
         index: indexValue
       });
     }
 
+    return;
+  }; // Mouse down on active cell
+
+
+  var handleActiveCellMouseDown = function handleActiveCellMouseDown() {
+    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) !== 'header' || (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) !== 'header') {
+      var tempMatcher = (0, _uuidv.default)();
+      setClickAndHoldActive(true);
+      (0, _removeCellSelections.removeCellSelections)({
+        spreadsheetRef: spreadsheetRef
+      });
+      setSelectionAreas([{
+        point1: activeCellCoordinates,
+        matcher: tempMatcher
+      }]);
+      setCurrentMatcher(tempMatcher);
+      setSelectionAreaData([]);
+      setActiveCellInsideSelectionArea(false);
+    }
+
     return;
   }; // Go into edit mode if 'Enter' key is pressed on activeCellRef
 
@@ -547,7 +664,7 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
   var handleActiveCellKeyDown = function handleActiveCellKeyDown(event) {
     var key = event.key;
 
-    if (key === 'Enter') {
+    if (key === 'Enter' && !activeCellInsideSelectionArea) {
       if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) !== 'header' && (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) !== 'header') {
         startEditMode();
       }
@@ -560,10 +677,10 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     }
   };
 
-  var handleRowColumnHeaderClick = function handleRowColumnHeaderClick(_ref4) {
-    var isKeyboard = _ref4.isKeyboard,
-        _ref4$index = _ref4.index,
-        index = _ref4$index === void 0 ? null : _ref4$index;
+  var handleRowColumnHeaderClick = function handleRowColumnHeaderClick(_ref5) {
+    var isKeyboard = _ref5.isKeyboard,
+        _ref5$index = _ref5.index,
+        index = _ref5$index === void 0 ? null : _ref5$index;
     var handleHeaderCellProps = {
       activeCellCoordinates: activeCellCoordinates,
       rows: rows,
@@ -577,112 +694,100 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       index: index
     }; // Select an entire column
 
-    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header') {
+    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header' && (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) !== 'header') {
       (0, _handleHeaderCellSelection.handleHeaderCellSelection)(_objectSpread({
         type: 'column'
       }, handleHeaderCellProps));
     } // Select an entire row
 
 
-    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header') {
+    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header' && (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) !== 'header') {
       (0, _handleHeaderCellSelection.handleHeaderCellSelection)(_objectSpread({
         type: 'row'
       }, handleHeaderCellProps));
     }
-  }; // Go into edit mode if double click is detected on activeCellRef
-
-
-  var handleActiveCellDoubleClick = function handleActiveCellDoubleClick() {
-    startEditMode();
-  }; // Update the data
 
-
-  var handleEditSubmit = function handleEditSubmit(event) {
-    var key = event.key;
-
-    var submitEditChanges = function submitEditChanges() {
-      var prevCoords = previousState === null || previousState === void 0 ? void 0 : previousState.activeCellCoordinates;
-      var cellProps = rows[prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.row].cells[prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.column];
-      removeCellEditor();
-      updateData(prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.row, cellProps.column.id);
-    };
-
-    if (key === 'Enter') {
-      submitEditChanges();
-      setActiveCellCoordinates(function (prev) {
-        return _objectSpread(_objectSpread({}, prev), {}, {
-          row: prev.row === rows.length - 1 ? prev.row : prev.row + 1 // do not move to next cell below if we're already in the last row
-
-        });
+    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header' && (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header') {
+      (0, _selectAllCells.selectAllCells)({
+        ref: spreadsheetRef,
+        setCurrentMatcher: setCurrentMatcher,
+        setSelectionAreas: setSelectionAreas,
+        rows: rows,
+        columns: columns,
+        activeCellCoordinates: activeCellCoordinates,
+        updateActiveCellCoordinates: updateActiveCellCoordinates
       });
     }
+  }; // Go into edit mode if double click is detected on activeCellRef
 
-    if (key === 'Tab') {
-      event.preventDefault();
-      submitEditChanges();
-      setActiveCellCoordinates(function (prev) {
-        return _objectSpread(_objectSpread({}, prev), {}, {
-          column: prev.column === columns.length - 1 ? prev.column : prev.column + 1 // do not move to next cell below if we're already in the last column
 
-        });
-      });
-    }
-
-    return;
+  var handleActiveCellDoubleClick = function handleActiveCellDoubleClick() {
+    startEditMode();
   };
 
-  (0, _react.useEffect)(function () {
-    if (isEditing) {
-      var _rows$activeCellCoord, _cellProps$column, _cellEditorRef$curren;
-
-      var cellProps = (_rows$activeCellCoord = rows[activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row]) === null || _rows$activeCellCoord === void 0 ? void 0 : _rows$activeCellCoord.cells[activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column];
-      var activeCellLeftPosition = activeCellRef === null || activeCellRef === void 0 ? void 0 : activeCellRef.current.style.left;
-      var activeCellTopPosition = activeCellRef === null || activeCellRef === void 0 ? void 0 : activeCellRef.current.style.top;
-      cellEditorRef.current.style.left = activeCellLeftPosition;
-      cellEditorRef.current.style.top = activeCellTopPosition;
-      cellEditorRef.current.style.display = 'block';
-      cellEditorRef.current.style.width = activeCellRef === null || activeCellRef === void 0 ? void 0 : activeCellRef.current.style.width;
-      cellEditorRef.current.style.height = activeCellRef === null || activeCellRef === void 0 ? void 0 : activeCellRef.current.style.height;
-      cellEditorRef.current.style.paddingTop = "".concat((parseInt(activeCellRef === null || activeCellRef === void 0 ? void 0 : activeCellRef.current.style.height) - 16) / 2 - 1, "px"); // calculate paddingTop based on cellHeight which could be variable depending on the cellSize prop
-
-      cellEditorRef.current.style.textAlign = (cellProps === null || cellProps === void 0 ? void 0 : (_cellProps$column = cellProps.column) === null || _cellProps$column === void 0 ? void 0 : _cellProps$column.placement) === 'right' ? 'right' : 'left';
-      (_cellEditorRef$curren = cellEditorRef.current) === null || _cellEditorRef$curren === void 0 ? void 0 : _cellEditorRef$curren.focus();
+  (0, _hooks2.useSpreadsheetEdit)({
+    isEditing: isEditing,
+    rows: rows,
+    activeCellCoordinates: activeCellCoordinates,
+    activeCellRef: activeCellRef,
+    cellEditorRef: cellEditorRef,
+    cellEditorRulerRef: cellEditorRulerRef,
+    columns: columns,
+    defaultColumn: defaultColumn,
+    cellEditorValue: cellEditorValue
+  });
+  var handleActiveCellMouseEnter = (0, _react.useCallback)(function () {
+    handleActiveCellMouseEnterCallback(selectionAreas, clickAndHoldActive);
+  }, [clickAndHoldActive, selectionAreas, handleActiveCellMouseEnterCallback]); // Only update if there are cell selection areas
+  // Find point object that matches currentMatcher and remove the second point
+  // because hovering over the active cell while clicking and holding should
+  // remove the previously existing selection area
+
+  var handleActiveCellMouseEnterCallback = (0, _react.useCallback)(function (areas, clickHold) {
+    if (!currentMatcher) {
+      return;
     }
 
-    if (!isEditing) {
-      cellEditorRef.current.style.display = 'none';
-      cellEditorRef.current.blur();
-      activeCellRef.current.focus();
-    }
-  }, [isEditing, activeCellCoordinates, rows]);
+    if (areas && areas.length && clickHold && currentMatcher) {
+      setSelectionAreas(function (prev) {
+        var selectionAreaClone = (0, _deepCloneObject.deepCloneObject)(prev);
+        var indexOfItemToUpdate = selectionAreaClone.findIndex(function (item) {
+          return item.matcher === currentMatcher;
+        });
 
-  var handleKeyUp = function handleKeyUp(event) {
-    var _activeKeys$current3;
+        if (indexOfItemToUpdate === -1) {
+          return prev;
+        }
 
-    var key = event.key; // Remove key from active keys array on key up
+        if ((0, _typeof2.default)(selectionAreaClone[indexOfItemToUpdate].point2) === 'object' && selectionAreaClone[indexOfItemToUpdate].areaCreated) {
+          selectionAreaClone[indexOfItemToUpdate].point2 = selectionAreaClone[indexOfItemToUpdate].point1;
+          selectionAreaClone[indexOfItemToUpdate].areaCreated = false;
+          setActiveCellInsideSelectionArea(false);
+          (0, _removeCellSelections.removeCellSelections)({
+            matcher: currentMatcher,
+            spreadsheetRef: spreadsheetRef
+          });
+          return selectionAreaClone;
+        }
 
-    if ((_activeKeys$current3 = activeKeys.current) !== null && _activeKeys$current3 !== void 0 && _activeKeys$current3.includes(key)) {
-      var activeKeysClone = (0, _toConsumableArray2.default)(activeKeys.current);
-      var filteredKeysClone = activeKeysClone.filter(function (item) {
-        return item !== key;
+        return prev;
       });
-      activeKeys.current = filteredKeysClone;
     }
-  };
-
+  }, [spreadsheetRef, currentMatcher]);
   return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, rest, getTableProps(), (0, _devtools.getDevtoolsProps)(componentName), {
-    className: (0, _classnames.default)(blockClass, className, (0, _defineProperty2.default)({}, "".concat(blockClass, "__container-has-focus"), containerHasFocus)),
+    className: (0, _classnames.default)(blockClass, className, "".concat(blockClass, "--interactive-cell-element"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__container-has-focus"), containerHasFocus)),
     ref: spreadsheetRef,
     role: "grid",
     tabIndex: 0,
     "aria-rowcount": (rows === null || rows === void 0 ? void 0 : rows.length) || 0,
     "aria-colcount": (columns === null || columns === void 0 ? void 0 : columns.length) || 0,
     onKeyDown: handleKeyPress,
-    onKeyUp: handleKeyUp,
     onFocus: function onFocus() {
       return setContainerHasFocus(true);
     }
-  }), /*#__PURE__*/_react.default.createElement(_DataSpreadsheetHeader.DataSpreadsheetHeader, {
+  }), /*#__PURE__*/_react.default.createElement("div", {
+    ref: multiKeyTrackingRef
+  }, /*#__PURE__*/_react.default.createElement(_DataSpreadsheetHeader.DataSpreadsheetHeader, {
     ref: spreadsheetRef,
     activeCellCoordinates: activeCellCoordinates,
     cellSize: cellSize,
@@ -695,7 +800,8 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     setActiveCellCoordinates: setActiveCellCoordinates,
     setSelectionAreas: setSelectionAreas,
     setCurrentMatcher: setCurrentMatcher,
-    setSelectionAreaData: setSelectionAreaData
+    setSelectionAreaData: setSelectionAreaData,
+    updateActiveCellCoordinates: updateActiveCellCoordinates
   }), /*#__PURE__*/_react.default.createElement(_DataSpreadsheetBody.DataSpreadsheetBody, {
     activeCellCoordinates: activeCellCoordinates,
     ref: spreadsheetRef,
@@ -707,8 +813,10 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     selectionAreas: selectionAreas,
     setSelectionAreas: setSelectionAreas,
     cellSize: cellSize,
+    headerGroups: headerGroups,
     defaultColumn: defaultColumn,
     getTableBodyProps: getTableBodyProps,
+    onDataUpdate: onDataUpdate,
     onActiveCellChange: onActiveCellChange,
     onSelectionAreaChange: onSelectionAreaChange,
     prepareRow: prepareRow,
@@ -719,25 +827,46 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     scrollBarSize: scrollBarSize,
     totalColumnsWidth: totalColumnsWidth,
     id: id,
-    columns: columns
+    columns: columns,
+    defaultEmptyRowCount: defaultEmptyRowCount,
+    setActiveCellInsideSelectionArea: setActiveCellInsideSelectionArea
   }), /*#__PURE__*/_react.default.createElement("button", {
+    onMouseDown: handleActiveCellMouseDown,
     onClick: handleActiveCellClick,
     onKeyDown: handleActiveCellKeyDown,
     onDoubleClick: handleActiveCellDoubleClick,
+    onMouseEnter: handleActiveCellMouseEnter,
     ref: activeCellRef,
-    className: (0, _classnames.default)("".concat(blockClass, "--interactive-cell-element"), "".concat(blockClass, "__active-cell--highlight")),
+    className: (0, _classnames.default)("".concat(blockClass, "--interactive-cell-element"), "".concat(blockClass, "__active-cell--highlight"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__active-cell--with-selection"), activeCellInsideSelectionArea)),
     type: "button"
   }, activeCellContent), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.TextArea, {
     value: cellEditorValue,
-    onKeyDown: handleEditSubmit,
+    onKeyDown: (0, _handleEditSubmit.handleEditSubmit)({
+      activeCellCoordinates: activeCellCoordinates,
+      cellEditorRulerRef: cellEditorRulerRef,
+      columns: columns,
+      previousState: previousState,
+      removeCellEditor: removeCellEditor,
+      rows: rows,
+      setActiveCellCoordinates: setActiveCellCoordinates,
+      setCurrentMatcher: setCurrentMatcher,
+      setSelectionAreas: setSelectionAreas,
+      spreadsheetRef: spreadsheetRef,
+      updateData: updateData
+    }),
     onChange: function onChange(event) {
-      return setCellEditorValue(event.target.value);
+      setCellEditorValue(event.target.value);
+      cellEditorRulerRef.current.textContent = event.target.value;
     },
     ref: cellEditorRef,
     labelText: "",
-    "aria-labelledby": activeCellCoordinates ? "[data-row-index=\"".concat(activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row, "\"][data-column-index=\"").concat(activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column, "\"]") : null,
+    "aria-labelledby": activeCellCoordinates ? "#".concat(blockClass, "__cell--").concat(activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row, "--").concat(activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) : null,
     className: (0, _classnames.default)("".concat(blockClass, "__cell-editor"), "".concat(blockClass, "--interactive-cell-element"), "".concat(blockClass, "__cell-editor--").concat(cellSize), (0, _defineProperty2.default)({}, "".concat(blockClass, "__cell-editor--active"), isEditing))
-  }));
+  }), /*#__PURE__*/_react.default.createElement("pre", {
+    "aria-hidden": true,
+    ref: cellEditorRulerRef,
+    className: "".concat(blockClass, "__cell-editor-ruler")
+  })));
 }); // Return a placeholder if not released and not enabled by feature flag
 
 
@@ -775,6 +904,11 @@ DataSpreadsheet.propTypes = {
    */
   data: _propTypes.default.arrayOf(_propTypes.default.shape),
 
+  /**
+   * Sets the number of empty rows to be created when there is no data provided
+   */
+  defaultEmptyRowCount: _propTypes.default.number,
+
   /**
    * The spreadsheet id
    */