@elastic/eui 113.2.1 → 114.0.0

package/lib/components/basic_table/collapsed_item_actions.js

@@ -71,6 +71,7 @@ var CollapsedItemActions = exports.CollapsedItemActions = function CollapsedItem
         var toolTipContent = (0, _action_types.callWithItemIfFunction)(item)(action.description);
         var href = (0, _action_types.callWithItemIfFunction)(item)(action.href);
         var dataTestSubj = (0, _action_types.callWithItemIfFunction)(item)(action['data-test-subj']);
+        var color = action.color ? (0, _action_types.callWithItemIfFunction)(item)(action.color) : undefined;
         var _onClick = action.onClick,
           target = action.target;
         controls.push((0, _react2.jsx)(_context_menu.EuiContextMenuItem, {
@@ -80,6 +81,7 @@ var CollapsedItemActions = exports.CollapsedItemActions = function CollapsedItem
           href: href,
           target: target,
           icon: icon,
+          color: color,
           "data-test-subj": dataTestSubj,
           onClick: function onClick(event) {
             event.persist();

package/lib/components/button/split_button/split_button.js

@@ -106,6 +106,19 @@ _EuiSplitButton.propTypes = {
   "aria-label": _propTypes.default.string,
   "data-test-subj": _propTypes.default.string,
   css: _propTypes.default.any,
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
+  isDisabled: _propTypes.default.bool,
+  /**
+     * NOTE: Beta feature, may be changed or removed in the future
+     *
+     * Changes the native `disabled` attribute to `aria-disabled` to preserve focusability.
+     * This results in a semantically disabled button without the default browser handling of the disabled state.
+     *
+     * Use e.g. when a disabled button should have a tooltip.
+     */
+  hasAriaDisabled: _propTypes.default.bool,
   size: _propTypes.default.any,
   color: _propTypes.default.any,
   fill: _propTypes.default.bool,

package/lib/components/button/split_button/split_button_actions.js

@@ -69,6 +69,19 @@ var EuiSplitButtonActionPrimary = exports.EuiSplitButtonActionPrimary = function
   return tooltipProps ? (0, _react2.jsx)(_tool_tip.EuiToolTip, tooltipProps, button) : button;
 };
 EuiSplitButtonActionPrimary.propTypes = {
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
+  isDisabled: _propTypes.default.bool,
+  /**
+     * NOTE: Beta feature, may be changed or removed in the future
+     *
+     * Changes the native `disabled` attribute to `aria-disabled` to preserve focusability.
+     * This results in a semantically disabled button without the default browser handling of the disabled state.
+     *
+     * Use e.g. when a disabled button should have a tooltip.
+     */
+  hasAriaDisabled: _propTypes.default.bool,
   /**
      * Enables rendering an `EuiToolTip` with the passed props.
      */
@@ -111,6 +124,8 @@ var EuiSplitButtonActionSecondary = exports.EuiSplitButtonActionSecondary = func
   })) : action;
 };
 EuiSplitButtonActionSecondary.propTypes = {
+  isDisabled: _propTypes.default.bool,
+  hasAriaDisabled: _propTypes.default.bool,
   /**
      * Enables rendering an `EuiToolTip` with the passed props.
      */

package/lib/components/collapsible_nav/collapsible_nav.js

@@ -137,6 +137,11 @@ EuiCollapsibleNav.propTypes = {
      * @default undefined (auto-inherit when nested, otherwise 'never')
      */
   session: _propTypes.default.oneOfType([_propTypes.default.any.isRequired, _propTypes.default.any.isRequired, _propTypes.default.any.isRequired]),
+  /**
+     * Optional Symbol to scope flyout history. Only flyouts that receive the same Symbol reference share Back button and history; omit to get a unique group per session.
+     * @default undefined (each session gets a unique key and does not share history)
+     */
+  historyKey: _propTypes.default.any,
   /**
      * Callback fired when the flyout becomes active/visible, which may happen programmatically from history navigation.
      */

package/lib/components/color_picker/color_picker.js

@@ -101,9 +101,12 @@ var EuiColorPicker = exports.EuiColorPicker = function EuiColorPicker(_ref) {
     _ref$isClearable = _ref.isClearable,
     isClearable = _ref$isClearable === void 0 ? false : _ref$isClearable,
     placeholder = _ref.placeholder,
-    dataTestSubj = _ref['data-test-subj'];
-  var _useEuiI18n = (0, _i18n.useEuiI18n)(['euiColorPicker.popoverLabel', 'euiColorPicker.colorLabel', 'euiColorPicker.selectedColorLabel', 'euiColorPicker.colorErrorMessage', 'euiColorPicker.transparent', 'euiColorPicker.alphaLabel', 'euiColorPicker.openLabel', 'euiColorPicker.closeLabel'], ['Color selection dialog', 'Color value', 'Selected color', 'Invalid color value', 'Transparent', 'Alpha channel (opacity) value', 'Press the escape key to close the popover', 'Press the down key to open a popover containing color options']),
-    _useEuiI18n2 = _slicedToArray(_useEuiI18n, 8),
+    dataTestSubj = _ref['data-test-subj'],
+    _ariaLabel = _ref['aria-label'],
+    ariaLabelledby = _ref['aria-labelledby'],
+    ariaDescribedby = _ref['aria-describedby'];
+  var _useEuiI18n = (0, _i18n.useEuiI18n)(['euiColorPicker.popoverLabel', 'euiColorPicker.colorLabel', 'euiColorPicker.selectedColorLabel', 'euiColorPicker.colorErrorMessage', 'euiColorPicker.transparent', 'euiColorPicker.alphaLabel', 'euiColorPicker.openLabel', 'euiColorPicker.closeLabel', 'euiColorPicker.ariaLabel'], ['Color selection dialog', 'Color value', 'Selected color', 'Invalid color value', 'Transparent', 'Alpha channel (opacity) value', 'Press the escape key to close the popover', 'Press the down key to open a popover containing color options', 'Select a color']),
+    _useEuiI18n2 = _slicedToArray(_useEuiI18n, 9),
     popoverLabel = _useEuiI18n2[0],
     colorLabel = _useEuiI18n2[1],
     selectedColorLabel = _useEuiI18n2[2],
@@ -111,7 +114,16 @@ var EuiColorPicker = exports.EuiColorPicker = function EuiColorPicker(_ref) {
     transparent = _useEuiI18n2[4],
     alphaLabel = _useEuiI18n2[5],
     openLabel = _useEuiI18n2[6],
-    closeLabel = _useEuiI18n2[7];
+    closeLabel = _useEuiI18n2[7],
+    ariaLabel = _useEuiI18n2[8];
+  var openLabelId = (0, _services.useGeneratedHtmlId)({
+    prefix: 'colorPicker',
+    suffix: 'openLabel'
+  });
+  var closeLabelId = (0, _services.useGeneratedHtmlId)({
+    prefix: 'colorPicker',
+    suffix: 'closeLabel'
+  });
   var defaultSwatches = (0, _services.useEuiPaletteColorBlind)();
   var swatches = _swatches !== null && _swatches !== void 0 ? _swatches : defaultSwatches;
   var preferredFormat = (0, _react.useMemo)(function () {
@@ -440,10 +452,21 @@ var EuiColorPicker = exports.EuiColorPicker = function EuiColorPicker(_ref) {
       readOnly: readOnly,
       fullWidth: fullWidth,
       autoComplete: "off",
-      "data-test-subj": testSubjAnchor,
-      "aria-label": isColorSelectorShown ? openLabel : closeLabel,
+      "data-test-subj": testSubjAnchor
+      // if an id is provided it might be used in combination with `htmlFor` on a label,
+      // so we don't want to override it with a fallback `aria-label`
+      ,
+      "aria-label": _ariaLabel ? _ariaLabel : id || ariaLabelledby ? undefined : ariaLabel,
+      "aria-labelledby": ariaLabelledby,
+      "aria-describedby": (0, _classnames.default)(isColorSelectorShown ? openLabelId : closeLabelId, ariaDescribedby),
       controlOnly: true // Don't need two EuiFormControlwrappers
-    }));
+    }), (0, _react2.jsx)(_accessibility.EuiScreenReaderOnly, null, (0, _react2.jsx)("span", null, (0, _react2.jsx)("span", {
+      id: openLabelId,
+      "aria-hidden": !isColorSelectorShown
+    }, openLabel), (0, _react2.jsx)("span", {
+      id: closeLabelId,
+      "aria-hidden": isColorSelectorShown
+    }, closeLabel))));
   }
   return display === 'inline' ? (0, _react2.jsx)("div", {
     css: styles.euiColorPicker,

package/lib/components/context_menu/context_menu_item.js

@@ -14,7 +14,7 @@ var _icon = require("../icon");
 var _tool_tip = require("../tool_tip");
 var _context_menu_item = require("./context_menu_item.styles");
 var _react2 = require("@emotion/react");
-var _excluded = ["children", "className", "hasPanel", "icon", "buttonRef", "disabled", "layoutAlign", "toolTipContent", "toolTipProps", "href", "target", "rel", "size"];
+var _excluded = ["children", "className", "hasPanel", "icon", "buttonRef", "disabled", "layoutAlign", "toolTipContent", "toolTipProps", "href", "target", "rel", "size", "color"];
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -49,12 +49,13 @@ var EuiContextMenuItem = exports.EuiContextMenuItem = function EuiContextMenuIte
     rel = _ref.rel,
     _ref$size = _ref.size,
     size = _ref$size === void 0 ? 'm' : _ref$size,
+    color = _ref.color,
     rest = _objectWithoutProperties(_ref, _excluded);
   var isHrefValid = !href || (0, _href_validator.validateHref)(href);
   var disabled = _disabled || !isHrefValid;
   var classes = (0, _classnames.default)('euiContextMenuItem', className);
   var styles = (0, _services.useEuiMemoizedStyles)(_context_menu_item.euiContextMenuItemStyles);
-  var cssStyles = [styles.euiContextMenuItem, styles.sizes[size], styles.layoutAlign[layoutAlign], disabled && styles.disabled];
+  var cssStyles = [styles.euiContextMenuItem, styles.sizes[size], styles.layoutAlign[layoutAlign], disabled && styles.disabled, !disabled && color && styles.colors[color]];
   var iconInstance = icon && (typeof icon === 'string' ? (0, _react2.jsx)(_icon.EuiIcon, {
     type: icon,
     size: "m",
@@ -150,5 +151,10 @@ EuiContextMenuItem.propTypes = {
   /**
      * Reduce the size to `s` when in need of a more compressed menu
      */
-  size: _propTypes.default.any
+  size: _propTypes.default.any,
+  /**
+     * Applies a color to the text and icon of the item.
+     * Accepts the same color values as `EuiButtonEmpty`.
+     */
+  color: _propTypes.default.any
 };

package/lib/components/context_menu/context_menu_item.styles.js

@@ -81,6 +81,10 @@ var euiContextMenuItemStyles = exports.euiContextMenuItemStyles = function euiCo
       euiContextMenuItem__text: _ref2,
       s: /*#__PURE__*/(0, _react.css)((0, _global_styling.euiFontSize)(euiThemeContext, 's'), ";;label:s;")
     },
-    euiContextMenuItem__arrow: _ref
+    euiContextMenuItem__arrow: _ref,
+    // Colors - maps button color names to text color overrides
+    colors: Object.fromEntries(_global_styling.EXTENDED_BUTTON_COLORS.map(function (color) {
+      return [color, /*#__PURE__*/(0, _react.css)("color:", (0, _global_styling.euiButtonEmptyColor)(euiThemeContext, color).color, ";;label:colors;")];
+    }))
   };
 };

package/lib/components/datagrid/utils/scrolling.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.useScrollCellIntoView = exports.useScrollBars = exports.useScroll = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _services = require("../../../services");
+var _hooks = require("../../../services/hooks");
 var _global_styling = require("../../../global_styling");
 var _cell = require("../body/cell");
 var _focus = require("./focus");
@@ -35,20 +36,48 @@ var useScroll = exports.useScroll = function useScroll(args) {
     scrollCellIntoView = _useScrollCellIntoVie.scrollCellIntoView;
   var _useContext = (0, _react.useContext)(_focus.DataGridFocusContext),
     focusedCell = _useContext.focusedCell;
-  var isPointerDown = (0, _services.useIsPointerDown)(args.outerGridRef);
+  var isPointerDownRef = (0, _hooks.useIsPointerDown)(args.outerGridRef);
+
+  /**
+   * Set when `focusedCell` changes while the pointer is held down (e.g. clicking a cell).
+   * Allows the `pointerup` listener below to scroll on release without
+   * causing snap-back when the user scrolls the grid without changing focus.
+   */
+  var pendingScrollRef = (0, _react.useRef)(false);
+  (0, _react.useEffect)(function () {
+    if (!focusedCell) return;
+    if (isPointerDownRef.current) {
+      // Pointer is down - defer scroll decision to the pointerup listener
+      pendingScrollRef.current = true;
+      return;
+    }
+    scrollCellIntoView({
+      rowIndex: focusedCell[1],
+      colIndex: focusedCell[0]
+    });
+  }, [focusedCell, scrollCellIntoView, isPointerDownRef]);
   (0, _react.useEffect)(function () {
-    if (focusedCell) {
+    var handlePointerUp = function handlePointerUp() {
       var _window;
-      // do not scroll if text is being selected
-      if (isPointerDown || ((_window = window) === null || _window === void 0 || (_window = _window.getSelection()) === null || _window === void 0 ? void 0 : _window.type) === 'Range') {
-        return;
-      }
+      if (!pendingScrollRef.current || !focusedCell) return;
+      pendingScrollRef.current = false;
+
+      // Skip if the interaction resulted in text being selected
+      if (((_window = window) === null || _window === void 0 || (_window = _window.getSelection()) === null || _window === void 0 ? void 0 : _window.type) === 'Range') return;
       scrollCellIntoView({
         rowIndex: focusedCell[1],
         colIndex: focusedCell[0]
       });
-    }
-  }, [focusedCell, isPointerDown, scrollCellIntoView]);
+    };
+    document.addEventListener('pointerup', handlePointerUp, {
+      capture: true
+    });
+    return function () {
+      return document.removeEventListener('pointerup', handlePointerUp, {
+        capture: true
+      });
+    };
+  }, [focusedCell, scrollCellIntoView]);
   var _useContext2 = (0, _react.useContext)(_cell.DataGridCellPopoverContext),
     popoverIsOpen = _useContext2.popoverIsOpen,
     cellLocation = _useContext2.cellLocation;

package/lib/components/date_picker/super_date_picker/time_window_buttons.js

@@ -160,11 +160,20 @@ var EuiTimeWindowButtons = exports.EuiTimeWindowButtons = function EuiTimeWindow
 function useEuiTimeWindow(start, end, apply, options) {
   var _options$zoomFactor;
   var min = _datemath.default.parse(start);
+
+  /* `roundUp: true` will result in an "inclusive" time (e.g. 23:59:59.999 for 'now/d').
+  It only changes the value for relative expressions (e.g. 'now/d') but not absolute ISO strings. */
   var max = _datemath.default.parse(end, {
     roundUp: true
   });
   var isInvalid = !min || !min.isValid() || !max || !max.isValid();
-  var windowDuration = isInvalid ? -1 : max.diff(min);
+  /* An end at .999ms is always considered an inclusive boundary (either as result of `roundUp: true`
+  or entered manually). 
+  To avoid a 1ms drift on every time window or zoom step, windowDuration has to be increased by 1ms.
+  This ensures the window is always at a clean boundary (e.g. 00:00:00.000 - 23:59:59.999). */
+  var isInclusiveBoundary = !isInvalid && max.milliseconds() === 999;
+  var endBoundary = !isInvalid ? isInclusiveBoundary ? (0, _moment.default)(max).add(1, 'ms') : (0, _moment.default)(max) : null;
+  var windowDuration = isInvalid || !endBoundary ? -1 : endBoundary.diff(min);
   var isWindowDurationZero = windowDuration === 0;
   var zoomFactor = getPercentageMultiplier((_options$zoomFactor = options === null || options === void 0 ? void 0 : options.zoomFactor) !== null && _options$zoomFactor !== void 0 ? _options$zoomFactor : ZOOM_FACTOR_DEFAULT);
   var zoomDelta = windowDuration * (zoomFactor / 2); // Gets added to each end, that's why it's split in half
@@ -185,7 +194,10 @@ function useEuiTimeWindow(start, end, apply, options) {
   function stepForward() {
     if (isInvalid || isWindowDurationZero) return;
     apply({
-      start: (0, _moment.default)(max).toISOString(),
+      /* Prevent 1ms drifts for inclusive boundaries by using the exclusive max (+ 1ms)
+      as the start of the next window (e.g. 00:00:00.000 instead of 23:59:59.999) */
+      start: (isInclusiveBoundary ? endBoundary // `!` is safe here because we early return on `isInvalid`
+      : (0, _moment.default)(max)).toISOString(),
       end: (0, _moment.default)(max).add(windowDuration, 'ms').toISOString()
     });
   }
@@ -193,7 +205,9 @@ function useEuiTimeWindow(start, end, apply, options) {
     if (isInvalid || isWindowDurationZero) return;
     apply({
       start: (0, _moment.default)(min).subtract(windowDuration, 'ms').toISOString(),
-      end: (0, _moment.default)(min).toISOString()
+      /* Prevent 1ms drifts for inclusive boundaries by using the exclusive min (- 1ms)
+      as the end of the previous window (e.g. 23:59:59.999 instead of 00:00:00.000) */
+      end: (isInclusiveBoundary ? (0, _moment.default)(min).subtract(1, 'ms') : (0, _moment.default)(min)).toISOString()
     });
   }
   function expandWindow() {

package/lib/components/flyout/_flyout_overlay.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.EuiFlyoutOverlay = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _css = require("@emotion/css");
+var _services = require("../../services");
 var _overlay_mask = require("../overlay_mask");
 var _portal = require("../portal");
 var _react2 = require("@emotion/react");
@@ -23,8 +24,7 @@ var getEuiFlyoutOverlayStyles = function getEuiFlyoutOverlayStyles(zIndex) {
   /*
   This needs to have !important to override the default EuiOverlayMask
   z-index based on the headerZindexLocation prop. Using the style attribute
-  doesn't work since EuiOverlayMask requires a string style prop that
-  causes React errors in the test environment.
+  doesn't work since EuiOverlayMask requires the styles to be provided via className
   */
   return /*#__PURE__*/(0, _css.css)("z-index:", zIndex, "!important;;label:getEuiFlyoutOverlayStyles;");
 };
@@ -45,10 +45,39 @@ var EuiFlyoutOverlay = exports.EuiFlyoutOverlay = function EuiFlyoutOverlay(_ref
     hasOverlayMask = _ref.hasOverlayMask,
     maskZIndex = _ref.maskZIndex,
     _ref$headerZindexLoca = _ref.headerZindexLocation,
-    headerZindexLocation = _ref$headerZindexLoca === void 0 ? 'below' : _ref$headerZindexLoca;
+    headerZindexLocation = _ref$headerZindexLoca === void 0 ? 'below' : _ref$headerZindexLoca,
+    containerRect = _ref.containerRect;
   var styles = (0, _react.useMemo)(function () {
     return getEuiFlyoutOverlayStyles(maskZIndex);
   }, [maskZIndex]);
+
+  // Internal ref so we can apply containerRect positioning directly on the DOM
+  // node, avoiding new Emotion CSS class generation on every scroll/resize.
+  var internalMaskRef = (0, _react.useRef)(null);
+  var combinedMaskRef = (0, _services.useCombinedRefs)([internalMaskRef, maskProps === null || maskProps === void 0 ? void 0 : maskProps.maskRef]);
+  (0, _react.useEffect)(function () {
+    var node = internalMaskRef.current;
+    if (!node) return;
+
+    //  containerRect positioning must be applied via node.style.setProperty rather than
+    //  through the style prop - EuiOverlayMask requires styles to be passed via className
+    if (containerRect) {
+      node.style.setProperty('inset-block-start', "".concat(containerRect.top, "px"));
+      node.style.setProperty('inset-inline-start', "".concat(containerRect.left, "px"));
+      node.style.setProperty('inline-size', "".concat(containerRect.width, "px"));
+      node.style.setProperty('block-size', "".concat(containerRect.height, "px"));
+      node.style.setProperty('inset-inline-end', 'auto');
+      node.style.setProperty('inset-block-end', 'auto');
+    } else {
+      node.style.removeProperty('inset-block-start');
+      node.style.removeProperty('inset-inline-start');
+      node.style.removeProperty('inline-size');
+      node.style.removeProperty('block-size');
+      node.style.removeProperty('inset-inline-end');
+      node.style.removeProperty('inset-block-end');
+    }
+  }, [containerRect, hasOverlayMask]); // toggling ownFocus while the flyout is already open should cause re-render
+
   var content = children;
   if (!isPushed || hasOverlayMask) {
     content = (0, _react2.jsx)(_portal.EuiPortal, null, content);
@@ -57,6 +86,7 @@ var EuiFlyoutOverlay = exports.EuiFlyoutOverlay = function EuiFlyoutOverlay(_ref
   return (0, _react2.jsx)(_react.default.Fragment, null, hasOverlayMask && (0, _react2.jsx)(_overlay_mask.EuiOverlayMask, _extends({
     headerZindexLocation: (_maskProps$headerZind = maskProps === null || maskProps === void 0 ? void 0 : maskProps.headerZindexLocation) !== null && _maskProps$headerZind !== void 0 ? _maskProps$headerZind : headerZindexLocation
   }, maskProps, {
+    maskRef: combinedMaskRef,
     className: classes
   })), content);
 };

package/lib/components/flyout/const.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.FLYOUT_TYPES = exports.FLYOUT_SIZES = exports.FLYOUT_SIDES = exports.FLYOUT_PADDING_SIZES = exports.DEFAULT_TYPE = exports.DEFAULT_SIZE = exports.DEFAULT_SIDE = exports.DEFAULT_PUSH_MIN_BREAKPOINT = exports.DEFAULT_PADDING_SIZE = void 0;
+exports.MENU_DISPLAY_AUTO = exports.MENU_DISPLAY_ALWAYS = exports.FLYOUT_TYPES = exports.FLYOUT_SIZES = exports.FLYOUT_SIDES = exports.FLYOUT_PADDING_SIZES = exports.FLYOUT_MENU_DISPLAY_MODES = exports.DEFAULT_TYPE = exports.DEFAULT_SIZE = exports.DEFAULT_SIDE = exports.DEFAULT_PUSH_MIN_BREAKPOINT = exports.DEFAULT_PADDING_SIZE = exports.DEFAULT_MENU_DISPLAY_MODE = void 0;
 exports.isEuiFlyoutSizeNamed = isEuiFlyoutSizeNamed;
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
@@ -25,6 +25,14 @@ var FLYOUT_SIDES = exports.FLYOUT_SIDES = ['left', 'right'];
 var FLYOUT_SIZES = exports.FLYOUT_SIZES = ['s', 'm', 'l', 'fill'];
 /** Type representing a supported named flyout size. */
 
+/** Menu display mode: always render menu when flyoutMenuProps is provided. */
+var MENU_DISPLAY_ALWAYS = exports.MENU_DISPLAY_ALWAYS = 'always';
+/** Menu display mode: only render menu when it has content (back button, history, title, or custom actions). */
+var MENU_DISPLAY_AUTO = exports.MENU_DISPLAY_AUTO = 'auto';
+/** Allowed flyout menu display modes. */
+var FLYOUT_MENU_DISPLAY_MODES = exports.FLYOUT_MENU_DISPLAY_MODES = [MENU_DISPLAY_ALWAYS, MENU_DISPLAY_AUTO];
+/** Type representing a supported flyout menu display mode. */
+
 /** Allowed padding sizes for flyout content. */
 var FLYOUT_PADDING_SIZES = exports.FLYOUT_PADDING_SIZES = ['none', 's', 'm', 'l'];
 /** Type representing a supported flyout padding size. */
@@ -39,6 +47,8 @@ var DEFAULT_SIDE = exports.DEFAULT_SIDE = 'right';
 var DEFAULT_SIZE = exports.DEFAULT_SIZE = 'm';
 /** Default padding size inside flyouts. */
 var DEFAULT_PADDING_SIZE = exports.DEFAULT_PADDING_SIZE = 'l';
+/** Default flyout menu display mode. */
+var DEFAULT_MENU_DISPLAY_MODE = exports.DEFAULT_MENU_DISPLAY_MODE = MENU_DISPLAY_AUTO;
 
 /**
  * Custom type checker for named flyout sizes since the prop

package/lib/components/flyout/flyout.component.js

@@ -25,9 +25,9 @@ var _flyout_resize_button = require("./_flyout_resize_button");
 var _use_flyout_resizable = require("./use_flyout_resizable");
 var _use_flyout_z_index = require("./use_flyout_z_index");
 var _flyout_parent_context = require("./flyout_parent_context");
+var _use_flyout_menu = require("./use_flyout_menu");
 var _react2 = require("@emotion/react");
-var _excluded = ["className", "children", "as", "hideCloseButton", "flyoutMenuProps", "closeButtonProps", "closeButtonPosition", "onClose", "ownFocus", "side", "size", "paddingSize", "maxWidth", "style", "hasChildBackground", "maskProps", "type", "outsideClickCloses", "pushMinBreakpoint", "pushAnimation", "focusTrapProps", "includeFixedHeadersInFocusTrap", "includeSelectorInFocusTrap", "aria-describedby", "aria-labelledby", "id", "resizable", "minWidth", "onResize", "onAnimationEnd", "container"],
-  _excluded2 = ["titleId"];
+var _excluded = ["className", "children", "as", "hideCloseButton", "flyoutMenuProps", "flyoutMenuDisplayMode", "closeButtonProps", "closeButtonPosition", "onClose", "ownFocus", "side", "size", "paddingSize", "maxWidth", "style", "hasChildBackground", "maskProps", "type", "outsideClickCloses", "pushMinBreakpoint", "pushAnimation", "hasAnimation", "focusTrapProps", "includeFixedHeadersInFocusTrap", "includeSelectorInFocusTrap", "aria-describedby", "aria-labelledby", "id", "resizable", "minWidth", "onResize", "onAnimationEnd", "container"];
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -82,31 +82,33 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
     _usePropsWithComponen2 = _usePropsWithComponen.hideCloseButton,
     hideCloseButton = _usePropsWithComponen2 === void 0 ? false : _usePropsWithComponen2,
     _flyoutMenuProps = _usePropsWithComponen.flyoutMenuProps,
+    _usePropsWithComponen3 = _usePropsWithComponen.flyoutMenuDisplayMode,
+    flyoutMenuDisplayMode = _usePropsWithComponen3 === void 0 ? _const2.DEFAULT_MENU_DISPLAY_MODE : _usePropsWithComponen3,
     closeButtonProps = _usePropsWithComponen.closeButtonProps,
-    _usePropsWithComponen3 = _usePropsWithComponen.closeButtonPosition,
-    closeButtonPosition = _usePropsWithComponen3 === void 0 ? 'inside' : _usePropsWithComponen3,
+    _usePropsWithComponen4 = _usePropsWithComponen.closeButtonPosition,
+    closeButtonPosition = _usePropsWithComponen4 === void 0 ? 'inside' : _usePropsWithComponen4,
     onClose = _usePropsWithComponen.onClose,
-    _usePropsWithComponen4 = _usePropsWithComponen.ownFocus,
-    ownFocus = _usePropsWithComponen4 === void 0 ? true : _usePropsWithComponen4,
-    _usePropsWithComponen5 = _usePropsWithComponen.side,
-    side = _usePropsWithComponen5 === void 0 ? _const2.DEFAULT_SIDE : _usePropsWithComponen5,
-    _usePropsWithComponen6 = _usePropsWithComponen.size,
-    _size = _usePropsWithComponen6 === void 0 ? _const2.DEFAULT_SIZE : _usePropsWithComponen6,
-    _usePropsWithComponen7 = _usePropsWithComponen.paddingSize,
-    paddingSize = _usePropsWithComponen7 === void 0 ? _const2.DEFAULT_PADDING_SIZE : _usePropsWithComponen7,
-    _usePropsWithComponen8 = _usePropsWithComponen.maxWidth,
-    maxWidth = _usePropsWithComponen8 === void 0 ? false : _usePropsWithComponen8,
+    _usePropsWithComponen5 = _usePropsWithComponen.ownFocus,
+    ownFocus = _usePropsWithComponen5 === void 0 ? true : _usePropsWithComponen5,
+    _usePropsWithComponen6 = _usePropsWithComponen.side,
+    side = _usePropsWithComponen6 === void 0 ? _const2.DEFAULT_SIDE : _usePropsWithComponen6,
+    _usePropsWithComponen7 = _usePropsWithComponen.size,
+    _size = _usePropsWithComponen7 === void 0 ? _const2.DEFAULT_SIZE : _usePropsWithComponen7,
+    _usePropsWithComponen8 = _usePropsWithComponen.paddingSize,
+    paddingSize = _usePropsWithComponen8 === void 0 ? _const2.DEFAULT_PADDING_SIZE : _usePropsWithComponen8,
+    _usePropsWithComponen9 = _usePropsWithComponen.maxWidth,
+    maxWidth = _usePropsWithComponen9 === void 0 ? false : _usePropsWithComponen9,
     style = _usePropsWithComponen.style,
-    _usePropsWithComponen9 = _usePropsWithComponen.hasChildBackground,
-    hasChildBackground = _usePropsWithComponen9 === void 0 ? false : _usePropsWithComponen9,
+    _usePropsWithComponen10 = _usePropsWithComponen.hasChildBackground,
+    hasChildBackground = _usePropsWithComponen10 === void 0 ? false : _usePropsWithComponen10,
     maskProps = _usePropsWithComponen.maskProps,
-    _usePropsWithComponen10 = _usePropsWithComponen.type,
-    type = _usePropsWithComponen10 === void 0 ? _const2.DEFAULT_TYPE : _usePropsWithComponen10,
+    _usePropsWithComponen11 = _usePropsWithComponen.type,
+    type = _usePropsWithComponen11 === void 0 ? _const2.DEFAULT_TYPE : _usePropsWithComponen11,
     outsideClickCloses = _usePropsWithComponen.outsideClickCloses,
-    _usePropsWithComponen11 = _usePropsWithComponen.pushMinBreakpoint,
-    pushMinBreakpoint = _usePropsWithComponen11 === void 0 ? _const2.DEFAULT_PUSH_MIN_BREAKPOINT : _usePropsWithComponen11,
-    _usePropsWithComponen12 = _usePropsWithComponen.pushAnimation,
-    pushAnimation = _usePropsWithComponen12 === void 0 ? false : _usePropsWithComponen12,
+    _usePropsWithComponen12 = _usePropsWithComponen.pushMinBreakpoint,
+    pushMinBreakpoint = _usePropsWithComponen12 === void 0 ? _const2.DEFAULT_PUSH_MIN_BREAKPOINT : _usePropsWithComponen12,
+    _pushAnimation = _usePropsWithComponen.pushAnimation,
+    _hasAnimation = _usePropsWithComponen.hasAnimation,
     _focusTrapProps = _usePropsWithComponen.focusTrapProps,
     _usePropsWithComponen13 = _usePropsWithComponen.includeFixedHeadersInFocusTrap,
     includeFixedHeadersInFocusTrap = _usePropsWithComponen13 === void 0 ? true : _usePropsWithComponen13,
@@ -122,6 +124,8 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
     containerProp = _usePropsWithComponen.container,
     rest = _objectWithoutProperties(_usePropsWithComponen, _excluded);
   var container = resolveContainer(containerProp);
+  var hasAnimationDefault = type === 'overlay';
+  var hasAnimation = _hasAnimation !== null && _hasAnimation !== void 0 ? _hasAnimation : hasAnimationDefault;
   var _useEuiThemeCSSVariab = (0, _services.useEuiThemeCSSVariables)(),
     setGlobalCSSVariables = _useEuiThemeCSSVariab.setGlobalCSSVariables;
   var Element = as || defaultElement;
@@ -173,6 +177,21 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
   var layoutMode = (_managerState$layoutM = managerState === null || managerState === void 0 ? void 0 : managerState.layoutMode) !== null && _managerState$layoutM !== void 0 ? _managerState$layoutM : _const.LAYOUT_MODE_SIDE_BY_SIDE;
   var isActiveManagedFlyout = (currentSession === null || currentSession === void 0 ? void 0 : currentSession.mainFlyoutId) === flyoutId || (currentSession === null || currentSession === void 0 ? void 0 : currentSession.childFlyoutId) === flyoutId;
   var currentZIndexRef = (0, _react.useRef)((_managerState$current = managerState === null || managerState === void 0 ? void 0 : managerState.currentZIndex) !== null && _managerState$current !== void 0 ? _managerState$current : 0);
+  var _useEuiFlyoutMenu = (0, _use_flyout_menu.useEuiFlyoutMenu)({
+      flyoutMenuProps: _flyoutMenuProps,
+      flyoutMenuDisplayMode: flyoutMenuDisplayMode,
+      ariaLabelledBy: _ariaLabelledBy
+    }),
+    flyoutMenuId = _useEuiFlyoutMenu.flyoutMenuId,
+    flyoutMenuProps = _useEuiFlyoutMenu.flyoutMenuProps,
+    shouldRenderMenu = _useEuiFlyoutMenu.shouldRenderMenu,
+    ariaLabelledBy = _useEuiFlyoutMenu.ariaLabelledBy;
+  (0, _react.useEffect)(function () {
+    if (process.env.NODE_ENV === 'development' && _flyoutMenuProps && 'hideTitle' in _flyoutMenuProps) {
+      console.warn('EuiFlyout: `flyoutMenuProps.hideTitle` is deprecated. Use `EuiFlyoutHeader` for visible titles instead.');
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
 
   // Use a ref to access the latest flyoutManager without triggering effect re-runs
   var flyoutManagerRef = (0, _react.useRef)(flyoutManager);
@@ -527,7 +546,7 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
     return _objectSpread(_objectSpread(_objectSpread({}, style), composedStyles), containerPositionStyles);
   }, [style, size, layoutMode, siblingFlyoutId, siblingFlyoutWidth, maxWidth, flyoutZIndex, containerRect, side, isChildFlyout]);
   var styles = (0, _services.useEuiMemoizedStyles)(_flyout.euiFlyoutStyles);
-  var cssStyles = [styles.euiFlyout, styles.paddingSizes[paddingSize], (0, _const2.isEuiFlyoutSizeNamed)(size) && styles[size], maxWidth === false && styles.noMaxWidth, isPushed ? styles.push.push : styles.overlay.overlay, isPushed ? styles.push[side] : styles.overlay[side], isPushed && !pushAnimation && styles.push.noAnimation, styles[side]];
+  var cssStyles = [styles.euiFlyout, styles.paddingSizes[paddingSize], (0, _const2.isEuiFlyoutSizeNamed)(size) && styles[size], maxWidth === false && styles.noMaxWidth, isPushed ? styles.push.push : styles.overlay.overlay, isPushed ? styles.push[side] : styles.overlay[side], !hasAnimation && styles.noAnimation, styles[side]];
   var classes = (0, _classnames.default)('euiFlyout', isChildFlyout && hasChildBackground && 'euiFlyout--hasChildBackground', className);
   var flyoutToggle = (0, _react.useRef)(document.activeElement);
   var _useState5 = (0, _react.useState)([]),
@@ -621,34 +640,6 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
     })));
   }, [hasOverlayMask, descriptionId, focusTrapShards.length]);
 
-  /*
-   * If the flyout menu is to be rendered, ensure the flyout has aria-labelledby referencing the menu's titleId
-   */
-  var generatedMenuId = (0, _services.useGeneratedHtmlId)();
-  var _ref = _flyoutMenuProps || {},
-    _titleId = _ref.titleId,
-    flyoutMenuProps = _objectWithoutProperties(_ref, _excluded2);
-  var hasMenu = !!_flyoutMenuProps;
-  var flyoutMenuId = (0, _react.useMemo)(function () {
-    if (!hasMenu) return undefined;
-    return _titleId || generatedMenuId;
-  }, [hasMenu, _titleId, generatedMenuId]);
-
-  // If the flyout level is LEVEL_MAIN, the title should be hidden by default
-  var flyoutMenuHideTitle = (0, _react.useMemo)(function () {
-    if (!hasMenu) return undefined;
-    if ((_flyoutMenuProps === null || _flyoutMenuProps === void 0 ? void 0 : _flyoutMenuProps.hideTitle) !== undefined) {
-      return _flyoutMenuProps.hideTitle;
-    }
-    return (currentSession === null || currentSession === void 0 ? void 0 : currentSession.mainFlyoutId) === flyoutId;
-  }, [hasMenu, _flyoutMenuProps, currentSession, flyoutId]);
-  var ariaLabelledBy = (0, _react.useMemo)(function () {
-    if (flyoutMenuId) {
-      return (0, _classnames.default)(flyoutMenuId, _ariaLabelledBy);
-    }
-    return _ariaLabelledBy;
-  }, [flyoutMenuId, _ariaLabelledBy]);
-
   /*
    * Trap focus even when `ownFocus={false}`, otherwise closing
    * the flyout won't return focus to the originating button.
@@ -691,8 +682,10 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
     isPushed: isPushed,
     maskZIndex: maskZIndex,
     headerZindexLocation: effectiveHeaderZindexLocation,
+    containerRect: containerRect,
     maskProps: _objectSpread(_objectSpread({}, maskProps), {}, {
-      maskRef: maskCombinedRefs
+      maskRef: maskCombinedRefs,
+      hasAnimation: hasAnimation
     })
   }, (0, _react2.jsx)(_services.EuiWindowEvent, {
     event: "keydown",
@@ -716,13 +709,12 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
     "aria-labelledby": ariaLabelledBy,
     "data-autofocus": !isPushed || undefined,
     onAnimationEnd: onAnimationEnd
-  }), !isPushed && screenReaderDescription, !_flyoutMenuProps && !hideCloseButton && (0, _react2.jsx)(_flyout_close_button.EuiFlyoutCloseButton, _extends({}, closeButtonProps, {
+  }), !isPushed && screenReaderDescription, shouldRenderMenu ? (0, _react2.jsx)(_flyout_menu.EuiFlyoutMenu, _extends({}, flyoutMenuProps, {
+    titleId: flyoutMenuId
+  })) : !hideCloseButton && (0, _react2.jsx)(_flyout_close_button.EuiFlyoutCloseButton, _extends({}, closeButtonProps, {
     onClose: handleClose,
     closeButtonPosition: closeButtonPosition,
     side: side
-  })), _flyoutMenuProps && (0, _react2.jsx)(_flyout_menu.EuiFlyoutMenu, _extends({}, flyoutMenuProps, {
-    hideTitle: flyoutMenuHideTitle,
-    titleId: flyoutMenuId
   })), resizable && (0, _react2.jsx)(_flyout_resize_button.EuiFlyoutResizeButton, {
     type: type,
     side: side,

package/lib/components/flyout/flyout.js

@@ -5,6 +5,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.EuiFlyout = void 0;
+Object.defineProperty(exports, "FLYOUT_MENU_DISPLAY_MODES", {
+  enumerable: true,
+  get: function get() {
+    return _const2.FLYOUT_MENU_DISPLAY_MODES;
+  }
+});
 Object.defineProperty(exports, "FLYOUT_PADDING_SIZES", {
   enumerable: true,
   get: function get() {
@@ -39,7 +45,7 @@ var _flyout_parent_context = require("./flyout_parent_context");
 var _const = require("./manager/const");
 var _react2 = require("@emotion/react");
 var _const2 = require("./const");
-var _excluded = ["as", "onClose", "onActive", "session"];
+var _excluded = ["as", "onClose", "onActive", "session", "historyKey"];
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -59,6 +65,7 @@ var EuiFlyout = exports.EuiFlyout = /*#__PURE__*/(0, _react.forwardRef)(function
     onClose = _usePropsWithComponen.onClose,
     onActive = _usePropsWithComponen.onActive,
     session = _usePropsWithComponen.session,
+    historyKey = _usePropsWithComponen.historyKey,
     rest = _objectWithoutProperties(_usePropsWithComponen, _excluded);
   var hasActiveSession = (0, _manager.useHasActiveSession)();
   var isInsideParentFlyout = (0, _flyout_parent_context.useIsInsideParentFlyout)();
@@ -85,6 +92,7 @@ var EuiFlyout = exports.EuiFlyout = /*#__PURE__*/(0, _react.forwardRef)(function
         return null;
       }
       return (0, _react2.jsx)(_manager.EuiFlyoutMain, _extends({}, rest, {
+        historyKey: historyKey,
         onClose: onClose,
         onActive: onActive,
         as: "div",
@@ -95,6 +103,7 @@ var EuiFlyout = exports.EuiFlyout = /*#__PURE__*/(0, _react.forwardRef)(function
     // session=inherit: auto-join existing session as child
     if (hasActiveSession && effectiveSession === _const.SESSION_INHERIT) {
       return (0, _react2.jsx)(_manager.EuiFlyoutChild, _extends({}, rest, {
+        historyKey: historyKey,
         onClose: onClose,
         onActive: onActive,
         as: "div",
@@ -128,6 +137,11 @@ EuiFlyout.propTypes = {
      * @default undefined (auto-inherit when nested, otherwise 'never')
      */
   session: _propTypes.default.oneOfType([_propTypes.default.any.isRequired, _propTypes.default.any.isRequired, _propTypes.default.any.isRequired]),
+  /**
+     * Optional Symbol to scope flyout history. Only flyouts that receive the same Symbol reference share Back button and history; omit to get a unique group per session.
+     * @default undefined (each session gets a unique key and does not share history)
+     */
+  historyKey: _propTypes.default.any,
   /**
      * Callback fired when the flyout becomes active/visible, which may happen programmatically from history navigation.
      */