@elastic/eui 113.3.0 → 114.0.0

package/es/components/button/split_button/split_button.js

@@ -97,6 +97,19 @@ _EuiSplitButton.propTypes = {
   "aria-label": PropTypes.string,
   "data-test-subj": PropTypes.string,
   css: PropTypes.any,
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
+  isDisabled: PropTypes.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.bool,
   size: PropTypes.any,
   color: PropTypes.any,
   fill: PropTypes.bool,

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

@@ -61,6 +61,19 @@ export var EuiSplitButtonActionPrimary = function EuiSplitButtonActionPrimary(_r
   return tooltipProps ? ___EmotionJSX(EuiToolTip, tooltipProps, button) : button;
 };
 EuiSplitButtonActionPrimary.propTypes = {
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
+  isDisabled: PropTypes.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.bool,
   /**
      * Enables rendering an `EuiToolTip` with the passed props.
      */
@@ -103,6 +116,8 @@ export var EuiSplitButtonActionSecondary = function EuiSplitButtonActionSecondar
   })) : action;
 };
 EuiSplitButtonActionSecondary.propTypes = {
+  isDisabled: PropTypes.bool,
+  hasAriaDisabled: PropTypes.bool,
   /**
      * Enables rendering an `EuiToolTip` with the passed props.
      */

package/es/components/collapsible_nav/collapsible_nav.js

@@ -130,6 +130,11 @@ EuiCollapsibleNav.propTypes = {
      * @default undefined (auto-inherit when nested, otherwise 'never')
      */
   session: PropTypes.oneOfType([PropTypes.any.isRequired, PropTypes.any.isRequired, PropTypes.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.any,
   /**
      * Callback fired when the flyout becomes active/visible, which may happen programmatically from history navigation.
      */

package/es/components/color_picker/color_picker.js

@@ -21,7 +21,7 @@ import PropTypes from "prop-types";
 import React, { cloneElement, useEffect, useMemo, useRef, useState } from 'react';
 import classNames from 'classnames';
 import chroma from 'chroma-js';
-import { useEuiMemoizedStyles, keys, useEuiPaletteColorBlind } from '../../services';
+import { useEuiMemoizedStyles, keys, useEuiPaletteColorBlind, useGeneratedHtmlId } from '../../services';
 import { EuiFieldText, EuiFormControlLayout, EuiFormRow, EuiRange } from '../form';
 import { useEuiI18n } from '../i18n';
 import { EuiPopover } from '../popover';
@@ -94,9 +94,12 @@ export var 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 = 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 = 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],
@@ -104,7 +107,16 @@ export var EuiColorPicker = function EuiColorPicker(_ref) {
     transparent = _useEuiI18n2[4],
     alphaLabel = _useEuiI18n2[5],
     openLabel = _useEuiI18n2[6],
-    closeLabel = _useEuiI18n2[7];
+    closeLabel = _useEuiI18n2[7],
+    ariaLabel = _useEuiI18n2[8];
+  var openLabelId = useGeneratedHtmlId({
+    prefix: 'colorPicker',
+    suffix: 'openLabel'
+  });
+  var closeLabelId = useGeneratedHtmlId({
+    prefix: 'colorPicker',
+    suffix: 'closeLabel'
+  });
   var defaultSwatches = useEuiPaletteColorBlind();
   var swatches = _swatches !== null && _swatches !== void 0 ? _swatches : defaultSwatches;
   var preferredFormat = useMemo(function () {
@@ -433,10 +445,21 @@ export var 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": classNames(isColorSelectorShown ? openLabelId : closeLabelId, ariaDescribedby),
       controlOnly: true // Don't need two EuiFormControlwrappers
-    }));
+    }), ___EmotionJSX(EuiScreenReaderOnly, null, ___EmotionJSX("span", null, ___EmotionJSX("span", {
+      id: openLabelId,
+      "aria-hidden": !isColorSelectorShown
+    }, openLabel), ___EmotionJSX("span", {
+      id: closeLabelId,
+      "aria-hidden": isColorSelectorShown
+    }, closeLabel))));
   }
   return display === 'inline' ? ___EmotionJSX("div", {
     css: styles.euiColorPicker,

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

@@ -10,8 +10,9 @@ function _asyncToGenerator(n) { return function () { var t = this, e = arguments
  * Side Public License, v 1.
  */
 
-import React, { useContext, useEffect, useCallback, useMemo } from 'react';
-import { useEuiMemoizedStyles, useIsPointerDown } from '../../../services';
+import React, { useContext, useEffect, useCallback, useMemo, useRef } from 'react';
+import { useEuiMemoizedStyles } from '../../../services';
+import { useIsPointerDown } from '../../../services/hooks';
 import { logicalStyles } from '../../../global_styling';
 import { DataGridCellPopoverContext } from '../body/cell';
 import { DataGridFocusContext } from './focus';
@@ -29,20 +30,48 @@ export var useScroll = function useScroll(args) {
     scrollCellIntoView = _useScrollCellIntoVie.scrollCellIntoView;
   var _useContext = useContext(DataGridFocusContext),
     focusedCell = _useContext.focusedCell;
-  var isPointerDown = useIsPointerDown(args.outerGridRef);
+  var isPointerDownRef = 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 = useRef(false);
+  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]);
   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 = useContext(DataGridCellPopoverContext),
     popoverIsOpen = _useContext2.popoverIsOpen,
     cellLocation = _useContext2.cellLocation;

package/es/components/flyout/_flyout_overlay.js

@@ -7,8 +7,9 @@ function _extends() { return _extends = Object.assign ? Object.assign.bind() : f
  * Side Public License, v 1.
  */
 
-import React, { useMemo } from 'react';
+import React, { useEffect, useMemo, useRef } from 'react';
 import { css, cx } from '@emotion/css';
+import { useCombinedRefs } from '../../services';
 import { EuiOverlayMask } from '../overlay_mask';
 import { EuiPortal } from '../portal';
 import { jsx as ___EmotionJSX } from "@emotion/react";
@@ -16,8 +17,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__*/css("z-index:", zIndex, "!important;;label:getEuiFlyoutOverlayStyles;");
 };
@@ -38,10 +38,39 @@ export var 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 = 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 = useRef(null);
+  var combinedMaskRef = useCombinedRefs([internalMaskRef, maskProps === null || maskProps === void 0 ? void 0 : maskProps.maskRef]);
+  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 = ___EmotionJSX(EuiPortal, null, content);
@@ -50,6 +79,7 @@ export var EuiFlyoutOverlay = function EuiFlyoutOverlay(_ref) {
   return ___EmotionJSX(React.Fragment, null, hasOverlayMask && ___EmotionJSX(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/es/components/flyout/flyout.component.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["className", "children", "as", "hideCloseButton", "flyoutMenuProps", "flyoutMenuDisplayMode", "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"];
+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"];
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -100,23 +100,25 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     outsideClickCloses = _usePropsWithComponen.outsideClickCloses,
     _usePropsWithComponen12 = _usePropsWithComponen.pushMinBreakpoint,
     pushMinBreakpoint = _usePropsWithComponen12 === void 0 ? DEFAULT_PUSH_MIN_BREAKPOINT : _usePropsWithComponen12,
-    _usePropsWithComponen13 = _usePropsWithComponen.pushAnimation,
-    pushAnimation = _usePropsWithComponen13 === void 0 ? false : _usePropsWithComponen13,
+    _pushAnimation = _usePropsWithComponen.pushAnimation,
+    _hasAnimation = _usePropsWithComponen.hasAnimation,
     _focusTrapProps = _usePropsWithComponen.focusTrapProps,
-    _usePropsWithComponen14 = _usePropsWithComponen.includeFixedHeadersInFocusTrap,
-    includeFixedHeadersInFocusTrap = _usePropsWithComponen14 === void 0 ? true : _usePropsWithComponen14,
+    _usePropsWithComponen13 = _usePropsWithComponen.includeFixedHeadersInFocusTrap,
+    includeFixedHeadersInFocusTrap = _usePropsWithComponen13 === void 0 ? true : _usePropsWithComponen13,
     includeSelectorInFocusTrap = _usePropsWithComponen.includeSelectorInFocusTrap,
     _ariaDescribedBy = _usePropsWithComponen['aria-describedby'],
     _ariaLabelledBy = _usePropsWithComponen['aria-labelledby'],
     id = _usePropsWithComponen.id,
-    _usePropsWithComponen15 = _usePropsWithComponen.resizable,
-    resizable = _usePropsWithComponen15 === void 0 ? false : _usePropsWithComponen15,
+    _usePropsWithComponen14 = _usePropsWithComponen.resizable,
+    resizable = _usePropsWithComponen14 === void 0 ? false : _usePropsWithComponen14,
     minWidth = _usePropsWithComponen.minWidth,
     onResize = _usePropsWithComponen.onResize,
     onAnimationEnd = _usePropsWithComponen.onAnimationEnd,
     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 = useEuiThemeCSSVariables(),
     setGlobalCSSVariables = _useEuiThemeCSSVariab.setGlobalCSSVariables;
   var Element = as || defaultElement;
@@ -537,7 +539,7 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     return _objectSpread(_objectSpread(_objectSpread({}, style), composedStyles), containerPositionStyles);
   }, [style, size, layoutMode, siblingFlyoutId, siblingFlyoutWidth, maxWidth, flyoutZIndex, containerRect, side, isChildFlyout]);
   var styles = useEuiMemoizedStyles(euiFlyoutStyles);
-  var cssStyles = [styles.euiFlyout, styles.paddingSizes[paddingSize], 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], 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 = classnames('euiFlyout', isChildFlyout && hasChildBackground && 'euiFlyout--hasChildBackground', className);
   var flyoutToggle = useRef(document.activeElement);
   var _useState5 = useState([]),
@@ -673,8 +675,10 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     isPushed: isPushed,
     maskZIndex: maskZIndex,
     headerZindexLocation: effectiveHeaderZindexLocation,
+    containerRect: containerRect,
     maskProps: _objectSpread(_objectSpread({}, maskProps), {}, {
-      maskRef: maskCombinedRefs
+      maskRef: maskCombinedRefs,
+      hasAnimation: hasAnimation
     })
   }, ___EmotionJSX(EuiWindowEvent, {
     event: "keydown",

package/es/components/flyout/flyout.js

@@ -1,4 +1,4 @@
-var _excluded = ["as", "onClose", "onActive", "session"];
+var _excluded = ["as", "onClose", "onActive", "session", "historyKey"];
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], t.indexOf(o) >= 0 || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.indexOf(n) >= 0) continue; t[n] = r[n]; } return t; }
@@ -26,6 +26,7 @@ export var EuiFlyout = /*#__PURE__*/forwardRef(function (props, ref) {
     onClose = _usePropsWithComponen.onClose,
     onActive = _usePropsWithComponen.onActive,
     session = _usePropsWithComponen.session,
+    historyKey = _usePropsWithComponen.historyKey,
     rest = _objectWithoutProperties(_usePropsWithComponen, _excluded);
   var hasActiveSession = useHasActiveSession();
   var isInsideParentFlyout = useIsInsideParentFlyout();
@@ -52,6 +53,7 @@ export var EuiFlyout = /*#__PURE__*/forwardRef(function (props, ref) {
         return null;
       }
       return ___EmotionJSX(EuiFlyoutMain, _extends({}, rest, {
+        historyKey: historyKey,
         onClose: onClose,
         onActive: onActive,
         as: "div",
@@ -62,6 +64,7 @@ export var EuiFlyout = /*#__PURE__*/forwardRef(function (props, ref) {
     // session=inherit: auto-join existing session as child
     if (hasActiveSession && effectiveSession === SESSION_INHERIT) {
       return ___EmotionJSX(EuiFlyoutChild, _extends({}, rest, {
+        historyKey: historyKey,
         onClose: onClose,
         onActive: onActive,
         as: "div",
@@ -95,6 +98,11 @@ EuiFlyout.propTypes = {
      * @default undefined (auto-inherit when nested, otherwise 'never')
      */
   session: PropTypes.oneOfType([PropTypes.any.isRequired, PropTypes.any.isRequired, PropTypes.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.any,
   /**
      * Callback fired when the flyout becomes active/visible, which may happen programmatically from history navigation.
      */

package/es/components/flyout/flyout.styles.js

@@ -72,9 +72,9 @@ export var euiFlyoutStyles = function euiFlyoutStyles(euiThemeContext) {
     push: {
       push: /*#__PURE__*/css("clip-path:none;z-index:", Number(euiTheme.levels.flyout) - 1, ";;label:push;"),
       right: /*#__PURE__*/css(logicalCSS('border-left', euiTheme.border.thick), ";;label:right;"),
-      left: /*#__PURE__*/css(logicalCSS('border-right', euiTheme.border.thick), ";;label:left;"),
-      noAnimation: _ref
+      left: /*#__PURE__*/css(logicalCSS('border-right', euiTheme.border.thick), ";;label:left;")
     },
+    noAnimation: _ref,
     // Padding
     paddingSizes: {
       none: /*#__PURE__*/css(composeFlyoutPadding(euiThemeContext, 'none'), ";;label:none;"),

package/es/components/flyout/flyout_menu.js

@@ -1,4 +1,4 @@
-var _excluded = ["className", "title", "titleId", "hideTitle", "hideCloseButton", "historyItems", "showBackButton", "backButtonProps", "customActions"];
+var _excluded = ["className", "title", "titleId", "hideTitle", "hideCloseButton", "historyItems", "showBackButton", "backButtonProps", "customActions", "iconType"];
 function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], t.indexOf(o) >= 0 || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.indexOf(n) >= 0) continue; t[n] = r[n]; } return t; }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
@@ -114,6 +114,7 @@ export var EuiFlyoutMenu = function EuiFlyoutMenu(_ref2) {
     showBackButton = _ref2.showBackButton,
     backButtonProps = _ref2.backButtonProps,
     customActions = _ref2.customActions,
+    _iconType = _ref2.iconType,
     rest = _objectWithoutProperties(_ref2, _excluded);
   var _useContext = useContext(EuiFlyoutMenuContext),
     onClose = _useContext.onClose;

package/es/components/flyout/flyout_resizable.js

@@ -36,6 +36,11 @@ EuiFlyoutResizable.propTypes = {
      * @default undefined (auto-inherit when nested, otherwise 'never')
      */
   session: PropTypes.oneOfType([PropTypes.any.isRequired, PropTypes.any.isRequired, PropTypes.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.any,
   /**
      * Callback fired when the flyout becomes active/visible, which may happen programmatically from history navigation.
      */

package/es/components/flyout/manager/actions.js

@@ -69,19 +69,22 @@ export var ACTION_CLOSE_UNMANAGED_FLYOUT = "".concat(PREFIX, "/closeUnmanagedFly
  * - `title` is used for the flyout menu.
  * - `level` determines whether the flyout is `main` or `child`.
  * - Optional `size` is the named EUI size (e.g. `s`, `m`, `l`).
+ * - Optional `historyKey` (Symbol) scopes history; only flyouts with the same reference share Back/history. Omit for a unique group per session.
  * - Optional `iconType` is shown next to the session title in the history menu.
  */
 export var addFlyout = function addFlyout(flyoutId, title) {
   var level = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : LEVEL_MAIN;
   var size = arguments.length > 3 ? arguments[3] : undefined;
-  var iconType = arguments.length > 4 ? arguments[4] : undefined;
-  var minWidth = arguments.length > 5 ? arguments[5] : undefined;
+  var historyKey = arguments.length > 4 ? arguments[4] : undefined;
+  var iconType = arguments.length > 5 ? arguments[5] : undefined;
+  var minWidth = arguments.length > 6 ? arguments[6] : undefined;
   return {
     type: ACTION_ADD,
     flyoutId: flyoutId,
     title: title,
     level: level,
     size: size,
+    historyKey: historyKey,
     iconType: iconType,
     minWidth: minWidth
   };

package/es/components/flyout/manager/flyout_child.js

@@ -89,6 +89,7 @@ export var EuiFlyoutChild = /*#__PURE__*/forwardRef(function (_ref, ref) {
   }));
 });
 EuiFlyoutChild.propTypes = {
+  historyKey: PropTypes.any,
   flyoutMenuProps: PropTypes.shape({
     className: PropTypes.string,
     "aria-label": PropTypes.string,

package/es/components/flyout/manager/flyout_managed.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["id", "onClose", "onActive", "level", "size", "minWidth", "css", "flyoutMenuProps"];
+var _excluded = ["id", "onClose", "onActive", "level", "size", "minWidth", "historyKey", "css", "flyoutMenuProps"];
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
@@ -68,6 +68,7 @@ export var EuiManagedFlyout = /*#__PURE__*/forwardRef(function (_ref, ref) {
     level = _ref.level,
     sizeProp = _ref.size,
     minWidth = _ref.minWidth,
+    historyKey = _ref.historyKey,
     customCss = _ref.css,
     _flyoutMenuProps = _ref.flyoutMenuProps,
     props = _objectWithoutProperties(_ref, _excluded);
@@ -166,7 +167,7 @@ export var EuiManagedFlyout = /*#__PURE__*/forwardRef(function (_ref, ref) {
   // Register with flyout manager context when open, remove when closed
   // Using useLayoutEffect to run synchronously before DOM updates
   useLayoutEffect(function () {
-    addFlyout(flyoutId, title, level, size, _flyoutMenuProps === null || _flyoutMenuProps === void 0 ? void 0 : _flyoutMenuProps.iconType, typeof minWidth === 'number' ? minWidth : undefined);
+    addFlyout(flyoutId, title, level, size, level === LEVEL_MAIN ? historyKey : undefined, _flyoutMenuProps === null || _flyoutMenuProps === void 0 ? void 0 : _flyoutMenuProps.iconType, typeof minWidth === 'number' ? minWidth : undefined);
     return function () {
       var currentStoreState = getFlyoutManagerStore().getState();
       var stillInStore = currentStoreState.flyouts.some(function (f) {
@@ -182,7 +183,7 @@ export var EuiManagedFlyout = /*#__PURE__*/forwardRef(function (_ref, ref) {
       }
       wasRegisteredRef.current = false;
     };
-  }, [flyoutId, title, level, size, minWidth, _flyoutMenuProps === null || _flyoutMenuProps === void 0 ? void 0 : _flyoutMenuProps.iconType, addFlyout, closeFlyout, closeAllFlyouts]);
+  }, [flyoutId, title, level, size, minWidth, historyKey, _flyoutMenuProps === null || _flyoutMenuProps === void 0 ? void 0 : _flyoutMenuProps.iconType, addFlyout, closeFlyout, closeAllFlyouts]);
 
   // Detect when flyout has been removed from manager state (e.g., via Back button)
   // and trigger onClose callback to notify the parent component
@@ -284,6 +285,7 @@ export var EuiManagedFlyout = /*#__PURE__*/forwardRef(function (_ref, ref) {
 });
 EuiManagedFlyout.propTypes = {
   level: PropTypes.oneOfType([PropTypes.any.isRequired, PropTypes.any.isRequired]).isRequired,
+  historyKey: PropTypes.any,
   flyoutMenuProps: PropTypes.shape({
     className: PropTypes.string,
     "aria-label": PropTypes.string,