@carbon/ibm-products 1.6.1 → 1.9.0

package/lib/components/DataSpreadsheet/DataSpreadsheetBody.js

@@ -0,0 +1,349 @@
+"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 _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");
+
+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 = function DataSpreadsheetBody(_ref) {
+  var 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;
+  // 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'))
+        };
+        setCurrentMatcher(null);
+        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 newArray = selectionAreaClone.filter(function (item) {
+          return item.matcher !== currentMatcher;
+        });
+        setCurrentMatcher(null);
+        setSelectionAreas(newArray);
+      }
+    };
+
+    document.addEventListener('mouseup', handleMouseUp);
+    return function () {
+      document.removeEventListener('mouseup', handleMouseUp);
+    };
+  }, [selectionAreas, currentMatcher, setSelectionAreas, setClickAndHoldActive, setCurrentMatcher]); // 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 (event, cell, columnIndex) {
+    var isHoldingCommandKey = event.metaKey || event.ctrlKey;
+    setContainerHasFocus(true);
+    var activeCoordinates = {
+      row: cell.row.index,
+      column: columnIndex
+    };
+    var tempMatcher = (0, _uuidv.default)();
+    setActiveCellCoordinates(activeCoordinates); // prevent multiple selections unless cmd key is held
+    // meaning that selectionAreas should only have one item by default
+
+    if (isHoldingCommandKey) {
+      setSelectionAreas(function (prev) {
+        return [].concat((0, _toConsumableArray2.default)(prev), [{
+          point1: activeCoordinates,
+          matcher: tempMatcher
+        }]);
+      });
+    } else {
+      // remove all previous cell selections
+      var cellSelections = spreadsheetBodyRef.current.querySelectorAll(".".concat(blockClass, "__selection-area--element"));
+      Array.from(cellSelections).forEach(function (element) {
+        return element.remove();
+      });
+      setSelectionAreas([{
+        point1: activeCoordinates,
+        matcher: tempMatcher
+      }]);
+    }
+
+    setCurrentMatcher(tempMatcher);
+    setClickAndHoldActive(true);
+  }, [setActiveCellCoordinates, setSelectionAreas, setContainerHasFocus, setClickAndHoldActive, setCurrentMatcher]);
+  var handleBodyCellHover = (0, _react.useCallback)(function (event, cell, columnIndex) {
+    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")),
+      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: function onMouseDown(event) {
+          return handleBodyCellClick(event, cell, index);
+        },
+        onMouseOver: function onMouseOver(event) {
+          return handleBodyCellHover(event, cell, index);
+        },
+        onFocus: function onFocus() {},
+        type: "button"
+      }), cell.render('Cell'));
+    }));
+  }, [prepareRow, rows, defaultColumn.rowHeaderWidth, handleBodyCellClick, handleBodyCellHover]);
+  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 = {
+  /**
+   * 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,80 @@
+"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 _react = _interopRequireDefault(require("react"));
+
+var _propTypes = _interopRequireDefault(require("prop-types"));
+
+var _classnames = _interopRequireDefault(require("classnames"));
+
+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 blockClass = "".concat(_settings.pkg.prefix, "--data-spreadsheet");
+
+var DataSpreadsheetHeader = function DataSpreadsheetHeader(_ref) {
+  var defaultColumn = _ref.defaultColumn,
+      headerGroups = _ref.headerGroups;
+  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")),
+      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")),
+        type: "button"
+      }), column.render('Header'));
+    }));
+  }));
+};
+
+exports.DataSpreadsheetHeader = DataSpreadsheetHeader;
+DataSpreadsheetHeader.propTypes = {
+  /**
+   * 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)
+};

package/lib/components/DataSpreadsheet/createActiveCellFn.js

@@ -0,0 +1,56 @@
+"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;
+
+  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.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;

package/lib/components/DataSpreadsheet/generateData.js

@@ -0,0 +1,58 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.generateData = void 0;
+
+var _defineProperty2 = _interopRequireDefault(require("@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) { (0, _defineProperty2.default)(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; }
+
+// 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() {
+  return {
+    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)
+  };
+};
+
+var generateData = function generateData() {
+  for (var _len = arguments.length, lens = new Array(_len), _key = 0; _key < _len; _key++) {
+    lens[_key] = arguments[_key];
+  }
+
+  var makeDataLevel = function makeDataLevel() {
+    var depth = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
+    var len = lens[depth];
+    return range(len).map(function () {
+      return _objectSpread(_objectSpread({}, newPet()), {}, {
+        subRows: lens[depth + 1] ? makeDataLevel(depth + 1) : undefined
+      });
+    });
+  };
+
+  return makeDataLevel();
+};
+
+exports.generateData = generateData;

package/lib/components/DataSpreadsheet/getCellSize.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getCellSize = void 0;
+
+var _layout = require("@carbon/layout");
+
+/**
+ * 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 getSizeInPixels = function getSizeInPixels(carbonSize) {
+  return Number(carbonSize.replace('rem', '') * _layout.baseFontSize);
+};
+
+var getCellSize = function getCellSize(cellSize) {
+  switch (cellSize) {
+    case 'compact':
+      return getSizeInPixels(_layout.sizeXSmall);
+
+    case 'standard':
+      return getSizeInPixels(_layout.sizeSmall);
+
+    case 'medium':
+      return getSizeInPixels(_layout.sizeMedium);
+
+    case 'large':
+      return getSizeInPixels(_layout.sizeLarge);
+
+    default:
+      return getSizeInPixels(_layout.sizeSmall);
+  }
+};
+
+exports.getCellSize = getCellSize;

package/lib/components/DataSpreadsheet/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DataSpreadsheet", {
+  enumerable: true,
+  get: function get() {
+    return _DataSpreadsheet.DataSpreadsheet;
+  }
+});
+
+var _DataSpreadsheet = require("./DataSpreadsheet");