@elastic/eui 113.1.0 → 113.2.0

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", "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"],
+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"];
 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(); }
@@ -32,8 +32,8 @@ function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t =
 import React, { useEffect, useLayoutEffect, useRef, useMemo, useCallback, useState, forwardRef } from 'react';
 import classnames from 'classnames';
 import { keys, EuiWindowEvent, useCombinedRefs, useEuiMemoizedStyles, useGeneratedHtmlId, useEuiThemeCSSVariables, focusTrapPubSub } from '../../services';
-import { useCurrentSession, useIsInManagedFlyout, useFlyoutLayoutMode, useFlyoutId, useFlyoutWidth, useIsFlyoutActive, useFlyoutManager, useHasPushPadding } from './manager';
-import { LAYOUT_MODE_STACKED } from './manager/const';
+import { useIsInManagedFlyout, useFlyoutId, useFlyoutManager } from './manager';
+import { LAYOUT_MODE_SIDE_BY_SIDE, LAYOUT_MODE_STACKED, LEVEL_MAIN, PROPERTY_LEVEL } from './manager/const';
 import { EuiFocusTrap } from '../focus_trap';
 import { EuiI18n } from '../i18n';
 import { useResizeObserver } from '../observer/resize_observer';
@@ -49,10 +49,25 @@ import { EuiFlyoutResizeButton } from './_flyout_resize_button';
 import { useEuiFlyoutResizable } from './use_flyout_resizable';
 import { useEuiFlyoutZIndex } from './use_flyout_z_index';
 import { EuiFlyoutParentProvider } from './flyout_parent_context';
-import { useCurrentFlyoutZIndexRef } from './manager/selectors';
 import { jsx as ___EmotionJSX } from "@emotion/react";
+/**
+ * Resolves the container prop (element, getter, or selector string) to an
+ * HTMLElement, or null if not found / invalid.
+ */
+var resolveContainer = function resolveContainer(raw) {
+  if (raw == null) return null;
+  if (typeof raw === 'string') {
+    if (typeof document === 'undefined') return null;
+    var el = document.querySelector(raw);
+    return el instanceof HTMLElement ? el : null;
+  }
+  if (typeof raw === 'function') return raw();
+  if (typeof HTMLElement === 'undefined') return null;
+  return raw instanceof HTMLElement ? raw : null;
+};
 var defaultElement = 'div';
 export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
+  var _maskProps$headerZind, _managerSessions, _managerState$layoutM, _managerState$current, _managerState$flyouts, _managerState$pushPad;
   var _usePropsWithComponen = usePropsWithComponentDefaults('EuiFlyout', props),
     className = _usePropsWithComponen.className,
     children = _usePropsWithComponen.children,
@@ -97,7 +112,9 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     minWidth = _usePropsWithComponen.minWidth,
     onResize = _usePropsWithComponen.onResize,
     onAnimationEnd = _usePropsWithComponen.onAnimationEnd,
+    containerProp = _usePropsWithComponen.container,
     rest = _objectWithoutProperties(_usePropsWithComponen, _excluded);
+  var container = resolveContainer(containerProp);
   var _useEuiThemeCSSVariab = useEuiThemeCSSVariables(),
     setGlobalCSSVariables = _useEuiThemeCSSVariab.setGlobalCSSVariables;
   var Element = as || defaultElement;
@@ -109,13 +126,46 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     type: type,
     pushMinBreakpoint: pushMinBreakpoint
   });
-  var currentSession = useCurrentSession();
+  // When no explicit container is provided, push padding targets
+  // document.body and global push-offset CSS vars are set. When a
+  // container is provided, only that element receives padding.
+  var shouldSetGlobalPushVars = container == null;
+  if ('container' in props && ('maskProps' in props || 'includeFixedHeadersInFocusTrap' in props) && process.env.NODE_ENV === 'development') {
+    if ('maskProps' in props) {
+      console.warn('EuiFlyout: `maskProps` is deprecated. Prefer using the `container` prop to scope flyouts.');
+    }
+    if ('includeFixedHeadersInFocusTrap' in props) {
+      console.warn('EuiFlyout: `includeFixedHeadersInFocusTrap` is deprecated. Prefer `includeSelectorInFocusTrap` when using `container`.');
+    }
+  }
+  // Explicit viewport flyouts (container={null}) default to 'above' so
+  // they render above fixed headers. Container-scoped and legacy flyouts
+  // (no container prop) default to 'below'.
+  var effectiveHeaderZindexLocation = (_maskProps$headerZind = maskProps === null || maskProps === void 0 ? void 0 : maskProps.headerZindexLocation) !== null && _maskProps$headerZind !== void 0 ? _maskProps$headerZind : containerProp === null ? 'above' : 'below';
+
+  // Report the container element to the flyout manager for layout calculations.
+  useEffect(function () {
+    var _flyoutManagerRef$cur;
+    if (!container) return;
+    (_flyoutManagerRef$cur = flyoutManagerRef.current) === null || _flyoutManagerRef$cur === void 0 || _flyoutManagerRef$cur.setContainerElement(container);
+    return function () {
+      var _flyoutManagerRef$cur2;
+      if (((_flyoutManagerRef$cur2 = flyoutManagerRef.current) === null || _flyoutManagerRef$cur2 === void 0 || (_flyoutManagerRef$cur2 = _flyoutManagerRef$cur2.state) === null || _flyoutManagerRef$cur2 === void 0 ? void 0 : _flyoutManagerRef$cur2.containerElement) === container) {
+        flyoutManagerRef.current.setContainerElement(null);
+      }
+    };
+  }, [container]);
+
+  // Performance: read context once and derive all manager-dependent values inline.
   var isInManagedContext = useIsInManagedFlyout();
   var flyoutId = useFlyoutId(id);
-  var layoutMode = useFlyoutLayoutMode();
-  var isActiveManagedFlyout = useIsFlyoutActive(flyoutId);
   var flyoutManager = useFlyoutManager();
-  var currentZIndexRef = useCurrentFlyoutZIndexRef();
+  var managerState = flyoutManager === null || flyoutManager === void 0 ? void 0 : flyoutManager.state;
+  var managerSessions = managerState === null || managerState === void 0 ? void 0 : managerState.sessions;
+  var currentSession = managerSessions ? (_managerSessions = managerSessions[managerSessions.length - 1]) !== null && _managerSessions !== void 0 ? _managerSessions : null : null;
+  var layoutMode = (_managerState$layoutM = managerState === null || managerState === void 0 ? void 0 : managerState.layoutMode) !== null && _managerState$layoutM !== void 0 ? _managerState$layoutM : 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 = useRef((_managerState$current = managerState === null || managerState === void 0 ? void 0 : managerState.currentZIndex) !== null && _managerState$current !== void 0 ? _managerState$current : 0);
 
   // Use a ref to access the latest flyoutManager without triggering effect re-runs
   var flyoutManagerRef = useRef(flyoutManager);
@@ -126,106 +176,186 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     // Keep track of unmanaged flyouts to properly calculate z-index
     // values for all flyouts
     if (!isInManagedContext) {
-      var _flyoutManagerRef$cur;
-      (_flyoutManagerRef$cur = flyoutManagerRef.current) === null || _flyoutManagerRef$cur === void 0 || _flyoutManagerRef$cur.addUnmanagedFlyout(flyoutId);
+      var _flyoutManagerRef$cur3;
+      (_flyoutManagerRef$cur3 = flyoutManagerRef.current) === null || _flyoutManagerRef$cur3 === void 0 || _flyoutManagerRef$cur3.addUnmanagedFlyout(flyoutId);
       return function () {
-        var _flyoutManagerRef$cur2;
-        return (_flyoutManagerRef$cur2 = flyoutManagerRef.current) === null || _flyoutManagerRef$cur2 === void 0 ? void 0 : _flyoutManagerRef$cur2.closeUnmanagedFlyout(flyoutId);
+        var _flyoutManagerRef$cur4;
+        return (_flyoutManagerRef$cur4 = flyoutManagerRef.current) === null || _flyoutManagerRef$cur4 === void 0 ? void 0 : _flyoutManagerRef$cur4.closeUnmanagedFlyout(flyoutId);
       };
     }
   }, [isInManagedContext, flyoutId]);
-  var _useEuiFlyoutResizabl = useEuiFlyoutResizable({
-      enabled: resizable,
-      minWidth: minWidth,
-      maxWidth: typeof maxWidth === 'number' ? maxWidth : 0,
-      onResize: onResize,
-      side: side,
-      size: _size
-    }),
-    onMouseDownResizableButton = _useEuiFlyoutResizabl.onMouseDown,
-    onKeyDownResizableButton = _useEuiFlyoutResizabl.onKeyDown,
-    size = _useEuiFlyoutResizabl.size,
-    setFlyoutRef = _useEuiFlyoutResizabl.setFlyoutRef;
 
-  /**
-   * Setting up the refs on the actual flyout element in order to
-   * accommodate for the `isPushed` state by adding padding to the body equal to the width of the element
-   */
-  var _useState = useState(null),
-    _useState2 = _slicedToArray(_useState, 2),
-    resizeRef = _useState2[0],
-    setResizeRef = _useState2[1];
-  var setRef = useCombinedRefs([setResizeRef, ref, internalParentFlyoutRef, setFlyoutRef]);
-  var _useResizeObserver = useResizeObserver(isPushed ? resizeRef : null, 'width'),
-    width = _useResizeObserver.width;
-
-  // Memoize flyout identification and relationships to prevent race conditions
+  // Derive flyout identity and sibling info from the single context read
   var flyoutIdentity = useMemo(function () {
     if (!flyoutId || !currentSession) {
       return {
         isMainFlyout: false,
         siblingFlyoutId: null,
-        hasValidSession: false,
-        sessionForWidth: null
+        hasValidSession: false
       };
     }
     var siblingFlyoutId = currentSession.mainFlyoutId === flyoutId ? currentSession.childFlyoutId : currentSession.mainFlyoutId;
     return {
       isMainFlyout: currentSession.mainFlyoutId === flyoutId,
       siblingFlyoutId: siblingFlyoutId,
-      hasValidSession: true,
-      sessionForWidth: currentSession
+      hasValidSession: true
     };
   }, [flyoutId, currentSession]);
 
   // Destructure for easier use
   var siblingFlyoutId = flyoutIdentity.siblingFlyoutId,
     isMainFlyout = flyoutIdentity.isMainFlyout;
-  var _siblingFlyoutWidth = useFlyoutWidth(siblingFlyoutId);
+
+  // Derive sibling flyout data from manager state (single read, no extra hooks)
+  var siblingFlyout = siblingFlyoutId ? (_managerState$flyouts = managerState === null || managerState === void 0 ? void 0 : managerState.flyouts.find(function (f) {
+    return f.flyoutId === siblingFlyoutId;
+  })) !== null && _managerState$flyouts !== void 0 ? _managerState$flyouts : null : null;
+  var _siblingFlyoutWidth = siblingFlyout === null || siblingFlyout === void 0 ? void 0 : siblingFlyout.width;
+  var isSiblingFill = (siblingFlyout === null || siblingFlyout === void 0 ? void 0 : siblingFlyout.size) === 'fill';
+  var siblingFlyoutMinWidth = siblingFlyout === null || siblingFlyout === void 0 ? void 0 : siblingFlyout.minWidth;
   var siblingFlyoutWidth = layoutMode === LAYOUT_MODE_STACKED ? 0 : _siblingFlyoutWidth;
 
+  // Observe the container's dimensions so the resize hook and
+  // positioning styles stay aligned with its bounding rect.
+  // When no container is provided, these remain inert (null/undefined).
+  var containerDimensions = useResizeObserver(container !== null && container !== void 0 ? container : null, 'width');
+  var containerReferenceWidth = container ? containerDimensions.width || container.clientWidth : undefined;
+
+  // Track the container's bounding rect for positioning the flyout.
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    containerRect = _useState2[0],
+    setContainerRect = _useState2[1];
+  useLayoutEffect(function () {
+    if (!container) {
+      setContainerRect(null);
+      return;
+    }
+    setContainerRect(container.getBoundingClientRect());
+  }, [container, containerDimensions.width]);
+  useEffect(function () {
+    if (!container) return;
+    var updateRect = function updateRect() {
+      var next = container.getBoundingClientRect();
+      setContainerRect(function (prev) {
+        if (prev && prev.top === next.top && prev.left === next.left && prev.width === next.width && prev.height === next.height) {
+          return prev;
+        }
+        return next;
+      });
+    };
+    window.addEventListener('scroll', updateRect, {
+      passive: true
+    });
+    window.addEventListener('resize', updateRect, {
+      passive: true
+    });
+    return function () {
+      window.removeEventListener('scroll', updateRect);
+      window.removeEventListener('resize', updateRect);
+    };
+  }, [container]);
+  // Prefer the manager's reference width when available so resize clamp
+  // uses the same value as layout mode. When we have a container, cap by
+  // its measured width so we never allow resize past the container (e.g. if
+  // manager had viewport fallback or timing mismatch).
+  var managerRefWidth = isInManagedContext && typeof (managerState === null || managerState === void 0 ? void 0 : managerState.referenceWidth) === 'number' && managerState.referenceWidth > 0 ? managerState.referenceWidth : undefined;
+  var effectiveReferenceWidth = containerReferenceWidth != null && containerReferenceWidth > 0 ? managerRefWidth != null ? Math.min(managerRefWidth, containerReferenceWidth) : containerReferenceWidth : managerRefWidth !== null && managerRefWidth !== void 0 ? managerRefWidth : containerReferenceWidth;
+  var _useEuiFlyoutResizabl = useEuiFlyoutResizable({
+      enabled: resizable,
+      minWidth: minWidth,
+      maxWidth: typeof maxWidth === 'number' ? maxWidth : undefined,
+      // For fill siblings, clamp based on their minWidth rather than their
+      // current measured width. Fill siblings dynamically adjust via CSS
+      // (`calc(90% - mainWidth)`), so subtracting their current width from
+      // the max creates a circular dependency where the main flyout can
+      // never grow (max = 90% - (90% - main) = main). Using minWidth
+      // breaks this cycle while ensuring the fill sibling never collapses
+      // below its configured minimum.
+      siblingFlyoutWidth: isSiblingFill ? siblingFlyoutMinWidth : siblingFlyoutWidth !== null && siblingFlyoutWidth !== void 0 ? siblingFlyoutWidth : undefined,
+      referenceWidth: effectiveReferenceWidth,
+      onResize: onResize,
+      side: side,
+      size: _size
+    }),
+    onMouseDownResizableButton = _useEuiFlyoutResizabl.onMouseDown,
+    onKeyDownResizableButton = _useEuiFlyoutResizabl.onKeyDown,
+    size = _useEuiFlyoutResizabl.size,
+    setFlyoutRef = _useEuiFlyoutResizabl.setFlyoutRef;
+
+  // Publish the main flyout's resolved width as a CSS custom property on
+  // the document element so that the child (fill) flyout can track it
+  // synchronously during drag resize, avoiding the 1-frame lag that
+  // results from the async ResizeObserver → manager-state pipeline.
+  useLayoutEffect(function () {
+    if (!isMainFlyout) return;
+
+    // Only set when we have a computed percentage (during active resize)
+    if (typeof size === 'string' && size.endsWith('%')) {
+      document.documentElement.style.setProperty('--euiFlyoutMainWidth', size);
+    }
+    return function () {
+      document.documentElement.style.removeProperty('--euiFlyoutMainWidth');
+    };
+  }, [isMainFlyout, size]);
+
+  /**
+   * Setting up the refs on the actual flyout element in order to
+   * accommodate for the `isPushed` state by adding padding to the body equal to the width of the element
+   */
+  var _useState3 = useState(null),
+    _useState4 = _slicedToArray(_useState3, 2),
+    resizeRef = _useState4[0],
+    setResizeRef = _useState4[1];
+  var setRef = useCombinedRefs([setResizeRef, ref, internalParentFlyoutRef, setFlyoutRef]);
+  var _useResizeObserver = useResizeObserver(isPushed ? resizeRef : null, 'width'),
+    width = _useResizeObserver.width;
+
   /**
-   * Effect for adding push padding to body. Using useLayoutEffect to ensure
-   * padding changes happen synchronously before child components render -
-   * this is needed to prevent RemoveScrollBar from measuring the body in an
-   * inconsistent state during flyout transitions.
+   * Effect for adding push padding so the flyout has room. Targets the
+   * container element when one is provided, otherwise document.body.
+   * Uses useLayoutEffect so padding is applied before child render.
    */
   useLayoutEffect(function () {
     if (!isPushed) {
-      return; // Only push-type flyouts manage body padding
+      return;
     }
+    var paddingTarget = container !== null && container !== void 0 ? container : document.body;
     var shouldApplyPadding = !isInManagedContext || isActiveManagedFlyout;
     var paddingSide = side === 'left' ? 'paddingInlineStart' : 'paddingInlineEnd';
     var cssVarName = "--euiPushFlyoutOffset".concat(side === 'left' ? 'InlineStart' : 'InlineEnd');
     var managerSide = side === 'left' ? 'left' : 'right';
+
+    // Capture pre-existing inline padding so it can be restored on cleanup
+    var previousPadding = paddingTarget.style[paddingSide];
     var paddingWidth = layoutMode === LAYOUT_MODE_STACKED && isMainFlyout && _siblingFlyoutWidth ? _siblingFlyoutWidth : width;
     if (shouldApplyPadding) {
-      document.body.style[paddingSide] = "".concat(paddingWidth, "px");
-      setGlobalCSSVariables(_defineProperty({}, cssVarName, "".concat(paddingWidth, "px")));
-      // Update manager state if in managed context
+      paddingTarget.style[paddingSide] = "".concat(paddingWidth, "px");
+      if (shouldSetGlobalPushVars) {
+        setGlobalCSSVariables(_defineProperty({}, cssVarName, "".concat(paddingWidth, "px")));
+      }
       if (isInManagedContext && flyoutManagerRef.current) {
         flyoutManagerRef.current.setPushPadding(managerSide, paddingWidth);
       }
     } else {
-      // Explicitly remove padding when this push flyout becomes inactive
-      document.body.style[paddingSide] = '';
-      setGlobalCSSVariables(_defineProperty({}, cssVarName, null));
-      // Clear manager state if in managed context
+      paddingTarget.style[paddingSide] = previousPadding;
+      if (shouldSetGlobalPushVars) {
+        setGlobalCSSVariables(_defineProperty({}, cssVarName, null));
+      }
       if (isInManagedContext && flyoutManagerRef.current) {
         flyoutManagerRef.current.setPushPadding(managerSide, 0);
       }
     }
-
-    // Cleanup on unmount
     return function () {
-      document.body.style[paddingSide] = '';
-      setGlobalCSSVariables(_defineProperty({}, cssVarName, null));
-      // Clear manager state on unmount if in managed context
+      paddingTarget.style[paddingSide] = previousPadding;
+      if (shouldSetGlobalPushVars) {
+        setGlobalCSSVariables(_defineProperty({}, cssVarName, null));
+      }
       if (isInManagedContext && flyoutManagerRef.current) {
         flyoutManagerRef.current.setPushPadding(managerSide, 0);
       }
     };
-  }, [isPushed, isInManagedContext, isActiveManagedFlyout, setGlobalCSSVariables, side, width, layoutMode, isMainFlyout, _siblingFlyoutWidth]);
+  }, [isPushed, isInManagedContext, isActiveManagedFlyout, setGlobalCSSVariables, side, width, layoutMode, isMainFlyout, _siblingFlyoutWidth, shouldSetGlobalPushVars, container]);
 
   /**
    * This class doesn't actually do anything by EUI, but is nice to add for consumers (JIC)
@@ -233,7 +363,6 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
   useEffect(function () {
     document.body.classList.add('euiBody--hasFlyout');
     return function () {
-      // Remove the hasFlyout class when the flyout is unmounted
       document.body.classList.remove('euiBody--hasFlyout');
     };
   }, []);
@@ -258,6 +387,9 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     // Main flyout with child flyout - don't close on ESC
     return false;
   }, [isInManagedContext, hasChildFlyout, isChildFlyout]);
+  var handleClose = useCallback(function (event) {
+    onClose(event);
+  }, [onClose]);
 
   /**
    * ESC key closes flyout based on flyout hierarchy rules
@@ -265,15 +397,15 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
   var onKeyDown = useCallback(function (event) {
     if (!isPushed && event.key === keys.ESCAPE && shouldCloseOnEscape) {
       event.preventDefault();
-      onClose(event);
+      handleClose(event);
     }
-  }, [onClose, isPushed, shouldCloseOnEscape]);
+  }, [handleClose, isPushed, shouldCloseOnEscape]);
   var managedFlyoutIndex = currentZIndexRef.current;
   if (isInManagedContext && currentSession) {
     managedFlyoutIndex = currentSession.zIndex;
   }
   var _useEuiFlyoutZIndex = useEuiFlyoutZIndex({
-      maskProps: maskProps,
+      headerZindexLocation: effectiveHeaderZindexLocation,
       isPushed: isPushed,
       managedFlyoutIndex: managedFlyoutIndex,
       isChildFlyout: isChildFlyout
@@ -282,20 +414,125 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     maskZIndex = _useEuiFlyoutZIndex.maskZIndex;
 
   /**
-   * Set inline styles
+   * Inline styles position the flyout inside the reference container's
+   * bounding rect (document.body or a specific element) while remaining in
+   * document.body with position: fixed.
    */
   var inlineStyles = useMemo(function () {
     var composedStyles = composeFlyoutInlineStyles(size, layoutMode, siblingFlyoutId, siblingFlyoutWidth || null, maxWidth, flyoutZIndex);
-    return _objectSpread(_objectSpread({}, style), composedStyles);
-  }, [style, size, layoutMode, siblingFlyoutId, siblingFlyoutWidth, maxWidth, flyoutZIndex]);
+
+    // Constrain the flyout to the reference container's bounding rect.
+    var containerPositionStyles = {};
+    if (containerRect) {
+      var containerMaxWidth = containerRect.width * 0.9;
+      // Use clientWidth (excludes scrollbar) to match the coordinate
+      // system of getBoundingClientRect() and CSS position: fixed.
+      var viewportWidth = document.documentElement.clientWidth;
+      var containerRightOffset = viewportWidth - containerRect.right;
+
+      // Compute the container-relative width for this flyout.
+      //
+      // For `position: fixed` elements CSS resolves `%` values against
+      // the viewport, not the container. The resize hook outputs
+      // percentage strings relative to `_referenceWidth` (the container),
+      // so we must convert them to pixel values here.
+      //
+      // Named sizes use their standard proportions (matching
+      // `composeFlyoutSizing`). Percentage strings from the resize hook
+      // are parsed and resolved against the container width. Numeric
+      // values are used directly.
+      var sizePercentMap = {
+        s: 0.25,
+        m: 0.5,
+        l: 0.75,
+        fill: 0.9
+      };
+      var containerRelativeWidth;
+      if (typeof size === 'string') {
+        var namedPct = sizePercentMap[size];
+        if (namedPct !== undefined) {
+          containerRelativeWidth = containerRect.width * namedPct;
+        } else if (size.endsWith('%')) {
+          // Percentage string from the resize hook — the value is
+          // relative to `_referenceWidth` (container width). Parse it
+          // and resolve against the container to get the correct pixels.
+          var pct = parseFloat(size);
+          if (!isNaN(pct)) {
+            containerRelativeWidth = containerRect.width * (pct / 100);
+          }
+        }
+      } else if (typeof size === 'number') {
+        containerRelativeWidth = size;
+      }
+
+      // All container-scoped flyouts get top/height from the container rect.
+      // Reset minInlineSize to 0 so that the CSS `min-inline-size` (which
+      // resolves against the viewport for `position: fixed`) does not
+      // prevent the container-relative width constraints from taking effect.
+      containerPositionStyles = {
+        top: containerRect.top,
+        height: containerRect.height,
+        minInlineSize: 0
+      };
+      if (isChildFlyout) {
+        // Child flyouts position themselves relative to the main flyout.
+        // In side-by-side mode, `siblingFlyoutWidth` is the main flyout's
+        // pixel width; in stacked mode it's 0 (child sits on top).
+        var siblingPx = siblingFlyoutWidth || 0;
+        if (side === 'left') {
+          containerPositionStyles.left = containerRect.left + siblingPx;
+        } else {
+          containerPositionStyles.right = containerRightOffset + siblingPx;
+        }
+        if (containerRelativeWidth !== undefined) {
+          // Set `inlineSize` (logical property) so it properly overrides
+          // `inlineSize` from composedStyles. We intentionally do NOT set
+          // maxInlineSize — the CSS `max-inline-size` from the size class
+          // provides the size-specific cap on initial render, and the
+          // resize hook's clamp handles it after resize interactions.
+          //
+          // For fill-size children in side-by-side mode, subtract the
+          // main flyout's width so the child takes only the remaining
+          // available space. For non-fill children, do NOT subtract —
+          // a fill-size main will shrink dynamically to accommodate.
+          var fillDeduction = size === 'fill' && layoutMode === LAYOUT_MODE_SIDE_BY_SIDE && siblingFlyoutWidth ? siblingFlyoutWidth : 0;
+          containerPositionStyles.inlineSize = Math.min(Math.max(0, containerRelativeWidth - fillDeduction), containerMaxWidth);
+        } else {
+          containerPositionStyles.maxInlineSize = containerMaxWidth;
+        }
+      } else {
+        // Main/standalone flyouts align to the container's edge.
+        if (side === 'left') {
+          containerPositionStyles.left = containerRect.left;
+        } else {
+          containerPositionStyles.right = containerRightOffset;
+        }
+        if (containerRelativeWidth !== undefined) {
+          // For fill-size flyouts in side-by-side mode, subtract the
+          // sibling's width so the main shrinks to accommodate the child.
+          var _siblingPx = size === 'fill' && layoutMode === LAYOUT_MODE_SIDE_BY_SIDE && siblingFlyoutWidth ? siblingFlyoutWidth : 0;
+          containerPositionStyles.inlineSize = Math.min(Math.max(0, containerRelativeWidth - _siblingPx), containerMaxWidth);
+        } else {
+          containerPositionStyles.maxInlineSize = containerMaxWidth;
+        }
+      }
+    }
+    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 classes = classnames('euiFlyout', isChildFlyout && hasChildBackground && 'euiFlyout--hasChildBackground', className);
   var flyoutToggle = useRef(document.activeElement);
-  var _useState3 = useState([]),
-    _useState4 = _slicedToArray(_useState3, 2),
-    focusTrapShards = _useState4[0],
-    setFocusTrapShards = _useState4[1];
+  var _useState5 = useState([]),
+    _useState6 = _slicedToArray(_useState5, 2),
+    focusTrapShards = _useState6[0],
+    setFocusTrapShards = _useState6[1];
+  var isSideBySideChild = isChildFlyout && layoutMode === LAYOUT_MODE_SIDE_BY_SIDE;
+  // Side-by-side: main + child form a single modal unit; only main has aria-modal
+  // to avoid competing dialog semantics. Stacked children are independent modals.
+  var announcesAsModal = useMemo(function () {
+    return !isPushed && !isSideBySideChild;
+  }, [isPushed, isSideBySideChild]);
   var focusTrapSelectors = useMemo(function () {
     var selectors = [];
     if (includeSelectorInFocusTrap) {
@@ -304,8 +541,14 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     if (includeFixedHeadersInFocusTrap) {
       selectors.push('.euiHeader[data-fixed-header]');
     }
+
+    // Include parent in focus trap shards for side-by-side mode (unified navigation).
+    // In stacked mode, parent is hidden behind child so shouldn't be navigable.
+    if (isSideBySideChild) {
+      selectors.push("[".concat(PROPERTY_LEVEL, "=\"").concat(LEVEL_MAIN, "\"]"));
+    }
     return selectors;
-  }, [includeSelectorInFocusTrap, includeFixedHeadersInFocusTrap]);
+  }, [includeSelectorInFocusTrap, includeFixedHeadersInFocusTrap, isSideBySideChild]);
 
   /**
    * Finds the shards to include in the focus trap by querying by `focusTrapSelectors`.
@@ -363,8 +606,8 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
       token: "euiFlyout.screenReaderModalDialog",
       default: "You are in a modal dialog. Press Escape or tap/click outside the dialog on the shadowed overlay to close."
     }) : ___EmotionJSX(EuiI18n, {
-      token: "euiFlyout.screenReaderNonModalDialog",
-      default: "You are in a non-modal dialog. To close the dialog, press Escape."
+      token: "euiFlyout.screenReaderNoOverlayMaskDialog",
+      default: "You are in a modal dialog. To close the dialog, press Escape."
     }), ' ', focusTrapShards.length > 0 && ___EmotionJSX(EuiI18n, {
       token: "euiFlyout.screenReaderFocusTrapShards",
       default: "You can still continue tabbing through other global page landmarks."
@@ -416,26 +659,31 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     if (outsideClickCloses === false) return undefined;
     if (hasOverlayMask) {
       // The overlay mask is present, so only clicks on the mask should close the flyout, regardless of outsideClickCloses
-      if (event.target === maskRef.current) return onClose(event);
+      if (event.target === maskRef.current) return handleClose(event);
     } else {
       // No overlay mask is present, so any outside clicks should close the flyout
-      if (outsideClickCloses === true) return onClose(event);
+      if (outsideClickCloses === true) return handleClose(event);
     }
     // Otherwise if ownFocus is false and outsideClickCloses is undefined, outside clicks should not close the flyout
     return undefined;
-  }, [onClose, hasOverlayMask, outsideClickCloses]);
+  }, [handleClose, hasOverlayMask, outsideClickCloses]);
   var maskCombinedRefs = useCombinedRefs([maskProps === null || maskProps === void 0 ? void 0 : maskProps.maskRef, maskRef]);
 
   /**
    * For overlay flyouts in managed contexts, coordinate scroll locking with push flyout state.
    */
-  var hasPushPaddingInManager = useHasPushPadding();
+  var pushPadding = (_managerState$pushPad = managerState === null || managerState === void 0 ? void 0 : managerState.pushPadding) !== null && _managerState$pushPad !== void 0 ? _managerState$pushPad : {
+    left: 0,
+    right: 0
+  };
+  var hasPushPaddingInManager = pushPadding.left > 0 || pushPadding.right > 0;
   var shouldDeferScrollLock = !isPushed && isInManagedContext && hasPushPaddingInManager;
   var shouldUseScrollLock = hasOverlayMask && !shouldDeferScrollLock;
   return ___EmotionJSX(EuiFlyoutOverlay, {
     hasOverlayMask: hasOverlayMask,
     isPushed: isPushed,
     maskZIndex: maskZIndex,
+    headerZindexLocation: effectiveHeaderZindexLocation,
     maskProps: _objectSpread(_objectSpread({}, maskProps), {}, {
       maskRef: maskCombinedRefs
     })
@@ -454,15 +702,15 @@ export var EuiFlyoutComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     ref: setRef,
     id: id
   }, rest, {
-    role: !isPushed ? 'dialog' : rest.role,
-    "aria-modal": !isPushed || undefined,
+    role: announcesAsModal ? 'dialog' : rest.role,
+    "aria-modal": announcesAsModal ? true : undefined,
     tabIndex: !isPushed ? 0 : rest.tabIndex,
     "aria-describedby": !isPushed ? ariaDescribedBy : _ariaDescribedBy,
     "aria-labelledby": ariaLabelledBy,
     "data-autofocus": !isPushed || undefined,
     onAnimationEnd: onAnimationEnd
   }), !isPushed && screenReaderDescription, !_flyoutMenuProps && !hideCloseButton && ___EmotionJSX(EuiFlyoutCloseButton, _extends({}, closeButtonProps, {
-    onClose: onClose,
+    onClose: handleClose,
     closeButtonPosition: closeButtonPosition,
     side: side
   })), _flyoutMenuProps && ___EmotionJSX(EuiFlyoutMenu, _extends({}, flyoutMenuProps, {