@carbon/ibm-products 1.8.0 → 1.11.0

package/es/components/DataSpreadsheet/DataSpreadsheetBody.js

@@ -1,4 +1,6 @@
 import _extends from "@babel/runtime/helpers/extends";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 
 /**
  * Copyright IBM Corp. 2022, 2022
@@ -6,23 +8,101 @@ import _extends from "@babel/runtime/helpers/extends";
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React, { useRef, useCallback, useEffect } from 'react';
+import React, { useRef, useCallback, useEffect, forwardRef } from 'react';
 import PropTypes from 'prop-types';
 import { FixedSizeList } from 'react-window';
 import cx from 'classnames';
 import { pkg } from '../../settings';
+import { deepCloneObject } from '../../global/js/utils/deepCloneObject';
+import uuidv4 from '../../global/js/utils/uuidv4';
+import { removeCellSelections } from './utils/removeCellSelections';
+import { createCellSelectionArea } from './utils/createCellSelectionArea';
+import { checkActiveHeaderCell } from './utils/checkActiveHeaderCell';
+import { handleHeaderCellSelection } from './utils/handleHeaderCellSelection';
 var blockClass = "".concat(pkg.prefix, "--data-spreadsheet");
-export var DataSpreadsheetBody = function DataSpreadsheetBody(_ref) {
-  var defaultColumn = _ref.defaultColumn,
+export var DataSpreadsheetBody = /*#__PURE__*/forwardRef(function (_ref, ref) {
+  var columns = _ref.columns,
+      activeCellCoordinates = _ref.activeCellCoordinates,
+      defaultColumn = _ref.defaultColumn,
       getTableBodyProps = _ref.getTableBodyProps,
       id = _ref.id,
       prepareRow = _ref.prepareRow,
       rows = _ref.rows,
       setActiveCellCoordinates = _ref.setActiveCellCoordinates,
+      selectionAreas = _ref.selectionAreas,
+      setContainerHasFocus = _ref.setContainerHasFocus,
+      setSelectionAreas = _ref.setSelectionAreas,
       scrollBarSize = _ref.scrollBarSize,
-      totalColumnsWidth = _ref.totalColumnsWidth;
-  // Make sure that if the cellSize prop changes, the active
+      totalColumnsWidth = _ref.totalColumnsWidth,
+      clickAndHoldActive = _ref.clickAndHoldActive,
+      setClickAndHoldActive = _ref.setClickAndHoldActive,
+      currentMatcher = _ref.currentMatcher,
+      setCurrentMatcher = _ref.setCurrentMatcher;
+  // Create cell selection areas based on selectionAreas array
+  useEffect(function () {
+    if (selectionAreas && selectionAreas.length) {
+      selectionAreas.map(function (area) {
+        if (!area.areaCreated && area.point1 && area.point2 && area.matcher) {
+          // Do not create a cell selection area if point1 and point2 have the same values
+          // Cell selections must have two distinctly different points for an area to be created
+          if (area.point1.row === area.point2.row && area.point1.column === area.point2.column) {
+            var selectionAreasClone = deepCloneObject(selectionAreas);
+            var indexOfCurrentArea = selectionAreasClone.findIndex(function (item) {
+              return item.matcher === area.matcher;
+            });
+            selectionAreasClone[indexOfCurrentArea].areaCreated = false;
+            selectionAreasClone[indexOfCurrentArea].point2 = null;
+            return setSelectionAreas(selectionAreasClone);
+          }
+
+          createCellSelectionArea({
+            area: area,
+            blockClass: blockClass,
+            defaultColumn: defaultColumn,
+            selectionAreas: selectionAreas,
+            setSelectionAreas: setSelectionAreas
+          });
+        }
+
+        return;
+      });
+    }
+  }, [selectionAreas, setSelectionAreas, defaultColumn]); // Mouse up
+
+  useEffect(function () {
+    var handleMouseUp = function handleMouseUp(event) {
+      setClickAndHoldActive(false);
+      var cellButton = event.target.closest(".".concat(blockClass, "__body--td"));
+
+      if (cellButton) {
+        var endCellCoordinates = {
+          row: Number(cellButton.getAttribute('data-row-index')),
+          column: Number(cellButton.getAttribute('data-column-index'))
+        };
+        setSelectionAreas(function (prev) {
+          var selectionAreaClone = deepCloneObject(prev);
+          var indexOfItemToUpdate = selectionAreaClone.findIndex(function (item) {
+            return item.matcher === currentMatcher;
+          }); // No items in the array have an object that matches the value of currentMatcher
+
+          if (indexOfItemToUpdate === -1) {
+            return prev;
+          }
+
+          selectionAreaClone[indexOfItemToUpdate].point2 = endCellCoordinates;
+          selectionAreaClone[indexOfItemToUpdate].areaCreated = false;
+          return selectionAreaClone;
+        });
+      }
+    };
+
+    document.addEventListener('mouseup', handleMouseUp);
+    return function () {
+      document.removeEventListener('mouseup', handleMouseUp);
+    };
+  }, [selectionAreas, currentMatcher, setSelectionAreas, setClickAndHoldActive, setCurrentMatcher, ref]); // Make sure that if the cellSize prop changes, the active
   // cell also gets updated with the new size
+
   useEffect(function () {
     var listContainer = spreadsheetBodyRef === null || spreadsheetBodyRef === void 0 ? void 0 : spreadsheetBodyRef.current;
     var activeCellButton = listContainer.querySelector(".".concat(blockClass, "__active-cell--highlight"));
@@ -34,11 +114,109 @@ export var DataSpreadsheetBody = function DataSpreadsheetBody(_ref) {
   // adds the active cell highlight
 
   var handleBodyCellClick = useCallback(function (cell, columnIndex) {
-    setActiveCellCoordinates({
-      row: cell.row.index,
-      column: columnIndex
-    });
-  }, [setActiveCellCoordinates]); // Renders each cell in the spreadsheet body
+    return function (event) {
+      event.preventDefault();
+      var isHoldingCommandKey = event.metaKey || event.ctrlKey;
+      var isHoldingShiftKey = event.shiftKey;
+      setContainerHasFocus(true);
+      var activeCoordinates = {
+        row: cell.row.index,
+        column: columnIndex
+      };
+      var tempMatcher = uuidv4();
+      setClickAndHoldActive(true); // prevent multiple selections unless cmd key is held
+      // meaning that selectionAreas should only have one item by default
+
+      if (isHoldingCommandKey) {
+        setActiveCellCoordinates(activeCoordinates);
+        setCurrentMatcher(tempMatcher);
+        setSelectionAreas(function (prev) {
+          return [].concat(_toConsumableArray(prev), [{
+            point1: activeCoordinates,
+            matcher: tempMatcher
+          }]);
+        });
+      } else if (isHoldingShiftKey) {
+        setContainerHasFocus(true);
+        var selectionAreaClone = deepCloneObject(selectionAreas);
+        var indexOfItemToUpdate = selectionAreaClone.findIndex(function (item) {
+          return item.matcher === currentMatcher;
+        });
+
+        if (indexOfItemToUpdate === -1) {
+          // There is always a selectionArea with a point1 object that updates
+          // whenever the activeCellCoordinates update, we should always be able
+          // to find an index, but if we do not for some reason we should return
+          // at this point.
+          return;
+        } else {
+          // Update the selectionArea that was found, do not update currentMatcher
+          selectionAreaClone[indexOfItemToUpdate].point1 = activeCellCoordinates;
+          selectionAreaClone[indexOfItemToUpdate].point2 = activeCoordinates;
+          selectionAreaClone[indexOfItemToUpdate].areaCreated = false;
+          selectionAreaClone[indexOfItemToUpdate].matcher = currentMatcher;
+          setSelectionAreas(selectionAreaClone);
+        }
+      } else {
+        setActiveCellCoordinates(activeCoordinates); // remove all previous cell selections
+
+        removeCellSelections({
+          spreadsheetRef: ref
+        });
+        setSelectionAreas([{
+          point1: activeCoordinates,
+          matcher: tempMatcher
+        }]);
+        setCurrentMatcher(tempMatcher);
+      }
+    };
+  }, [currentMatcher, activeCellCoordinates, selectionAreas, setActiveCellCoordinates, setSelectionAreas, setContainerHasFocus, setClickAndHoldActive, setCurrentMatcher, ref]);
+  var handleBodyCellHover = useCallback(function (cell, columnIndex) {
+    return function () {
+      if (clickAndHoldActive) {
+        var cellCoordinates = {
+          row: cell.row.index,
+          column: columnIndex
+        };
+        setSelectionAreas(function (prev) {
+          var _selectionAreaClone$i, _selectionAreaClone$i2;
+
+          var selectionAreaClone = deepCloneObject(prev);
+          var indexOfItemToUpdate = selectionAreaClone.findIndex(function (item) {
+            return item.matcher === currentMatcher;
+          }); // No items in the array match up with the currentMatcher value
+
+          if (indexOfItemToUpdate === -1) {
+            return prev;
+          } // Do not update state if you're still hovering on the same cell
+
+
+          if (((_selectionAreaClone$i = selectionAreaClone[indexOfItemToUpdate].point2) === null || _selectionAreaClone$i === void 0 ? void 0 : _selectionAreaClone$i.row) === cellCoordinates.row && ((_selectionAreaClone$i2 = selectionAreaClone[indexOfItemToUpdate].point2) === null || _selectionAreaClone$i2 === void 0 ? void 0 : _selectionAreaClone$i2.column) === cellCoordinates.column) {
+            return prev;
+          }
+
+          selectionAreaClone[indexOfItemToUpdate].point2 = cellCoordinates;
+          selectionAreaClone[indexOfItemToUpdate].areaCreated = false;
+          return selectionAreaClone;
+        });
+      }
+    };
+  }, [clickAndHoldActive, currentMatcher, setSelectionAreas]);
+  var handleRowHeaderClick = useCallback(function (index) {
+    return function () {
+      handleHeaderCellSelection({
+        type: 'row',
+        activeCellCoordinates: activeCellCoordinates,
+        rows: rows,
+        columns: columns,
+        setActiveCellCoordinates: setActiveCellCoordinates,
+        setCurrentMatcher: setCurrentMatcher,
+        setSelectionAreas: setSelectionAreas,
+        spreadsheetRef: ref,
+        index: index
+      });
+    };
+  }, [columns, ref, setSelectionAreas, setCurrentMatcher, setActiveCellCoordinates, activeCellCoordinates, rows]); // Renders each row/cell in the spreadsheet body
 
   var RenderRow = useCallback(function (_ref2) {
     var index = _ref2.index,
@@ -55,7 +233,8 @@ export var DataSpreadsheetBody = function DataSpreadsheetBody(_ref) {
       "data-row-index": index,
       "data-column-index": "header",
       type: "button",
-      className: cx("".concat(blockClass, "__td"), "".concat(blockClass, "__td-th"), "".concat(blockClass, "--interactive-cell-element")),
+      onClick: handleRowHeaderClick(index),
+      className: cx("".concat(blockClass, "__td"), "".concat(blockClass, "__td-th"), "".concat(blockClass, "--interactive-cell-element"), _defineProperty({}, "".concat(blockClass, "__td-th--active-header"), (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === index || checkActiveHeaderCell(index, selectionAreas, 'row'))),
       style: {
         width: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth
       }
@@ -65,15 +244,15 @@ export var DataSpreadsheetBody = function DataSpreadsheetBody(_ref) {
         "data-row-index": cell.row.index,
         "data-column-index": index
       }, cell.getCellProps(), {
-        className: cx("".concat(blockClass, "__td"), "".concat(blockClass, "--interactive-cell-element")),
+        className: cx("".concat(blockClass, "__td"), "".concat(blockClass, "__body--td"), "".concat(blockClass, "--interactive-cell-element")),
         key: "cell_".concat(index),
-        onClick: function onClick() {
-          return handleBodyCellClick(cell, index);
-        },
+        onMouseDown: handleBodyCellClick(cell, index),
+        onMouseOver: handleBodyCellHover(cell, index),
+        onFocus: function onFocus() {},
         type: "button"
       }), cell.render('Cell'));
     }));
-  }, [prepareRow, rows, defaultColumn.rowHeaderWidth, handleBodyCellClick]);
+  }, [prepareRow, rows, defaultColumn.rowHeaderWidth, activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row, selectionAreas, handleRowHeaderClick, handleBodyCellClick, handleBodyCellHover]);
   var spreadsheetBodyRef = useRef();
   return /*#__PURE__*/React.createElement("div", _extends({
     ref: spreadsheetBodyRef,
@@ -85,8 +264,31 @@ export var DataSpreadsheetBody = function DataSpreadsheetBody(_ref) {
     itemSize: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight,
     width: totalColumnsWidth + scrollBarSize
   }, RenderRow));
-};
+});
 DataSpreadsheetBody.propTypes = {
+  /**
+   * Object containing the active cell coordinates
+   */
+  activeCellCoordinates: PropTypes.shape({
+    row: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
+    column: PropTypes.oneOfType([PropTypes.string, PropTypes.number])
+  }),
+
+  /**
+   * Is the user clicking and holding in the data spreadsheet body
+   */
+  clickAndHoldActive: PropTypes.bool,
+
+  /**
+   * All of the spreadsheet columns
+   */
+  columns: PropTypes.array,
+
+  /**
+   * This represents the id of the current cell selection area
+   */
+  currentMatcher: PropTypes.string,
+
   /**
    * Default spreadsheet sizing values
    */
@@ -126,11 +328,36 @@ DataSpreadsheetBody.propTypes = {
    */
   scrollBarSize: PropTypes.number,
 
+  /**
+   * Array of selection areas
+   */
+  selectionAreas: PropTypes.array,
+
   /**
    * Setter fn for activeCellCoordinates state value
    */
   setActiveCellCoordinates: PropTypes.func,
 
+  /**
+   * Setter fn for clickAndHold state value
+   */
+  setClickAndHoldActive: PropTypes.func,
+
+  /**
+   * Setter fn for containerHasFocus state value
+   */
+  setContainerHasFocus: PropTypes.func,
+
+  /**
+   * Setter fn for currentMatcher state value
+   */
+  setCurrentMatcher: PropTypes.func,
+
+  /**
+   * Setter fn for selectionAreas state value
+   */
+  setSelectionAreas: PropTypes.func,
+
   /**
    * The total columns width
    */

package/es/components/DataSpreadsheet/DataSpreadsheetHeader.js

@@ -1,4 +1,5 @@
 import _extends from "@babel/runtime/helpers/extends";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
 /**
  * Copyright IBM Corp. 2022, 2022
@@ -6,14 +7,40 @@ import _extends from "@babel/runtime/helpers/extends";
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import React from 'react';
+import React, { forwardRef } from 'react';
 import PropTypes from 'prop-types';
 import cx from 'classnames';
 import { pkg } from '../../settings';
+import { checkActiveHeaderCell } from './utils/checkActiveHeaderCell';
+import { handleHeaderCellSelection } from './utils/handleHeaderCellSelection';
 var blockClass = "".concat(pkg.prefix, "--data-spreadsheet");
-export var DataSpreadsheetHeader = function DataSpreadsheetHeader(_ref) {
-  var defaultColumn = _ref.defaultColumn,
-      headerGroups = _ref.headerGroups;
+export var DataSpreadsheetHeader = /*#__PURE__*/forwardRef(function (_ref, ref) {
+  var activeCellCoordinates = _ref.activeCellCoordinates,
+      columns = _ref.columns,
+      defaultColumn = _ref.defaultColumn,
+      headerGroups = _ref.headerGroups,
+      selectionAreas = _ref.selectionAreas,
+      setActiveCellCoordinates = _ref.setActiveCellCoordinates,
+      setCurrentMatcher = _ref.setCurrentMatcher,
+      setSelectionAreas = _ref.setSelectionAreas,
+      rows = _ref.rows;
+
+  var handleColumnHeaderClick = function handleColumnHeaderClick(index) {
+    return function () {
+      handleHeaderCellSelection({
+        type: 'column',
+        activeCellCoordinates: activeCellCoordinates,
+        rows: rows,
+        columns: columns,
+        setActiveCellCoordinates: setActiveCellCoordinates,
+        setCurrentMatcher: setCurrentMatcher,
+        setSelectionAreas: setSelectionAreas,
+        spreadsheetRef: ref,
+        index: index
+      });
+    };
+  };
+
   return /*#__PURE__*/React.createElement("div", {
     className: cx("".concat(blockClass, "__header--container"))
   }, headerGroups.map(function (headerGroup, index) {
@@ -26,7 +53,7 @@ export var DataSpreadsheetHeader = function DataSpreadsheetHeader(_ref) {
       "data-column-index": "header",
       type: "button",
       tabIndex: -1,
-      className: cx("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element")),
+      className: cx("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element"), _defineProperty({}, "".concat(blockClass, "__th--active-header"), (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === 'header' && (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === 'header')),
       style: {
         width: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth,
         height: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight
@@ -37,17 +64,31 @@ export var DataSpreadsheetHeader = function DataSpreadsheetHeader(_ref) {
         "data-row-index": "header",
         "data-column-index": index,
         tabIndex: -1,
+        onClick: handleColumnHeaderClick(index),
         style: {
           height: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight
         }
       }, column.getHeaderProps(), {
-        className: cx("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element")),
+        className: cx("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element"), _defineProperty({}, "".concat(blockClass, "__th--active-header"), (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === index || checkActiveHeaderCell(index, selectionAreas, 'column'))),
         type: "button"
       }), column.render('Header'));
     }));
   }));
-};
+});
 DataSpreadsheetHeader.propTypes = {
+  /**
+   * Object containing the active cell coordinates
+   */
+  activeCellCoordinates: PropTypes.shape({
+    row: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
+    column: PropTypes.oneOfType([PropTypes.number, PropTypes.string])
+  }),
+
+  /**
+   * All of the spreadsheet columns
+   */
+  columns: PropTypes.array,
+
   /**
    * Default spreadsheet sizing values
    */
@@ -60,5 +101,30 @@ DataSpreadsheetHeader.propTypes = {
   /**
    * Headers provided from useTable hook
    */
-  headerGroups: PropTypes.arrayOf(PropTypes.object)
+  headerGroups: PropTypes.arrayOf(PropTypes.object),
+
+  /**
+   * All of the spreadsheet row data
+   */
+  rows: PropTypes.arrayOf(PropTypes.object),
+
+  /**
+   * All of the cell selection area items
+   */
+  selectionAreas: PropTypes.arrayOf(PropTypes.object),
+
+  /**
+   * Setter fn for activeCellCoordinates value
+   */
+  setActiveCellCoordinates: PropTypes.func,
+
+  /**
+   * Setter fn for currentMatcher value
+   */
+  setCurrentMatcher: PropTypes.func,
+
+  /**
+   * Setter fn for selectionAreas value
+   */
+  setSelectionAreas: PropTypes.func
 };

package/es/components/DataSpreadsheet/hooks/useMoveActiveCell.js

@@ -0,0 +1,27 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useEffect } from 'react'; // Moves the placement of the active cell
+
+export var useMoveActiveCell = function useMoveActiveCell(_ref) {
+  var spreadsheetRef = _ref.spreadsheetRef,
+      activeCellCoordinates = _ref.activeCellCoordinates,
+      containerHasFocus = _ref.containerHasFocus,
+      createActiveCell = _ref.createActiveCell;
+  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
+      });
+    }
+  }, [activeCellCoordinates, spreadsheetRef, createActiveCell, containerHasFocus]);
+};

package/es/components/DataSpreadsheet/hooks/useResetSpreadsheetFocus.js

@@ -0,0 +1,28 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useEffect } from 'react';
+import { pkg } from '../../../settings';
+export var useResetSpreadsheetFocus = function useResetSpreadsheetFocus(_ref) {
+  var activeKeys = _ref.activeKeys,
+      _ref$blockClass = _ref.blockClass,
+      blockClass = _ref$blockClass === void 0 ? "".concat(pkg.prefix, "--data-spreadsheet") : _ref$blockClass,
+      focusedElement = _ref.focusedElement,
+      removeActiveCell = _ref.removeActiveCell,
+      setContainerHasFocus = _ref.setContainerHasFocus;
+  // Reset everything when spreadsheet loses focus
+  useEffect(function () {
+    if (!focusedElement.classList.contains("".concat(blockClass, "--interactive-cell-element"))) {
+      setContainerHasFocus(false);
+      removeActiveCell();
+      activeKeys.current = [];
+    }
+
+    if (focusedElement.classList.contains(blockClass) || focusedElement.classList.contains("".concat(blockClass, "--interactive-cell-element"))) {
+      setContainerHasFocus(true);
+    }
+  }, [focusedElement, removeActiveCell, activeKeys, blockClass, setContainerHasFocus]);
+};

package/es/components/DataSpreadsheet/hooks/useSpreadsheetOutsideClick.js

@@ -0,0 +1,41 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useEffect } from 'react';
+import { pkg } from '../../../settings'; // Click outside useEffect for spreadsheet
+
+export var useSpreadsheetOutsideClick = function useSpreadsheetOutsideClick(_ref) {
+  var spreadsheetRef = _ref.spreadsheetRef,
+      _ref$blockClass = _ref.blockClass,
+      blockClass = _ref$blockClass === void 0 ? "".concat(pkg.prefix, "--data-spreadsheet") : _ref$blockClass,
+      setActiveCellCoordinates = _ref.setActiveCellCoordinates,
+      setSelectionAreas = _ref.setSelectionAreas,
+      removeActiveCell = _ref.removeActiveCell,
+      removeCellSelections = _ref.removeCellSelections,
+      setContainerHasFocus = _ref.setContainerHasFocus,
+      activeKeys = _ref.activeKeys,
+      removeCellEditor = _ref.removeCellEditor;
+  useEffect(function () {
+    var handleOutsideClick = function handleOutsideClick(event) {
+      if (!spreadsheetRef.current || spreadsheetRef.current.contains(event.target) || event.target.classList.contains("".concat(blockClass, "__active-cell--highlight")) || event.target.classList.contains("".concat(blockClass, "--interactive-cell-element"))) {
+        return;
+      }
+
+      setActiveCellCoordinates(null);
+      setSelectionAreas([]);
+      removeActiveCell();
+      removeCellSelections();
+      setContainerHasFocus(false);
+      removeCellEditor();
+      activeKeys.current = [];
+    };
+
+    document.addEventListener('click', handleOutsideClick);
+    return function () {
+      document.removeEventListener('click', handleOutsideClick);
+    };
+  }, [spreadsheetRef, removeActiveCell, removeCellSelections, activeKeys, blockClass, setActiveCellCoordinates, setContainerHasFocus, setSelectionAreas, removeCellEditor]);
+};

package/es/components/DataSpreadsheet/utils/checkActiveHeaderCell.js

@@ -0,0 +1,34 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { deepCloneObject } from '../../../global/js/utils/deepCloneObject'; // Determines if a row or column header cell should receive a highlight/active background color
+// Check each object in selectionAreas and see if the headerIndex is between
+// point1.row and point2.row, inclusive
+
+export var checkActiveHeaderCell = function checkActiveHeaderCell(headerIndex, selectionAreas, headerType) {
+  var areasCloned = deepCloneObject(selectionAreas);
+  var activeRowIndexes = [];
+  areasCloned.forEach(function (area) {
+    var _area$point, _area$point2, _area$point3, _area$point4;
+
+    var greatestRowIndex = Math.max((_area$point = area.point1) === null || _area$point === void 0 ? void 0 : _area$point[headerType], (_area$point2 = area.point2) === null || _area$point2 === void 0 ? void 0 : _area$point2[headerType]);
+    var lowestRowIndex = Math.min((_area$point3 = area.point1) === null || _area$point3 === void 0 ? void 0 : _area$point3[headerType], (_area$point4 = area.point2) === null || _area$point4 === void 0 ? void 0 : _area$point4[headerType]);
+
+    for (var i = lowestRowIndex; i <= greatestRowIndex; i++) {
+      activeRowIndexes.push(i);
+    }
+  });
+
+  var activeRowIndexesNoDuplicates = _toConsumableArray(new Set(activeRowIndexes));
+
+  if (areasCloned !== null && areasCloned !== void 0 && areasCloned.length && activeRowIndexesNoDuplicates.includes(headerIndex)) {
+    return true;
+  }
+
+  return false;
+};

package/es/components/DataSpreadsheet/utils/createActiveCellFn.js

@@ -0,0 +1,58 @@
+/**
+ * Copyright IBM Corp. 2022, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { px } from '@carbon/layout';
+import { pkg } from '../../../settings';
+export var createActiveCellFn = function createActiveCellFn(_ref) {
+  var placementElement = _ref.placementElement,
+      coords = _ref.coords,
+      _ref$addToHeader = _ref.addToHeader,
+      addToHeader = _ref$addToHeader === void 0 ? false : _ref$addToHeader,
+      contextRef = _ref.contextRef,
+      _ref$blockClass = _ref.blockClass,
+      blockClass = _ref$blockClass === void 0 ? "".concat(pkg.prefix, "--data-spreadsheet") : _ref$blockClass,
+      onActiveCellChange = _ref.onActiveCellChange,
+      activeCellValue = _ref.activeCellValue,
+      activeCellRef = _ref.activeCellRef,
+      cellEditorRef = _ref.cellEditorRef,
+      defaultColumn = _ref.defaultColumn;
+
+  if (!coords) {
+    return;
+  } // If the active cell is in the column header row (very first), we need to append this element
+  // to `.${blockClass}__header--container`, otherwise it should be appended to `.${blockClass}__listContainer` firstElementChild
+
+
+  var point1Element = document.querySelector("[data-row-index=\"".concat(coords.row, "\"][data-column-index=\"").concat(coords.column, "\"]")) || document.querySelector(".".concat(blockClass, "__body--td")); // if we can't find the point1 element (this can happen in the case where a virtualized row is not present anymore in the DOM), we get the default height/width of the first body cell we find
+
+  var selectionAreaCellWidth = point1Element.offsetWidth;
+  var selectionAreaCellHeight = point1Element.offsetHeight;
+  var activeElementContainer = addToHeader ? contextRef === null || contextRef === void 0 ? void 0 : contextRef.current.querySelector(".".concat(blockClass, "__header--container")) : contextRef === null || contextRef === void 0 ? void 0 : contextRef.current.querySelector(".".concat(blockClass, "__list--container")).firstElementChild;
+  var relativePosition = {
+    top: placementElement ? placementElement.getBoundingClientRect().top - activeElementContainer.getBoundingClientRect().top : coords.row === 0 ? 0 : selectionAreaCellHeight * coords.row,
+    // calculate top value here if virtualized row is not in DOM
+    left: placementElement ? placementElement.getBoundingClientRect().left - activeElementContainer.getBoundingClientRect().left : coords.column === 0 ? 0 + (defaultColumn.rowHeaderWidth - 4) : selectionAreaCellWidth * coords.column + (defaultColumn.rowHeaderWidth - 4) // calculate left value here if virtualized row is not in DOM, accounting for row header cell width (including borders)
+
+  };
+  var activeCellButton = activeCellRef === null || activeCellRef === void 0 ? void 0 : activeCellRef.current;
+  activeCellButton.style.width = px(placementElement ? placementElement === null || placementElement === void 0 ? void 0 : placementElement.offsetWidth : selectionAreaCellWidth);
+  activeCellButton.style.height = px(placementElement ? placementElement === null || placementElement === void 0 ? void 0 : placementElement.offsetHeight : selectionAreaCellHeight);
+  activeCellButton.style.left = px(relativePosition.left);
+  activeCellButton.style.top = px(relativePosition.top);
+  activeCellButton.style.display = 'block';
+  activeCellButton.setAttribute('data-active-row-index', typeof (coords === null || coords === void 0 ? void 0 : coords.row) === 'number' ? coords.row : 'header');
+  activeCellButton.setAttribute('data-active-column-index', typeof (coords === null || coords === void 0 ? void 0 : coords.column) === 'number' ? coords.column : 'header');
+  activeElementContainer.appendChild(activeCellButton);
+  activeCellButton.focus();
+
+  if (!addToHeader) {
+    activeElementContainer.appendChild(cellEditorRef.current);
+  }
+
+  if (typeof (coords === null || coords === void 0 ? void 0 : coords.column) === 'number' && typeof (coords === null || coords === void 0 ? void 0 : coords.row) === 'number') {
+    onActiveCellChange === null || onActiveCellChange === void 0 ? void 0 : onActiveCellChange(activeCellValue);
+  }
+};