@elastic/eui 61.0.0 → 62.0.2

package/optimize/es/themes/amsterdam/global_styling/mixins/shadow.js

@@ -44,10 +44,21 @@ export var euiShadowMedium = function euiShadowMedium(_ref5) {
       colorMode = _ref5.colorMode;
 
   var _ref6 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
-      _color = _ref6.color;
+      _color = _ref6.color,
+      property = _ref6.property;
 
   var color = _color || euiTheme.colors.shadow;
-  return "\nbox-shadow:\n  0 .9px 4px -1px ".concat(getShadowColor(color, 0.08, colorMode), ",\n  0 2.6px 8px -1px ").concat(getShadowColor(color, 0.06, colorMode), ",\n  0 5.7px 12px -1px ").concat(getShadowColor(color, 0.05, colorMode), ",\n  0 15px 15px -1px ").concat(getShadowColor(color, 0.04, colorMode), ";\n");
+  var array = ["0 .9px 4px ".concat(getShadowColor(color, 0.08, colorMode)), "0 2.6px 8px ".concat(getShadowColor(color, 0.06, colorMode)), "0 5.7px 12px ".concat(getShadowColor(color, 0.05, colorMode)), "0 15px 15px ".concat(getShadowColor(color, 0.04, colorMode))];
+
+  if (property === 'filter') {
+    return "filter: ".concat(array.reduce(function (v, i) {
+      return "".concat(v, " drop-shadow(").concat(i, ")");
+    }, ''), ";");
+  } else {
+    return "box-shadow: ".concat(array.map(function (v) {
+      return v;
+    }), ";");
+  }
 };
 /**
  * bottomShadow

package/optimize/lib/components/avatar/avatar.js

@@ -95,7 +95,6 @@ var EuiAvatar = function EuiAvatar(_ref) {
       className: "euiAvatar__icon",
       size: iconSize || size,
       type: iconType,
-      "aria-label": name,
       color: iconCustomColor === null ? undefined : iconCustomColor
     });
   }

package/optimize/lib/components/color_picker/color_picker.js

@@ -536,7 +536,7 @@ var EuiColorPicker = function EuiColorPicker(_ref) {
     zIndex: popoverZIndex,
     className: popoverClass,
     panelClassName: panelClasses,
-    display: button ? 'inlineBlock' : 'block',
+    display: button ? 'inline-block' : 'block',
     attachToAnchor: button ? false : true,
     anchorPosition: "downLeft",
     panelPaddingSize: "s",

package/optimize/lib/components/combo_box/combo_box_options_list/combo_box_options_list.js

@@ -37,8 +37,6 @@ var _flex = require("../../flex");
 
 var _highlight = require("../../highlight");
 
-var _panel = require("../../panel");
-
 var _text = require("../../text");
 
 var _loading = require("../../loading");
@@ -51,6 +49,8 @@ var _filter_select_item = require("../../filter_group/filter_select_item");
 
 var _badge = require("../../badge/");
 
+var _popover_panel = require("../../popover/popover_panel");
+
 var _react2 = require("@emotion/react");
 
 var _excluded = ["key", "isGroupLabelOption", "label", "value"],
@@ -384,8 +384,8 @@ var EuiComboBoxOptionsList = /*#__PURE__*/function (_Component) {
        * But this should really be converted to user the popover component.
        */
 
-      var classes = (0, _classnames.default)('euiComboBoxOptionsList', 'euiPopover__panel', 'euiPopover__panel-isAttached', 'euiPopover__panel-noArrow', 'euiPopover__panel-isOpen', "euiPopover__panel--".concat(position));
-      return (0, _react2.jsx)(_panel.EuiPanel, (0, _extends2.default)({
+      var classes = (0, _classnames.default)('euiComboBoxOptionsList');
+      return (0, _react2.jsx)(_popover_panel.EuiPopoverPanel, (0, _extends2.default)({
         paddingSize: "none",
         hasShadow: false,
         className: classes,
@@ -393,7 +393,10 @@ var EuiComboBoxOptionsList = /*#__PURE__*/function (_Component) {
         "data-test-subj": "comboBoxOptionsList ".concat(dataTestSubj),
         style: _objectSpread(_objectSpread({}, style), {}, {
           zIndex: zIndex
-        })
+        }),
+        isOpen: true,
+        isAttached: true,
+        position: position
       }, rest), (0, _react2.jsx)("div", {
         className: "euiComboBoxOptionsList__rowWrap"
       }, emptyState || optionsList));

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

@@ -23,7 +23,7 @@ var _comment_timeline = require("./comment_timeline");
 
 var _react2 = require("@emotion/react");
 
-var _excluded = ["children", "className", "username", "event", "actions", "timestamp", "timelineIcon", "eventColor", "eventIcon", "eventIconAriaLabel"];
+var _excluded = ["children", "className", "username", "event", "actions", "timestamp", "timelineAvatar", "timelineAvatarAriaLabel", "eventColor", "eventIcon", "eventIconAriaLabel"];
 
 var EuiComment = function EuiComment(_ref) {
   var children = _ref.children,
@@ -32,7 +32,8 @@ var EuiComment = function EuiComment(_ref) {
       event = _ref.event,
       actions = _ref.actions,
       timestamp = _ref.timestamp,
-      timelineIcon = _ref.timelineIcon,
+      timelineAvatar = _ref.timelineAvatar,
+      timelineAvatarAriaLabel = _ref.timelineAvatarAriaLabel,
       eventColor = _ref.eventColor,
       eventIcon = _ref.eventIcon,
       eventIconAriaLabel = _ref.eventIconAriaLabel,
@@ -41,8 +42,8 @@ var EuiComment = function EuiComment(_ref) {
   var isTypeUpdate = !children;
   var verticalAlign = isTypeUpdate ? 'center' : 'top';
   var mainIcon = (0, _react2.jsx)(_comment_timeline.EuiCommentTimeline, {
-    username: username,
-    timelineIcon: timelineIcon
+    timelineAvatar: timelineAvatar,
+    timelineAvatarAriaLabel: timelineAvatarAriaLabel
   });
   return (0, _react2.jsx)(_timeline.EuiTimelineItem, (0, _extends2.default)({
     verticalAlign: verticalAlign,

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

@@ -7,8 +7,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.EuiCommentEvent = void 0;
 
-var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-
 var _react = _interopRequireDefault(require("react"));
 
 var _services = require("../../services");
@@ -60,14 +58,6 @@ var EuiCommentEvent = function EuiCommentEvent(_ref) {
   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;
@@ -83,34 +73,40 @@ var EuiCommentEvent = function EuiCommentEvent(_ref) {
     color: 'transparent',
     paddingSize: 'none'
   };
-  var eventHeader = (0, _react2.jsx)(HeaderElement, {
+  return (0, _react2.jsx)(Element, {
+    className: classes,
+    css: cssStyles,
+    "data-type": type
+  }, hasEventElements && (0, _react2.jsx)(HeaderElement, {
+    className: "euiCommentEvent__header",
     css: cssHeaderStyles
-  }, (0, _react2.jsx)(_panel.EuiPanel, (0, _extends2.default)({}, panelProps, {
-    css: cssHeaderPanelStyles
-  }), (0, _react2.jsx)("div", {
-    css: cssHeaderMainStyles
+  }, (0, _react2.jsx)(_panel.EuiPanel, panelProps, (0, _react2.jsx)("div", {
+    className: "euiCommentEvent__headerMain",
+    css: headerStyles.euiCommentEvent__headerMain
   }, (0, _react2.jsx)("div", {
-    css: cssHeaderDataStyles
+    className: "euiCommentEvent__headerData",
+    css: headerStyles.euiCommentEvent__headerData
   }, eventIcon && (0, _react2.jsx)(_avatar.EuiAvatar, {
-    css: cssHeaderEventIconStyles,
+    className: "euiCommentEvent__headerEventIcon",
+    css: headerStyles.euiCommentEvent__headerEventIcon,
     size: "s",
     iconType: eventIcon,
     name: eventIconAriaLabel ? eventIconAriaLabel : '',
     color: "subdued",
     "aria-hidden": !eventIconAriaLabel
   }), username && (0, _react2.jsx)("div", {
-    css: cssHeaderUsernameStyles
+    className: "euiCommentEvent__headerUsername",
+    css: headerStyles.euiCommentEvent__headerUsername
   }, username), event && (0, _react2.jsx)("div", {
-    css: cssHeaderEventStyles
+    className: "euiCommentEvent__headerEvent",
+    css: headerStyles.euiCommentEvent__headerEvent
   }, event), timestamp && (0, _react2.jsx)("div", {
-    css: cssHeaderTimestampStyles
+    className: "euiCommentEvent__headerTimestamp"
   }, (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", {
+    className: "euiCommentEvent__headerActions",
+    css: headerStyles.euiCommentEvent__headerActions
+  }, actions)))), children && (0, _react2.jsx)("div", {
+    className: "euiCommentEvent__body",
     css: cssBodyStyles
   }, children));
 };

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

@@ -34,20 +34,20 @@ var euiCommentEventStyles = function euiCommentEventStyles(_ref4) {
 exports.euiCommentEventStyles = euiCommentEventStyles;
 
 var _ref = process.env.NODE_ENV === "production" ? {
-  name: "bqgcpj-hasEventColor",
-  styles: "padding:0;label:hasEventColor;"
+  name: "ui5tce-euiCommentEvent__headerEvent",
+  styles: "align-items:center;display:inline-flex;white-space:pre-wrap;flex-wrap:wrap;label:euiCommentEvent__headerEvent;"
 } : {
-  name: "bqgcpj-hasEventColor",
-  styles: "padding:0;label:hasEventColor;",
+  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 _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: "bqgcpj-hasEventColor",
+  styles: "padding:0;label:hasEventColor;"
 } : {
-  name: "ui5tce-euiCommentEvent__headerEvent",
-  styles: "align-items:center;display:inline-flex;white-space:pre-wrap;flex-wrap:wrap;label:euiCommentEvent__headerEvent;",
+  name: "bqgcpj-hasEventColor",
+  styles: "padding:0;label:hasEventColor;",
   toString: _EMOTION_STRINGIFIED_CSS_ERROR__
 };
 
@@ -55,18 +55,17 @@ 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;"),
+    // types
+    regular: /*#__PURE__*/(0, _react.css)("background:", euiTheme.colors.lightestShade, ";border-bottom:", euiTheme.border.thin, ";padding:", euiTheme.size.s, ";;label:regular;"),
+    // variants
+    hasEventColor: _ref2,
+    // Children
     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
+    euiCommentEvent__headerEvent: _ref,
+    euiCommentEvent__headerActions: /*#__PURE__*/(0, _react.css)("display:flex;flex-wrap:wrap;gap:", euiTheme.size.xs, ";;label:euiCommentEvent__headerActions;")
   };
 };
 

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

@@ -7,8 +7,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.EuiCommentTimeline = void 0;
 
-var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
-
 var _react = _interopRequireDefault(require("react"));
 
 var _avatar = require("../avatar");
@@ -23,26 +21,27 @@ var _react2 = require("@emotion/react");
  * Side Public License, v 1.
  */
 var EuiCommentTimeline = function EuiCommentTimeline(_ref) {
-  var timelineIcon = _ref.timelineIcon,
-      username = _ref.username;
+  var timelineAvatar = _ref.timelineAvatar,
+      timelineAvatarAriaLabel = _ref.timelineAvatarAriaLabel;
   var iconRender;
   var avatarClassName = 'euiCommentAvatar';
-  var iconIsString = typeof timelineIcon === 'string';
-  var iconIsNode = (0, _typeof2.default)(timelineIcon) === 'object';
+  var iconIsString = typeof timelineAvatar === 'string';
 
   if (iconIsString) {
     iconRender = (0, _react2.jsx)(_avatar.EuiAvatar, {
       className: avatarClassName,
-      name: username,
-      iconType: timelineIcon,
+      name: timelineAvatarAriaLabel || '',
+      iconType: timelineAvatar,
       color: "subdued"
     });
-  } else if (iconIsNode) {
-    iconRender = timelineIcon;
+  } else if (timelineAvatar) {
+    iconRender = timelineAvatar;
   } else {
     iconRender = (0, _react2.jsx)(_avatar.EuiAvatar, {
       className: avatarClassName,
-      name: username
+      name: timelineAvatarAriaLabel || '',
+      iconType: "userAvatar",
+      color: "subdued"
     });
   }
 

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/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);