@carbon/ibm-products 1.7.0 → 1.10.0

package/lib/components/DataSpreadsheet/DataSpreadsheetBody.js

@@ -0,0 +1,391 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DataSpreadsheetBody = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
+var _react = _interopRequireWildcard(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _reactWindow = require("react-window");
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _settings = require("../../settings");
+
+var _deepCloneObject = require("../../global/js/utils/deepCloneObject");
+
+var _uuidv = _interopRequireDefault(require("../../global/js/utils/uuidv4"));
+
+var _createCellSelectionArea = require("./createCellSelectionArea");
+
+var _checkActiveHeaderCell = require("./checkActiveHeaderCell");
+
+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; }
+
+/**
+ * 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.
+ */
+var blockClass = "".concat(_settings.pkg.prefix, "--data-spreadsheet");
+var DataSpreadsheetBody = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
+  var 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,
+      clickAndHoldActive = _ref.clickAndHoldActive,
+      setClickAndHoldActive = _ref.setClickAndHoldActive,
+      currentMatcher = _ref.currentMatcher,
+      setCurrentMatcher = _ref.setCurrentMatcher;
+  var currentMatcherRef = ref; // Create cell selection areas based on selectionAreas array
+
+  (0, _react.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 = (0, _deepCloneObject.deepCloneObject)(selectionAreas);
+            var indexOfCurrentArea = selectionAreasClone.findIndex(function (item) {
+              return item.matcher === area.matcher;
+            });
+            selectionAreasClone[indexOfCurrentArea].areaCreated = false;
+            selectionAreasClone[indexOfCurrentArea].point2 = null;
+            return setSelectionAreas(selectionAreasClone);
+          }
+
+          (0, _createCellSelectionArea.createCellSelectionArea)({
+            area: area,
+            blockClass: blockClass,
+            selectionAreas: selectionAreas,
+            setSelectionAreas: setSelectionAreas
+          });
+        }
+
+        return;
+      });
+    }
+  }, [selectionAreas, setSelectionAreas]); // Mouse up
+
+  (0, _react.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 = (0, _deepCloneObject.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;
+        });
+      } else {
+        var selectionAreaClone = (0, _deepCloneObject.deepCloneObject)(selectionAreas);
+        var indexOfItemToUpdate = selectionAreaClone.findIndex(function (item) {
+          return item.matcher === currentMatcher;
+        });
+
+        if (indexOfItemToUpdate === -1) {
+          return;
+        }
+
+        var notYetCreatedSelections = selectionAreaClone.filter(function (item) {
+          return !item.areaCreated && item.matcher === currentMatcher;
+        });
+        var previouslyCreatedSelectionAreas = selectionAreaClone.filter(function (item) {
+          return item.point2 && item.areaCreated;
+        }); // We want to ensure that there is only ever one item in selectionAreas
+        // that has not been created yet. This item's point1 values will always
+        // be equal to the activeCellCoordinates
+
+        setSelectionAreas([].concat((0, _toConsumableArray2.default)(notYetCreatedSelections), (0, _toConsumableArray2.default)(previouslyCreatedSelectionAreas)));
+      }
+    };
+
+    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
+
+  (0, _react.useEffect)(function () {
+    var listContainer = spreadsheetBodyRef === null || spreadsheetBodyRef === void 0 ? void 0 : spreadsheetBodyRef.current;
+    var activeCellButton = listContainer.querySelector(".".concat(blockClass, "__active-cell--highlight"));
+
+    if (activeCellButton) {
+      activeCellButton.style.height = "".concat(defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight, "px");
+    }
+  }, [defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight]); // onClick fn for each cell in the data spreadsheet body,
+  // adds the active cell highlight
+
+  var handleBodyCellClick = (0, _react.useCallback)(function (cell, columnIndex) {
+    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 = (0, _uuidv.default)(); // 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((0, _toConsumableArray2.default)(prev), [{
+            point1: activeCoordinates,
+            matcher: tempMatcher
+          }]);
+        });
+      } else if (isHoldingShiftKey) {
+        setContainerHasFocus(true);
+        var selectionAreaClone = (0, _deepCloneObject.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
+
+        var cellSelections = spreadsheetBodyRef.current.querySelectorAll(".".concat(blockClass, "__selection-area--element"));
+        (0, _toConsumableArray2.default)(cellSelections).forEach(function (element) {
+          return element.remove();
+        });
+        setSelectionAreas([{
+          point1: activeCoordinates,
+          matcher: tempMatcher
+        }]);
+        setCurrentMatcher(tempMatcher);
+      }
+
+      currentMatcherRef.current = tempMatcher;
+      setClickAndHoldActive(true);
+    };
+  }, [currentMatcherRef, currentMatcher, activeCellCoordinates, selectionAreas, setActiveCellCoordinates, setSelectionAreas, setContainerHasFocus, setClickAndHoldActive, setCurrentMatcher]);
+  var handleBodyCellHover = (0, _react.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 = (0, _deepCloneObject.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]); // Renders each cell in the spreadsheet body
+
+  var RenderRow = (0, _react.useCallback)(function (_ref2) {
+    var index = _ref2.index,
+        style = _ref2.style;
+    var row = rows[index];
+    prepareRow(row);
+    return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({}, row.getRowProps({
+      style: style
+    }), {
+      className: (0, _classnames.default)("".concat(blockClass, "__tr")),
+      "data-row-index": index
+    }), /*#__PURE__*/_react.default.createElement("button", {
+      tabIndex: -1,
+      "data-row-index": index,
+      "data-column-index": "header",
+      type: "button",
+      className: (0, _classnames.default)("".concat(blockClass, "__td"), "".concat(blockClass, "__td-th"), "".concat(blockClass, "--interactive-cell-element"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__td-th--active-header"), (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === index || (0, _checkActiveHeaderCell.checkActiveHeaderCell)(index, selectionAreas, 'row'))),
+      style: {
+        width: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth
+      }
+    }, index + 1), row.cells.map(function (cell, index) {
+      return /*#__PURE__*/_react.default.createElement("button", (0, _extends2.default)({
+        tabIndex: -1,
+        "data-row-index": cell.row.index,
+        "data-column-index": index
+      }, cell.getCellProps(), {
+        className: (0, _classnames.default)("".concat(blockClass, "__td"), "".concat(blockClass, "__body--td"), "".concat(blockClass, "--interactive-cell-element")),
+        key: "cell_".concat(index),
+        onMouseDown: handleBodyCellClick(cell, index),
+        onMouseOver: handleBodyCellHover(cell, index),
+        onFocus: function onFocus() {},
+        type: "button"
+      }), cell.render('Cell'));
+    }));
+  }, [prepareRow, rows, defaultColumn.rowHeaderWidth, handleBodyCellClick, handleBodyCellHover, activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row, selectionAreas]);
+  var spreadsheetBodyRef = (0, _react.useRef)();
+  return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({
+    ref: spreadsheetBodyRef,
+    className: (0, _classnames.default)("".concat(blockClass, "__body--container"))
+  }, getTableBodyProps()), /*#__PURE__*/_react.default.createElement(_reactWindow.FixedSizeList, {
+    className: (0, _classnames.default)("".concat(blockClass, "__list--container"), "".concat(blockClass, "__list--container--").concat(id)),
+    height: 400,
+    itemCount: rows.length,
+    itemSize: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight,
+    width: totalColumnsWidth + scrollBarSize
+  }, RenderRow));
+});
+exports.DataSpreadsheetBody = DataSpreadsheetBody;
+DataSpreadsheetBody.propTypes = {
+  /**
+   * Object containing the active cell coordinates
+   */
+  activeCellCoordinates: _propTypes.default.shape({
+    row: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number]),
+    column: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number])
+  }),
+
+  /**
+   * Is the user clicking and holding in the data spreadsheet body
+   */
+  clickAndHoldActive: _propTypes.default.bool,
+
+  /**
+   * This represents the id of the current cell selection area
+   */
+  currentMatcher: _propTypes.default.string,
+
+  /**
+   * Default spreadsheet sizing values
+   */
+  defaultColumn: _propTypes.default.shape({
+    rowHeight: _propTypes.default.number,
+    rowHeaderWidth: _propTypes.default.number,
+    width: _propTypes.default.number
+  }),
+
+  /**
+   * Function to set table body prop values
+   */
+  getTableBodyProps: _propTypes.default.func,
+
+  /**
+   * The spreadsheet id
+   */
+  id: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
+
+  /**
+   * The event handler that is called when the active cell changes
+   */
+  onActiveCellChange: _propTypes.default.func,
+
+  /**
+   * Prepare row function from react-table
+   */
+  prepareRow: _propTypes.default.func,
+
+  /**
+   * All of the spreadsheet row data
+   */
+  rows: _propTypes.default.arrayOf(_propTypes.default.object),
+
+  /**
+   * The scrollbar width
+   */
+  scrollBarSize: _propTypes.default.number,
+
+  /**
+   * Array of selection areas
+   */
+  selectionAreas: _propTypes.default.array,
+
+  /**
+   * Setter fn for activeCellCoordinates state value
+   */
+  setActiveCellCoordinates: _propTypes.default.func,
+
+  /**
+   * Setter fn for clickAndHold state value
+   */
+  setClickAndHoldActive: _propTypes.default.func,
+
+  /**
+   * Setter fn for containerHasFocus state value
+   */
+  setContainerHasFocus: _propTypes.default.func,
+
+  /**
+   * Setter fn for currentMatcher state value
+   */
+  setCurrentMatcher: _propTypes.default.func,
+
+  /**
+   * Setter fn for selectionAreas state value
+   */
+  setSelectionAreas: _propTypes.default.func,
+
+  /**
+   * The total columns width
+   */
+  totalColumnsWidth: _propTypes.default.number
+};

package/lib/components/DataSpreadsheet/DataSpreadsheetHeader.js

@@ -0,0 +1,99 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DataSpreadsheetHeader = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+var _settings = require("../../settings");
+
+var _checkActiveHeaderCell = require("./checkActiveHeaderCell");
+
+/**
+ * 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.
+ */
+var blockClass = "".concat(_settings.pkg.prefix, "--data-spreadsheet");
+
+var DataSpreadsheetHeader = function DataSpreadsheetHeader(_ref) {
+  var activeCellCoordinates = _ref.activeCellCoordinates,
+      defaultColumn = _ref.defaultColumn,
+      headerGroups = _ref.headerGroups,
+      selectionAreas = _ref.selectionAreas;
+  return /*#__PURE__*/_react.default.createElement("div", {
+    className: (0, _classnames.default)("".concat(blockClass, "__header--container"))
+  }, headerGroups.map(function (headerGroup, index) {
+    return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({
+      key: "header_".concat(index)
+    }, headerGroup.getHeaderGroupProps(), {
+      className: "".concat(blockClass, "__tr")
+    }), /*#__PURE__*/_react.default.createElement("button", {
+      "data-row-index": "header",
+      "data-column-index": "header",
+      type: "button",
+      tabIndex: -1,
+      className: (0, _classnames.default)("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element"), (0, _defineProperty2.default)({}, "".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
+      }
+    }, "\xA0"), headerGroup.headers.map(function (column, index) {
+      return /*#__PURE__*/_react.default.createElement("button", (0, _extends2.default)({
+        key: "column_".concat(index),
+        "data-row-index": "header",
+        "data-column-index": index,
+        tabIndex: -1,
+        style: {
+          height: defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeight
+        }
+      }, column.getHeaderProps(), {
+        className: (0, _classnames.default)("".concat(blockClass, "__th"), "".concat(blockClass, "--interactive-cell-element"), (0, _defineProperty2.default)({}, "".concat(blockClass, "__th--active-header"), (activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === index || (0, _checkActiveHeaderCell.checkActiveHeaderCell)(index, selectionAreas, 'column'))),
+        type: "button"
+      }), column.render('Header'));
+    }));
+  }));
+};
+
+exports.DataSpreadsheetHeader = DataSpreadsheetHeader;
+DataSpreadsheetHeader.propTypes = {
+  /**
+   * Object containing the active cell coordinates
+   */
+  activeCellCoordinates: _propTypes.default.shape({
+    row: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]),
+    column: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string])
+  }),
+
+  /**
+   * Default spreadsheet sizing values
+   */
+  defaultColumn: _propTypes.default.shape({
+    rowHeight: _propTypes.default.number,
+    rowHeaderWidth: _propTypes.default.number,
+    width: _propTypes.default.number
+  }),
+
+  /**
+   * Headers provided from useTable hook
+   */
+  headerGroups: _propTypes.default.arrayOf(_propTypes.default.object),
+
+  /**
+   * All of the cell selection area items
+   */
+  selectionAreas: _propTypes.default.arrayOf(_propTypes.default.object)
+};

package/lib/components/DataSpreadsheet/checkActiveHeaderCell.js

@@ -0,0 +1,45 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.checkActiveHeaderCell = void 0;
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
+var _deepCloneObject = require("../../global/js/utils/deepCloneObject");
+
+/**
+ * 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.
+ */
+// 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
+var checkActiveHeaderCell = function checkActiveHeaderCell(headerIndex, selectionAreas, headerType) {
+  var areasCloned = (0, _deepCloneObject.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 = (0, _toConsumableArray2.default)(new Set(activeRowIndexes));
+
+  if (areasCloned !== null && areasCloned !== void 0 && areasCloned.length && activeRowIndexesNoDuplicates.includes(headerIndex)) {
+    return true;
+  }
+
+  return false;
+};
+
+exports.checkActiveHeaderCell = checkActiveHeaderCell;

package/lib/components/DataSpreadsheet/createActiveCellFn.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createActiveCellFn = void 0;
+
+var _layout = require("@carbon/layout");
+
+var _settings = require("../../settings");
+
+/**
+ * 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.
+ */
+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(_settings.pkg.prefix, "--data-spreadsheet") : _ref$blockClass,
+      onActiveCellChange = _ref.onActiveCellChange,
+      activeCellValue = _ref.activeCellValue,
+      handleActiveCellMouseEnter = _ref.handleActiveCellMouseEnter;
+
+  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 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.getBoundingClientRect().top - activeElementContainer.getBoundingClientRect().top,
+    left: placementElement.getBoundingClientRect().left - activeElementContainer.getBoundingClientRect().left
+  };
+  var activeCellButton = (contextRef === null || contextRef === void 0 ? void 0 : contextRef.current.querySelector(".".concat(blockClass, "__active-cell--highlight"))) || document.createElement('button');
+  activeCellButton.classList.add("".concat(blockClass, "__active-cell--highlight"), "".concat(blockClass, "--interactive-cell-element"));
+  activeCellButton.addEventListener('mouseenter', handleActiveCellMouseEnter);
+  activeCellButton.style.width = (0, _layout.px)(placementElement === null || placementElement === void 0 ? void 0 : placementElement.offsetWidth);
+  activeCellButton.style.height = (0, _layout.px)(placementElement === null || placementElement === void 0 ? void 0 : placementElement.offsetHeight);
+  activeCellButton.style.left = (0, _layout.px)(relativePosition.left);
+  activeCellButton.style.top = (0, _layout.px)(relativePosition.top);
+  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 (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);
+  }
+};
+
+exports.createActiveCellFn = createActiveCellFn;

package/lib/components/DataSpreadsheet/createCellSelectionArea.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createCellSelectionArea = void 0;
+
+var _layout = require("@carbon/layout");
+
+var _deepCloneObject = require("../../global/js/utils/deepCloneObject");
+
+/**
+ * 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.
+ */
+var createCellSelectionArea = function createCellSelectionArea(_ref) {
+  var area = _ref.area,
+      blockClass = _ref.blockClass,
+      selectionAreas = _ref.selectionAreas,
+      setSelectionAreas = _ref.setSelectionAreas;
+  var greatestRow = Math.max(area.point1.row, area.point2.row);
+  var greatestColumn = Math.max(area.point1.column, area.point2.column);
+  var lowestRowIndex = Math.min(area.point1.row, area.point2.row);
+  var lowestColumnIndex = Math.min(area.point1.column, area.point2.column);
+  var point1Element = document.querySelector("[data-row-index=\"".concat(area.point1.row, "\"][data-column-index=\"").concat(area.point1.column, "\"]"));
+  var selectionAreaCellWidth = point1Element.offsetWidth;
+  var selectionAreaCellHeight = point1Element.offsetHeight;
+  var selectionAreaTotalWidth = selectionAreaCellWidth * (greatestColumn - lowestColumnIndex + 1);
+  var selectionAreaTotalHeight = selectionAreaCellHeight * (greatestRow - lowestRowIndex + 1);
+  var bodyContainer = document.querySelector(".".concat(blockClass, "__list--container")).firstElementChild;
+  var placementElement = bodyContainer.querySelector("[data-row-index=\"".concat(lowestRowIndex, "\"][data-column-index=\"").concat(lowestColumnIndex, "\"]"));
+  var relativePosition = {
+    top: placementElement.getBoundingClientRect().top - bodyContainer.getBoundingClientRect().top,
+    left: placementElement.getBoundingClientRect().left - bodyContainer.getBoundingClientRect().left
+  };
+  var selectionAreaElement = document.querySelector("[data-matcher-id=\"".concat(area.matcher, "\"]")) || document.createElement('div');
+  selectionAreaElement.classList.add("".concat(blockClass, "__selection-area--element"));
+  selectionAreaElement.setAttribute('data-matcher-id', area.matcher);
+  selectionAreaElement.style.width = (0, _layout.px)(selectionAreaTotalWidth);
+  selectionAreaElement.style.height = (0, _layout.px)(selectionAreaTotalHeight);
+  selectionAreaElement.style.left = (0, _layout.px)(relativePosition.left);
+  selectionAreaElement.style.top = (0, _layout.px)(relativePosition.top);
+  bodyContainer.appendChild(selectionAreaElement);
+  var selectionAreasClone = (0, _deepCloneObject.deepCloneObject)(selectionAreas);
+  var indexOfCurrentArea = selectionAreasClone.findIndex(function (item) {
+    return item.matcher === area.matcher;
+  }); // We need to add another property to the selectionAreas object array to
+  // let us know if an area has been created for each item already, ie createdArea: true
+
+  selectionAreasClone[indexOfCurrentArea].areaCreated = true;
+  setSelectionAreas(selectionAreasClone);
+};
+
+exports.createCellSelectionArea = createCellSelectionArea;