@elastic/eui 104.1.0 → 105.0.0

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

@@ -0,0 +1,168 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+var _excluded = ["children", "className", "banner", "hideCloseButton", "onClose", "scrollableTabIndex", "size"];
+/*
+ * 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.
+ */
+
+import React, { useContext, Children, useEffect, useMemo, useRef } from 'react';
+import classNames from 'classnames';
+import { useEuiMemoizedStyles, useGeneratedHtmlId } from '../../services';
+import { euiFlyoutChildStyles } from './flyout_child.styles';
+import { EuiFlyoutCloseButton } from './_flyout_close_button';
+import { EuiFlyoutContext } from './flyout_context';
+import { EuiFlyoutBody } from './flyout_body';
+import { EuiFocusTrap } from '../focus_trap';
+
+/**
+ * Props used to render and configure the child flyout panel
+ */
+import { jsx as ___EmotionJSX } from "@emotion/react";
+/**
+ * The child flyout is a panel that appears to the left of the parent flyout.
+ * It is only visible when the parent flyout is open.
+ */
+export var EuiFlyoutChild = function EuiFlyoutChild(_ref) {
+  var children = _ref.children,
+    className = _ref.className,
+    banner = _ref.banner,
+    _ref$hideCloseButton = _ref.hideCloseButton,
+    hideCloseButton = _ref$hideCloseButton === void 0 ? false : _ref$hideCloseButton,
+    onClose = _ref.onClose,
+    _ref$scrollableTabInd = _ref.scrollableTabIndex,
+    scrollableTabIndex = _ref$scrollableTabInd === void 0 ? 0 : _ref$scrollableTabInd,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? 's' : _ref$size,
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var flyoutContext = useContext(EuiFlyoutContext);
+  if (!flyoutContext) {
+    throw new Error('EuiFlyoutChild must be used as a child of EuiFlyout.');
+  }
+  var setIsChildFlyoutOpen = flyoutContext.setIsChildFlyoutOpen,
+    parentSize = flyoutContext.parentSize;
+  useEffect(function () {
+    setIsChildFlyoutOpen === null || setIsChildFlyoutOpen === void 0 || setIsChildFlyoutOpen(true);
+    return function () {
+      setIsChildFlyoutOpen === null || setIsChildFlyoutOpen === void 0 || setIsChildFlyoutOpen(false);
+    };
+  }, [setIsChildFlyoutOpen]);
+  if (React.Children.count(children) === 0) {
+    console.warn('EuiFlyoutChild was rendered with no children!');
+  }
+  if (parentSize === 'm' && size === 'm') {
+    throw new Error('When the parent EuiFlyout size is "m", the EuiFlyoutChild size cannot be "m". Please use size "s" for the EuiFlyoutChild.');
+  }
+  var handleClose = function handleClose(event) {
+    setIsChildFlyoutOpen === null || setIsChildFlyoutOpen === void 0 || setIsChildFlyoutOpen(false);
+    onClose(event);
+  };
+  var flyoutTitleText;
+  var hasDescribedByBody = false;
+  Children.forEach(children, function (child) {
+    if ( /*#__PURE__*/React.isValidElement(child)) {
+      var _child$type;
+      if (((_child$type = child.type) === null || _child$type === void 0 ? void 0 : _child$type.displayName) === 'EuiFlyoutHeader') {
+        // Attempt to extract string content from header for ARIA
+        var headerChildren = child.props.children;
+        if (typeof headerChildren === 'string') {
+          flyoutTitleText = headerChildren;
+        } else if ( /*#__PURE__*/React.isValidElement(headerChildren) &&
+        // Check if props exist and children is a string
+        typeof headerChildren.props.children === 'string') {
+          flyoutTitleText = headerChildren.props.children;
+        } else if (Array.isArray(headerChildren)) {
+          // Find the first string child if headerChildren is an array
+          flyoutTitleText = headerChildren.find(function (cNode) {
+            return typeof cNode === 'string';
+          });
+        }
+      }
+      if (child.type === EuiFlyoutBody) {
+        hasDescribedByBody = true;
+      }
+    }
+  });
+  var titleIdGenerated = useGeneratedHtmlId({
+    prefix: 'euiFlyoutChildTitle'
+  });
+  var bodyIdGenerated = useGeneratedHtmlId({
+    prefix: 'euiFlyoutChildBody'
+  });
+  var ariaLabelledBy = flyoutTitleText ? titleIdGenerated : undefined;
+  var ariaDescribedBy = hasDescribedByBody ? bodyIdGenerated : undefined;
+  // Use existing aria-label if provided, otherwise fallback if no labelledby can be derived
+  var ariaLabel = rest['aria-label'] || (!ariaLabelledBy && !flyoutTitleText ? 'Flyout panel' : undefined);
+  var processedChildren = useMemo(function () {
+    return Children.map(children, function (child) {
+      if ( /*#__PURE__*/React.isValidElement(child)) {
+        var _child$type2, _child$type3;
+        if ((child.type === EuiFlyoutBody || ((_child$type2 = child.type) === null || _child$type2 === void 0 ? void 0 : _child$type2.displayName) === 'EuiFlyoutBody') && hasDescribedByBody) {
+          return /*#__PURE__*/React.cloneElement(child, {
+            id: bodyIdGenerated
+          });
+        }
+        // If EuiFlyoutHeader is found and we derived flyoutTitleText, set its ID
+        if (((_child$type3 = child.type) === null || _child$type3 === void 0 ? void 0 : _child$type3.displayName) === 'EuiFlyoutHeader' && flyoutTitleText && ariaLabelledBy) {
+          return /*#__PURE__*/React.cloneElement(child, {
+            id: titleIdGenerated
+          });
+        }
+      }
+      return child;
+    });
+  }, [children, bodyIdGenerated, titleIdGenerated, hasDescribedByBody, flyoutTitleText, ariaLabelledBy]);
+  var flyoutWrapperRef = useRef(null);
+  var classes = classNames('euiFlyoutChild', className);
+  var styles = useEuiMemoizedStyles(euiFlyoutChildStyles);
+  var childLayoutMode = flyoutContext.childLayoutMode,
+    parentFlyoutRef = flyoutContext.parentFlyoutRef;
+  var flyoutChildCss = [styles.euiFlyoutChild, size === 's' ? styles.s : styles.m, childLayoutMode === 'side-by-side' ? styles.sidePosition : styles.stackedPosition];
+  return ___EmotionJSX(EuiFocusTrap, {
+    returnFocus: function returnFocus() {
+      if (parentFlyoutRef !== null && parentFlyoutRef !== void 0 && parentFlyoutRef.current) {
+        parentFlyoutRef.current.focus();
+        return false; // We've handled focus
+      }
+      return true;
+    },
+    shards: [],
+    disabled: false
+  }, ___EmotionJSX("div", _extends({
+    ref: flyoutWrapperRef,
+    className: classes,
+    css: flyoutChildCss,
+    "data-test-subj": "euiFlyoutChild",
+    role: "dialog",
+    "aria-modal": "true",
+    "aria-label": ariaLabel,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-describedby": ariaDescribedBy,
+    tabIndex: -1
+  }, rest), flyoutTitleText && !ariaLabelledBy && ___EmotionJSX("h2", {
+    id: titleIdGenerated,
+    className: "euiScreenReaderOnly"
+  }, flyoutTitleText), !hideCloseButton && ___EmotionJSX(EuiFlyoutCloseButton, {
+    className: "euiFlyoutChild__closeButton",
+    css: styles.closeButton,
+    onClose: handleClose,
+    side: "right",
+    closeButtonPosition: "inside",
+    "data-test-subj": "euiFlyoutChildCloseButton"
+  }), ___EmotionJSX("div", {
+    tabIndex: scrollableTabIndex,
+    className: "euiFlyoutChild__overflow",
+    css: styles.overflow.overflow
+  }, banner && ___EmotionJSX("div", {
+    className: "euiFlyoutChild__banner",
+    css: styles.banner,
+    "data-test-subj": "euiFlyoutChildBanner"
+  }, banner), ___EmotionJSX("div", {
+    className: "euiFlyoutChild__overflowContent",
+    css: styles.overflow.wrapper
+  }, processedChildren))));
+};
+EuiFlyoutChild.displayName = 'EuiFlyoutChild';

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

@@ -0,0 +1,31 @@
+/*
+ * 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.
+ */
+
+import { css } from '@emotion/react';
+import { logicalCSS, logicalCSSWithFallback, highContrastModeStyles, euiYScroll } from '../../global_styling';
+import { composeFlyoutSizing, maxedFlyoutWidth } from './flyout.styles';
+export var euiFlyoutChildStyles = function euiFlyoutChildStyles(euiThemeContext) {
+  var euiTheme = euiThemeContext.euiTheme;
+  return {
+    // Base styles for the child flyout
+    euiFlyoutChild: /*#__PURE__*/css("position:absolute;inset-block-start:0;inset-inline-start:0;block-size:100%;background:", euiTheme.colors.backgroundBaseSubdued, ";display:flex;flex-direction:column;", logicalCSSWithFallback('overflow-y', 'hidden'), " ", logicalCSS('height', '100%'), " z-index:", Number(euiTheme.levels.flyout) + 1, ";border-inline-start:", euiTheme.border.thin, ";", maxedFlyoutWidth(euiThemeContext), ";;label:euiFlyoutChild;"),
+    // Position variants based on screen size
+    sidePosition: /*#__PURE__*/css("transform:translateX(-100%);border-inline-end:", euiTheme.border.thin, ";;label:sidePosition;"),
+    stackedPosition: /*#__PURE__*/css("inset-inline-end:0;inline-size:100%;border-block-end:", euiTheme.border.thin, ";;label:stackedPosition;"),
+    s: /*#__PURE__*/css(composeFlyoutSizing(euiThemeContext, 's'), ";;label:s;"),
+    m: /*#__PURE__*/css(composeFlyoutSizing(euiThemeContext, 'm'), ";;label:m;"),
+    closeButton: /*#__PURE__*/css("position:absolute;inset-block-start:", euiTheme.size.s, ";inset-inline-end:", euiTheme.size.s, ";z-index:1;;label:closeButton;"),
+    overflow: {
+      overflow: /*#__PURE__*/css("flex-grow:1;display:flex;flex-direction:column;", euiYScroll(euiThemeContext), ";;label:overflow;"),
+      wrapper: /*#__PURE__*/css("display:flex;flex-direction:column;flex-grow:1;", logicalCSS('overflow-x', 'auto'), ";;label:wrapper;")
+    },
+    banner: /*#__PURE__*/css(logicalCSSWithFallback('overflow-x', 'hidden'), " ", highContrastModeStyles(euiThemeContext, {
+      preferred: logicalCSS('border-bottom', euiTheme.border.thin)
+    }), ";;label:banner;")
+  };
+};

package/optimize/es/components/flyout/flyout_child_manager.js

@@ -0,0 +1,98 @@
+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
+ * 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.
+ */
+
+import React, { useEffect, useMemo, useState } from 'react';
+import { useEuiTheme } from '../../services';
+import { EuiFlyoutContext } from './flyout_context';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+/**
+ * An intermediate component between EuiFlyout and EuiFlyoutChild.
+ * It is responsible for managing the state of the child flyout, and passing it to EuiFlyoutContext.
+ * It removes the responsibility of managing child flyout state from EuiFlyout, which is especially important there might not be a child flyout.
+ */
+export var EuiFlyoutChildProvider = function EuiFlyoutChildProvider(_ref) {
+  var parentSize = _ref.parentSize,
+    parentFlyoutRef = _ref.parentFlyoutRef,
+    childElement = _ref.childElement,
+    childrenToRender = _ref.childrenToRender,
+    reportIsChildOpen = _ref.reportIsChildOpen,
+    reportChildLayoutMode = _ref.reportChildLayoutMode;
+  var _useEuiTheme = useEuiTheme(),
+    euiTheme = _useEuiTheme.euiTheme;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isChildFlyoutOpen = _useState2[0],
+    setIsChildFlyoutOpen = _useState2[1];
+  var _useState3 = useState(typeof window !== 'undefined' ? window.innerWidth : Infinity),
+    _useState4 = _slicedToArray(_useState3, 2),
+    windowWidth = _useState4[0],
+    setWindowWidth = _useState4[1];
+  var _useState5 = useState('side-by-side'),
+    _useState6 = _slicedToArray(_useState5, 2),
+    childLayoutMode = _useState6[0],
+    setChildLayoutMode = _useState6[1];
+
+  // update windowWidth on resize
+  useEffect(function () {
+    if (typeof window === 'undefined') return;
+    var handleResize = function handleResize() {
+      setWindowWidth(window.innerWidth);
+    };
+    window.addEventListener('resize', handleResize);
+    handleResize();
+    return function () {
+      return window.removeEventListener('resize', handleResize);
+    };
+  }, []);
+
+  // Calculate stacking breakpoint value for child flyout.
+  // Stacking breakpoint value is a sum of parent breakpoint value and child breakpoint value.
+  var stackingBreakpointValue = useMemo(function () {
+    var parentSizeName = parentSize;
+    var childSizeName = childElement.props.size || 's';
+    var parentNumericValue = 0;
+    if (parentSizeName === 's') parentNumericValue = euiTheme.breakpoint.s;else if (parentSizeName === 'm') parentNumericValue = euiTheme.breakpoint.m;
+    // Parent 'l' size is not allowed when child is present, so no need to check here
+
+    var childNumericValue = 0;
+    if (childSizeName === 's') childNumericValue = euiTheme.breakpoint.s;else if (childSizeName === 'm') childNumericValue = euiTheme.breakpoint.m;
+    return parentNumericValue + childNumericValue;
+  }, [parentSize, childElement.props.size, euiTheme.breakpoint]);
+
+  // update childLayoutMode based on windowWidth and the calculated stackingBreakpoint
+  useEffect(function () {
+    if (windowWidth >= stackingBreakpointValue) {
+      setChildLayoutMode('side-by-side');
+    } else {
+      setChildLayoutMode('stacked');
+    }
+  }, [windowWidth, stackingBreakpointValue]);
+
+  // report isChildFlyoutOpen changes to the parent EuiFlyout
+  useEffect(function () {
+    reportIsChildOpen(isChildFlyoutOpen);
+  }, [isChildFlyoutOpen, reportIsChildOpen]);
+
+  // report childLayoutMode changes to the parent EuiFlyout
+  useEffect(function () {
+    reportChildLayoutMode(childLayoutMode);
+  }, [childLayoutMode, reportChildLayoutMode]);
+  var contextValue = useMemo(function () {
+    return {
+      parentSize: parentSize,
+      parentFlyoutRef: parentFlyoutRef,
+      isChildFlyoutOpen: isChildFlyoutOpen,
+      setIsChildFlyoutOpen: setIsChildFlyoutOpen,
+      childLayoutMode: childLayoutMode
+    };
+  }, [parentSize, parentFlyoutRef, isChildFlyoutOpen, setIsChildFlyoutOpen, childLayoutMode]);
+  return ___EmotionJSX(EuiFlyoutContext.Provider, {
+    value: contextValue
+  }, childrenToRender);
+};

package/optimize/es/components/flyout/flyout_context.js

@@ -0,0 +1,16 @@
+/*
+ * 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.
+ */
+
+import { createContext } from 'react';
+
+/**
+ * Context shared between the main and child flyouts
+ * @internal
+ */
+
+export var EuiFlyoutContext = /*#__PURE__*/createContext(null);

package/optimize/es/components/flyout/index.js

@@ -11,4 +11,6 @@ export { EuiFlyoutBody } from './flyout_body';
 export { EuiFlyoutFooter } from './flyout_footer';
 export { EuiFlyoutHeader } from './flyout_header';
 export { euiFlyoutSlideInRight, euiFlyoutSlideInLeft } from './flyout.styles';
-export { EuiFlyoutResizable } from './flyout_resizable';
+export { EuiFlyoutResizable } from './flyout_resizable';
+export { EuiFlyoutChild } from './flyout_child';
+export { EuiFlyoutSessionProvider, useEuiFlyoutSession } from './sessions';

package/optimize/es/components/flyout/sessions/flyout_provider.js

@@ -0,0 +1,104 @@
+import _extends from "@babel/runtime/helpers/extends";
+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
+ * 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.
+ */
+
+import React, { createContext, useContext, useReducer } from 'react';
+import { EuiFlyout, EuiFlyoutChild } from '../index';
+import { initialFlyoutState, flyoutReducer } from './flyout_reducer';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+var EuiFlyoutSessionContext = /*#__PURE__*/createContext(null);
+
+/**
+ * Accesses the state data and dispatch function from the context of EuiFlyoutSessionProvider
+ * Use this if you need to debug the state or need direct access to the dispatch function, otherwise use useEuiFlyoutSession hook.
+ */
+export var useEuiFlyoutSessionContext = function useEuiFlyoutSessionContext() {
+  var context = useContext(EuiFlyoutSessionContext);
+  if (!context) {
+    throw new Error('useEuiFlyoutSessionContext must be used within a EuiFlyoutSessionProvider');
+  }
+  return context;
+};
+
+/**
+ * FlyoutProvider is a component that provides a context for Flyout components.
+ * It is used to manage the state of the Flyout and its child.
+ * It also renders the Flyout and FlyoutChild components.
+ *
+ * @param children - The children of the FlyoutProvider component.
+ * @param renderMainFlyoutContent - A function that renders the content of the main Flyout.
+ * @param renderChildFlyoutContent - A function that renders the content of the child Flyout.
+ * @returns The FlyoutProvider component.
+ */
+export var EuiFlyoutSessionProvider = function EuiFlyoutSessionProvider(_ref) {
+  var children = _ref.children,
+    renderMainFlyoutContent = _ref.renderMainFlyoutContent,
+    renderChildFlyoutContent = _ref.renderChildFlyoutContent;
+  var _useReducer = useReducer(flyoutReducer, initialFlyoutState),
+    _useReducer2 = _slicedToArray(_useReducer, 2),
+    state = _useReducer2[0],
+    dispatch = _useReducer2[1];
+  var activeFlyoutGroup = state.activeFlyoutGroup;
+  var handleClose = function handleClose() {
+    dispatch({
+      type: 'CLEAR_HISTORY'
+    });
+  };
+  var handleCloseChild = function handleCloseChild() {
+    dispatch({
+      type: 'CLOSE_CHILD_FLYOUT'
+    });
+  };
+  var mainFlyoutContentNode = null;
+  var childFlyoutContentNode = null;
+  if (activeFlyoutGroup) {
+    var mainRenderContext = {
+      flyoutProps: activeFlyoutGroup.config.mainFlyoutProps || {},
+      flyoutSize: activeFlyoutGroup.config.mainSize,
+      flyoutType: 'main',
+      dispatch: dispatch,
+      activeFlyoutGroup: activeFlyoutGroup,
+      onCloseFlyout: handleClose,
+      onCloseChildFlyout: handleCloseChild,
+      meta: activeFlyoutGroup.meta
+    };
+    mainFlyoutContentNode = renderMainFlyoutContent(mainRenderContext);
+    if (activeFlyoutGroup.isChildOpen && renderChildFlyoutContent) {
+      var childRenderContext = {
+        flyoutProps: activeFlyoutGroup.config.childFlyoutProps || {},
+        flyoutSize: activeFlyoutGroup.config.childSize,
+        flyoutType: 'child',
+        dispatch: dispatch,
+        activeFlyoutGroup: activeFlyoutGroup,
+        onCloseFlyout: handleClose,
+        onCloseChildFlyout: handleCloseChild,
+        meta: activeFlyoutGroup.meta
+      };
+      childFlyoutContentNode = renderChildFlyoutContent(childRenderContext);
+    } else if (activeFlyoutGroup.isChildOpen && !renderChildFlyoutContent) {
+      console.warn('EuiFlyoutSessionProvider: A child flyout is open, but renderChildFlyoutContent was not provided.');
+    }
+  }
+  var config = activeFlyoutGroup === null || activeFlyoutGroup === void 0 ? void 0 : activeFlyoutGroup.config;
+  var flyoutPropsMain = (config === null || config === void 0 ? void 0 : config.mainFlyoutProps) || {};
+  var flyoutPropsChild = (config === null || config === void 0 ? void 0 : config.childFlyoutProps) || {};
+  return ___EmotionJSX(EuiFlyoutSessionContext.Provider, {
+    value: {
+      state: state,
+      dispatch: dispatch
+    }
+  }, children, (activeFlyoutGroup === null || activeFlyoutGroup === void 0 ? void 0 : activeFlyoutGroup.isMainOpen) && ___EmotionJSX(EuiFlyout, _extends({
+    onClose: handleClose,
+    size: activeFlyoutGroup.config.mainSize,
+    ownFocus: !activeFlyoutGroup.isChildOpen
+  }, flyoutPropsMain), mainFlyoutContentNode, activeFlyoutGroup.isChildOpen && childFlyoutContentNode && ___EmotionJSX(EuiFlyoutChild, _extends({
+    onClose: handleCloseChild,
+    size: activeFlyoutGroup.config.childSize
+  }, flyoutPropsChild), childFlyoutContentNode)));
+};

package/optimize/es/components/flyout/sessions/flyout_reducer.js

@@ -0,0 +1,209 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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; }
+/*
+ * 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.
+ */
+
+/**
+ * Initial state for the flyout session
+ * @internal
+ */
+export var initialFlyoutState = {
+  activeFlyoutGroup: null,
+  history: []
+};
+
+// Helper to apply size constraints for flyout groups
+var applySizeConstraints = function applySizeConstraints(group) {
+  var originalMainSize = group.config.mainSize;
+  var originalChildSize = group.config.childSize;
+  var newMainSize = originalMainSize;
+  var newChildSize = originalChildSize;
+  if (group.isChildOpen) {
+    if (originalMainSize === 'l') {
+      newMainSize = 'm'; // If main is 'l' with child, it must be converted to 'm'
+      newChildSize = 's'; // And child must be 's'
+    } else if (originalMainSize === 'm' && originalChildSize !== 's') {
+      newChildSize = 's'; // If main is 'm' with child, child must be 's'
+    }
+  }
+
+  // If sizes haven't changed, return the original group to preserve references
+  if (newMainSize === originalMainSize && newChildSize === originalChildSize) {
+    return group;
+  }
+  return _objectSpread(_objectSpread({}, group), {}, {
+    config: _objectSpread(_objectSpread({}, group.config), {}, {
+      mainSize: newMainSize,
+      childSize: newChildSize
+    })
+  });
+};
+
+/**
+ * Flyout reducer
+ * Controls state changes for flyout groups
+ */
+export function flyoutReducer(state, action) {
+  switch (action.type) {
+    case 'OPEN_MAIN_FLYOUT':
+      {
+        var _state$activeFlyoutGr, _state$activeFlyoutGr2;
+        var _action$payload = action.payload,
+          size = _action$payload.size,
+          flyoutProps = _action$payload.flyoutProps,
+          onUnmount = _action$payload.onUnmount;
+        var newHistory = _toConsumableArray(state.history);
+        if (state.activeFlyoutGroup) {
+          newHistory.push(state.activeFlyoutGroup);
+        }
+        var newActiveGroup = {
+          isMainOpen: true,
+          isChildOpen: false,
+          config: {
+            mainSize: size,
+            childSize: 's',
+            mainFlyoutProps: flyoutProps,
+            childFlyoutProps: {}
+          },
+          mainOnUnmount: onUnmount,
+          childOnUnmount: undefined,
+          meta: action.payload.meta !== undefined ? ((_state$activeFlyoutGr = state.activeFlyoutGroup) === null || _state$activeFlyoutGr === void 0 ? void 0 : _state$activeFlyoutGr.meta) !== undefined ? _objectSpread(_objectSpread({}, state.activeFlyoutGroup.meta), action.payload.meta) : action.payload.meta : (_state$activeFlyoutGr2 = state.activeFlyoutGroup) === null || _state$activeFlyoutGr2 === void 0 ? void 0 : _state$activeFlyoutGr2.meta
+        };
+        return {
+          activeFlyoutGroup: applySizeConstraints(newActiveGroup),
+          history: newHistory
+        };
+      }
+    case 'OPEN_CHILD_FLYOUT':
+      {
+        if (!state.activeFlyoutGroup || !state.activeFlyoutGroup.isMainOpen) {
+          console.warn('Cannot open child flyout: main flyout is not open or no active group.');
+          return state;
+        }
+        var _action$payload2 = action.payload,
+          _size = _action$payload2.size,
+          _flyoutProps = _action$payload2.flyoutProps,
+          _onUnmount = _action$payload2.onUnmount;
+        var updatedActiveGroup = _objectSpread(_objectSpread({}, state.activeFlyoutGroup), {}, {
+          isChildOpen: true,
+          config: _objectSpread(_objectSpread({}, state.activeFlyoutGroup.config), {}, {
+            childSize: _size,
+            childFlyoutProps: _flyoutProps
+          }),
+          childOnUnmount: _onUnmount,
+          meta: action.payload.meta !== undefined ? state.activeFlyoutGroup.meta !== undefined ? _objectSpread(_objectSpread({}, state.activeFlyoutGroup.meta), action.payload.meta) : action.payload.meta : state.activeFlyoutGroup.meta
+        });
+        return {
+          history: state.history,
+          activeFlyoutGroup: applySizeConstraints(updatedActiveGroup)
+        };
+      }
+    case 'OPEN_FLYOUT_GROUP':
+      {
+        var _action$payload3 = action.payload,
+          main = _action$payload3.main,
+          child = _action$payload3.child,
+          meta = _action$payload3.meta;
+        var _newHistory = _toConsumableArray(state.history);
+        if (state.activeFlyoutGroup) {
+          _newHistory.push(state.activeFlyoutGroup);
+        }
+
+        // Create the new active group with both main and child flyouts open
+        var _newActiveGroup = {
+          isMainOpen: true,
+          isChildOpen: true,
+          config: {
+            mainSize: main.size,
+            childSize: child.size,
+            mainFlyoutProps: main.flyoutProps,
+            childFlyoutProps: child.flyoutProps
+          },
+          mainOnUnmount: main.onUnmount,
+          childOnUnmount: child.onUnmount,
+          meta: meta
+        };
+        return {
+          activeFlyoutGroup: applySizeConstraints(_newActiveGroup),
+          history: _newHistory
+        };
+      }
+    case 'CLOSE_CHILD_FLYOUT':
+      {
+        var _state$activeFlyoutGr3, _state$activeFlyoutGr4;
+        if (!state.activeFlyoutGroup || !state.activeFlyoutGroup.isChildOpen) {
+          console.warn('Cannot close child flyout: no child is open or no active group.');
+          return state;
+        }
+        (_state$activeFlyoutGr3 = (_state$activeFlyoutGr4 = state.activeFlyoutGroup).childOnUnmount) === null || _state$activeFlyoutGr3 === void 0 || _state$activeFlyoutGr3.call(_state$activeFlyoutGr4);
+        var _updatedActiveGroup = _objectSpread(_objectSpread({}, state.activeFlyoutGroup), {}, {
+          isChildOpen: false,
+          config: _objectSpread(_objectSpread({}, state.activeFlyoutGroup.config), {}, {
+            childFlyoutProps: {}
+          }),
+          childOnUnmount: undefined
+        });
+        return {
+          history: state.history,
+          activeFlyoutGroup: applySizeConstraints(_updatedActiveGroup)
+        };
+      }
+    case 'GO_BACK':
+      {
+        var _state$activeFlyoutGr7, _state$activeFlyoutGr8;
+        if (!state.activeFlyoutGroup) return initialFlyoutState;
+        if (state.activeFlyoutGroup.isChildOpen) {
+          var _state$activeFlyoutGr5, _state$activeFlyoutGr6;
+          (_state$activeFlyoutGr5 = (_state$activeFlyoutGr6 = state.activeFlyoutGroup).childOnUnmount) === null || _state$activeFlyoutGr5 === void 0 || _state$activeFlyoutGr5.call(_state$activeFlyoutGr6);
+        }
+        (_state$activeFlyoutGr7 = (_state$activeFlyoutGr8 = state.activeFlyoutGroup).mainOnUnmount) === null || _state$activeFlyoutGr7 === void 0 || _state$activeFlyoutGr7.call(_state$activeFlyoutGr8);
+
+        // Restore from history or return to initial state
+        if (state.history.length > 0) {
+          var _newHistory2 = _toConsumableArray(state.history);
+          var previousGroup = _newHistory2.pop();
+          return {
+            activeFlyoutGroup: previousGroup ? applySizeConstraints(previousGroup) : null,
+            history: _newHistory2
+          };
+        } else {
+          return initialFlyoutState;
+        }
+      }
+    case 'UPDATE_ACTIVE_FLYOUT_CONFIG':
+      {
+        if (!state.activeFlyoutGroup) {
+          console.warn('Cannot update config: no active flyout group.');
+          return state;
+        }
+        var _action$payload4 = action.payload,
+          configChanges = _action$payload4.configChanges,
+          newMainOnUnmount = _action$payload4.newMainOnUnmount,
+          newChildOnUnmount = _action$payload4.newChildOnUnmount;
+        var _updatedActiveGroup2 = _objectSpread(_objectSpread({}, state.activeFlyoutGroup), {}, {
+          config: _objectSpread(_objectSpread({}, state.activeFlyoutGroup.config), configChanges),
+          mainOnUnmount: newMainOnUnmount !== undefined ? newMainOnUnmount : state.activeFlyoutGroup.mainOnUnmount,
+          childOnUnmount: newChildOnUnmount !== undefined ? newChildOnUnmount : state.activeFlyoutGroup.childOnUnmount
+        });
+        var finalUpdatedActiveGroup = applySizeConstraints(_updatedActiveGroup2);
+        return _objectSpread(_objectSpread({}, state), {}, {
+          activeFlyoutGroup: finalUpdatedActiveGroup
+        });
+      }
+    case 'CLEAR_HISTORY':
+      // Clear the history and remove the active group
+      return {
+        activeFlyoutGroup: null,
+        history: []
+      };
+    default:
+      return state;
+  }
+}

package/optimize/es/components/flyout/sessions/index.js

@@ -0,0 +1,10 @@
+/*
+ * 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.
+ */
+
+export { EuiFlyoutSessionProvider, useEuiFlyoutSessionContext } from './flyout_provider';
+export { useEuiFlyoutSession } from './use_eui_flyout';

package/optimize/es/components/flyout/sessions/types.js

@@ -0,0 +1 @@
+export {};