@carbon/ibm-products 2.0.0-rc.34 → 2.0.0-rc.38

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

@@ -0,0 +1,164 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+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; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+/**
+ * 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 { px } from '@carbon/layout';
+import { pkg } from '../../../settings';
+import { deepCloneObject } from '../../../global/js/utils/deepCloneObject';
+export var useSpreadsheetMouseUp = function useSpreadsheetMouseUp(_ref) {
+  var currentMatcher = _ref.currentMatcher,
+    setSelectionAreas = _ref.setSelectionAreas,
+    setClickAndHoldActive = _ref.setClickAndHoldActive,
+    setValidStartingPoint = _ref.setValidStartingPoint,
+    validStartingPoint = _ref.validStartingPoint,
+    _ref$blockClass = _ref.blockClass,
+    blockClass = _ref$blockClass === void 0 ? "".concat(pkg.prefix, "--data-spreadsheet") : _ref$blockClass,
+    ref = _ref.ref,
+    setHeaderCellHoldActive = _ref.setHeaderCellHoldActive,
+    setColumnOrder = _ref.setColumnOrder,
+    visibleColumns = _ref.visibleColumns,
+    setActiveCellCoordinates = _ref.setActiveCellCoordinates,
+    activeCellCoordinates = _ref.activeCellCoordinates,
+    rows = _ref.rows,
+    defaultColumn = _ref.defaultColumn,
+    selectionAreas = _ref.selectionAreas;
+  useEffect(function () {
+    var handleMouseUp = function handleMouseUp(event) {
+      // Remove the cloned selection area on mouse up
+      if (!validStartingPoint) {
+        setHeaderCellHoldActive(false);
+        var selectionAreaCloneElement = ref.current.querySelector(".".concat(blockClass, "__selection-area--element-cloned"));
+        if (!selectionAreaCloneElement) {
+          return;
+        }
+        // Mouse up while a cloned selection area exists/a column is being reordered
+        if (selectionAreaCloneElement) {
+          var closestCell = event.target.closest(".".concat(blockClass, "--interactive-cell-element"));
+          var newColumnIndex = parseInt === null || parseInt === void 0 ? void 0 : parseInt(closestCell === null || closestCell === void 0 ? void 0 : closestCell.getAttribute('data-column-index'));
+          var originalColumnIndex = parseInt === null || parseInt === void 0 ? void 0 : parseInt(selectionAreaCloneElement === null || selectionAreaCloneElement === void 0 ? void 0 : selectionAreaCloneElement.getAttribute('data-column-index-original'));
+          var selectionAreaToClone = selectionAreas.filter(function (item) {
+            return (item === null || item === void 0 ? void 0 : item.matcher) === currentMatcher;
+          });
+          var selectionAreaIndexArray = selectionAreaToClone[0].header.selectedIndexList;
+          var columnToMoveToElement = ref.current.querySelector("[data-row-index=\"header\"][data-column-index=\"".concat(newColumnIndex, "\"]"));
+          // Mouse up element was not part of the spreadsheet component
+          if (!columnToMoveToElement) {
+            return;
+          }
+          var selectionAreaToMove = ref.current.querySelector("[data-matcher-id=\"".concat(currentMatcher, "\"]"));
+          var spreadsheetPosition = ref.current.getBoundingClientRect();
+          var listContainer = ref.current.querySelector(".".concat(blockClass, "__list--container"));
+          var leftScrollAmount = listContainer.scrollLeft;
+          var newIndexLessThanStarting = newColumnIndex < originalColumnIndex;
+          var newIndexGreater = newColumnIndex > originalColumnIndex;
+          var differenceBetweenOldNewIndex = newIndexGreater ? newColumnIndex - originalColumnIndex : originalColumnIndex - newColumnIndex;
+          setSelectionAreas(function (prev) {
+            var selectionAreaClone = deepCloneObject(prev);
+            if (originalColumnIndex === newColumnIndex) {
+              return prev;
+            }
+            var indexOfItemToUpdate = selectionAreaClone.findIndex(function (item) {
+              return item.matcher === currentMatcher;
+            });
+            if (indexOfItemToUpdate === -1) {
+              return prev;
+            }
+            if (!selectionAreaIndexArray.includes(newColumnIndex)) {
+              // We need to not add just the newColumnIndex, but an array of indexes
+              // if there are multiple columns
+              var newIndexArray = newIndexGreater ? selectionAreaIndexArray.map(function (num) {
+                return num + differenceBetweenOldNewIndex;
+              }) : selectionAreaIndexArray.map(function (num) {
+                return num - differenceBetweenOldNewIndex;
+              });
+              selectionAreaClone[indexOfItemToUpdate].header.selectedIndexList = newIndexArray;
+              selectionAreaClone[indexOfItemToUpdate].point1.column = Math.min.apply(Math, _toConsumableArray(newIndexArray));
+              selectionAreaClone[indexOfItemToUpdate].point2.column = Math.max.apply(Math, _toConsumableArray(newIndexArray));
+            }
+            return selectionAreaClone;
+          });
+          // Only reorder columns if the new index is _not_ part of the
+          // selectionAreaIndexArray, meaning the new placement is outside
+          // of the current selection area. Similarly, the active cell position
+          // should only be changed under the same condition.
+          if (!selectionAreaIndexArray.includes(newColumnIndex)) {
+            var deleteCount = selectionAreaIndexArray.length;
+            var startIndex = Math.min.apply(Math, _toConsumableArray(selectionAreaIndexArray));
+            var columnIdArray = visibleColumns.map(function (column) {
+              return column.id;
+            });
+            var columnIdArrayClone = _toConsumableArray(columnIdArray);
+            var getNewColumnOrder = function getNewColumnOrder() {
+              var newColumnList = [];
+              selectionAreaIndexArray.map(function (index) {
+                return newColumnList.push(columnIdArray[index]);
+              });
+              return newColumnList;
+            };
+            // Remove one element at the original index
+            columnIdArrayClone.splice(startIndex, deleteCount);
+            var originalPointIndex = selectionAreaIndexArray.findIndex(function (item) {
+              return item === originalColumnIndex;
+            });
+            var updatedNewIndexWithNewOrder = newColumnIndex - originalPointIndex;
+            // Add one element at the new index
+            columnIdArrayClone.splice.apply(columnIdArrayClone, [updatedNewIndexWithNewOrder, 0].concat(_toConsumableArray(getNewColumnOrder())));
+            setColumnOrder(columnIdArrayClone); // Function provided by useTable (react-table) hook to reorder columns
+            var newCellCoords = _objectSpread(_objectSpread({}, activeCellCoordinates), {}, {
+              column: newIndexGreater ? activeCellCoordinates.column + differenceBetweenOldNewIndex : activeCellCoordinates.column - differenceBetweenOldNewIndex
+            });
+            setActiveCellCoordinates(newCellCoords);
+            var firstSelectedHeader = Array.from(ref.current.querySelectorAll(".".concat(blockClass, "__th--selected-header")))[0];
+            var firstSelectedHeaderCoords = firstSelectedHeader.getBoundingClientRect();
+            var newRelativePosition = firstSelectedHeaderCoords.left - spreadsheetPosition.left + leftScrollAmount;
+            // console.log(firstSelectedHeaderCoords.left - spreadsheetPosition.left + leftScrollAmount);
+            var updatedSelectionAreaPlacement = newIndexLessThanStarting ? newRelativePosition : newColumnIndex === originalColumnIndex ? selectionAreaToMove.style.left : newRelativePosition;
+            selectionAreaToMove.style.left = px(updatedSelectionAreaPlacement);
+          }
+          // Remove the cloned column and indicator elements
+          var indicatorLineElement = ref.current.querySelector(".".concat(blockClass, "__reorder-indicator-line"));
+          indicatorLineElement === null || indicatorLineElement === void 0 ? void 0 : indicatorLineElement.remove();
+          selectionAreaCloneElement === null || selectionAreaCloneElement === void 0 ? void 0 : selectionAreaCloneElement.remove();
+        }
+      }
+      // Mouse up was on a spreadsheet body cell which is a valid
+      // start/end point for creating a selection area
+      if (validStartingPoint) {
+        setClickAndHoldActive(false);
+        setValidStartingPoint(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);
+    };
+  }, [blockClass, currentMatcher, setSelectionAreas, setClickAndHoldActive, setValidStartingPoint, validStartingPoint, ref, setHeaderCellHoldActive, setColumnOrder, visibleColumns, setActiveCellCoordinates, activeCellCoordinates, rows, defaultColumn, selectionAreas]);
+};

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';
+import { removeCellSelections } from '../utils/removeCellSelections';
+
+// 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,
+    setContainerHasFocus = _ref.setContainerHasFocus,
+    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({
+        spreadsheetRef: spreadsheetRef
+      });
+      setContainerHasFocus(false);
+      removeCellEditor();
+    };
+    document.addEventListener('click', handleOutsideClick);
+    return function () {
+      document.removeEventListener('click', handleOutsideClick);
+    };
+  }, [spreadsheetRef, removeActiveCell, blockClass, setActiveCellCoordinates, setContainerHasFocus, setSelectionAreas, removeCellEditor]);
+};

package/es/components/DataSpreadsheet/index.js

@@ -0,0 +1,8 @@
+/**
+ * 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.
+ */
+
+export { DataSpreadsheet } from './DataSpreadsheet';

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

@@ -0,0 +1,30 @@
+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/checkSelectedHeaderCell.js

@@ -0,0 +1,29 @@
+/**
+ * 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';
+export var checkSelectedHeaderCell = function checkSelectedHeaderCell(headerIndex, selectionAreas, headerType, items) {
+  var areasCloned = deepCloneObject(selectionAreas);
+  var isSelectedHeader = areasCloned.some(function (area) {
+    var _area$point, _area$point2, _area$point3, _area$point4, _area$point5, _area$point6, _area$point7, _area$point8;
+    var oppositeType = headerType === 'column' ? 'row' : 'column';
+    var minOppositeSelection = Math.min(area === null || area === void 0 ? void 0 : (_area$point = area.point1) === null || _area$point === void 0 ? void 0 : _area$point[oppositeType], area === null || area === void 0 ? void 0 : (_area$point2 = area.point2) === null || _area$point2 === void 0 ? void 0 : _area$point2[oppositeType]);
+    var maxOppositeSelection = Math.max(area === null || area === void 0 ? void 0 : (_area$point3 = area.point1) === null || _area$point3 === void 0 ? void 0 : _area$point3[oppositeType], area === null || area === void 0 ? void 0 : (_area$point4 = area.point2) === null || _area$point4 === void 0 ? void 0 : _area$point4[oppositeType]);
+    var minSelection = Math.min(area === null || area === void 0 ? void 0 : (_area$point5 = area.point1) === null || _area$point5 === void 0 ? void 0 : _area$point5[headerType], area === null || area === void 0 ? void 0 : (_area$point6 = area.point2) === null || _area$point6 === void 0 ? void 0 : _area$point6[headerType]);
+    var maxSelection = Math.max(area === null || area === void 0 ? void 0 : (_area$point7 = area.point1) === null || _area$point7 === void 0 ? void 0 : _area$point7[headerType], area === null || area === void 0 ? void 0 : (_area$point8 = area.point2) === null || _area$point8 === void 0 ? void 0 : _area$point8[headerType]);
+    var isTrueSelectedState = (items === null || items === void 0 ? void 0 : items.length) - 1 === maxOppositeSelection && minOppositeSelection === 0;
+    // console.log({minSelection, maxSelection});
+    // Iterate over all columns included in the selection area
+    for (var i = minSelection; i <= maxSelection; i++) {
+      if (headerIndex === i && isTrueSelectedState) {
+        return true;
+      }
+    }
+    return false;
+  });
+  return isSelectedHeader;
+};

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

@@ -0,0 +1,54 @@
+/**
+ * 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);
+  }
+};

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

@@ -0,0 +1,64 @@
+/**
+ * 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 { deepCloneObject } from '../../../global/js/utils/deepCloneObject';
+import { getSelectionAreaPoints } from './getSelectionAreaPoints';
+export var createCellSelectionArea = function createCellSelectionArea(_ref) {
+  var ref = _ref.ref,
+    area = _ref.area,
+    blockClass = _ref.blockClass,
+    defaultColumn = _ref.defaultColumn,
+    selectionAreas = _ref.selectionAreas,
+    setSelectionAreas = _ref.setSelectionAreas,
+    setActiveCellInsideSelectionArea = _ref.setActiveCellInsideSelectionArea,
+    visibleColumns = _ref.visibleColumns;
+  var _getSelectionAreaPoin = getSelectionAreaPoints(area),
+    lowestColumnIndex = _getSelectionAreaPoin.lowestColumnIndex,
+    lowestRowIndex = _getSelectionAreaPoin.lowestRowIndex,
+    greatestColumnIndex = _getSelectionAreaPoin.greatestColumnIndex,
+    greatestRowIndex = _getSelectionAreaPoin.greatestRowIndex;
+  if (greatestRowIndex - lowestRowIndex > 0 || greatestColumnIndex - lowestColumnIndex > 0) {
+    setActiveCellInsideSelectionArea(true);
+    var activeCellElement = ref.current.querySelector(".".concat(blockClass, "__active-cell--highlight"));
+    activeCellElement.setAttribute('data-selection-id', area.matcher);
+  }
+  var selectionAreaVariableWidth = 0;
+  visibleColumns.forEach(function (item, index) {
+    if (index >= lowestColumnIndex && index <= greatestColumnIndex) {
+      selectionAreaVariableWidth += (item === null || item === void 0 ? void 0 : item.width) || (defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.width);
+    }
+  });
+  var point1Element = document.querySelector("[data-row-index=\"".concat(area.point1.row, "\"][data-column-index=\"").concat(area.point1.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 of the first body cell we find
+
+  var selectionAreaCellHeight = point1Element.offsetHeight;
+  var selectionAreaTotalHeight = selectionAreaCellHeight * (greatestRowIndex - 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 ? placementElement.getBoundingClientRect().top - bodyContainer.getBoundingClientRect().top : lowestRowIndex === 0 ? 0 : selectionAreaCellHeight * lowestRowIndex,
+    // calculate top value here if virtualized row is not in DOM
+    left: placementElement ? placementElement.getBoundingClientRect().left - bodyContainer.getBoundingClientRect().left : lowestColumnIndex === 0 ? 0 + (defaultColumn.rowHeaderWidth - 4) : defaultColumn.width * lowestColumnIndex + (defaultColumn.rowHeaderWidth - 4) // calculate left value here if virtualized row is not in DOM, accounting for row header cell width (including borders)
+  };
+
+  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 = px(selectionAreaVariableWidth);
+  selectionAreaElement.style.height = px(selectionAreaTotalHeight);
+  selectionAreaElement.style.left = px(relativePosition.left);
+  selectionAreaElement.style.top = px(relativePosition.top);
+  bodyContainer.appendChild(selectionAreaElement);
+  var selectionAreasClone = 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);
+};

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

@@ -0,0 +1,52 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+/**
+ * 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.
+ */
+
+// cspell:disable
+var pets = ['dog', 'cat', 'bird', 'lizard', 'frog', 'hamster', 'fish', 'rabbit', 'snake'];
+var petNames = ['Bruno', 'Willow', 'Kona', 'Heidi', 'Rusty', 'Bonnie', 'Cash', 'Gucci', 'Brody', 'Emma', 'Loki', 'Angel', 'Astro', 'Sherman', 'Layla', 'Peanut', 'Grace', 'Mickey', 'Sasha', 'Finn', 'Tucker', 'Bear', 'Mocha', 'Roscoe'];
+// cspell:enable
+
+var range = function range(len) {
+  var arr = [];
+  for (var i = 0; i < len; i++) {
+    arr.push(i);
+  }
+  return arr;
+};
+var newPet = function newPet(extraColumns) {
+  var extraDataProps = extraColumns && {
+    ownerName: petNames[Math.floor(Math.random() * petNames.length)],
+    weight: Math.floor(Math.random() * 40)
+  };
+  var defaultPet = {
+    petType: pets[Math.floor(Math.random() * pets.length)],
+    firstName: petNames[Math.floor(Math.random() * petNames.length)],
+    age: Math.floor(Math.random() * 30),
+    visits: Math.floor(Math.random() * 40),
+    health: Math.floor(Math.random() * 100)
+  };
+  if (extraColumns) {
+    return _objectSpread(_objectSpread({}, defaultPet), extraDataProps);
+  }
+  return defaultPet;
+};
+export var generateData = function generateData(_ref) {
+  var rows = _ref.rows,
+    extraColumns = _ref.extraColumns;
+  var makeDataLevel = function makeDataLevel() {
+    var depth = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
+    var lens = [rows];
+    var len = lens[depth];
+    return range(len).map(function () {
+      return _objectSpread({}, newPet(extraColumns));
+    });
+  };
+  return makeDataLevel();
+};

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

@@ -0,0 +1,25 @@
+/**
+ * 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 { baseFontSize, sizeXSmall as xs, sizeSmall as sm, sizeMedium as md, sizeLarge as lg } from '@carbon/layout';
+var getSizeInPixels = function getSizeInPixels(carbonSize) {
+  return Number(carbonSize.replace('rem', '') * baseFontSize);
+};
+export var getCellSize = function getCellSize(cellSize) {
+  switch (cellSize) {
+    case 'xs':
+      return getSizeInPixels(xs);
+    case 'sm':
+      return getSizeInPixels(sm);
+    case 'md':
+      return getSizeInPixels(md);
+    case 'lg':
+      return getSizeInPixels(lg);
+    default:
+      return getSizeInPixels(sm);
+  }
+};

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

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+
+export var getSelectionAreaPoints = function getSelectionAreaPoints(area) {
+  var greatestRowIndex = Math.max(area.point1.row, area.point2.row);
+  var greatestColumnIndex = 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);
+  return {
+    greatestRowIndex: greatestRowIndex,
+    greatestColumnIndex: greatestColumnIndex,
+    lowestColumnIndex: lowestColumnIndex,
+    lowestRowIndex: lowestRowIndex
+  };
+};

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

@@ -0,0 +1,34 @@
+/**
+ * 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';
+export var getSpreadsheetWidth = function getSpreadsheetWidth(_ref) {
+  var type = _ref.type,
+    headerGroup = _ref.headerGroup,
+    scrollBarSizeValue = _ref.scrollBarSizeValue,
+    totalVisibleColumns = _ref.totalVisibleColumns,
+    defaultColumn = _ref.defaultColumn,
+    totalColumnsWidth = _ref.totalColumnsWidth,
+    visibleColumns = _ref.visibleColumns;
+  var additionalWidth = scrollBarSizeValue + defaultColumn.rowHeaderWidth;
+  if (!totalVisibleColumns) {
+    if (type === 'header') {
+      return px(parseInt(headerGroup.getHeaderGroupProps().style.width) + additionalWidth);
+    }
+    if (type !== 'header') {
+      return totalColumnsWidth + additionalWidth;
+    }
+  }
+  if (totalVisibleColumns) {
+    var totalVisibleColumnWidth = visibleColumns.map(function (item, index) {
+      return index <= totalVisibleColumns - 1 && ((item === null || item === void 0 ? void 0 : item.width) || (defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.width));
+    }).reduce(function (prev, curr) {
+      return prev + curr;
+    }, 0);
+    return totalVisibleColumnWidth + additionalWidth;
+  }
+};

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

@@ -0,0 +1,107 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+/**
+ * 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 { getSelectionAreaPoints } from './getSelectionAreaPoints';
+export var handleActiveCellInSelectionEnter = function handleActiveCellInSelectionEnter(_ref) {
+  var activeCellInsideSelectionArea = _ref.activeCellInsideSelectionArea,
+    activeCellCoordinates = _ref.activeCellCoordinates,
+    activeCellRef = _ref.activeCellRef,
+    selectionAreas = _ref.selectionAreas,
+    updateActiveCellCoordinates = _ref.updateActiveCellCoordinates;
+  if (!activeCellInsideSelectionArea) {
+    return;
+  }
+  var activeCellSelectionId = activeCellRef.current.getAttribute('data-selection-id');
+  var activeCellIndexInSelectionAreas = selectionAreas.findIndex(function (item) {
+    return item.matcher === activeCellSelectionId;
+  });
+  var selectionAreaToNavigate = selectionAreas[activeCellIndexInSelectionAreas];
+  var _getSelectionAreaPoin = getSelectionAreaPoints(selectionAreaToNavigate),
+    lowestColumnIndex = _getSelectionAreaPoin.lowestColumnIndex,
+    lowestRowIndex = _getSelectionAreaPoin.lowestRowIndex,
+    greatestColumnIndex = _getSelectionAreaPoin.greatestColumnIndex,
+    greatestRowIndex = _getSelectionAreaPoin.greatestRowIndex;
+  // Move active cell down one row if possible
+  var coordinatesClone = _objectSpread({}, activeCellCoordinates);
+  if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) < greatestRowIndex) {
+    updateActiveCellCoordinates({
+      coords: coordinatesClone,
+      updatedValue: {
+        row: (coordinatesClone === null || coordinatesClone === void 0 ? void 0 : coordinatesClone.row) + 1
+      },
+      optOutOfSelectionAreaUpdate: true
+    });
+  }
+  // Move active cell to next column of selection area if it exists
+  // If not, find the next selection area and update active cell to
+  // be the first cell in that selection
+  if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.row) === greatestRowIndex) {
+    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) < greatestColumnIndex) {
+      updateActiveCellCoordinates({
+        coords: coordinatesClone,
+        updatedValue: {
+          column: (coordinatesClone === null || coordinatesClone === void 0 ? void 0 : coordinatesClone.column) + 1,
+          row: lowestRowIndex
+        },
+        optOutOfSelectionAreaUpdate: true
+      });
+    }
+    // Move to next selection area if there is one, or back to
+    // the beginning of the current selection
+    if ((activeCellCoordinates === null || activeCellCoordinates === void 0 ? void 0 : activeCellCoordinates.column) === greatestColumnIndex) {
+      if (selectionAreas.length > 1) {
+        if (selectionAreas[activeCellIndexInSelectionAreas + 1]) {
+          // Update activeCellRef data-selection-id attribute to the matcher of the next selection area
+          activeCellRef.current.setAttribute('data-selection-id', selectionAreas[activeCellIndexInSelectionAreas + 1].matcher);
+          var nextSelectionArea = selectionAreas[activeCellIndexInSelectionAreas + 1];
+          var _getSelectionAreaPoin2 = getSelectionAreaPoints(nextSelectionArea),
+            _lowestColumnIndex = _getSelectionAreaPoin2.lowestColumnIndex,
+            _lowestRowIndex = _getSelectionAreaPoin2.lowestRowIndex;
+          updateActiveCellCoordinates({
+            coords: coordinatesClone,
+            updatedValue: {
+              column: _lowestColumnIndex,
+              row: _lowestRowIndex
+            },
+            optOutOfSelectionAreaUpdate: true
+          });
+          return;
+        } else {
+          // There are multiple selection areas and the active cell is in the last one
+          // So we need to move the active cell to the first cell in the first selection area
+          activeCellRef.current.setAttribute('data-selection-id', selectionAreas[0].matcher);
+          var firstSelectionArea = selectionAreas[0];
+          var _getSelectionAreaPoin3 = getSelectionAreaPoints(firstSelectionArea),
+            _lowestColumnIndex2 = _getSelectionAreaPoin3.lowestColumnIndex,
+            _lowestRowIndex2 = _getSelectionAreaPoin3.lowestRowIndex;
+          updateActiveCellCoordinates({
+            coords: coordinatesClone,
+            updatedValue: {
+              column: _lowestColumnIndex2,
+              row: _lowestRowIndex2
+            },
+            optOutOfSelectionAreaUpdate: true
+          });
+        }
+      }
+      // Only one selection area, go back to first cell in the selection
+      if (selectionAreas.length === 1) {
+        return updateActiveCellCoordinates({
+          coords: coordinatesClone,
+          updatedValue: {
+            column: lowestColumnIndex,
+            row: lowestRowIndex
+          },
+          optOutOfSelectionAreaUpdate: true
+        });
+      }
+    }
+  }
+};