@elastic/eui 60.3.0 → 62.0.1

package/optimize/lib/components/comment_list/comment_event.js

@@ -5,14 +5,22 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TYPES = exports.EuiCommentEvent = void 0;
+exports.EuiCommentEvent = void 0;
+
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 
 var _react = _interopRequireDefault(require("react"));
 
-var _common = require("../common");
+var _services = require("../../services");
 
 var _classnames = _interopRequireDefault(require("classnames"));
 
+var _panel = require("../panel");
+
+var _avatar = require("../avatar");
+
+var _comment_event = require("./comment_event.styles");
+
 var _react2 = require("@emotion/react");
 
 /*
@@ -22,43 +30,89 @@ var _react2 = require("@emotion/react");
  * in compliance with, at your election, the Elastic License 2.0 or the Server
  * Side Public License, v 1.
  */
-var typeToClassNameMap = {
-  regular: 'euiCommentEvent--regular',
-  update: 'euiCommentEvent--update'
-};
-var TYPES = (0, _common.keysOf)(typeToClassNameMap);
-exports.TYPES = TYPES;
-
 var EuiCommentEvent = function EuiCommentEvent(_ref) {
   var children = _ref.children,
       className = _ref.className,
+      eventIcon = _ref.eventIcon,
+      eventIconAriaLabel = _ref.eventIconAriaLabel,
       username = _ref.username,
       timestamp = _ref.timestamp,
-      _ref$type = _ref.type,
-      type = _ref$type === void 0 ? 'regular' : _ref$type,
       event = _ref.event,
-      actions = _ref.actions;
-  var classes = (0, _classnames.default)('euiCommentEvent', typeToClassNameMap[type], className);
-  var isFigure = type === 'regular' || type === 'update' && typeof children !== 'undefined';
+      actions = _ref.actions,
+      eventColor = _ref.eventColor;
+  var classes = (0, _classnames.default)('euiCommentEvent', className); // the username is required so we only check if other elements are define
+
+  var hasEventElements = eventIcon || timestamp || event || actions;
+  var isTypeRegular = children && hasEventElements;
+  var isTypeUpdate = !children && hasEventElements;
+  var type;
+
+  if (isTypeRegular) {
+    type = 'regular';
+  } else if (isTypeUpdate) {
+    type = 'update';
+  } else {
+    type = 'custom';
+  }
+
+  var euiTheme = (0, _services.useEuiTheme)();
+  var styles = (0, _comment_event.euiCommentEventStyles)(euiTheme);
+  var cssStyles = [styles.euiCommentEvent, styles[type]];
+  var headerStyles = (0, _comment_event.euiCommentEventHeaderStyles)(euiTheme);
+  var cssHeaderStyles = [headerStyles.euiCommentEvent__header, eventColor && headerStyles.hasEventColor, isTypeRegular && headerStyles.regular];
+  var cssHeaderPanelStyles = headerStyles.euiCommentEvent__headerPanel;
+  var cssHeaderEventIconStyles = headerStyles.euiCommentEvent__headerEventIcon;
+  var cssHeaderUsernameStyles = headerStyles.euiCommentEvent__headerUsername;
+  var cssHeaderEventStyles = headerStyles.euiCommentEvent__headerEvent;
+  var cssHeaderTimestampStyles = headerStyles.euiCommentEvent__headerTimestamp;
+  var cssHeaderMainStyles = headerStyles.euiCommentEvent__headerMain;
+  var cssHeaderDataStyles = headerStyles.euiCommentEvent__headerData;
+  var cssHeaderActionsStyles = headerStyles.euiCommentEvent__headerActions;
+  var bodyStyles = (0, _comment_event.euiCommentEventBodyStyles)(euiTheme);
+  var cssBodyStyles = [bodyStyles.euiCommentEvent__body, bodyStyles[type]];
+  var isFigure = isTypeRegular;
   var Element = isFigure ? 'figure' : 'div';
-  var HeaderElement = isFigure ? 'figcaption' : 'div';
-  return (0, _react2.jsx)(Element, {
-    className: classes
-  }, (0, _react2.jsx)(HeaderElement, {
-    className: "euiCommentEvent__header"
-  }, (0, _react2.jsx)("div", {
-    className: "euiCommentEvent__headerData"
+  var HeaderElement = isFigure ? 'figcaption' : 'div'; // The 'plain' color creates a shadow and adds a border radius that we don't want.
+  // So for these cases we use the transparent color instead.
+
+  var finalEventColor = eventColor === 'plain' ? 'transparent' : eventColor;
+  var panelProps = finalEventColor ? {
+    color: finalEventColor,
+    paddingSize: 's'
+  } : {
+    color: 'transparent',
+    paddingSize: 'none'
+  };
+  var eventHeader = (0, _react2.jsx)(HeaderElement, {
+    css: cssHeaderStyles
+  }, (0, _react2.jsx)(_panel.EuiPanel, (0, _extends2.default)({}, panelProps, {
+    css: cssHeaderPanelStyles
+  }), (0, _react2.jsx)("div", {
+    css: cssHeaderMainStyles
   }, (0, _react2.jsx)("div", {
-    className: "euiCommentEvent__headerUsername"
-  }, username), (0, _react2.jsx)("div", {
-    className: "euiCommentEvent__headerEvent"
-  }, event), timestamp ? (0, _react2.jsx)("div", {
-    className: "euiCommentEvent__headerTimestamp"
-  }, (0, _react2.jsx)("time", null, timestamp)) : undefined), actions ? (0, _react2.jsx)("div", {
-    className: "euiCommentEvent__headerActions"
-  }, actions) : undefined), children ? (0, _react2.jsx)("div", {
-    className: "euiCommentEvent__body"
-  }, children) : undefined);
+    css: cssHeaderDataStyles
+  }, eventIcon && (0, _react2.jsx)(_avatar.EuiAvatar, {
+    css: cssHeaderEventIconStyles,
+    size: "s",
+    iconType: eventIcon,
+    name: eventIconAriaLabel ? eventIconAriaLabel : '',
+    color: "subdued",
+    "aria-hidden": !eventIconAriaLabel
+  }), username && (0, _react2.jsx)("div", {
+    css: cssHeaderUsernameStyles
+  }, username), event && (0, _react2.jsx)("div", {
+    css: cssHeaderEventStyles
+  }, event), timestamp && (0, _react2.jsx)("div", {
+    css: cssHeaderTimestampStyles
+  }, (0, _react2.jsx)("time", null, timestamp))), actions && (0, _react2.jsx)("div", {
+    css: cssHeaderActionsStyles
+  }, actions))));
+  return (0, _react2.jsx)(Element, {
+    className: classes,
+    css: cssStyles
+  }, hasEventElements && eventHeader, children && (0, _react2.jsx)("div", {
+    css: cssBodyStyles
+  }, children));
 };
 
 exports.EuiCommentEvent = EuiCommentEvent;

package/optimize/lib/components/comment_list/comment_event.styles.js

@@ -0,0 +1,86 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.euiCommentEventStyles = exports.euiCommentEventHeaderStyles = exports.euiCommentEventBodyStyles = void 0;
+
+var _react = require("@emotion/react");
+
+var _global_styling = require("../../global_styling");
+
+function _EMOTION_STRINGIFIED_CSS_ERROR__() { return "You have tried to stringify object returned from `css` function. It isn't supposed to be used directly (e.g. as value of the `className` prop), but rather handed to emotion so it can handle it (e.g. as value of `css` prop)."; }
+
+var _ref3 = process.env.NODE_ENV === "production" ? {
+  name: "yoyozp-euiCommentEvent",
+  styles: "overflow:hidden;label:euiCommentEvent;"
+} : {
+  name: "yoyozp-euiCommentEvent",
+  styles: "overflow:hidden;label:euiCommentEvent;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var euiCommentEventStyles = function euiCommentEventStyles(_ref4) {
+  var euiTheme = _ref4.euiTheme;
+  return {
+    euiCommentEvent: _ref3,
+    // types
+    regular: /*#__PURE__*/(0, _react.css)("border:", euiTheme.border.thin, ";border-radius:", euiTheme.border.radius.medium, ";;label:regular;"),
+    update: /*#__PURE__*/(0, _react.css)(";label:update;"),
+    custom: /*#__PURE__*/(0, _react.css)(";label:custom;")
+  };
+};
+
+exports.euiCommentEventStyles = euiCommentEventStyles;
+
+var _ref = process.env.NODE_ENV === "production" ? {
+  name: "bqgcpj-hasEventColor",
+  styles: "padding:0;label:hasEventColor;"
+} : {
+  name: "bqgcpj-hasEventColor",
+  styles: "padding:0;label:hasEventColor;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var _ref2 = process.env.NODE_ENV === "production" ? {
+  name: "ui5tce-euiCommentEvent__headerEvent",
+  styles: "align-items:center;display:inline-flex;white-space:pre-wrap;flex-wrap:wrap;label:euiCommentEvent__headerEvent;"
+} : {
+  name: "ui5tce-euiCommentEvent__headerEvent",
+  styles: "align-items:center;display:inline-flex;white-space:pre-wrap;flex-wrap:wrap;label:euiCommentEvent__headerEvent;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var euiCommentEventHeaderStyles = function euiCommentEventHeaderStyles(_ref5) {
+  var euiTheme = _ref5.euiTheme;
+  return {
+    euiCommentEvent__header: /*#__PURE__*/(0, _react.css)(";label:euiCommentEvent__header;"),
+    euiCommentEvent__headerPanel: /*#__PURE__*/(0, _react.css)(";label:euiCommentEvent__headerPanel;"),
+    euiCommentEvent__headerMain: /*#__PURE__*/(0, _react.css)("display:flex;flex:1;gap:", euiTheme.size.s, ";;label:euiCommentEvent__headerMain;"),
+    euiCommentEvent__headerData: /*#__PURE__*/(0, _react.css)("display:flex;flex:1;align-items:center;flex-wrap:wrap;gap:", euiTheme.size.xs, ";;label:euiCommentEvent__headerData;"),
+    euiCommentEvent__headerEventIcon: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('margin-right', euiTheme.size.xs), ";;label:euiCommentEvent__headerEventIcon;"),
+    euiCommentEvent__headerUsername: /*#__PURE__*/(0, _react.css)("font-weight:", euiTheme.font.weight.semiBold, ";;label:euiCommentEvent__headerUsername;"),
+    euiCommentEvent__headerEvent: _ref2,
+    euiCommentEvent__headerTimestamp: /*#__PURE__*/(0, _react.css)(";label:euiCommentEvent__headerTimestamp;"),
+    euiCommentEvent__headerActions: /*#__PURE__*/(0, _react.css)("display:flex;flex-wrap:wrap;gap:", euiTheme.size.xs, ";;label:euiCommentEvent__headerActions;"),
+    // types
+    regular: /*#__PURE__*/(0, _react.css)("background:", euiTheme.colors.lightestShade, ";border-bottom:", euiTheme.border.thin, ";padding:", euiTheme.size.s, ";;label:regular;"),
+    // variants
+    hasEventColor: _ref
+  };
+};
+
+exports.euiCommentEventHeaderStyles = euiCommentEventHeaderStyles;
+
+var euiCommentEventBodyStyles = function euiCommentEventBodyStyles(_ref6) {
+  var euiTheme = _ref6.euiTheme;
+  return {
+    euiCommentEvent__body: /*#__PURE__*/(0, _react.css)(";label:euiCommentEvent__body;"),
+    // types
+    regular: /*#__PURE__*/(0, _react.css)("padding:", euiTheme.size.s, ";;label:regular;"),
+    update: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('padding-top', euiTheme.size.xs), ";;label:update;"),
+    custom: /*#__PURE__*/(0, _react.css)(";label:custom;")
+  };
+};
+
+exports.euiCommentEventBodyStyles = euiCommentEventBodyStyles;

package/optimize/lib/components/comment_list/comment_list.js

@@ -17,14 +17,18 @@ var _classnames = _interopRequireDefault(require("classnames"));
 
 var _comment = require("./comment");
 
+var _timeline = require("../timeline");
+
 var _react2 = require("@emotion/react");
 
-var _excluded = ["children", "className", "comments"];
+var _excluded = ["children", "className", "comments", "gutterSize"];
 
 var EuiCommentList = function EuiCommentList(_ref) {
   var children = _ref.children,
       className = _ref.className,
       comments = _ref.comments,
+      _ref$gutterSize = _ref.gutterSize,
+      gutterSize = _ref$gutterSize === void 0 ? 'l' : _ref$gutterSize,
       rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
   var classes = (0, _classnames.default)('euiCommentList', className);
   var commentElements = null;
@@ -37,8 +41,9 @@ var EuiCommentList = function EuiCommentList(_ref) {
     });
   }
 
-  return (0, _react2.jsx)("div", (0, _extends2.default)({
-    className: classes
+  return (0, _react2.jsx)(_timeline.EuiTimeline, (0, _extends2.default)({
+    className: classes,
+    gutterSize: gutterSize
   }, rest), commentElements, children);
 };
 

package/optimize/lib/components/comment_list/comment_timeline.js

@@ -5,15 +5,11 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.TYPES = exports.EuiCommentTimeline = void 0;
+exports.EuiCommentTimeline = void 0;
 
 var _react = _interopRequireDefault(require("react"));
 
-var _common = require("../common");
-
-var _classnames = _interopRequireDefault(require("classnames"));
-
-var _icon = require("../icon");
+var _avatar = require("../avatar");
 
 var _react2 = require("@emotion/react");
 
@@ -24,45 +20,32 @@ var _react2 = require("@emotion/react");
  * in compliance with, at your election, the Elastic License 2.0 or the Server
  * Side Public License, v 1.
  */
-var typeToClassNameMap = {
-  regular: 'euiCommentTimeline__icon--regular',
-  update: 'euiCommentTimeline__icon--update'
-};
-var TYPES = (0, _common.keysOf)(typeToClassNameMap);
-exports.TYPES = TYPES;
-
 var EuiCommentTimeline = function EuiCommentTimeline(_ref) {
-  var className = _ref.className,
-      timelineIcon = _ref.timelineIcon,
-      _ref$type = _ref.type,
-      type = _ref$type === void 0 ? 'regular' : _ref$type;
-  var classes = (0, _classnames.default)('euiCommentTimeline', className);
-  var iconClasses = (0, _classnames.default)({
-    'euiCommentTimeline__icon--default': !timelineIcon || typeof timelineIcon === 'string'
-  }, typeToClassNameMap[type]);
+  var timelineAvatar = _ref.timelineAvatar,
+      timelineAvatarAriaLabel = _ref.timelineAvatarAriaLabel;
   var iconRender;
-
-  if (typeof timelineIcon === 'string') {
-    iconRender = (0, _react2.jsx)(_icon.EuiIcon, {
-      size: type === 'update' ? 'm' : 'l',
-      type: timelineIcon
+  var avatarClassName = 'euiCommentAvatar';
+  var iconIsString = typeof timelineAvatar === 'string';
+
+  if (iconIsString) {
+    iconRender = (0, _react2.jsx)(_avatar.EuiAvatar, {
+      className: avatarClassName,
+      name: timelineAvatarAriaLabel || '',
+      iconType: timelineAvatar,
+      color: "subdued"
     });
-  } else if (timelineIcon) {
-    iconRender = timelineIcon;
+  } else if (timelineAvatar) {
+    iconRender = timelineAvatar;
   } else {
-    iconRender = (0, _react2.jsx)(_icon.EuiIcon, {
-      type: type === 'update' ? 'dot' : 'user',
-      size: type === 'update' ? 's' : 'l'
+    iconRender = (0, _react2.jsx)(_avatar.EuiAvatar, {
+      className: avatarClassName,
+      name: timelineAvatarAriaLabel || '',
+      iconType: "userAvatar",
+      color: "subdued"
     });
   }
 
-  return (0, _react2.jsx)("div", {
-    className: classes
-  }, (0, _react2.jsx)("div", {
-    className: "euiCommentTimeline__content"
-  }, (0, _react2.jsx)("div", {
-    className: iconClasses
-  }, iconRender)));
+  return (0, _react2.jsx)(_react.default.Fragment, null, iconRender);
 };
 
 exports.EuiCommentTimeline = EuiCommentTimeline;

package/optimize/lib/components/context_menu/context_menu_panel.js

@@ -336,7 +336,7 @@ var EuiContextMenuPanel = /*#__PURE__*/function (_Component) {
       // If EuiContextMenu is used within an EuiPopover, we need to wait for EuiPopover to:
       // 1. Correctly set its `returnFocus` to the toggling button,
       //    so focus is correctly restored to the popover toggle on close
-      // 2. Finish its own `updateFocus()` call 350ms after transitioning in,
+      // 2. Finish its react-focus-on `autoFocus` behavior after transitioning in,
       //    so the panel can handle its own focus without focus fighting
       if (this.initialPopoverParent) {
         this.initialPopoverParent.addEventListener('focus', this.reclaimPopoverFocus, {

package/optimize/lib/components/datagrid/body/data_grid_body.js

@@ -353,7 +353,7 @@ var EuiDataGridBody = function EuiDataGridBody(props) {
    */
 
   var rowHeightUtils = (0, _row_heights.useRowHeightUtils)({
-    gridRef: gridRef.current,
+    gridRef: gridRef,
     gridStyles: gridStyles,
     columns: columns,
     rowHeightsOptions: rowHeightsOptions

package/optimize/lib/components/datagrid/body/header/data_grid_header_cell.js

@@ -7,7 +7,7 @@ var _typeof = require("@babel/runtime/helpers/typeof");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.usePopoverArrowNavigation = exports.EuiDataGridHeaderCell = void 0;
+exports.useSortingUtils = exports.usePopoverArrowNavigation = exports.EuiDataGridHeaderCell = void 0;
 
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 
@@ -76,9 +76,6 @@ var EuiDataGridHeaderCell = function EuiDataGridHeaderCell(_ref) {
   var width = columnWidths[id] || defaultColumnWidth;
   var columnType = schema[id] ? schema[id].columnType : null;
   var classes = (0, _classnames2.default)((0, _defineProperty2.default)({}, "euiDataGridHeaderCell--".concat(columnType), columnType));
-  var actionButtonAriaLabel = (0, _i18n.useEuiI18n)('euiDataGridHeaderCell.headerActions', 'Header actions');
-  var ariaProps = {};
-  var screenReaderId = (0, _accessibility.useGeneratedHtmlId)();
 
   var _useContext = (0, _react.useContext)(_focus.DataGridFocusContext),
       setFocusedCell = _useContext.setFocusedCell,
@@ -87,37 +84,6 @@ var EuiDataGridHeaderCell = function EuiDataGridHeaderCell(_ref) {
   var _useContext2 = (0, _react.useContext)(_sorting.DataGridSortingContext),
       sorting = _useContext2.sorting;
 
-  var sortString;
-
-  if (sorting) {
-    var sortedColumnIds = new Set(sorting.columns.map(function (_ref2) {
-      var id = _ref2.id;
-      return id;
-    }));
-
-    if (sortedColumnIds.has(id)) {
-      if (sorting.columns.length === 1) {
-        var sortDirection = sorting.columns[0].direction;
-        var sortValue = 'other';
-
-        if (sortDirection === 'asc') {
-          sortValue = 'ascending';
-        }
-
-        if (sortDirection === 'desc') {
-          sortValue = 'descending';
-        }
-
-        ariaProps['aria-sort'] = sortValue;
-      } else {
-        sortString = sorting.columns.map(function (col) {
-          return "Sorted by ".concat(col.id, " ").concat(col.direction);
-        }).join(' then ');
-        ariaProps['aria-describedby'] = screenReaderId;
-      }
-    }
-  }
-
   var _useState = (0, _react.useState)(false),
       _useState2 = (0, _slicedToArray2.default)(_useState, 2),
       isPopoverOpen = _useState2[0],
@@ -137,31 +103,39 @@ var EuiDataGridHeaderCell = function EuiDataGridHeaderCell(_ref) {
     setFocusedCell: setFocusedCell
   });
   var showColumnActions = columnActions && columnActions.length > 0;
-  var sortedColumn = sorting === null || sorting === void 0 ? void 0 : sorting.columns.find(function (col) {
-    return col.id === id;
+
+  var _useSortingUtils = useSortingUtils({
+    sorting: sorting,
+    id: id,
+    showColumnActions: showColumnActions
+  }),
+      sortingArrow = _useSortingUtils.sortingArrow,
+      ariaSort = _useSortingUtils.ariaSort,
+      sortingScreenReaderText = _useSortingUtils.sortingScreenReaderText;
+
+  var sortingAriaId = (0, _accessibility.useGeneratedHtmlId)({
+    prefix: 'euiDataGridCellHeader',
+    suffix: 'sorting'
   });
-  var sortingArrow = sortedColumn ? (0, _react2.jsx)(_icon.EuiIcon, {
-    type: sortedColumn.direction === 'asc' ? 'sortUp' : 'sortDown',
-    color: "text",
-    className: "euiDataGridHeaderCell__sortingArrow",
-    "data-test-subj": "dataGridHeaderCellSortingIcon-".concat(id)
-  }) : null;
-  return (0, _react2.jsx)(_data_grid_header_cell_wrapper.EuiDataGridHeaderCellWrapper, (0, _extends2.default)({
+  var actionsAriaId = (0, _accessibility.useGeneratedHtmlId)({
+    prefix: 'euiDataGridCellHeader',
+    suffix: 'actions'
+  });
+  return (0, _react2.jsx)(_data_grid_header_cell_wrapper.EuiDataGridHeaderCellWrapper, {
     id: id,
     index: index,
     width: width,
     headerIsInteractive: headerIsInteractive,
-    className: classes
-  }, ariaProps), column.isResizable !== false && width != null ? (0, _react2.jsx)(_data_grid_column_resizer.EuiDataGridColumnResizer, {
+    className: classes,
+    "aria-sort": ariaSort
+  }, column.isResizable !== false && width != null ? (0, _react2.jsx)(_data_grid_column_resizer.EuiDataGridColumnResizer, {
     columnId: id,
     columnWidth: width,
     setColumnWidth: setColumnWidth
-  }) : null, sortString && (0, _react2.jsx)(_accessibility2.EuiScreenReaderOnly, null, (0, _react2.jsx)("div", {
-    id: screenReaderId
-  }, sortString)), !showColumnActions ? (0, _react2.jsx)(_react.default.Fragment, null, sortingArrow, (0, _react2.jsx)("div", {
+  }) : null, !showColumnActions ? (0, _react2.jsx)(_react.default.Fragment, null, sortingArrow, (0, _react2.jsx)("div", {
     className: "euiDataGridHeaderCell__content",
     title: displayAsText || id
-  }, display || displayAsText || id)) : (0, _react2.jsx)(_popover.EuiPopover, (0, _extends2.default)({
+  }, display || displayAsText || id), sortingScreenReaderText && (0, _react2.jsx)(_accessibility2.EuiScreenReaderOnly, null, (0, _react2.jsx)("p", null, sortingScreenReaderText))) : (0, _react2.jsx)(_react.default.Fragment, null, (0, _react2.jsx)(_popover.EuiPopover, (0, _extends2.default)({
     className: "eui-fullWidth",
     anchorClassName: "eui-fullWidth",
     panelPaddingSize: "none",
@@ -173,7 +147,8 @@ var EuiDataGridHeaderCell = function EuiDataGridHeaderCell(_ref) {
         setIsPopoverOpen(function (isPopoverOpen) {
           return !isPopoverOpen;
         });
-      }
+      },
+      "aria-describedby": "".concat(sortingAriaId, " ").concat(actionsAriaId)
     }, sortingArrow, (0, _react2.jsx)("div", {
       className: "euiDataGridHeaderCell__content",
       title: displayAsText || id
@@ -182,7 +157,6 @@ var EuiDataGridHeaderCell = function EuiDataGridHeaderCell(_ref) {
       type: "arrowDown",
       size: "s",
       color: "text",
-      "aria-label": actionButtonAriaLabel,
       "data-test-subj": "dataGridHeaderCellActionButton-".concat(id)
     })),
     isOpen: isPopoverOpen,
@@ -193,7 +167,132 @@ var EuiDataGridHeaderCell = function EuiDataGridHeaderCell(_ref) {
     listItems: columnActions,
     gutterSize: "none",
     "data-test-subj": "dataGridHeaderCellActionGroup-".concat(id)
-  })));
+  })), (0, _react2.jsx)("p", {
+    id: sortingAriaId,
+    hidden: true
+  }, sortingScreenReaderText), (0, _react2.jsx)("p", {
+    id: actionsAriaId,
+    hidden: true
+  }, (0, _react2.jsx)(_i18n.EuiI18n, {
+    token: "euiDataGridHeaderCell.headerActions",
+    default: "Click to view column header actions"
+  }))));
+};
+/**
+ * Column sorting utility helpers
+ */
+
+
+exports.EuiDataGridHeaderCell = EuiDataGridHeaderCell;
+
+var useSortingUtils = function useSortingUtils(_ref2) {
+  var _sorting$columns;
+
+  var sorting = _ref2.sorting,
+      id = _ref2.id,
+      showColumnActions = _ref2.showColumnActions;
+  var sortedColumn = (0, _react.useMemo)(function () {
+    return sorting === null || sorting === void 0 ? void 0 : sorting.columns.find(function (col) {
+      return col.id === id;
+    });
+  }, [sorting, id]);
+  var isColumnSorted = !!sortedColumn;
+  var hasOnlyOneSort = (sorting === null || sorting === void 0 ? void 0 : (_sorting$columns = sorting.columns) === null || _sorting$columns === void 0 ? void 0 : _sorting$columns.length) === 1;
+  /**
+   * Arrow icon
+   */
+
+  var sortingArrow = isColumnSorted ? (0, _react2.jsx)(_icon.EuiIcon, {
+    type: sortedColumn.direction === 'asc' ? 'sortUp' : 'sortDown',
+    color: "text",
+    className: "euiDataGridHeaderCell__sortingArrow",
+    "data-test-subj": "dataGridHeaderCellSortingIcon-".concat(id)
+  }) : null;
+  /**
+   * aria-sort attribute - should only be used when a single column is being sorted
+   * @see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-sort
+   * @see https://www.w3.org/WAI/ARIA/apg/example-index/table/sortable-table.html
+   * @see https://github.com/w3c/aria/issues/283 for potential future multi-column usage
+   */
+
+  var ariaSort = // eslint-disable-next-line no-nested-ternary
+  isColumnSorted && hasOnlyOneSort ? sorting.columns[0].direction === 'asc' ? 'ascending' : 'descending' : undefined;
+  /**
+   * Sorting status - screen reader text
+   */
+
+  var sortingScreenReaderText = (0, _react.useMemo)(function () {
+    var _sorting$columns2;
+
+    if (!isColumnSorted) return null;
+    if (!showColumnActions && hasOnlyOneSort) return null; // in this scenario, the `aria-sort` attribute will be used by screen readers
+
+    return (0, _react2.jsx)(_react.default.Fragment, null, sorting === null || sorting === void 0 ? void 0 : (_sorting$columns2 = sorting.columns) === null || _sorting$columns2 === void 0 ? void 0 : _sorting$columns2.map(function (_ref3, index) {
+      var columnId = _ref3.id,
+          direction = _ref3.direction;
+
+      if (hasOnlyOneSort) {
+        if (direction === 'asc') {
+          return (0, _react2.jsx)(_i18n.EuiI18n, {
+            token: "euiDataGridHeaderCell.sortedByAscendingSingle",
+            default: "Sorted ascending",
+            key: index
+          });
+        } else {
+          return (0, _react2.jsx)(_i18n.EuiI18n, {
+            token: "euiDataGridHeaderCell.sortedByDescendingSingle",
+            default: "Sorted descending",
+            key: index
+          });
+        }
+      } else if (index === 0) {
+        if (direction === 'asc') {
+          return (0, _react2.jsx)(_i18n.EuiI18n, {
+            token: "euiDataGridHeaderCell.sortedByAscendingFirst",
+            default: "Sorted by {columnId}, ascending",
+            values: {
+              columnId: columnId
+            },
+            key: index
+          });
+        } else {
+          return (0, _react2.jsx)(_i18n.EuiI18n, {
+            token: "euiDataGridHeaderCell.sortedByDescendingFirst",
+            default: "Sorted by {columnId}, descending",
+            values: {
+              columnId: columnId
+            },
+            key: index
+          });
+        }
+      } else {
+        if (direction === 'asc') {
+          return (0, _react2.jsx)(_i18n.EuiI18n, {
+            token: "euiDataGridHeaderCell.sortedByAscendingMultiple",
+            default: ", then sorted by {columnId}, ascending",
+            values: {
+              columnId: columnId
+            },
+            key: index
+          });
+        } else {
+          return (0, _react2.jsx)(_i18n.EuiI18n, {
+            token: "euiDataGridHeaderCell.sortedByDescendingMultiple",
+            default: ", then sorted by {columnId}, descending",
+            values: {
+              columnId: columnId
+            },
+            key: index
+          });
+        }
+      }
+    }), ".");
+  }, [isColumnSorted, showColumnActions, hasOnlyOneSort, sorting]);
+  return {
+    sortingArrow: sortingArrow,
+    ariaSort: ariaSort,
+    sortingScreenReaderText: sortingScreenReaderText
+  };
 };
 /**
  * Add keyboard arrow navigation to the cell actions popover
@@ -201,7 +300,7 @@ var EuiDataGridHeaderCell = function EuiDataGridHeaderCell(_ref) {
  */
 
 
-exports.EuiDataGridHeaderCell = EuiDataGridHeaderCell;
+exports.useSortingUtils = useSortingUtils;
 
 var usePopoverArrowNavigation = function usePopoverArrowNavigation() {
   var popoverPanelRef = (0, _react.useRef)(null);