@carbon/ibm-products 1.17.0 → 1.18.2

package/es/components/DataSpreadsheet/hooks/useSpreadsheetMouseMove.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 { useEffect } from 'react';
+import { px } from '@carbon/layout';
+import { pkg } from '../../../settings';
+import { getScrollbarWidth } from '../../../global/js/utils/getScrollbarWidth';
+import { moveColumnIndicatorLine } from '../utils/moveColumnIndicatorLine'; // Used specifically for reordering columns, will move the position of the
+// cloned selection area to follow the position of the cursor
+
+export var useSpreadsheetMouseMove = function useSpreadsheetMouseMove(_ref) {
+  var ref = _ref.ref,
+      _ref$blockClass = _ref.blockClass,
+      blockClass = _ref$blockClass === void 0 ? "".concat(pkg.prefix, "--data-spreadsheet") : _ref$blockClass,
+      headerCellHoldActive = _ref.headerCellHoldActive,
+      defaultColumn = _ref.defaultColumn;
+  useEffect(function () {
+    var handleMouseMove = function handleMouseMove(event) {
+      var clonedSelectionElement = ref.current.querySelector(".".concat(blockClass, "__selection-area--element-cloned"));
+
+      if (clonedSelectionElement) {
+        ref.current.addEventListener('mousemove', handleMouseMove);
+      }
+
+      var spreadsheetCoords = ref.current.getBoundingClientRect();
+      var listContainer = ref.current.querySelector(".".concat(blockClass, "__list--container"));
+      var scrollAmount = listContainer.scrollLeft;
+      moveColumnIndicatorLine({
+        clonedSelectionElement: clonedSelectionElement,
+        ref: ref,
+        spreadsheetCoords: spreadsheetCoords,
+        leftScrollAmount: scrollAmount
+      });
+      var scrollbarWidth = getScrollbarWidth();
+      var spreadsheetWrapperElement = ref.current;
+      spreadsheetWrapperElement.getBoundingClientRect();
+      var xPositionRelativeToSpreadsheet = event.clientX - spreadsheetCoords.left;
+      var offsetXValue = clonedSelectionElement === null || clonedSelectionElement === void 0 ? void 0 : clonedSelectionElement.getAttribute('data-clone-offset-x');
+      var totalSpreadsheetScrollingWidth = listContainer.scrollWidth;
+      var clonedSelectionWidth = clonedSelectionElement.offsetWidth;
+      var clonePlacement = Math.max(xPositionRelativeToSpreadsheet - offsetXValue, defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth); // Moves the position of the cloned selection area to follow mouse, and
+      // add the amount horizontally scrolled
+
+      clonedSelectionElement.style.left = px(totalSpreadsheetScrollingWidth - clonedSelectionWidth - scrollbarWidth >= clonePlacement ? clonePlacement + scrollAmount : totalSpreadsheetScrollingWidth - clonedSelectionWidth - scrollbarWidth);
+    };
+
+    if (headerCellHoldActive) {
+      ref.current.addEventListener('mousemove', handleMouseMove);
+    }
+
+    var spreadsheetRef = ref.current;
+
+    if (!headerCellHoldActive) {
+      spreadsheetRef === null || spreadsheetRef === void 0 ? void 0 : spreadsheetRef.removeEventListener('mousemove', handleMouseMove);
+    }
+
+    return function () {
+      spreadsheetRef === null || spreadsheetRef === void 0 ? void 0 : spreadsheetRef.removeEventListener('mousemove', handleMouseMove);
+    };
+  });
+};

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

@@ -0,0 +1,155 @@
+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;
+  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 = closestCell === null || closestCell === void 0 ? void 0 : closestCell.getAttribute('data-column-index');
+          var originalColumnIndex = selectionAreaCloneElement === null || selectionAreaCloneElement === void 0 ? void 0 : selectionAreaCloneElement.getAttribute('data-column-index-original');
+          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 newIndexPosition = columnToMoveToElement.getBoundingClientRect();
+          var listContainer = ref.current.querySelector(".".concat(blockClass, "__list--container"));
+          var leftScrollAmount = listContainer.scrollLeft;
+          var relativeNewPosition = newIndexPosition.left - spreadsheetPosition.left + leftScrollAmount;
+          var cloneColumnWidth = selectionAreaCloneElement.offsetWidth;
+          var columnsWidthUpToNewIndex = 0;
+          var newIndexLessThanStarting = newColumnIndex < originalColumnIndex;
+          visibleColumns.forEach(function (item, index) {
+            if (newIndexLessThanStarting && index === visibleColumns.length - 1) {
+              return;
+            }
+
+            if (index <= newColumnIndex) {
+              columnsWidthUpToNewIndex += (item === null || item === void 0 ? void 0 : item.width) || (defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.width);
+            }
+          });
+          var updatedSelectionAreaPlacement = newIndexLessThanStarting ? relativeNewPosition : columnsWidthUpToNewIndex - cloneColumnWidth + (defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.rowHeaderWidth);
+          selectionAreaToMove.style.left = px(updatedSelectionAreaPlacement);
+          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;
+            }
+
+            selectionAreaClone[indexOfItemToUpdate].header.index = Number(newColumnIndex);
+            selectionAreaClone[indexOfItemToUpdate].point1.column = Number(newColumnIndex);
+            selectionAreaClone[indexOfItemToUpdate].point2.column = Number(newColumnIndex);
+            return selectionAreaClone;
+          });
+          var columnIdArray = visibleColumns.map(function (column) {
+            return column.id;
+          });
+
+          var columnIdArrayClone = _toConsumableArray(columnIdArray); // Remove one element at the original index
+
+
+          columnIdArrayClone.splice(originalColumnIndex, 1); // Add one element at the new index
+
+          columnIdArrayClone.splice(newColumnIndex, 0, columnIdArray[originalColumnIndex]);
+          setColumnOrder(columnIdArrayClone); // Function provided by useTable (react-table) hook to reorder columns
+
+          var newCellCoords = _objectSpread(_objectSpread({}, activeCellCoordinates), {}, {
+            column: Number(newColumnIndex)
+          });
+
+          setActiveCellCoordinates(newCellCoords); // 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]);
+};

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

@@ -11,11 +11,11 @@ export var createCellSelectionArea = function createCellSelectionArea(_ref) {
   var ref = _ref.ref,
       area = _ref.area,
       blockClass = _ref.blockClass,
-      columns = _ref.columns,
       defaultColumn = _ref.defaultColumn,
       selectionAreas = _ref.selectionAreas,
       setSelectionAreas = _ref.setSelectionAreas,
-      setActiveCellInsideSelectionArea = _ref.setActiveCellInsideSelectionArea;
+      setActiveCellInsideSelectionArea = _ref.setActiveCellInsideSelectionArea,
+      visibleColumns = _ref.visibleColumns;
 
   var _getSelectionAreaPoin = getSelectionAreaPoints(area),
       lowestColumnIndex = _getSelectionAreaPoin.lowestColumnIndex,
@@ -30,7 +30,7 @@ export var createCellSelectionArea = function createCellSelectionArea(_ref) {
   }
 
   var selectionAreaVariableWidth = 0;
-  columns.forEach(function (item, index) {
+  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);
     }

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

@@ -4,7 +4,7 @@
  * 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 compact, sizeSmall as standard, sizeMedium as medium, sizeLarge as large } from '@carbon/layout';
+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);
@@ -12,19 +12,19 @@ var getSizeInPixels = function getSizeInPixels(carbonSize) {
 
 export var getCellSize = function getCellSize(cellSize) {
   switch (cellSize) {
-    case 'compact':
-      return getSizeInPixels(compact);
+    case 'xs':
+      return getSizeInPixels(xs);
 
-    case 'standard':
-      return getSizeInPixels(standard);
+    case 'sm':
+      return getSizeInPixels(sm);
 
-    case 'medium':
-      return getSizeInPixels(medium);
+    case 'md':
+      return getSizeInPixels(md);
 
-    case 'large':
-      return getSizeInPixels(large);
+    case 'lg':
+      return getSizeInPixels(lg);
 
     default:
-      return getSizeInPixels(standard);
+      return getSizeInPixels(sm);
   }
 };

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

@@ -11,7 +11,8 @@ export var getSpreadsheetWidth = function getSpreadsheetWidth(_ref) {
       scrollBarSizeValue = _ref.scrollBarSizeValue,
       totalVisibleColumns = _ref.totalVisibleColumns,
       defaultColumn = _ref.defaultColumn,
-      totalColumnsWidth = _ref.totalColumnsWidth;
+      totalColumnsWidth = _ref.totalColumnsWidth,
+      visibleColumns = _ref.visibleColumns;
   var additionalWidth = scrollBarSizeValue + defaultColumn.rowHeaderWidth;
 
   if (!totalVisibleColumns) {
@@ -25,6 +26,11 @@ export var getSpreadsheetWidth = function getSpreadsheetWidth(_ref) {
   }
 
   if (totalVisibleColumns) {
-    return totalVisibleColumns * (defaultColumn === null || defaultColumn === void 0 ? void 0 : defaultColumn.width) + additionalWidth;
+    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/handleHeaderCellSelection.js

@@ -55,7 +55,7 @@ export var handleHeaderCellSelection = function handleHeaderCellSelection(_ref)
     matcher: tempMatcher,
     header: {
       type: type,
-      index: index
+      index: type === 'column' ? columnValue : rowValue
     }
   };
   setSelectionAreas(function (prev) {

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

@@ -0,0 +1,35 @@
+/**
+ * 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 moveColumnIndicatorLine = function moveColumnIndicatorLine(_ref) {
+  var _ref$blockClass = _ref.blockClass,
+      blockClass = _ref$blockClass === void 0 ? "".concat(pkg.prefix, "--data-spreadsheet") : _ref$blockClass,
+      clonedSelectionElement = _ref.clonedSelectionElement,
+      ref = _ref.ref,
+      spreadsheetCoords = _ref.spreadsheetCoords,
+      leftScrollAmount = _ref.leftScrollAmount;
+  var closestCell = event.target.closest(".".concat(blockClass, "--interactive-cell-element"));
+  var newColumnIndex = closestCell === null || closestCell === void 0 ? void 0 : closestCell.getAttribute('data-column-index');
+  var originalColumnIndex = clonedSelectionElement === null || clonedSelectionElement === void 0 ? void 0 : clonedSelectionElement.getAttribute('data-column-index-original');
+  var closestCellCoords = closestCell.getBoundingClientRect();
+  var indicatorLineElement = ref.current.querySelector(".".concat(blockClass, "__reorder-indicator-line"));
+  var matcherId = clonedSelectionElement === null || clonedSelectionElement === void 0 ? void 0 : clonedSelectionElement.getAttribute('data-matcher-id');
+  var selectionAreaOrigin = ref.current.querySelector("[data-matcher-id=\"".concat(matcherId, "\"]"));
+
+  if (Number(newColumnIndex) > Number(originalColumnIndex)) {
+    indicatorLineElement.style.left = px(closestCellCoords.left - spreadsheetCoords.left + closestCell.offsetWidth - 2 + leftScrollAmount);
+  }
+
+  if (Number(newColumnIndex) < Number(originalColumnIndex)) {
+    indicatorLineElement.style.left = px(closestCellCoords.left - spreadsheetCoords.left + leftScrollAmount);
+  }
+
+  if (Number(newColumnIndex) === Number(originalColumnIndex)) {
+    indicatorLineElement.style.left = selectionAreaOrigin.style.left;
+  }
+};

package/es/components/Datagrid/Datagrid/Datagrid.js

@@ -60,7 +60,7 @@ export var Datagrid = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   return /*#__PURE__*/React.createElement("div", _extends({}, rest, {
     id: tableId,
     ref: ref,
-    className: cx(className, blockClass, withVirtualScroll ? "".concat(blockClass, "__datagridWrap") : "".concat(blockClass, "__datagridWrap-simple"))
+    className: cx(className, blockClass, withVirtualScroll ? "".concat(blockClass, "__datagridWrap") : "".concat(blockClass, "__datagridWrap-simple"), !isFetching && rows.length === 0 ? "".concat(blockClass, "__empty-state") : '')
   }, getDevtoolsProps(componentName)), /*#__PURE__*/React.createElement(DatagridToolbar, datagridState), leftPanel && /*#__PURE__*/React.createElement("div", {
     className: "".concat(blockClass, "__grid-container ").concat(blockClass, "__displayFlex")
   }, leftPanel && leftPanel.isOpen && /*#__PURE__*/React.createElement("div", {

package/es/components/Datagrid/Datagrid/DatagridEmptyBody.js

@@ -1,3 +1,5 @@
+import _extends from "@babel/runtime/helpers/extends";
+
 /*
  * Licensed Materials - Property of IBM
  * 5724-Q36
@@ -7,13 +9,30 @@
  */
 import React from 'react';
 import { pkg } from '../../../settings';
+import { DataTable } from 'carbon-components-react';
+import { NoDataEmptyState } from '../../EmptyStates/NoDataEmptyState';
 var blockClass = "".concat(pkg.prefix, "--datagrid");
+var TableBody = DataTable.TableBody,
+    TableRow = DataTable.TableRow,
+    TableCell = DataTable.TableCell;
 
 var DatagridEmptyBody = function DatagridEmptyBody(datagridState) {
-  var EmptyState = datagridState.EmptyState;
-  return /*#__PURE__*/React.createElement("div", {
+  var getTableBodyProps = datagridState.getTableBodyProps,
+      headers = datagridState.headers,
+      emptyStateTitle = datagridState.emptyStateTitle,
+      emptyStateDescription = datagridState.emptyStateDescription,
+      emptyStateSize = datagridState.emptyStateSize,
+      illustrationTheme = datagridState.illustrationTheme;
+  return /*#__PURE__*/React.createElement(TableBody, _extends({}, getTableBodyProps(), {
     className: "".concat(blockClass, "__empty-state-body")
-  }, EmptyState);
+  }), /*#__PURE__*/React.createElement(TableRow, null, /*#__PURE__*/React.createElement(TableCell, {
+    colSpan: headers.length
+  }, /*#__PURE__*/React.createElement(NoDataEmptyState, {
+    illustrationTheme: illustrationTheme,
+    size: emptyStateSize,
+    title: emptyStateTitle,
+    subtitle: emptyStateDescription
+  }))));
 };
 
 export default DatagridEmptyBody;

package/es/components/Datagrid/Datagrid/addons/RowSize/RowSizeDropdown.js

@@ -54,9 +54,9 @@ var RowSizeDropdown = function RowSizeDropdown(_ref) {
 
 RowSizeDropdown.propTypes = {
   buttonLabel: PropTypes.string,
-  datagridName: PropTypes.string.isRequired,
-  light: PropTypes.bool.isRequired,
+  datagridName: PropTypes.string,
+  light: PropTypes.bool,
   onChange: PropTypes.func.isRequired,
-  selectedOption: PropTypes.string.isRequired
+  selectedOption: PropTypes.string
 };
 export default RowSizeDropdown;

package/es/components/Datagrid/Datagrid/addons/RowSize/RowSizeRadioGroup.js

@@ -128,7 +128,7 @@ RowSizeRadioGroup.defaultProps = {
 };
 RowSizeRadioGroup.propTypes = {
   buttonRef: PropTypes.any.isRequired,
-  datagridName: PropTypes.string.isRequired,
+  datagridName: PropTypes.string,
   hideRadioGroup: PropTypes.func.isRequired,
   legendText: PropTypes.string,
   onChange: PropTypes.func.isRequired,

package/es/components/ExportModal/ExportModal.js

@@ -79,7 +79,7 @@ export var ExportModal = /*#__PURE__*/forwardRef(function (_ref, ref) {
 
     setName(filename);
     setExtension(preformattedExtensions === null || preformattedExtensions === void 0 ? void 0 : (_preformattedExtensio = preformattedExtensions[0]) === null || _preformattedExtensio === void 0 ? void 0 : _preformattedExtensio.extension);
-  }, [filename, preformattedExtensions]);
+  }, [filename, preformattedExtensions, open]);
 
   var onNameChangeHandler = function onNameChangeHandler(evt) {
     setName(evt.target.value);

package/lib/components/AddSelect/AddSelect.js

@@ -43,7 +43,11 @@ var _addSelectUtils = require("./add-select-utils");
 
 var _AddSelectFilter = require("./AddSelectFilter");
 
-var _excluded = ["className", "clearFiltersText", "columnInputPlaceholder", "description", "globalFilters", "globalFiltersIconDescription", "globalFiltersPlaceholderText", "globalFiltersPrimaryButtonText", "globalFiltersSecondaryButtonText", "globalSearchLabel", "globalSearchPlaceholder", "influencerTitle", "items", "itemsLabel", "multi", "noResultsDescription", "noResultsTitle", "noSelectionDescription", "noSelectionTitle", "onClose", "onCloseButtonText", "onSubmit", "onSubmitButtonText", "open", "portalTarget", "removeIconDescription", "searchResultsLabel", "title"];
+var _AddSelectSort = require("./AddSelectSort");
+
+var _useItemSort2 = require("./hooks/useItemSort");
+
+var _excluded = ["className", "clearFiltersText", "closeIconDescription", "columnInputPlaceholder", "description", "globalFilters", "globalFiltersIconDescription", "globalFiltersPlaceholderText", "globalFiltersPrimaryButtonText", "globalFiltersSecondaryButtonText", "globalSearchLabel", "globalSearchPlaceholder", "globalSortBy", "influencerTitle", "items", "itemsLabel", "metaIconDescription", "metaPanelTitle", "multi", "navIconDescription", "noResultsDescription", "noResultsTitle", "noSelectionDescription", "noSelectionTitle", "onClose", "onCloseButtonText", "onSubmit", "onSubmitButtonText", "open", "portalTarget", "removeIconDescription", "searchResultsLabel", "title"];
 
 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); }
 
@@ -55,6 +59,7 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
 
   var className = _ref.className,
       clearFiltersText = _ref.clearFiltersText,
+      closeIconDescription = _ref.closeIconDescription,
       columnInputPlaceholder = _ref.columnInputPlaceholder,
       description = _ref.description,
       globalFilters = _ref.globalFilters,
@@ -64,10 +69,14 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
       globalFiltersSecondaryButtonText = _ref.globalFiltersSecondaryButtonText,
       globalSearchLabel = _ref.globalSearchLabel,
       globalSearchPlaceholder = _ref.globalSearchPlaceholder,
+      globalSortBy = _ref.globalSortBy,
       influencerTitle = _ref.influencerTitle,
       items = _ref.items,
       itemsLabel = _ref.itemsLabel,
+      metaIconDescription = _ref.metaIconDescription,
+      metaPanelTitle = _ref.metaPanelTitle,
       multi = _ref.multi,
+      navIconDescription = _ref.navIconDescription,
       noResultsDescription = _ref.noResultsDescription,
       noResultsTitle = _ref.noResultsTitle,
       noSelectionDescription = _ref.noSelectionDescription,
@@ -129,6 +138,17 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
       appliedGlobalFilters = _useState18[0],
       setAppliedGlobalFilters = _useState18[1];
 
+  var _useState19 = (0, _react.useState)({}),
+      _useState20 = (0, _slicedToArray2.default)(_useState19, 2),
+      displayMetalPanel = _useState20[0],
+      setDisplayMetaPanel = _useState20[1];
+
+  var _useItemSort = (0, _useItemSort2.useItemSort)(),
+      sortDirection = _useItemSort.sortDirection,
+      setSortDirection = _useItemSort.setSortDirection,
+      sortAttribute = _useItemSort.sortAttribute,
+      setSortAttribute = _useItemSort.setSortAttribute;
+
   (0, _react.useEffect)(function () {
     var entries = items.entries; // flatItems is just a single array of all entries including children
 
@@ -218,6 +238,8 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     return results;
   };
 
+  var sortFn = (0, _addSelectUtils.sortItems)(sortAttribute, sortDirection);
+
   var getDisplayItems = function getDisplayItems() {
     if (useNormalizedItems) {
       // when global search or filter is in use the results are not in column format
@@ -230,7 +252,7 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
           return filters.every(function (filter) {
             return item[filter] === appliedGlobalFilters[filter];
           });
-        });
+        }).sort(sortFn);
         return results;
       }
 
@@ -243,13 +265,16 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
 
   var itemsToDisplay = getDisplayItems();
   var commonListProps = {
+    metaIconDescription: metaIconDescription,
     multi: multi,
     multiSelection: multiSelection,
+    navIconDescription: navIconDescription,
     path: path,
     setMultiSelection: setMultiSelection,
     setPath: setPath,
     setSingleSelection: setSingleSelection,
-    singleSelection: singleSelection
+    singleSelection: singleSelection,
+    setDisplayMetaPanel: setDisplayMetaPanel
   }; // handlers
 
   var handleSearch = function handleSearch(term) {
@@ -284,13 +309,17 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     portalTarget: portalTarget
   };
   var sidebarProps = {
+    closeIconDescription: closeIconDescription,
     influencerTitle: influencerTitle,
     items: flatItems,
+    metaPanelTitle: metaPanelTitle,
     multiSelection: multiSelection,
     noSelectionDescription: noSelectionDescription,
     noSelectionTitle: noSelectionTitle,
     removeIconDescription: removeIconDescription,
-    setMultiSelection: setMultiSelection
+    setMultiSelection: setMultiSelection,
+    displayMetalPanel: displayMetalPanel,
+    setDisplayMetaPanel: setDisplayMetaPanel
   };
 
   var setShowBreadsCrumbs = function setShowBreadsCrumbs() {
@@ -317,9 +346,11 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     return true;
   };
 
+  var hasResults = itemsToDisplay.length > 0;
+  var globalFiltersApplied = Object.keys(appliedGlobalFilters).length > 0;
   var showBreadsCrumbs = setShowBreadsCrumbs();
-  var showTags = setShowTags();
-  var globalFiltersApplied = Object.keys(appliedGlobalFilters).length > 0; // main content
+  var showSort = (searchTerm || globalFiltersApplied) && hasResults;
+  var showTags = setShowTags(); // main content
 
   var body = /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement("div", {
     className: "".concat(blockClass, "__header")
@@ -339,6 +370,8 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     hasFiltersApplied: globalFiltersApplied,
     clearFiltersText: clearFiltersText
   }), /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(blockClass, "__sub-header")
+  }, /*#__PURE__*/_react.default.createElement("div", {
     className: "".concat(blockClass, "__tag-container")
   }, showBreadsCrumbs ? /*#__PURE__*/_react.default.createElement(_AddSelectBreadcrumbs.AddSelectBreadcrumbs, {
     itemsLabel: itemsLabel,
@@ -349,7 +382,14 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
   }, searchTerm ? searchResultsLabel : itemsLabel), showTags && /*#__PURE__*/_react.default.createElement(_carbonComponentsReact.Tag, {
     type: "gray",
     size: "sm"
-  }, itemsToDisplay.length))), useNormalizedItems && !searchTerm && !globalFiltersApplied ? /*#__PURE__*/_react.default.createElement("div", {
+  }, itemsToDisplay.length)), showSort && /*#__PURE__*/_react.default.createElement(_AddSelectSort.AddSelectSort, {
+    items: itemsToDisplay,
+    setSortAttribute: setSortAttribute,
+    setSortDirection: setSortDirection,
+    sortAttribute: sortAttribute,
+    sortDirection: sortDirection,
+    sortBy: globalSortBy
+  }))), useNormalizedItems && !searchTerm && !globalFiltersApplied ? /*#__PURE__*/_react.default.createElement("div", {
     className: "".concat(blockClass, "__columns")
   }, itemsToDisplay.map(function (page, idx) {
     var _path;
@@ -360,7 +400,7 @@ var AddSelect = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
       header: idx === 0 ? itemsLabel : (_path = path[idx - 1]) === null || _path === void 0 ? void 0 : _path.title,
       columnInputPlaceholder: columnInputPlaceholder
     }));
-  })) : /*#__PURE__*/_react.default.createElement("div", null, itemsToDisplay.length > 0 ? /*#__PURE__*/_react.default.createElement(_AddSelectList.AddSelectList, (0, _extends2.default)({}, commonListProps, {
+  })) : /*#__PURE__*/_react.default.createElement("div", null, hasResults ? /*#__PURE__*/_react.default.createElement(_AddSelectList.AddSelectList, (0, _extends2.default)({}, commonListProps, {
     filteredItems: itemsToDisplay,
     modifiers: items === null || items === void 0 ? void 0 : items.modifiers
   })) : /*#__PURE__*/_react.default.createElement("div", {
@@ -381,6 +421,7 @@ exports.AddSelect = AddSelect;
 AddSelect.propTypes = {
   className: _propTypes.default.string,
   clearFiltersText: _propTypes.default.string,
+  closeIconDescription: _propTypes.default.string,
   columnInputPlaceholder: _propTypes.default.string,
   description: _propTypes.default.string,
   globalFilters: _propTypes.default.arrayOf(_propTypes.default.shape({
@@ -393,6 +434,7 @@ AddSelect.propTypes = {
   globalFiltersSecondaryButtonText: _propTypes.default.string,
   globalSearchLabel: _propTypes.default.string,
   globalSearchPlaceholder: _propTypes.default.string,
+  globalSortBy: _propTypes.default.array,
   influencerTitle: _propTypes.default.string,
   items: _propTypes.default.shape({
     modifiers: _propTypes.default.shape({
@@ -410,13 +452,21 @@ AddSelect.propTypes = {
       children: _propTypes.default.object,
       icon: _propTypes.default.object,
       id: _propTypes.default.string.isRequired,
+      meta: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.shape({
+        id: _propTypes.default.string,
+        title: _propTypes.default.string,
+        value: _propTypes.default.string
+      })), _propTypes.default.node]),
       subtitle: _propTypes.default.string,
       title: _propTypes.default.string.isRequired,
       value: _propTypes.default.string.isRequired
     }))
   }),
   itemsLabel: _propTypes.default.string,
+  metaIconDescription: _propTypes.default.string,
+  metaPanelTitle: _propTypes.default.string,
   multi: _propTypes.default.bool,
+  navIconDescription: _propTypes.default.string,
   noResultsDescription: _propTypes.default.string,
   noResultsTitle: _propTypes.default.string,
   noSelectionDescription: _propTypes.default.string,