@elastic/eui 106.1.0-amsterdam.0 → 106.2.0-snapshot.1757009122780

package/lib/components/flyout/manager/layout_mode.js

@@ -0,0 +1,171 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFlyoutLayoutMode = exports.useApplyFlyoutLayoutMode = exports.getWidthFromSize = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _services = require("../../../services");
+var _actions = require("./actions");
+var _selectors = require("./selectors");
+var _hooks = require("./hooks");
+var _const = require("./const");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; } /*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+/**
+ * Hook to handle responsive layout mode for managed flyouts.
+ * Decides whether to place flyouts side-by-side or stacked based on
+ * viewport width and flyout widths/sizes.
+ */
+var useApplyFlyoutLayoutMode = exports.useApplyFlyoutLayoutMode = function useApplyFlyoutLayoutMode() {
+  var _useEuiTheme = (0, _services.useEuiTheme)(),
+    euiTheme = _useEuiTheme.euiTheme;
+  var context = (0, _hooks.useFlyoutManager)();
+  var currentSession = (0, _selectors.useCurrentSession)();
+  var parentFlyoutId = currentSession === null || currentSession === void 0 ? void 0 : currentSession.main;
+  var childFlyoutId = currentSession === null || currentSession === void 0 ? void 0 : currentSession.child;
+  var parentFlyout = (0, _selectors.useCurrentMainFlyout)();
+  var childFlyout = (0, _selectors.useCurrentChildFlyout)();
+  var parentWidth = (0, _selectors.useFlyoutWidth)(parentFlyoutId);
+  var childWidth = (0, _selectors.useFlyoutWidth)(childFlyoutId);
+  var _useState = (0, _react.useState)(typeof window !== 'undefined' ? window.innerWidth : Infinity),
+    _useState2 = _slicedToArray(_useState, 2),
+    windowWidth = _useState2[0],
+    setWindowWidth = _useState2[1];
+  var setMode = _react.default.useCallback(function (layoutMode) {
+    if (context !== null && context !== void 0 && context.dispatch && layoutMode !== context.state.layoutMode) {
+      context.dispatch((0, _actions.setLayoutMode)(layoutMode));
+    }
+  }, [context]);
+  (0, _react.useEffect)(function () {
+    if (typeof window === 'undefined') {
+      return;
+    }
+    var rafId = 0;
+    var handleResize = function handleResize() {
+      if (rafId) {
+        cancelAnimationFrame(rafId);
+      }
+      rafId = requestAnimationFrame(function () {
+        return setWindowWidth(window.innerWidth);
+      });
+    };
+    window.addEventListener('resize', handleResize);
+    return function () {
+      if (rafId) {
+        cancelAnimationFrame(rafId);
+      }
+      window.removeEventListener('resize', handleResize);
+    };
+  }, []);
+  (0, _react.useEffect)(function () {
+    if (!context) {
+      return;
+    }
+    var currentLayoutMode = context.state.layoutMode;
+
+    // Thresholds to prevent thrashing near the breakpoint.
+    var THRESHOLD_TO_SIDE_BY_SIDE = 85;
+    var THRESHOLD_TO_STACKED = 95;
+
+    // If the window is too small, set the mode to stacked.
+    //
+    // The value is based on the maximum width of a flyout in
+    // `composeFlyoutSizing` in `flyout.styles.ts` multiplied
+    // by 2 (open flyouts side-by-side).
+    if (windowWidth < Math.round(euiTheme.breakpoint.s * 1.4)) {
+      if (currentLayoutMode !== _const.LAYOUT_MODE_STACKED) {
+        setMode(_const.LAYOUT_MODE_STACKED);
+      }
+      return;
+    }
+    if (!childFlyoutId) {
+      if (currentLayoutMode !== _const.LAYOUT_MODE_SIDE_BY_SIDE) setMode(_const.LAYOUT_MODE_SIDE_BY_SIDE);
+      return;
+    }
+    var parentWidthValue = parentWidth;
+    var childWidthValue = childWidth;
+    if (!parentWidthValue && parentFlyout !== null && parentFlyout !== void 0 && parentFlyout.size) {
+      parentWidthValue = getWidthFromSize(parentFlyout.size);
+    }
+    if (!childWidthValue && childFlyout !== null && childFlyout !== void 0 && childFlyout.size) {
+      childWidthValue = getWidthFromSize(childFlyout.size);
+    }
+    if (!parentWidthValue || !childWidthValue) {
+      if (currentLayoutMode !== _const.LAYOUT_MODE_SIDE_BY_SIDE) setMode(_const.LAYOUT_MODE_SIDE_BY_SIDE);
+      return;
+    }
+    var combinedWidth = parentWidthValue + childWidthValue;
+    var combinedWidthPercentage = combinedWidth / windowWidth * 100;
+    var newLayoutMode;
+
+    // Handle fill size flyouts: keep layout as side-by-side when fill flyout is present
+    // This allows fill flyouts to dynamically calculate their width based on sibling
+    if ((parentFlyout === null || parentFlyout === void 0 ? void 0 : parentFlyout.size) === 'fill' || (childFlyout === null || childFlyout === void 0 ? void 0 : childFlyout.size) === 'fill') {
+      // For fill flyouts, we want to maintain side-by-side layout to enable dynamic width calculation
+      // Only stack if the viewport is too small (below the small breakpoint)
+      if (windowWidth >= Math.round(euiTheme.breakpoint.s * 1.4)) {
+        if (currentLayoutMode !== _const.LAYOUT_MODE_SIDE_BY_SIDE) {
+          setMode(_const.LAYOUT_MODE_SIDE_BY_SIDE);
+        }
+        return;
+      }
+    }
+    if (currentLayoutMode === _const.LAYOUT_MODE_STACKED) {
+      newLayoutMode = combinedWidthPercentage <= THRESHOLD_TO_SIDE_BY_SIDE ? _const.LAYOUT_MODE_SIDE_BY_SIDE : _const.LAYOUT_MODE_STACKED;
+    } else {
+      newLayoutMode = combinedWidthPercentage >= THRESHOLD_TO_STACKED ? _const.LAYOUT_MODE_STACKED : _const.LAYOUT_MODE_SIDE_BY_SIDE;
+    }
+    if (currentLayoutMode !== newLayoutMode) {
+      setMode(newLayoutMode);
+    }
+  }, [windowWidth, context, parentWidth, setMode, childWidth, childFlyoutId, parentFlyout === null || parentFlyout === void 0 ? void 0 : parentFlyout.size, childFlyout === null || childFlyout === void 0 ? void 0 : childFlyout.size, euiTheme]);
+};
+
+/** Convert a flyout `size` value to a pixel width using theme breakpoints. */
+var getWidthFromSize = exports.getWidthFromSize = function getWidthFromSize(size) {
+  if (typeof size === 'number') {
+    return size;
+  }
+  if (typeof size === 'string') {
+    var parsed = parseInt(size, 10);
+    if (!Number.isNaN(parsed)) {
+      return parsed;
+    }
+
+    // Size is a function of a percentage of `vw`, defined in `composeFlyoutSizing` in `flyout.styles.ts`
+    switch (size) {
+      case 's':
+        return Math.round(window.innerWidth * 0.25);
+      case 'm':
+        return Math.round(window.innerWidth * 0.5);
+      case 'l':
+        return Math.round(window.innerWidth * 0.75);
+      case 'fill':
+        return Math.round(window.innerWidth * 0.9);
+      default:
+        break;
+    }
+  }
+  return 0;
+};
+
+/** Current layout mode for managed flyouts (`side-by-side` or `stacked`). */
+var useFlyoutLayoutMode = exports.useFlyoutLayoutMode = function useFlyoutLayoutMode() {
+  var _context$state;
+  var context = (0, _hooks.useFlyoutManager)();
+  return (context === null || context === void 0 || (_context$state = context.state) === null || _context$state === void 0 ? void 0 : _context$state.layoutMode) || _const.LAYOUT_MODE_SIDE_BY_SIDE;
+};

package/lib/components/flyout/manager/provider.js

@@ -0,0 +1,46 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFlyoutManager = exports.EuiFlyoutManagerContext = exports.EuiFlyoutManager = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _hooks = require("./hooks");
+var _layout_mode = require("./layout_mode");
+var _react2 = require("@emotion/react");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+/**
+ * React context that exposes the Flyout Manager API (state + actions).
+ */
+var EuiFlyoutManagerContext = exports.EuiFlyoutManagerContext = /*#__PURE__*/(0, _react.createContext)(null);
+
+/**
+ * Provides the Flyout Manager API via context and runs layout-mode logic.
+ */
+var EuiFlyoutManager = exports.EuiFlyoutManager = function EuiFlyoutManager(_ref) {
+  var children = _ref.children;
+  var api = (0, _hooks.useFlyoutManagerReducer)();
+  return (0, _react2.jsx)(EuiFlyoutManagerContext.Provider, {
+    value: api
+  }, (0, _react2.jsx)(EuiFlyoutManagerContainer, null, children));
+};
+var EuiFlyoutManagerContainer = function EuiFlyoutManagerContainer(_ref2) {
+  var children = _ref2.children;
+  (0, _layout_mode.useApplyFlyoutLayoutMode)();
+  return (0, _react2.jsx)(_react.default.Fragment, null, children);
+};
+
+/** Hook to access the Flyout Manager API from context. */
+var useFlyoutManager = exports.useFlyoutManager = function useFlyoutManager() {
+  return (0, _react.useContext)(EuiFlyoutManagerContext);
+};

package/lib/components/flyout/manager/reducer.js

@@ -0,0 +1,205 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.flyoutManagerReducer = flyoutManagerReducer;
+exports.initialState = void 0;
+var _actions = require("./actions");
+var _const = require("./const");
+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; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+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."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; } /*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+/**
+ * Default flyout manager state used to initialize the reducer.
+ */
+var initialState = exports.initialState = {
+  sessions: [],
+  flyouts: [],
+  layoutMode: _const.LAYOUT_MODE_SIDE_BY_SIDE
+};
+
+/**
+ * Reducer handling all flyout manager actions and state transitions.
+ */
+function flyoutManagerReducer() {
+  var state = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : initialState;
+  var action = arguments.length > 1 ? arguments[1] : undefined;
+  switch (action.type) {
+    // Register a flyout.
+    // - Ignore duplicates by `flyoutId`.
+    // - For a `main` flyout, start a new session { main, child: null }.
+    // - For a `child` flyout, attach it to the most recent session; if no
+    //   session exists, do nothing (invalid child without a parent).
+    case _actions.ACTION_ADD:
+      {
+        var flyoutId = action.flyoutId,
+          level = action.level,
+          size = action.size;
+        if (state.flyouts.some(function (f) {
+          return f.flyoutId === flyoutId;
+        })) {
+          return state;
+        }
+        var newFlyoutState = {
+          level: level,
+          flyoutId: flyoutId,
+          size: size,
+          activityStage: _const.STAGE_OPENING
+        };
+        var newFlyouts = [].concat(_toConsumableArray(state.flyouts), [newFlyoutState]);
+        if (level === _const.LEVEL_MAIN) {
+          var newSession = {
+            main: flyoutId,
+            child: null
+          };
+          return _objectSpread(_objectSpread({}, state), {}, {
+            sessions: [].concat(_toConsumableArray(state.sessions), [newSession]),
+            flyouts: newFlyouts
+          });
+        }
+        if (state.sessions.length === 0) {
+          return state;
+        }
+        var updatedSessions = _toConsumableArray(state.sessions);
+        var currentSessionIndex = updatedSessions.length - 1;
+        updatedSessions[currentSessionIndex] = _objectSpread(_objectSpread({}, updatedSessions[currentSessionIndex]), {}, {
+          child: flyoutId
+        });
+        return _objectSpread(_objectSpread({}, state), {}, {
+          sessions: updatedSessions,
+          flyouts: newFlyouts
+        });
+      }
+
+    // Unregister a flyout and update sessions accordingly.
+    // - When closing a `main` flyout, drop its entire session and all associated flyouts.
+    // - When closing a `child` flyout, clear the child pointer on the most
+    //   recent session if it matches.
+    case _actions.ACTION_CLOSE:
+      {
+        var removedFlyout = state.flyouts.find(function (f) {
+          return f.flyoutId === action.flyoutId;
+        });
+        if (!removedFlyout) {
+          return state;
+        }
+        if (removedFlyout.level === _const.LEVEL_MAIN) {
+          // Find the session that contains this main flyout
+          var sessionToRemove = state.sessions.find(function (session) {
+            return session.main === action.flyoutId;
+          });
+          if (sessionToRemove) {
+            // Remove all flyouts associated with this session (main + child)
+            var flyoutsToRemove = new Set([action.flyoutId]);
+            if (sessionToRemove.child) {
+              flyoutsToRemove.add(sessionToRemove.child);
+            }
+            var _newFlyouts = state.flyouts.filter(function (f) {
+              return !flyoutsToRemove.has(f.flyoutId);
+            });
+            var newSessions = state.sessions.filter(function (session) {
+              return session.main !== action.flyoutId;
+            });
+            return _objectSpread(_objectSpread({}, state), {}, {
+              sessions: newSessions,
+              flyouts: _newFlyouts
+            });
+          }
+        }
+
+        // Handle child flyout closing (existing logic)
+        var _newFlyouts2 = state.flyouts.filter(function (f) {
+          return f.flyoutId !== action.flyoutId;
+        });
+        if (state.sessions.length === 0) {
+          return _objectSpread(_objectSpread({}, state), {}, {
+            flyouts: _newFlyouts2
+          });
+        }
+        var _updatedSessions = _toConsumableArray(state.sessions);
+        var _currentSessionIndex = _updatedSessions.length - 1;
+        if (_updatedSessions[_currentSessionIndex].child === action.flyoutId) {
+          _updatedSessions[_currentSessionIndex] = _objectSpread(_objectSpread({}, _updatedSessions[_currentSessionIndex]), {}, {
+            child: null
+          });
+        }
+        return _objectSpread(_objectSpread({}, state), {}, {
+          sessions: _updatedSessions,
+          flyouts: _newFlyouts2
+        });
+      }
+
+    // Mark the provided flyout ID as the active child for the latest session.
+    case _actions.ACTION_SET_ACTIVE:
+      {
+        // No-op when no session exists.
+        if (state.sessions.length === 0) {
+          return state;
+        }
+        var _updatedSessions2 = _toConsumableArray(state.sessions);
+        var _currentSessionIndex2 = _updatedSessions2.length - 1;
+        _updatedSessions2[_currentSessionIndex2] = _objectSpread(_objectSpread({}, _updatedSessions2[_currentSessionIndex2]), {}, {
+          child: action.flyoutId
+        });
+        return _objectSpread(_objectSpread({}, state), {}, {
+          sessions: _updatedSessions2
+        });
+      }
+
+    // Persist a flyout's measured width (px). Used for responsive layout
+    // calculations, e.g., deciding stacked vs side-by-side.
+    case _actions.ACTION_SET_WIDTH:
+      {
+        var _flyoutId = action.flyoutId,
+          width = action.width;
+        var updatedFlyouts = state.flyouts.map(function (flyout) {
+          return flyout.flyoutId === _flyoutId ? _objectSpread(_objectSpread({}, flyout), {}, {
+            width: width
+          }) : flyout;
+        });
+        return _objectSpread(_objectSpread({}, state), {}, {
+          flyouts: updatedFlyouts
+        });
+      }
+
+    // Switch global layout mode for managed flyouts.
+    case _actions.ACTION_SET_LAYOUT_MODE:
+      {
+        return _objectSpread(_objectSpread({}, state), {}, {
+          layoutMode: action.layoutMode
+        });
+      }
+
+    // Update a flyout's activity stage in state
+    case _actions.ACTION_SET_ACTIVITY_STAGE:
+      {
+        var _flyoutId2 = action.flyoutId;
+        var _updatedFlyouts = state.flyouts.map(function (flyout) {
+          return flyout.flyoutId === _flyoutId2 ? _objectSpread(_objectSpread({}, flyout), {}, {
+            activityStage: action.activityStage
+          }) : flyout;
+        });
+        return _objectSpread(_objectSpread({}, state), {}, {
+          flyouts: _updatedFlyouts
+        });
+      }
+    default:
+      return state;
+  }
+}

package/lib/components/flyout/manager/selectors.js

@@ -0,0 +1,93 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useSession = exports.useParentFlyoutSize = exports.useIsFlyoutRegistered = exports.useIsFlyoutActive = exports.useHasChildFlyout = exports.useHasActiveSession = exports.useFlyoutWidth = exports.useFlyout = exports.useCurrentSession = exports.useCurrentMainFlyout = exports.useCurrentChildFlyout = void 0;
+var _provider = require("./provider");
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+var useSession = exports.useSession = function useSession(flyoutId) {
+  var context = (0, _provider.useFlyoutManager)();
+  if (!context) {
+    return null;
+  }
+  return context.state.sessions.find(function (s) {
+    return s.main === flyoutId || s.child === flyoutId;
+  }) || null;
+};
+
+/** True when any managed flyout session is currently active. */
+var useHasActiveSession = exports.useHasActiveSession = function useHasActiveSession() {
+  return !!useCurrentSession();
+};
+
+/** True if the given `flyoutId` is the main or child flyout in the latest session. */
+var useIsFlyoutActive = exports.useIsFlyoutActive = function useIsFlyoutActive(flyoutId) {
+  var currentSession = useCurrentSession();
+  return (currentSession === null || currentSession === void 0 ? void 0 : currentSession.main) === flyoutId || (currentSession === null || currentSession === void 0 ? void 0 : currentSession.child) === flyoutId;
+};
+var useFlyout = exports.useFlyout = function useFlyout(flyoutId) {
+  var context = (0, _provider.useFlyoutManager)();
+  if (!context || !flyoutId) {
+    return null;
+  }
+  return context.state.flyouts.find(function (f) {
+    return f.flyoutId === flyoutId;
+  }) || null;
+};
+var useIsFlyoutRegistered = exports.useIsFlyoutRegistered = function useIsFlyoutRegistered(flyoutId) {
+  var context = (0, _provider.useFlyoutManager)();
+  if (!context || !flyoutId) {
+    return false;
+  }
+  return context.state.flyouts.some(function (f) {
+    return f.flyoutId === flyoutId;
+  });
+};
+
+/** The most recent flyout session or `null` if none. */
+var useCurrentSession = exports.useCurrentSession = function useCurrentSession() {
+  var context = (0, _provider.useFlyoutManager)();
+  if (!context) return null;
+  return context.state.sessions[context.state.sessions.length - 1] || null;
+};
+
+/** The registered state of the current session's main flyout, if present. */
+var useCurrentMainFlyout = exports.useCurrentMainFlyout = function useCurrentMainFlyout() {
+  var currentSession = useCurrentSession();
+  var mainFlyoutId = currentSession === null || currentSession === void 0 ? void 0 : currentSession.main;
+  return useFlyout(mainFlyoutId);
+};
+
+/** The registered state of the current session's child flyout, if present. */
+var useCurrentChildFlyout = exports.useCurrentChildFlyout = function useCurrentChildFlyout() {
+  var currentSession = useCurrentSession();
+  var childFlyoutId = currentSession === null || currentSession === void 0 ? void 0 : currentSession.child;
+  return useFlyout(childFlyoutId);
+};
+
+/** The measured width (px) of the specified flyout, or `null` if unknown. */
+var useFlyoutWidth = exports.useFlyoutWidth = function useFlyoutWidth(flyoutId) {
+  var _useFlyout;
+  return (_useFlyout = useFlyout(flyoutId)) === null || _useFlyout === void 0 ? void 0 : _useFlyout.width;
+};
+
+/** The configured size of the parent (main) flyout for a given child flyout ID. */
+var useParentFlyoutSize = exports.useParentFlyoutSize = function useParentFlyoutSize(childFlyoutId) {
+  var session = useSession(childFlyoutId);
+  var parentFlyout = useFlyout(session === null || session === void 0 ? void 0 : session.main);
+  return parentFlyout === null || parentFlyout === void 0 ? void 0 : parentFlyout.size;
+};
+
+/** True if the provided `flyoutId` is the main flyout and it currently has a child. */
+var useHasChildFlyout = exports.useHasChildFlyout = function useHasChildFlyout(flyoutId) {
+  var session = useSession(flyoutId);
+  return !!(session !== null && session !== void 0 && session.child);
+};

package/lib/components/flyout/manager/validation.js

@@ -0,0 +1,121 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createValidationErrorMessage = createValidationErrorMessage;
+exports.isNamedSize = isNamedSize;
+exports.validateFlyoutSize = validateFlyoutSize;
+exports.validateManagedFlyoutSize = validateManagedFlyoutSize;
+exports.validateSizeCombination = validateSizeCombination;
+var _const = require("../const");
+var _const2 = require("./const");
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+/**
+ * Business rules for flyout sizes:
+ * - Managed flyouts should only accept "named" sizes (s, m, l, fill)
+ * - Parent and child can't both be 'm'
+ * - Parent and child can't both be 'fill'
+ * - Parent can't be 'l' if there is a child
+ */
+
+/**
+ * Checks if a size is a named size (s, m, l)
+ */
+function isNamedSize(size) {
+  return _const.FLYOUT_SIZES.includes(size);
+}
+
+/**
+ * Validates that a managed flyout only uses named sizes
+ */
+function validateManagedFlyoutSize(size, flyoutId, level) {
+  if (!isNamedSize(size)) {
+    var namedSizes = _const.FLYOUT_SIZES.join(', ');
+    return {
+      type: 'INVALID_SIZE_TYPE',
+      message: "Managed flyouts must use named sizes (".concat(namedSizes, "). Received: ").concat(size),
+      flyoutId: flyoutId,
+      level: level,
+      size: "".concat(size)
+    };
+  }
+  return null;
+}
+
+/**
+ * Validates size combinations for parent-child flyouts
+ */
+function validateSizeCombination(parentSize, childSize) {
+  // Parent and child can't both be 'm'
+  if (parentSize === 'm' && childSize === 'm') {
+    return {
+      type: 'INVALID_SIZE_COMBINATION',
+      message: 'Parent and child flyouts cannot both be size "m"',
+      size: childSize
+    };
+  }
+
+  // Parent and child can't both be 'fill'
+  if (parentSize === 'fill' && childSize === 'fill') {
+    return {
+      type: 'INVALID_SIZE_COMBINATION',
+      message: 'Parent and child flyouts cannot both be size "fill"',
+      size: childSize
+    };
+  }
+
+  // Parent can't be 'l' if there is a child
+  if (parentSize === 'l') {
+    return {
+      type: 'INVALID_SIZE_COMBINATION',
+      message: 'Parent flyouts cannot be size "l" when there is a child flyout',
+      size: parentSize
+    };
+  }
+  return null;
+}
+
+/**
+ * Comprehensive validation for flyout size rules
+ */
+function validateFlyoutSize(size, flyoutId, level, parentSize) {
+  // First validate that managed flyouts use named sizes
+  var sizeTypeError = validateManagedFlyoutSize(size, flyoutId, level);
+  if (sizeTypeError) {
+    return sizeTypeError;
+  }
+
+  // If this is a child flyout and we have parent size, validate combination
+  if (level === _const2.LEVEL_CHILD && parentSize && isNamedSize(size)) {
+    var combinationError = validateSizeCombination(parentSize, size);
+    if (combinationError) {
+      combinationError.flyoutId = flyoutId;
+      combinationError.level = level;
+      return combinationError;
+    }
+  }
+  return null;
+}
+
+/**
+ * Creates a user-friendly error message for validation errors
+ */
+function createValidationErrorMessage(error) {
+  var prefix = "EuiFlyout validation error: ";
+  switch (error.type) {
+    case 'INVALID_SIZE_TYPE':
+      return "".concat(prefix).concat(error.message);
+    case 'INVALID_SIZE_COMBINATION':
+      return "".concat(prefix).concat(error.message);
+    default:
+      return "".concat(prefix, "Unknown validation error");
+  }
+}