@elastic/eui 113.3.0 → 114.1.0

package/optimize/es/components/tree_view/tree_view_item.styles.js

@@ -26,7 +26,7 @@ export var euiTreeViewItemStyles = function euiTreeViewItemStyles(euiThemeContex
       euiTreeView__node: _ref,
       default: /*#__PURE__*/css(logicalCSS('max-height', defaultSize), " line-height:", defaultSize, ";;label:default;"),
       compressed: /*#__PURE__*/css(logicalCSS('max-height', compressedSize), " line-height:", compressedSize, ";;label:compressed;"),
-      expanded: /*#__PURE__*/css(logicalCSS('max-height', '100vh'), ";;label:expanded;")
+      expanded: /*#__PURE__*/css(logicalCSS('max-height', 'none'), ";;label:expanded;")
     },
     button: {
       euiTreeView__nodeInner: /*#__PURE__*/css(logicalCSS('width', '100%'), " ", logicalCSS('padding-left', euiTheme.size.s), " ", logicalCSS('padding-right', euiTheme.size.xxs), " display:flex;align-items:center;&:focus{", euiFocusRing(euiThemeContext, 'inset'), ";}&:hover,&:active,&:focus{background-color:", euiTheme.components.treeViewItemBackgroundHover, ";};label:euiTreeView__nodeInner;"),

package/optimize/es/services/hooks/index.js

@@ -6,12 +6,12 @@
  * Side Public License, v 1.
  */
 
-export * from './useDependentState';
-export * from './useCombinedRefs';
-export * from './useForceRender';
-export * from './useLatest';
-export * from './useDeepEqual';
-export * from './useMouseMove';
-export * from './useIsPointerDown';
-export * from './useUpdateEffect';
+export { useDependentState } from './useDependentState';
+export { useCombinedRefs, setMultipleRefs } from './useCombinedRefs';
+export { useForceRender } from './useForceRender';
+export { useLatest } from './useLatest';
+export { useDeepEqual } from './useDeepEqual';
+export { isMouseEvent, useMouseMove } from './useMouseMove';
+export { useIsPointerDown } from './useIsPointerDown';
+export { useUpdateEffect } from './useUpdateEffect';
 export { useEuiDisabledElement } from './useEuiDisabledElement';

package/optimize/es/services/hooks/useIsPointerDown.js

@@ -1,4 +1,3 @@
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -7,30 +6,27 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
  * Side Public License, v 1.
  */
 
-import { useState, useEffect } from 'react';
+import { useRef, useEffect } from 'react';
 
 /**
  * A hook that tracks whether the pointer is currently down/pressed.
  * Useful for detecting text selection in progress.
  */
 export function useIsPointerDown(container) {
-  var _useState = useState(false),
-    _useState2 = _slicedToArray(_useState, 2),
-    isPointerDown = _useState2[0],
-    setIsPointerDown = _useState2[1];
+  var isPointerDownRef = useRef(false);
   useEffect(function () {
     var handlePointerDown = function handlePointerDown(event) {
       if (container !== null && container !== void 0 && container.current && !container.current.contains(event.target)) {
         return;
       }
-      setIsPointerDown(true);
+      isPointerDownRef.current = true;
     };
     var handlePointerUpOrCancel = function handlePointerUpOrCancel() {
-      setIsPointerDown(false);
+      isPointerDownRef.current = false;
     };
     var handleVisibilityChange = function handleVisibilityChange() {
       if (document.visibilityState === 'hidden') {
-        setIsPointerDown(false);
+        isPointerDownRef.current = false;
       }
     };
     var controller = new AbortController();
@@ -48,5 +44,5 @@ export function useIsPointerDown(container) {
       controller.abort();
     };
   }, [container]);
-  return isPointerDown;
+  return isPointerDownRef;
 }

package/optimize/es/services/index.js

@@ -22,7 +22,7 @@ export * from './emotion';
 export * from './findElement';
 export { focusTrapPubSub } from './focus_trap';
 export { dateFormatAliases, formatAuto, formatBoolean, formatDate, formatNumber, formatText } from './format';
-export * from './hooks';
+export { useDependentState, useCombinedRefs, setMultipleRefs, useForceRender, useLatest, useDeepEqual, isMouseEvent, useMouseMove, useUpdateEffect, useEuiDisabledElement } from './hooks';
 export { isEvenlyDivisibleBy, isWithinRange } from './number';
 export { Pager } from './paging';
 export { calculatePopoverPosition, findPopoverPosition } from './popover';

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

@@ -95,9 +95,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 = (0, _slicedToArray2.default)(_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 = (0, _slicedToArray2.default)(_useEuiI18n, 9),
     popoverLabel = _useEuiI18n2[0],
     colorLabel = _useEuiI18n2[1],
     selectedColorLabel = _useEuiI18n2[2],
@@ -105,7 +108,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 () {
@@ -434,10 +446,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/optimize/lib/components/datagrid/utils/scrolling.js

@@ -10,6 +10,7 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 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");
@@ -37,20 +38,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/optimize/lib/components/flyout/_flyout_overlay.js

@@ -9,6 +9,7 @@ exports.EuiFlyoutOverlay = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 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");
@@ -26,8 +27,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;");
 };
@@ -48,10 +48,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);
@@ -60,6 +89,7 @@ var EuiFlyoutOverlay = exports.EuiFlyoutOverlay = function EuiFlyoutOverlay(_ref
   return (0, _react2.jsx)(_react.default.Fragment, null, hasOverlayMask && (0, _react2.jsx)(_overlay_mask.EuiOverlayMask, (0, _extends2.default)({
     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/optimize/lib/components/flyout/flyout.component.js

@@ -33,7 +33,7 @@ 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", "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"];
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -96,23 +96,25 @@ var EuiFlyoutComponent = exports.EuiFlyoutComponent = /*#__PURE__*/(0, _react.fo
     outsideClickCloses = _usePropsWithComponen.outsideClickCloses,
     _usePropsWithComponen12 = _usePropsWithComponen.pushMinBreakpoint,
     pushMinBreakpoint = _usePropsWithComponen12 === void 0 ? _const2.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 = (0, _objectWithoutProperties2.default)(_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;
@@ -533,7 +535,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)([]),
@@ -669,8 +671,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",

package/optimize/lib/components/flyout/flyout.js

@@ -47,7 +47,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
@@ -63,6 +63,7 @@ var EuiFlyout = exports.EuiFlyout = /*#__PURE__*/(0, _react.forwardRef)(function
     onClose = _usePropsWithComponen.onClose,
     onActive = _usePropsWithComponen.onActive,
     session = _usePropsWithComponen.session,
+    historyKey = _usePropsWithComponen.historyKey,
     rest = (0, _objectWithoutProperties2.default)(_usePropsWithComponen, _excluded);
   var hasActiveSession = (0, _manager.useHasActiveSession)();
   var isInsideParentFlyout = (0, _flyout_parent_context.useIsInsideParentFlyout)();
@@ -89,6 +90,7 @@ var EuiFlyout = exports.EuiFlyout = /*#__PURE__*/(0, _react.forwardRef)(function
         return null;
       }
       return (0, _react2.jsx)(_manager.EuiFlyoutMain, (0, _extends2.default)({}, rest, {
+        historyKey: historyKey,
         onClose: onClose,
         onActive: onActive,
         as: "div",
@@ -99,6 +101,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, (0, _extends2.default)({}, rest, {
+        historyKey: historyKey,
         onClose: onClose,
         onActive: onActive,
         as: "div",

package/optimize/lib/components/flyout/flyout.styles.js

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

package/optimize/lib/components/flyout/flyout_menu.js

@@ -22,7 +22,7 @@ var _flyout_menu = require("./flyout_menu.styles");
 var _flyout_menu_context = require("./flyout_menu_context");
 var _i18n = require("../i18n");
 var _react2 = require("@emotion/react");
-var _excluded = ["className", "title", "titleId", "hideTitle", "hideCloseButton", "historyItems", "showBackButton", "backButtonProps", "customActions"];
+var _excluded = ["className", "title", "titleId", "hideTitle", "hideCloseButton", "historyItems", "showBackButton", "backButtonProps", "customActions", "iconType"];
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -113,6 +113,7 @@ var EuiFlyoutMenu = exports.EuiFlyoutMenu = function EuiFlyoutMenu(_ref2) {
     showBackButton = _ref2.showBackButton,
     backButtonProps = _ref2.backButtonProps,
     customActions = _ref2.customActions,
+    _iconType = _ref2.iconType,
     rest = (0, _objectWithoutProperties2.default)(_ref2, _excluded);
   var _useContext = (0, _react.useContext)(_flyout_menu_context.EuiFlyoutMenuContext),
     onClose = _useContext.onClose;

package/optimize/lib/components/flyout/manager/actions.js

@@ -75,19 +75,22 @@ var ACTION_CLOSE_UNMANAGED_FLYOUT = exports.ACTION_CLOSE_UNMANAGED_FLYOUT = "".c
  * - `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.
  */
 var addFlyout = exports.addFlyout = function addFlyout(flyoutId, title) {
   var level = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : _const.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/optimize/lib/components/flyout/manager/activity_stage.js

@@ -16,6 +16,24 @@ var _provider = require("./provider");
  * Side Public License, v 1.
  */
 
+/**
+ * Returns the final stage after an animation completes.
+ * OPENING/RETURNING -> ACTIVE; CLOSING -> INACTIVE; BACKGROUNDING -> BACKGROUNDED.
+ */
+var getNextStage = function getNextStage(stage) {
+  switch (stage) {
+    case _const.STAGE_OPENING:
+    case _const.STAGE_RETURNING:
+      return _const.STAGE_ACTIVE;
+    case _const.STAGE_CLOSING:
+      return _const.STAGE_INACTIVE;
+    case _const.STAGE_BACKGROUNDING:
+      return _const.STAGE_BACKGROUNDED;
+    default:
+      return null;
+  }
+};
+
 /**
  * Encapsulates all activity-stage transitions and animation-driven updates
  * for managed flyouts.
@@ -27,7 +45,9 @@ var _provider = require("./provider");
 var useFlyoutActivityStage = exports.useFlyoutActivityStage = function useFlyoutActivityStage(_ref) {
   var _sessions, _state$sessions$find, _state$layoutMode, _state$flyouts$find;
   var flyoutId = _ref.flyoutId,
-    level = _ref.level;
+    level = _ref.level,
+    _ref$shouldAnimate = _ref.shouldAnimate,
+    shouldAnimate = _ref$shouldAnimate === void 0 ? false : _ref$shouldAnimate;
   var ctx = (0, _provider.useFlyoutManager)();
   var state = ctx === null || ctx === void 0 ? void 0 : ctx.state;
 
@@ -47,64 +67,46 @@ var useFlyoutActivityStage = exports.useFlyoutActivityStage = function useFlyout
   if (stageRef.current !== stage) {
     stageRef.current = stage;
   }
+  var transitionTo = (0, _react.useCallback)(function (nextStage) {
+    var _ctx$dispatch;
+    ctx === null || ctx === void 0 || (_ctx$dispatch = ctx.dispatch) === null || _ctx$dispatch === void 0 || _ctx$dispatch.call(ctx, (0, _actions.setActivityStage)(flyoutId, nextStage));
+    stageRef.current = nextStage;
+  }, [ctx, flyoutId]);
 
   /**
-   * 1. ACTIVE -> CLOSING when no longer the active flyout.
-   * 2. INACTIVE -> RETURNING when it becomes active again (e.g., reopened or brought forward).
-   * 3. (Main flyout only) ACTIVE + stacked + has child -> BACKGROUNDING (begin background animation).
-   * 4. (Main only) BACKGROUNDED/BACKGROUNDING + (child gone OR side-by-side) -> RETURNING (bring main to foreground).
-   *
-   * Any stages that depend on animation end (OPENING, RETURNING, CLOSING, BACKGROUNDING) are finalized in `onAnimationEnd`.
+   * 1. ACTIVE -> CLOSING (or INACTIVE when !shouldAnimate) when no longer the active flyout.
+   * 2. INACTIVE -> RETURNING (or ACTIVE when !shouldAnimate) when it becomes active again.
+   * 3. (Main only) ACTIVE + stacked + has child -> BACKGROUNDING (or BACKGROUNDED when !shouldAnimate).
+   * 4. (Main only) BACKGROUNDED/BACKGROUNDING + (child gone OR side-by-side) -> RETURNING (or ACTIVE when !shouldAnimate).
    */
   (0, _react.useEffect)(function () {
     var s = stageRef.current;
     var next = null;
-    if (s === _const.STAGE_ACTIVE && !isActive) next = _const.STAGE_CLOSING;else if (s === _const.STAGE_INACTIVE && isActive) {
-      next = _const.STAGE_RETURNING;
-    } else if (level === _const.LEVEL_MAIN && isActive && s === _const.STAGE_ACTIVE && hasChild && layoutMode === _const.LAYOUT_MODE_STACKED) next = _const.STAGE_BACKGROUNDING;else if (level === _const.LEVEL_MAIN && (s === _const.STAGE_BACKGROUNDED || s === _const.STAGE_BACKGROUNDING) && (!hasChild || layoutMode === _const.LAYOUT_MODE_SIDE_BY_SIDE)) next = _const.STAGE_RETURNING;
-    if (next && next !== s) {
-      var _ctx$dispatch;
-      ctx === null || ctx === void 0 || (_ctx$dispatch = ctx.dispatch) === null || _ctx$dispatch === void 0 || _ctx$dispatch.call(ctx, (0, _actions.setActivityStage)(flyoutId, next));
-      stageRef.current = next;
+    if (s === _const.STAGE_ACTIVE && !isActive) {
+      next = shouldAnimate ? _const.STAGE_CLOSING : _const.STAGE_INACTIVE;
+    } else if (s === _const.STAGE_INACTIVE && isActive) {
+      next = shouldAnimate ? _const.STAGE_RETURNING : _const.STAGE_ACTIVE;
+    } else if (level === _const.LEVEL_MAIN && isActive && s === _const.STAGE_ACTIVE && hasChild && layoutMode === _const.LAYOUT_MODE_STACKED) {
+      next = shouldAnimate ? _const.STAGE_BACKGROUNDING : _const.STAGE_BACKGROUNDED;
+    } else if (level === _const.LEVEL_MAIN && (s === _const.STAGE_BACKGROUNDED || s === _const.STAGE_BACKGROUNDING) && (!hasChild || layoutMode === _const.LAYOUT_MODE_SIDE_BY_SIDE)) {
+      next = shouldAnimate ? _const.STAGE_RETURNING : _const.STAGE_ACTIVE;
     }
-  }, [isActive, hasChild, layoutMode, level, ctx, flyoutId, stage]);
-
-  /**
-   * Get the stage to transition to for given current stage.
-   * Returns `null` if stage should remain unchanged.
-   *
-   * Stage transitions:
-   *  - OPENING / RETURNING -> ACTIVE
-   *  - CLOSING -> INACTIVE
-   *  - BACKGROUNDING -> BACKGROUNDED
-   */
-  var getNextStage = function getNextStage(stage) {
-    switch (stage) {
-      case _const.STAGE_OPENING:
-      case _const.STAGE_RETURNING:
-        return _const.STAGE_ACTIVE;
-      case _const.STAGE_CLOSING:
-        return _const.STAGE_INACTIVE;
-      case _const.STAGE_BACKGROUNDING:
-        return _const.STAGE_BACKGROUNDED;
+    if (next && next !== s) {
+      transitionTo(next);
     }
-    return null;
-  };
+  }, [isActive, hasChild, layoutMode, level, shouldAnimate, transitionTo, stage]);
 
   /**
-   * onAnimationEnd event handler that must be passed to EuiFlyout.
-   * It handles transitions between stages and updates activity stage
-   * in EuiFlyoutManagerContext.
+   * onAnimationEnd: browser signal when a CSS animation completes.
+   * Calls transitionTo to move to the final stage (e.g. CLOSING -> INACTIVE).
    */
   var onAnimationEnd = (0, _react.useCallback)(function () {
     var currentStage = stageRef.current;
     var nextStage = getNextStage(currentStage);
     if (nextStage && nextStage !== currentStage) {
-      var _ctx$dispatch2;
-      ctx === null || ctx === void 0 || (_ctx$dispatch2 = ctx.dispatch) === null || _ctx$dispatch2 === void 0 || _ctx$dispatch2.call(ctx, (0, _actions.setActivityStage)(flyoutId, nextStage));
-      stageRef.current = nextStage;
+      transitionTo(nextStage);
     }
-  }, [ctx, flyoutId]);
+  }, [transitionTo]);
   return {
     activityStage: stage,
     onAnimationEnd: onAnimationEnd