@carbon/ibm-products 1.8.0 → 1.11.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,6 +11,10 @@ exports.DataSpreadsheet = void 0;
 
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
@@ -25,27 +29,43 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 
 var _classnames = _interopRequireDefault(require("classnames"));
 
-var _devtools = require("../../global/js/utils/devtools");
+var _carbonComponentsReact = require("carbon-components-react");
 
 var _settings = require("../../settings");
 
-var _getScrollbarWidth = require("../../global/js/utils/getScrollbarWidth");
-
 var _DataSpreadsheetBody = require("./DataSpreadsheetBody");
 
-var _getCellSize = require("./getCellSize");
-
 var _DataSpreadsheetHeader = require("./DataSpreadsheetHeader");
 
+var _devtools = require("../../global/js/utils/devtools");
+
+var _getScrollbarWidth = require("../../global/js/utils/getScrollbarWidth");
+
 var _hooks = require("../../global/js/hooks");
 
-var _createActiveCellFn = require("./createActiveCellFn");
+var _deepCloneObject = require("../../global/js/utils/deepCloneObject");
 
-var _excluded = ["cellSize", "className", "columns", "data", "id", "onActiveCellChange"];
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
+
+var _useResetSpreadsheetFocus = require("./hooks/useResetSpreadsheetFocus");
+
+var _useSpreadsheetOutsideClick = require("./hooks/useSpreadsheetOutsideClick");
+
+var _useMoveActiveCell = require("./hooks/useMoveActiveCell");
+
+var _createActiveCellFn = require("./utils/createActiveCellFn");
+
+var _getCellSize = require("./utils/getCellSize");
+
+var _handleMultipleKeys = require("./utils/handleMultipleKeys");
+
+var _handleHeaderCellSelection = require("./utils/handleHeaderCellSelection");
+
+var _excluded = ["cellSize", "className", "columns", "data", "onDataUpdate", "id", "onActiveCellChange"];
 
 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; }
 
@@ -59,7 +79,8 @@ var componentName = 'DataSpreadsheet'; // Default values for props
 var defaults = {
   cellSize: 'standard',
   columns: Object.freeze([]),
-  data: Object.freeze([])
+  data: Object.freeze([]),
+  onDataUpdate: Object.freeze(function () {})
 };
 /**
  * DataSpreadsheet: used to organize and display large amounts of structured data, separated by columns and rows in a grid-like format.
@@ -73,9 +94,13 @@ 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$onDataUpdate = _ref.onDataUpdate,
+      onDataUpdate = _ref$onDataUpdate === void 0 ? defaults.onDataUpdate : _ref$onDataUpdate,
       id = _ref.id,
       onActiveCellChange = _ref.onActiveCellChange,
       rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
+  var localRef = (0, _react.useRef)();
+  var spreadsheetRef = ref || localRef;
   var focusedElement = (0, _hooks.useActiveElement)();
 
   var _useState = (0, _react.useState)(false),
@@ -88,7 +113,39 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       activeCellCoordinates = _useState4[0],
       setActiveCellCoordinates = _useState4[1];
 
+  var _useState5 = (0, _react.useState)([]),
+      _useState6 = (0, _slicedToArray2.default)(_useState5, 2),
+      selectionAreas = _useState6[0],
+      setSelectionAreas = _useState6[1];
+
+  var _useState7 = (0, _react.useState)(false),
+      _useState8 = (0, _slicedToArray2.default)(_useState7, 2),
+      clickAndHoldActive = _useState8[0],
+      setClickAndHoldActive = _useState8[1];
+
+  var _useState9 = (0, _react.useState)(''),
+      _useState10 = (0, _slicedToArray2.default)(_useState9, 2),
+      currentMatcher = _useState10[0],
+      setCurrentMatcher = _useState10[1];
+
+  var _useState11 = (0, _react.useState)(false),
+      _useState12 = (0, _slicedToArray2.default)(_useState11, 2),
+      isEditing = _useState12[0],
+      setIsEditing = _useState12[1];
+
+  var _useState13 = (0, _react.useState)(''),
+      _useState14 = (0, _slicedToArray2.default)(_useState13, 2),
+      cellEditorValue = _useState14[0],
+      setCellEditorValue = _useState14[1];
+
+  var previousState = (0, _hooks.usePreviousValue)({
+    activeCellCoordinates: activeCellCoordinates
+  });
   var cellSizeValue = (0, _getCellSize.getCellSize)(cellSize);
+  var cellEditorRef = (0, _react.useRef)();
+  var currentMatcherRef = (0, _react.useRef)();
+  var activeKeys = (0, _react.useRef)([]);
+  var activeCellRef = (0, _react.useRef)();
   var defaultColumn = (0, _react.useMemo)(function () {
     return {
       width: 150,
@@ -110,44 +167,62 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
       headerGroups = _useTable.headerGroups,
       rows = _useTable.rows,
       totalColumnsWidth = _useTable.totalColumnsWidth,
-      prepareRow = _useTable.prepareRow; // Reset everything when spreadsheet loses focus
+      prepareRow = _useTable.prepareRow; // Update the spreadsheet data after editing a cell
 
 
-  (0, _react.useEffect)(function () {
-    if (!focusedElement.classList.contains("".concat(blockClass, "--interactive-cell-element"))) {
-      setContainerHasFocus(false);
-      removeActiveCell();
-    }
+  var updateData = (0, _react.useCallback)(function (rowIndex, columnId) {
+    onDataUpdate(function (prev) {
+      return prev.map(function (row, index) {
+        if (index === rowIndex) {
+          return _objectSpread(_objectSpread({}, prev[rowIndex]), {}, (0, _defineProperty2.default)({}, columnId, cellEditorValue));
+        }
 
-    if (focusedElement.classList.contains(blockClass) || focusedElement.classList.contains("".concat(blockClass, "--interactive-cell-element"))) {
-      setContainerHasFocus(true);
-    }
-  }, [focusedElement, removeActiveCell]); // Removes the active cell element
+        return row;
+      });
+    });
+  }, [cellEditorValue, onDataUpdate]); // Removes the active cell element
 
   var removeActiveCell = (0, _react.useCallback)(function () {
     var activeCellHighlight = spreadsheetRef.current.querySelector(".".concat(blockClass, "__active-cell--highlight"));
 
     if (activeCellHighlight) {
-      activeCellHighlight.remove();
+      activeCellHighlight.style.display = 'none';
     }
-  }, [spreadsheetRef]); // Click outside useEffect
-
-  (0, _react.useEffect)(function () {
-    var handleOutsideClick = function handleOutsideClick(event) {
-      if (!spreadsheetRef.current || spreadsheetRef.current.contains(event.target) || event.target.classList.contains("".concat(blockClass, "__active-cell--highlight"))) {
-        return;
+  }, [spreadsheetRef]);
+  var removeCellEditor = (0, _react.useCallback)(function () {
+    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
+  // happen if you click on another cell while isEditing is true
 
-      removeActiveCell();
-      setContainerHasFocus(false);
-      setActiveCellCoordinates(null);
-    };
+  (0, _react.useEffect)(function () {
+    var prevCoords = previousState === null || previousState === void 0 ? void 0 : previousState.activeCellCoordinates;
 
-    document.addEventListener('click', handleOutsideClick);
-    return function () {
-      document.removeEventListener('click', handleOutsideClick);
-    };
-  }, [spreadsheetRef, removeActiveCell]);
+    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)) && isEditing) {
+      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);
+    }
+  }, [activeCellCoordinates, previousState === null || previousState === void 0 ? void 0 : previousState.activeCellCoordinates, updateData, rows, isEditing, removeCellEditor]);
+  var handleActiveCellMouseEnter = (0, _react.useCallback)(function () {
+    handleActiveCellMouseEnterCallback(selectionAreas, clickAndHoldActive);
+  }, [clickAndHoldActive, selectionAreas, handleActiveCellMouseEnterCallback]);
   var createActiveCell = (0, _react.useCallback)(function (_ref2) {
     var placementElement = _ref2.placementElement,
         coords = _ref2.coords,
@@ -155,16 +230,45 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
         addToHeader = _ref2$addToHeader === void 0 ? false : _ref2$addToHeader;
     var activeCellFullData = typeof (coords === null || coords === void 0 ? void 0 : coords.column) === 'number' && typeof (coords === null || coords === void 0 ? void 0 : coords.row) === 'number' ? rows[coords === null || coords === void 0 ? void 0 : coords.row].cells[coords === null || coords === void 0 ? void 0 : coords.column] : null;
     var activeCellValue = activeCellFullData ? Object.values(activeCellFullData.row.values)[coords === null || coords === void 0 ? void 0 : coords.column] : null;
-    (0, _createActiveCellFn.createActiveCellFn)({
-      placementElement: placementElement,
-      coords: coords,
-      addToHeader: addToHeader,
-      contextRef: spreadsheetRef,
-      blockClass: blockClass,
-      onActiveCellChange: onActiveCellChange,
-      activeCellValue: activeCellValue
-    });
-  }, [spreadsheetRef, rows, onActiveCellChange]);
+    var prevCoords = previousState === null || previousState === void 0 ? void 0 : previousState.activeCellCoordinates; // Only create an active cell if the activeCellCoordinates have changed
+
+    if ((prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.row) !== (coords === null || coords === void 0 ? void 0 : coords.row) || (prevCoords === null || prevCoords === void 0 ? void 0 : prevCoords.column) !== (coords === null || coords === void 0 ? void 0 : coords.column)) {
+      (0, _createActiveCellFn.createActiveCellFn)({
+        placementElement: placementElement,
+        coords: coords,
+        addToHeader: addToHeader,
+        contextRef: spreadsheetRef,
+        blockClass: blockClass,
+        onActiveCellChange: onActiveCellChange,
+        activeCellValue: activeCellValue,
+        activeCellRef: activeCellRef,
+        cellEditorRef: cellEditorRef,
+        defaultColumn: defaultColumn
+      });
+    }
+  }, [spreadsheetRef, rows, onActiveCellChange, previousState === null || previousState === void 0 ? void 0 : previousState.activeCellCoordinates, defaultColumn]);
+  (0, _useResetSpreadsheetFocus.useResetSpreadsheetFocus)({
+    activeKeys: activeKeys,
+    focusedElement: focusedElement,
+    removeActiveCell: removeActiveCell,
+    setContainerHasFocus: setContainerHasFocus
+  });
+  (0, _useSpreadsheetOutsideClick.useSpreadsheetOutsideClick)({
+    spreadsheetRef: spreadsheetRef,
+    setActiveCellCoordinates: setActiveCellCoordinates,
+    setSelectionAreas: setSelectionAreas,
+    removeActiveCell: removeActiveCell,
+    removeCellSelections: removeCellSelections,
+    setContainerHasFocus: setContainerHasFocus,
+    activeKeys: activeKeys,
+    removeCellEditor: removeCellEditor
+  });
+  (0, _useMoveActiveCell.useMoveActiveCell)({
+    spreadsheetRef: spreadsheetRef,
+    activeCellCoordinates: activeCellCoordinates,
+    containerHasFocus: containerHasFocus,
+    createActiveCell: createActiveCell
+  });
   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
@@ -177,189 +281,388 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
 
     return;
   }, [activeCellCoordinates]);
-
-  var updateActiveCellCoordinates = function updateActiveCellCoordinates(_ref3) {
+  var updateActiveCellCoordinates = (0, _react.useCallback)(function (_ref3) {
     var coords = _ref3.coords,
         updatedValue = _ref3.updatedValue;
-    setActiveCellCoordinates(_objectSpread(_objectSpread({}, coords), updatedValue));
-  };
 
+    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
+
+    if (newActiveCell.row !== 'header' && newActiveCell.column !== 'header') {
+      var tempMatcher = (0, _uuidv.default)();
+      setSelectionAreas([{
+        point1: newActiveCell,
+        matcher: tempMatcher
+      }]);
+      setCurrentMatcher(tempMatcher);
+    }
+  }, []);
   var handleKeyPress = (0, _react.useCallback)(function (event) {
-    var keyCode = event.keyCode; // Command keys need to be returned as there is default browser behavior with these keys
+    var _activeKeys$current, _activeKeys$current2;
+
+    var key = event.key; // Command keys need to be returned as there is default browser behavior with these keys
 
-    if (keyCode === 91 || keyCode === 93) {
+    if (key === 'Meta' || key === 'Control') {
       return;
     } // Prevent arrow keys, home key, and end key from scrolling the page when the data spreadsheet container has focus
 
 
-    if ([35, 36, 37, 38, 39, 40].indexOf(keyCode) > -1) {
+    if (['End', 'Home', 'ArrowLeft', 'ArrowUp', 'ArrowRight', 'ArrowDown'].indexOf(key) > -1 && !isEditing) {
       event.preventDefault();
     }
 
-    switch (keyCode) {
-      // Tab
-      case 9:
-        {
-          removeActiveCell();
-          setContainerHasFocus(false);
-          setActiveCellCoordinates(null);
-          break;
-        }
-      // Left
+    if (['Tab'].indexOf(key) > -1 && isEditing) {
+      return;
+    } // Clear out all cell selection areas if user uses any arrow key, except if the shift key is being held
+
+
+    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')) {
+        setSelectionAreas([]);
+        removeCellSelections({
+          spreadsheetRef: spreadsheetRef
+        });
+      }
+    } // Update list of activeKeys
 
-      case 37:
-        {
-          handleInitialArrowPress();
 
-          var coordinatesClone = _objectSpread({}, activeCellCoordinates);
+    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 (coordinatesClone.column === 'header') {
-            return;
+    if (((_activeKeys$current2 = activeKeys.current) === null || _activeKeys$current2 === void 0 ? void 0 : _activeKeys$current2.length) > 1) {
+      (0, _handleMultipleKeys.handleMultipleKeys)({
+        activeKeys: activeKeys,
+        selectionAreas: selectionAreas,
+        currentMatcher: currentMatcher,
+        rows: rows,
+        setSelectionAreas: setSelectionAreas,
+        columns: columns
+      });
+    } // 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') {
+      switch (key) {
+        // Tab
+        case 'Tab':
+          {
+            setSelectionAreas([]);
+            removeActiveCell();
+            removeCellEditor();
+            setContainerHasFocus(false);
+            setActiveCellCoordinates(null);
+            break;
           }
+        // Left
+
+        case 'ArrowLeft':
+          {
+            handleInitialArrowPress();
+
+            var coordinatesClone = _objectSpread({}, activeCellCoordinates);
+
+            if (coordinatesClone.column === 'header') {
+              return;
+            }
+
+            if (typeof coordinatesClone.column === 'number') {
+              if (coordinatesClone.column === 0) {
+                updateActiveCellCoordinates({
+                  coords: coordinatesClone,
+                  updatedValue: {
+                    column: 'header'
+                  }
+                });
+                return;
+              }
 
-          if (typeof coordinatesClone.column === 'number') {
-            if (coordinatesClone.column === 0) {
               updateActiveCellCoordinates({
                 coords: coordinatesClone,
                 updatedValue: {
-                  column: 'header'
+                  column: coordinatesClone.column - 1
                 }
               });
-              return;
             }
 
-            updateActiveCellCoordinates({
-              coords: coordinatesClone,
-              updatedValue: {
-                column: coordinatesClone.column - 1
-              }
-            });
+            break;
           }
+        // Up
 
-          break;
-        }
-      // Up
+        case 'ArrowUp':
+          {
+            handleInitialArrowPress();
 
-      case 38:
-        {
-          handleInitialArrowPress();
+            var _coordinatesClone = _objectSpread({}, activeCellCoordinates);
 
-          var _coordinatesClone = _objectSpread({}, activeCellCoordinates);
+            if (_coordinatesClone.row === 'header') {
+              return;
+            }
+
+            if (typeof _coordinatesClone.row === 'number') {
+              // set row back to header if we are at index 0
+              if (_coordinatesClone.row === 0) {
+                updateActiveCellCoordinates({
+                  coords: _coordinatesClone,
+                  updatedValue: {
+                    row: 'header'
+                  }
+                });
+                return;
+              } // if we are at any other index than 0, subtract 1 from current row index
 
-          if (_coordinatesClone.row === 'header') {
-            return;
-          }
 
-          if (typeof _coordinatesClone.row === 'number') {
-            // set row back to header if we are at index 0
-            if (_coordinatesClone.row === 0) {
               updateActiveCellCoordinates({
                 coords: _coordinatesClone,
                 updatedValue: {
-                  row: 'header'
+                  row: _coordinatesClone.row - 1
                 }
               });
-              return;
-            } // if we are at any other index than 0, subtract 1 from current row index
-
+            }
 
-            updateActiveCellCoordinates({
-              coords: _coordinatesClone,
-              updatedValue: {
-                row: _coordinatesClone.row - 1
-              }
-            });
+            break;
           }
+        // Right
 
-          break;
-        }
-      // Right
+        case 'ArrowRight':
+          {
+            handleInitialArrowPress();
 
-      case 39:
-        {
-          handleInitialArrowPress();
+            var _coordinatesClone2 = _objectSpread({}, activeCellCoordinates);
 
-          var _coordinatesClone2 = _objectSpread({}, activeCellCoordinates);
+            if (_coordinatesClone2.column === 'header') {
+              updateActiveCellCoordinates({
+                coords: _coordinatesClone2,
+                updatedValue: {
+                  column: 0
+                }
+              });
+            }
 
-          if (_coordinatesClone2.column === 'header') {
-            updateActiveCellCoordinates({
-              coords: _coordinatesClone2,
-              updatedValue: {
-                column: 0
+            if (typeof _coordinatesClone2.column === 'number') {
+              // Prevent active cell coordinates from updating if the active
+              // cell is in the last column, ie we can't go any further to the right
+              if (columns.length - 1 === _coordinatesClone2.column) {
+                return;
               }
-            });
-          }
 
-          if (typeof _coordinatesClone2.column === 'number') {
-            // Prevent active cell coordinates from updating if the active
-            // cell is in the last column, ie we can't go any further to the right
-            if (columns.length - 1 === _coordinatesClone2.column) {
-              return;
+              updateActiveCellCoordinates({
+                coords: _coordinatesClone2,
+                updatedValue: {
+                  column: _coordinatesClone2.column + 1
+                }
+              });
             }
 
-            updateActiveCellCoordinates({
-              coords: _coordinatesClone2,
-              updatedValue: {
-                column: _coordinatesClone2.column + 1
-              }
-            });
+            break;
           }
+        // Down
 
-          break;
-        }
-      // Down
+        case 'ArrowDown':
+          {
+            handleInitialArrowPress();
 
-      case 40:
-        {
-          handleInitialArrowPress();
+            var _coordinatesClone3 = _objectSpread({}, activeCellCoordinates);
 
-          var _coordinatesClone3 = _objectSpread({}, activeCellCoordinates);
+            if (_coordinatesClone3.row === 'header') {
+              updateActiveCellCoordinates({
+                coords: _coordinatesClone3,
+                updatedValue: {
+                  row: 0
+                }
+              });
+            }
 
-          if (_coordinatesClone3.row === 'header') {
-            updateActiveCellCoordinates({
-              coords: _coordinatesClone3,
-              updatedValue: {
-                row: 0
+            if (typeof _coordinatesClone3.row === 'number') {
+              // Prevent active cell coordinates from updating if the active
+              // cell is in the last row, ie we can't go any further down since
+              // we are in the last row
+              if (rows.length - 1 === _coordinatesClone3.row) {
+                return;
               }
-            });
-          }
 
-          if (typeof _coordinatesClone3.row === 'number') {
-            // Prevent active cell coordinates from updating if the active
-            // cell is in the last row, ie we can't go any further down since
-            // we are in the last row
-            if (rows.length - 1 === _coordinatesClone3.row) {
-              return;
+              updateActiveCellCoordinates({
+                coords: _coordinatesClone3,
+                updatedValue: {
+                  row: _coordinatesClone3.row + 1
+                }
+              });
             }
 
-            updateActiveCellCoordinates({
-              coords: _coordinatesClone3,
-              updatedValue: {
-                row: _coordinatesClone3.row + 1
-              }
-            });
+            break;
           }
+      }
+    }
+  }, [updateActiveCellCoordinates, handleInitialArrowPress, activeCellCoordinates, removeActiveCell, columns, rows, spreadsheetRef, currentMatcher, isEditing, removeCellEditor, removeCellSelections, selectionAreas]);
+
+  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);
+  }; // Go into edit mode if 'Enter' key is pressed on activeCellRef
 
-          break;
+
+  var handleActiveCellKeyDown = function handleActiveCellKeyDown(event) {
+    var key = event.key;
+
+    if (key === 'Enter') {
+      if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) !== 'header' && (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) !== 'header') {
+        startEditMode();
+      }
+
+      if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header' || (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header') {
+        var handleHeaderCellProps = {
+          activeCellCoordinates: activeCellCoordinates,
+          rows: rows,
+          columns: columns,
+          setActiveCellCoordinates: setActiveCellCoordinates,
+          setCurrentMatcher: setCurrentMatcher,
+          setSelectionAreas: setSelectionAreas,
+          spreadsheetRef: spreadsheetRef,
+          isKeyboard: true
+        }; // Select an entire column
+
+        if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header') {
+          (0, _handleHeaderCellSelection.handleHeaderCellSelection)(_objectSpread({
+            type: 'column'
+          }, handleHeaderCellProps));
+        } // Select an entire row
+
+
+        if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header') {
+          (0, _handleHeaderCellSelection.handleHeaderCellSelection)(_objectSpread({
+            type: 'row'
+          }, handleHeaderCellProps));
         }
+      }
     }
-  }, [handleInitialArrowPress, activeCellCoordinates, removeActiveCell, columns.length, rows.length]); // Adds active cell highlight to correct cell onKeyDown
+  }; // 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 (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;
+  }; // 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) {
+    var freshMatcherValue = currentMatcherRef.current;
+
+    if (!freshMatcherValue) {
+      return;
+    }
+
+    if (areas && areas.length && clickHold && freshMatcherValue) {
+      setSelectionAreas(function (prev) {
+        var selectionAreaClone = (0, _deepCloneObject.deepCloneObject)(prev);
+        var indexOfItemToUpdate = selectionAreaClone.findIndex(function (item) {
+          return item.matcher === freshMatcherValue;
+        });
+
+        if (indexOfItemToUpdate === -1) {
+          return prev;
+        }
+
+        if ((0, _typeof2.default)(selectionAreaClone[indexOfItemToUpdate].point2) === 'object' && selectionAreaClone[indexOfItemToUpdate].areaCreated) {
+          selectionAreaClone[indexOfItemToUpdate].point2 = null;
+          selectionAreaClone[indexOfItemToUpdate].areaCreated = false;
+          removeCellSelections({
+            matcher: freshMatcherValue,
+            spreadsheetRef: spreadsheetRef
+          });
+          return selectionAreaClone;
+        }
+
+        return prev;
+      });
+    }
+  }, [spreadsheetRef, removeCellSelections]);
   (0, _react.useEffect)(function () {
-    var activeCellPlacementElement = spreadsheetRef === null || spreadsheetRef === void 0 ? void 0 : spreadsheetRef.current.querySelector("[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, "\"]"));
-    var shouldPlaceActiveCellInHeader = (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header' && true;
-    var selectAllElement = spreadsheetRef === null || spreadsheetRef === void 0 ? void 0 : spreadsheetRef.current.querySelector("[data-row-index=\"header\"][data-column-index=\"header\"]");
-
-    if (containerHasFocus) {
-      createActiveCell({
-        placementElement: activeCellCoordinates ? activeCellPlacementElement : selectAllElement,
-        coords: activeCellCoordinates,
-        addToHeader: shouldPlaceActiveCellInHeader
+    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, "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();
+    }
+
+    if (!isEditing) {
+      cellEditorRef.current.style.display = 'none';
+      cellEditorRef.current.blur();
+      activeCellRef.current.focus();
+    }
+  }, [isEditing, activeCellCoordinates, rows]);
+
+  var handleKeyUp = function handleKeyUp(event) {
+    var _activeKeys$current3;
+
+    var key = event.key; // Remove key from active keys array on key up
+
+    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;
       });
+      activeKeys.current = filteredKeysClone;
     }
-  }, [activeCellCoordinates, spreadsheetRef, createActiveCell, containerHasFocus]);
-  var localRef = (0, _react.useRef)();
-  var spreadsheetRef = ref || localRef;
+  };
+
   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)),
     ref: spreadsheetRef,
@@ -368,14 +671,32 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     "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, {
+    ref: spreadsheetRef,
+    activeCellCoordinates: activeCellCoordinates,
     cellSizeValue: cellSizeValue,
+    columns: columns,
     defaultColumn: defaultColumn,
-    headerGroups: headerGroups
+    headerGroups: headerGroups,
+    rows: rows,
+    selectionAreas: selectionAreas,
+    setActiveCellCoordinates: setActiveCellCoordinates,
+    setSelectionAreas: setSelectionAreas,
+    setCurrentMatcher: setCurrentMatcher
   }), /*#__PURE__*/_react.default.createElement(_DataSpreadsheetBody.DataSpreadsheetBody, {
+    activeCellCoordinates: activeCellCoordinates,
+    ref: spreadsheetRef,
+    clickAndHoldActive: clickAndHoldActive,
+    setClickAndHoldActive: setClickAndHoldActive,
+    currentMatcher: currentMatcher,
+    setCurrentMatcher: setCurrentMatcher,
+    setContainerHasFocus: setContainerHasFocus,
+    selectionAreas: selectionAreas,
+    setSelectionAreas: setSelectionAreas,
     cellSize: cellSize,
     defaultColumn: defaultColumn,
     getTableBodyProps: getTableBodyProps,
@@ -385,7 +706,25 @@ var DataSpreadsheet = /*#__PURE__*/_react.default.forwardRef(function (_ref, ref
     setActiveCellCoordinates: setActiveCellCoordinates,
     scrollBarSize: scrollBarSize,
     totalColumnsWidth: totalColumnsWidth,
-    id: id
+    id: id,
+    columns: columns
+  }), /*#__PURE__*/_react.default.createElement("button", {
+    onKeyDown: handleActiveCellKeyDown,
+    onMouseEnter: handleActiveCellMouseEnter,
+    onDoubleClick: handleActiveCellDoubleClick,
+    ref: activeCellRef,
+    className: (0, _classnames.default)("".concat(blockClass, "--interactive-cell-element"), "".concat(blockClass, "__active-cell--highlight")),
+    type: "button"
+  }), /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.TextArea, {
+    value: cellEditorValue,
+    onKeyDown: handleEditSubmit,
+    onChange: function onChange(event) {
+      return setCellEditorValue(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,
+    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))
   }));
 }); // Return a placeholder if not released and not enabled by feature flag
 
@@ -432,7 +771,12 @@ DataSpreadsheet.propTypes = {
   /**
    * The event handler that is called when the active cell changes
    */
-  onActiveCellChange: _propTypes.default.func
+  onActiveCellChange: _propTypes.default.func,
+
+  /**
+   * The setter fn for the data prop
+   */
+  onDataUpdate: _propTypes.default.func
   /* TODO: add types and DocGen for all props. */
 
 };