@elastic/eui 93.2.0 → 93.4.0

package/es/components/datagrid/body/cell/data_grid_cell_popover.js

@@ -19,7 +19,7 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  * Side Public License, v 1.
  */
 
-import React, { createContext, useState, useCallback } from 'react';
+import React, { createContext, useState, useCallback, useMemo } from 'react';
 import classNames from 'classnames';
 import { keys } from '../../../../services';
 import { EuiWrappingPopover } from '../../../popover';
@@ -37,7 +37,6 @@ export var DataGridCellPopoverContext = /*#__PURE__*/createContext({
   setCellPopoverProps: function setCellPopoverProps() {}
 });
 export var useCellPopover = function useCellPopover() {
-  var _cellPopoverProps$pan;
   // Current open state & cell location are handled here
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
@@ -88,16 +87,6 @@ export var useCellPopover = function useCellPopover() {
     });
     setPopoverIsOpen(true);
   }, [popoverIsOpen, cellLocation]);
-  var cellPopoverContext = {
-    popoverIsOpen: popoverIsOpen,
-    closeCellPopover: closeCellPopover,
-    openCellPopover: openCellPopover,
-    cellLocation: cellLocation,
-    setPopoverAnchor: setPopoverAnchor,
-    setPopoverAnchorPosition: setPopoverAnchorPosition,
-    setPopoverContent: setPopoverContent,
-    setCellPopoverProps: setCellPopoverProps
-  };
 
   // Override the default EuiPopover `onClickOutside` behavior, since the toggling
   // popover button isn't actually the DOM node we pass to `button`. Otherwise,
@@ -109,52 +98,71 @@ export var useCellPopover = function useCellPopover() {
       closeCellPopover();
     }
   }, [popoverAnchor, closeCellPopover]);
+  var onKeyDown = useCallback(function (event) {
+    if (event.key === keys.F2 || event.key === keys.ESCAPE) {
+      var _popoverAnchor$parent3, _popoverAnchor$parent4;
+      event.preventDefault();
+      event.stopPropagation();
+      closeCellPopover();
+      var cell = popoverAnchor === null || popoverAnchor === void 0 ? void 0 : (_popoverAnchor$parent3 = popoverAnchor.parentElement) === null || _popoverAnchor$parent3 === void 0 ? void 0 : (_popoverAnchor$parent4 = _popoverAnchor$parent3.parentElement) === null || _popoverAnchor$parent4 === void 0 ? void 0 : _popoverAnchor$parent4.parentElement;
 
-  // Note that this popover is rendered once at the top grid level, rather than one popover per cell
-  var cellPopover = popoverIsOpen && popoverAnchor && ___EmotionJSX(EuiWrappingPopover, _extends({
-    isOpen: popoverIsOpen,
-    display: "block",
-    hasArrow: false,
-    panelPaddingSize: "s",
-    anchorPosition: popoverAnchorPosition,
-    repositionToCrossAxis: false
-  }, cellPopoverProps, {
-    focusTrapProps: {
-      onClickOutside: onClickOutside,
-      clickOutsideDisables: false
-    },
-    panelProps: _objectSpread({
-      'data-test-subj': 'euiDataGridExpansionPopover'
-    }, cellPopoverProps.panelProps || {}),
-    panelClassName: classNames('euiDataGridRowCell__popover', cellPopoverProps.panelClassName, (_cellPopoverProps$pan = cellPopoverProps.panelProps) === null || _cellPopoverProps$pan === void 0 ? void 0 : _cellPopoverProps$pan.className),
-    panelStyle: {
-      maxInlineSize: "min(75vw, max(".concat(popoverAnchor.parentElement.offsetWidth, "px, 400px))"),
-      maxBlockSize: '50vh'
-    },
-    onKeyDown: function onKeyDown(event) {
-      if (event.key === keys.F2 || event.key === keys.ESCAPE) {
-        var _popoverAnchor$parent3, _popoverAnchor$parent4;
-        event.preventDefault();
-        event.stopPropagation();
-        closeCellPopover();
-        var cell = (_popoverAnchor$parent3 = popoverAnchor.parentElement) === null || _popoverAnchor$parent3 === void 0 ? void 0 : (_popoverAnchor$parent4 = _popoverAnchor$parent3.parentElement) === null || _popoverAnchor$parent4 === void 0 ? void 0 : _popoverAnchor$parent4.parentElement;
+      // Prevent cell animation flash while focus is being shifted between popover and cell
+      cell === null || cell === void 0 ? void 0 : cell.setAttribute('data-keyboard-closing', 'true');
+      // Ensure focus is returned to the parent cell, and remove animation stopgap
+      requestAnimationFrame(function () {
+        popoverAnchor === null || popoverAnchor === void 0 ? void 0 : popoverAnchor.parentElement.focus();
+        cell === null || cell === void 0 ? void 0 : cell.removeAttribute('data-keyboard-closing');
+      });
+    }
+  }, [popoverAnchor, closeCellPopover]);
+  var cellPopoverContext = useMemo(function () {
+    return {
+      popoverIsOpen: popoverIsOpen,
+      closeCellPopover: closeCellPopover,
+      openCellPopover: openCellPopover,
+      cellLocation: cellLocation,
+      setPopoverAnchorPosition: setPopoverAnchorPosition,
+      setPopoverAnchor: setPopoverAnchor,
+      setPopoverContent: setPopoverContent,
+      setCellPopoverProps: setCellPopoverProps
+    };
+  }, [popoverIsOpen, closeCellPopover, openCellPopover, cellLocation]);
+  var cellPopover = useMemo(function () {
+    var _cellPopoverProps$pan;
+    if (!popoverIsOpen || !popoverAnchor) return null;
 
-        // Prevent cell animation flash while focus is being shifted between popover and cell
-        cell === null || cell === void 0 ? void 0 : cell.setAttribute('data-keyboard-closing', 'true');
-        // Ensure focus is returned to the parent cell, and remove animation stopgap
-        requestAnimationFrame(function () {
-          popoverAnchor.parentElement.focus();
-          cell === null || cell === void 0 ? void 0 : cell.removeAttribute('data-keyboard-closing');
-        });
-      }
-    },
-    button: popoverAnchor,
-    closePopover: closeCellPopover
-  }), popoverContent);
-  return {
-    cellPopoverContext: cellPopoverContext,
-    cellPopover: cellPopover
-  };
+    // Note that this popover is rendered once at the top grid level, rather than one popover per cell
+    return ___EmotionJSX(EuiWrappingPopover, _extends({
+      isOpen: popoverIsOpen,
+      display: "block",
+      hasArrow: false,
+      panelPaddingSize: "s",
+      anchorPosition: popoverAnchorPosition,
+      repositionToCrossAxis: false
+    }, cellPopoverProps, {
+      focusTrapProps: {
+        onClickOutside: onClickOutside,
+        clickOutsideDisables: false
+      },
+      panelProps: _objectSpread({
+        'data-test-subj': 'euiDataGridExpansionPopover'
+      }, cellPopoverProps.panelProps || {}),
+      panelClassName: classNames('euiDataGridRowCell__popover', cellPopoverProps.panelClassName, (_cellPopoverProps$pan = cellPopoverProps.panelProps) === null || _cellPopoverProps$pan === void 0 ? void 0 : _cellPopoverProps$pan.className),
+      panelStyle: {
+        maxInlineSize: "min(75vw, max(".concat(popoverAnchor.parentElement.offsetWidth, "px, 400px))"),
+        maxBlockSize: '50vh'
+      },
+      onKeyDown: onKeyDown,
+      button: popoverAnchor,
+      closePopover: closeCellPopover
+    }), popoverContent);
+  }, [popoverIsOpen, popoverAnchor, popoverContent, cellPopoverProps, closeCellPopover, onClickOutside, onKeyDown, popoverAnchorPosition]);
+  return useMemo(function () {
+    return {
+      cellPopoverContext: cellPopoverContext,
+      cellPopover: cellPopover
+    };
+  }, [cellPopoverContext, cellPopover]);
 };
 
 /**

package/es/components/datagrid/body/cell/data_grid_cell_wrapper.js

@@ -1,5 +1,5 @@
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-var _excluded = ["colIndex", "visibleRowIndex", "style", "schema", "schemaDetectors", "pagination", "columns", "leadingControlColumns", "trailingControlColumns", "visibleColCount", "columnWidths", "defaultColumnWidth", "renderCellValue", "renderCellPopover", "interactiveCellId", "setRowHeight", "rowHeightsOptions", "rowHeightUtils", "rowManager"];
+var _excluded = ["colIndex", "visibleRowIndex", "style", "schema", "schemaDetectors", "pagination", "columns", "leadingControlColumns", "trailingControlColumns", "visibleColCount", "columnWidths", "defaultColumnWidth", "renderCellValue", "cellContext", "renderCellPopover", "interactiveCellId", "setRowHeight", "rowHeightsOptions", "rowHeightUtils", "rowManager"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
@@ -14,9 +14,9 @@ function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) r
  * Side Public License, v 1.
  */
 
-import React, { useContext, useMemo } from 'react';
+import React, { useContext, useMemo, memo } from 'react';
 import classNames from 'classnames';
-import { DataGridSortingContext } from '../../utils/sorting';
+import { DataGridSortedContext } from '../../utils/sorting';
 import { DataGridCellPopoverContext } from './data_grid_cell_popover';
 import { EuiDataGridCell } from './data_grid_cell';
 import { jsx as ___EmotionJSX } from "@emotion/react";
@@ -25,7 +25,7 @@ import { jsx as ___EmotionJSX } from "@emotion/react";
  * It grabs context,  determines the type of cell being rendered
  * (e.g. control vs data cell), & sets shared props between all cells
  */
-export var Cell = function Cell(_ref) {
+export var CellWrapper = /*#__PURE__*/memo(function (_ref) {
   var colIndex = _ref.colIndex,
     visibleRowIndex = _ref.visibleRowIndex,
     style = _ref.style,
@@ -39,6 +39,7 @@ export var Cell = function Cell(_ref) {
     columnWidths = _ref.columnWidths,
     defaultColumnWidth = _ref.defaultColumnWidth,
     renderCellValue = _ref.renderCellValue,
+    cellContext = _ref.cellContext,
     renderCellPopover = _ref.renderCellPopover,
     interactiveCellId = _ref.interactiveCellId,
     setRowHeight = _ref.setRowHeight,
@@ -47,9 +48,8 @@ export var Cell = function Cell(_ref) {
     rowManager = _ref.rowManager,
     rest = _objectWithoutProperties(_ref, _excluded);
   var popoverContext = useContext(DataGridCellPopoverContext);
-  var _useContext = useContext(DataGridSortingContext),
+  var _useContext = useContext(DataGridSortedContext),
     getCorrectRowIndex = _useContext.getCorrectRowIndex;
-  var cellContent;
   var isFirstColumn = colIndex === 0;
   var isLastColumn = colIndex === visibleColCount - 1;
   var isLeadingControlColumn = colIndex < leadingControlColumns.length;
@@ -63,30 +63,33 @@ export var Cell = function Cell(_ref) {
       return column !== null && column !== void 0 && column.schema ? (column === null || column === void 0 ? void 0 : column.schema) === row.type : columnId === row.type;
     })[0]) === null || _schemaDetectors$filt === void 0 ? void 0 : _schemaDetectors$filt.textTransform;
   }, [columnId, column === null || column === void 0 ? void 0 : column.schema, schemaDetectors]);
-  var classes = classNames(_defineProperty({
-    'euiDataGridRowCell--firstColumn': isFirstColumn,
-    'euiDataGridRowCell--lastColumn': isLastColumn,
-    'euiDataGridRowCell--controlColumn': isLeadingControlColumn || isTrailingControlColumn
-  }, "euiDataGridRowCell--".concat(textTransform), textTransform));
-  var sharedCellProps = {
-    rowIndex: getCorrectRowIndex(visibleRowIndex),
-    visibleRowIndex: visibleRowIndex,
-    colIndex: colIndex,
-    interactiveCellId: interactiveCellId,
-    className: classes,
-    style: style,
-    rowHeightsOptions: rowHeightsOptions,
-    rowHeightUtils: rowHeightUtils,
-    setRowHeight: isFirstColumn ? setRowHeight : undefined,
-    rowManager: rowManager,
-    popoverContext: popoverContext,
-    pagination: pagination
-  };
+  var sharedCellProps = useMemo(function () {
+    var classes = classNames(_defineProperty({
+      'euiDataGridRowCell--firstColumn': isFirstColumn,
+      'euiDataGridRowCell--lastColumn': isLastColumn,
+      'euiDataGridRowCell--controlColumn': isLeadingControlColumn || isTrailingControlColumn
+    }, "euiDataGridRowCell--".concat(textTransform), textTransform));
+    return {
+      rowIndex: getCorrectRowIndex(visibleRowIndex),
+      visibleRowIndex: visibleRowIndex,
+      colIndex: colIndex,
+      interactiveCellId: interactiveCellId,
+      className: classes,
+      style: style,
+      rowHeightsOptions: rowHeightsOptions,
+      rowHeightUtils: rowHeightUtils,
+      setRowHeight: isFirstColumn ? setRowHeight : undefined,
+      rowManager: rowManager,
+      popoverContext: popoverContext,
+      pagination: pagination,
+      cellContext: cellContext
+    };
+  }, [colIndex, setRowHeight, visibleRowIndex, getCorrectRowIndex, interactiveCellId, style, rowHeightsOptions, rowHeightUtils, rowManager, popoverContext, pagination, cellContext, isFirstColumn, isLastColumn, isLeadingControlColumn, isTrailingControlColumn, textTransform]);
   if (isLeadingControlColumn) {
     var leadingColumn = leadingControlColumns[colIndex];
     var id = leadingColumn.id,
       rowCellRender = leadingColumn.rowCellRender;
-    cellContent = ___EmotionJSX(EuiDataGridCell, _extends({}, sharedCellProps, {
+    return ___EmotionJSX(EuiDataGridCell, _extends({}, sharedCellProps, {
       columnId: id,
       width: leadingColumn.width,
       renderCellValue: rowCellRender,
@@ -98,7 +101,7 @@ export var Cell = function Cell(_ref) {
     var trailingColumn = trailingControlColumns[trailingcolIndex];
     var _id = trailingColumn.id,
       _rowCellRender = trailingColumn.rowCellRender;
-    cellContent = ___EmotionJSX(EuiDataGridCell, _extends({}, sharedCellProps, {
+    return ___EmotionJSX(EuiDataGridCell, _extends({}, sharedCellProps, {
       columnId: _id,
       width: trailingColumn.width,
       renderCellValue: _rowCellRender,
@@ -107,9 +110,9 @@ export var Cell = function Cell(_ref) {
   } else {
     // this is a normal data cell
     var columnType = schema[columnId] ? schema[columnId].columnType : null;
-    var isExpandable = column.isExpandable !== undefined ? column.isExpandable : true;
+    var isExpandable = (column === null || column === void 0 ? void 0 : column.isExpandable) !== undefined ? column === null || column === void 0 ? void 0 : column.isExpandable : true;
     var width = columnWidths[columnId] || defaultColumnWidth;
-    cellContent = ___EmotionJSX(EuiDataGridCell, _extends({}, sharedCellProps, {
+    return ___EmotionJSX(EuiDataGridCell, _extends({}, sharedCellProps, {
       columnId: columnId,
       column: column,
       columnType: columnType,
@@ -120,5 +123,5 @@ export var Cell = function Cell(_ref) {
       isExpandable: isExpandable
     }, rest));
   }
-  return cellContent;
-};
+});
+CellWrapper.displayName = 'CellWrapper';

package/es/components/datagrid/body/cell/index.js

@@ -7,5 +7,5 @@
  */
 
 export { EuiDataGridCell } from './data_grid_cell';
-export { Cell } from './data_grid_cell_wrapper';
+export { CellWrapper } from './data_grid_cell_wrapper';
 export { DataGridCellPopoverContext, useCellPopover } from './data_grid_cell_popover';

package/es/components/datagrid/body/data_grid_body.js

@@ -562,10 +562,24 @@ EuiDataGridBody.propTypes = {
     visibleRowCount: PropTypes.number.isRequired
   }).isRequired,
   renderCellValue: PropTypes.oneOfType([PropTypes.func.isRequired, PropTypes.element.isRequired]).isRequired,
+  cellContext: PropTypes.any,
   renderCellPopover: PropTypes.oneOfType([PropTypes.func.isRequired, PropTypes.func.isRequired]),
   renderFooterCellValue: PropTypes.oneOfType([PropTypes.func.isRequired, PropTypes.element.isRequired]),
   renderCustomGridBody: PropTypes.func,
   interactiveCellId: PropTypes.string.isRequired,
+  sorting: PropTypes.shape({
+    /**
+       * A function that receives updated column sort details in response to user interactions in the toolbar controls
+       */
+    onSort: PropTypes.func.isRequired,
+    /**
+       * An array of the column ids currently being sorted and their sort direction. The array order determines the sort order. `{ id: 'A'; direction: 'asc' }`
+       */
+    columns: PropTypes.arrayOf(PropTypes.shape({
+      id: PropTypes.string.isRequired,
+      direction: PropTypes.oneOf(["asc", "desc"]).isRequired
+    }).isRequired).isRequired
+  }),
   pagination: PropTypes.any,
   setVisibleColumns: PropTypes.func.isRequired,
   switchColumnPos: PropTypes.func.isRequired,

package/es/components/datagrid/body/data_grid_body_custom.js

@@ -33,28 +33,30 @@ import { useDefaultColumnWidth, useColumnWidths } from '../utils/col_widths';
 import { useRowHeightUtils, useDefaultRowHeight } from '../utils/row_heights';
 import { useDataGridHeader } from './header';
 import { useDataGridFooter } from './footer';
-import { Cell } from './cell';
+import { CellWrapper } from './cell';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var EuiDataGridBodyCustomRender = function EuiDataGridBodyCustomRender(_ref) {
   var renderCustomGridBody = _ref.renderCustomGridBody,
-    leadingControlColumns = _ref.leadingControlColumns,
-    trailingControlColumns = _ref.trailingControlColumns,
-    columns = _ref.columns,
-    visibleColCount = _ref.visibleColCount,
-    schema = _ref.schema,
-    schemaDetectors = _ref.schemaDetectors,
-    visibleRows = _ref.visibleRows,
     renderCellValue = _ref.renderCellValue,
+    cellContext = _ref.cellContext,
     renderCellPopover = _ref.renderCellPopover,
     renderFooterCellValue = _ref.renderFooterCellValue,
     interactiveCellId = _ref.interactiveCellId,
+    visibleRows = _ref.visibleRows,
+    visibleColCount = _ref.visibleColCount,
+    leadingControlColumns = _ref.leadingControlColumns,
+    trailingControlColumns = _ref.trailingControlColumns,
+    columns = _ref.columns,
     setVisibleColumns = _ref.setVisibleColumns,
     switchColumnPos = _ref.switchColumnPos,
     onColumnResize = _ref.onColumnResize,
-    gridWidth = _ref.gridWidth,
-    gridStyles = _ref.gridStyles,
+    schema = _ref.schema,
+    schemaDetectors = _ref.schemaDetectors,
+    sorting = _ref.sorting,
     pagination = _ref.pagination,
-    rowHeightsOptions = _ref.rowHeightsOptions;
+    rowHeightsOptions = _ref.rowHeightsOptions,
+    gridWidth = _ref.gridWidth,
+    gridStyles = _ref.gridStyles;
   /**
    * Columns & widths
    */
@@ -93,14 +95,15 @@ export var EuiDataGridBodyCustomRender = function EuiDataGridBodyCustomRender(_r
    * Header & footer
    */
   var _useDataGridHeader = useDataGridHeader({
-      switchColumnPos: switchColumnPos,
-      setVisibleColumns: setVisibleColumns,
       leadingControlColumns: leadingControlColumns,
       trailingControlColumns: trailingControlColumns,
       columns: columns,
       columnWidths: columnWidths,
       defaultColumnWidth: defaultColumnWidth,
       setColumnWidth: setColumnWidth,
+      setVisibleColumns: setVisibleColumns,
+      switchColumnPos: switchColumnPos,
+      sorting: sorting,
       schema: schema,
       schemaDetectors: schemaDetectors
     }),
@@ -123,24 +126,27 @@ export var EuiDataGridBodyCustomRender = function EuiDataGridBodyCustomRender(_r
   /**
    * Cell render fn
    */
-  var cellProps = {
-    schema: schema,
-    schemaDetectors: schemaDetectors,
-    pagination: pagination,
-    columns: columns,
-    leadingControlColumns: leadingControlColumns,
-    trailingControlColumns: trailingControlColumns,
-    visibleColCount: visibleColCount,
-    columnWidths: columnWidths,
-    defaultColumnWidth: defaultColumnWidth,
-    renderCellValue: renderCellValue,
-    renderCellPopover: renderCellPopover,
-    interactiveCellId: interactiveCellId,
-    setRowHeight: setRowHeight,
-    rowHeightsOptions: rowHeightsOptions,
-    rowHeightUtils: rowHeightUtils
-  };
-  var _Cell = useCallback(function (_ref2) {
+  var cellProps = useMemo(function () {
+    return {
+      schema: schema,
+      schemaDetectors: schemaDetectors,
+      pagination: pagination,
+      columns: columns,
+      leadingControlColumns: leadingControlColumns,
+      trailingControlColumns: trailingControlColumns,
+      visibleColCount: visibleColCount,
+      columnWidths: columnWidths,
+      defaultColumnWidth: defaultColumnWidth,
+      renderCellValue: renderCellValue,
+      cellContext: cellContext,
+      renderCellPopover: renderCellPopover,
+      interactiveCellId: interactiveCellId,
+      setRowHeight: setRowHeight,
+      rowHeightsOptions: rowHeightsOptions,
+      rowHeightUtils: rowHeightUtils
+    };
+  }, [schema, schemaDetectors, pagination, columns, leadingControlColumns, trailingControlColumns, visibleColCount, columnWidths, defaultColumnWidth, renderCellValue, cellContext, renderCellPopover, interactiveCellId, setRowHeight, rowHeightsOptions, rowHeightUtils]);
+  var Cell = useCallback(function (_ref2) {
     var colIndex = _ref2.colIndex,
       visibleRowIndex = _ref2.visibleRowIndex,
       rest = _objectWithoutProperties(_ref2, _excluded);
@@ -152,9 +158,8 @@ export var EuiDataGridBodyCustomRender = function EuiDataGridBodyCustomRender(_r
       visibleRowIndex: visibleRowIndex,
       style: style
     }, cellProps);
-    return ___EmotionJSX(Cell, _extends({}, props, rest));
-  }, [].concat(_toConsumableArray(Object.values(cellProps)), [getRowHeight]) // eslint-disable-line react-hooks/exhaustive-deps
-  );
+    return ___EmotionJSX(CellWrapper, _extends({}, props, rest));
+  }, [cellProps, getRowHeight, rowHeightUtils, rowHeightsOptions]);
 
   // Allow consumers to pass custom props/attributes/listeners etc. to the wrapping div
   var _useState = useState({}),
@@ -166,7 +171,7 @@ export var EuiDataGridBodyCustomRender = function EuiDataGridBodyCustomRender(_r
   }), headerRow, renderCustomGridBody({
     visibleColumns: visibleColumns,
     visibleRowData: visibleRows,
-    Cell: _Cell,
+    Cell: Cell,
     setCustomGridBodyProps: setCustomGridBodyProps
   }), footerRow);
 };
@@ -705,10 +710,24 @@ EuiDataGridBodyCustomRender.propTypes = {
     visibleRowCount: PropTypes.number.isRequired
   }).isRequired,
   renderCellValue: PropTypes.oneOfType([PropTypes.func.isRequired, PropTypes.element.isRequired]).isRequired,
+  cellContext: PropTypes.any,
   renderCellPopover: PropTypes.oneOfType([PropTypes.func.isRequired, PropTypes.func.isRequired]),
   renderFooterCellValue: PropTypes.oneOfType([PropTypes.func.isRequired, PropTypes.element.isRequired]),
   renderCustomGridBody: PropTypes.func,
   interactiveCellId: PropTypes.string.isRequired,
+  sorting: PropTypes.shape({
+    /**
+       * A function that receives updated column sort details in response to user interactions in the toolbar controls
+       */
+    onSort: PropTypes.func.isRequired,
+    /**
+       * An array of the column ids currently being sorted and their sort direction. The array order determines the sort order. `{ id: 'A'; direction: 'asc' }`
+       */
+    columns: PropTypes.arrayOf(PropTypes.shape({
+      id: PropTypes.string.isRequired,
+      direction: PropTypes.oneOf(["asc", "desc"]).isRequired
+    }).isRequired).isRequired
+  }),
   pagination: PropTypes.any,
   setVisibleColumns: PropTypes.func.isRequired,
   switchColumnPos: PropTypes.func.isRequired,