@elastic/eui 104.1.0 → 105.0.0

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

@@ -28,14 +28,15 @@ export var euiFlyoutStyles = function euiFlyoutStyles(euiThemeContext) {
   var euiTheme = euiThemeContext.euiTheme,
     colorMode = euiThemeContext.colorMode;
   return {
-    euiFlyout: /*#__PURE__*/css("position:fixed;", logicalCSS('bottom', 0), " ", logicalCSS('top', 'var(--euiFixedHeadersOffset, 0)'), " ", logicalCSS('height', 'inherit'), " z-index:", euiTheme.levels.flyout, ";background:", euiTheme.colors.emptyShade, ";display:flex;flex-direction:column;align-items:stretch;&:focus{outline:none;}", euiMaxBreakpoint(euiThemeContext, FLYOUT_BREAKPOINT), "{", logicalCSS('max-width', '90vw !important'), ";};label:euiFlyout;"),
+    euiFlyout: /*#__PURE__*/css("position:fixed;", logicalCSS('bottom', 0), " ", logicalCSS('top', 'var(--euiFixedHeadersOffset, 0)'), " ", logicalCSS('height', 'inherit'), " z-index:", euiTheme.levels.flyout, ";background:", euiTheme.colors.emptyShade, ";display:flex;flex-direction:column;align-items:stretch;&:focus{outline:none;}", maxedFlyoutWidth(euiThemeContext), ";;label:euiFlyout;"),
     // Flyout sizes
-    s: /*#__PURE__*/css(composeFlyoutSizing(euiThemeContext, 's'), ";;label:s;"),
-    m: /*#__PURE__*/css(composeFlyoutSizing(euiThemeContext, 'm'), ";;label:m;"),
+    // When a child flyout is stacked on top of the parent, the parent flyout size will match the child flyout size
+    s: /*#__PURE__*/css(composeFlyoutSizing(euiThemeContext, 's'), " &.euiFlyout--hasChild--stacked.euiFlyout--hasChild--m{", composeFlyoutSizing(euiThemeContext, 'm'), ";};label:s;"),
+    m: /*#__PURE__*/css(composeFlyoutSizing(euiThemeContext, 'm'), " &.euiFlyout--hasChild--stacked.euiFlyout--hasChild--s{", composeFlyoutSizing(euiThemeContext, 's'), ";};label:m;"),
     l: /*#__PURE__*/css(composeFlyoutSizing(euiThemeContext, 'l'), ";;label:l;"),
     noMaxWidth: /*#__PURE__*/css(logicalCSS('max-width', 'none'), ";;label:noMaxWidth;"),
     // Side
-    right: /*#__PURE__*/css("clip-path:polygon(-50% 0, 100% 0, 100% 100%, -50% 100%);", logicalCSS('right', 0), " ", euiCanAnimate, "{animation:", euiFlyoutSlideInRight, " ", euiTheme.animation.normal, " ", euiTheme.animation.resistance, ";};label:right;"),
+    right: /*#__PURE__*/css("clip-path:polygon(-50% 0, 100% 0, 100% 100%, -50% 100%);", logicalCSS('right', 0), " ", euiCanAnimate, "{animation:", euiFlyoutSlideInRight, " ", euiTheme.animation.normal, " ", euiTheme.animation.resistance, ";}&.euiFlyout--hasChild{clip-path:none;};label:right;"),
     // Left-side flyouts should only be used for navigation
     left: /*#__PURE__*/css(logicalCSS('left', 0), " clip-path:polygon(0 0, 150% 0, 150% 100%, 0 100%);", euiCanAnimate, "{animation:", euiFlyoutSlideInLeft, " ", euiTheme.animation.normal, " ", euiTheme.animation.resistance, ";};label:left;"),
     // Type
@@ -61,7 +62,10 @@ export var euiFlyoutStyles = function euiFlyoutStyles(euiThemeContext) {
     }
   };
 };
-var composeFlyoutSizing = function composeFlyoutSizing(euiThemeContext, size) {
+export var maxedFlyoutWidth = function maxedFlyoutWidth(euiThemeContext) {
+  return "\n  ".concat(euiMaxBreakpoint(euiThemeContext, FLYOUT_BREAKPOINT), " {\n    ").concat(logicalCSS('max-width', '90vw !important'), "\n  }\n");
+};
+export var composeFlyoutSizing = function composeFlyoutSizing(euiThemeContext, size) {
   var euiTheme = euiThemeContext.euiTheme;
   var formMaxWidth = euiFormMaxWidth(euiThemeContext);
 

package/es/components/flyout/flyout_child.js

@@ -0,0 +1,209 @@
+var _excluded = ["children", "className", "banner", "hideCloseButton", "onClose", "scrollableTabIndex", "size"];
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], t.indexOf(o) >= 0 || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.indexOf(n) >= 0) continue; t[n] = r[n]; } return t; }
+/*
+ * 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 PropTypes from "prop-types";
+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.propTypes = {
+  /**
+     * Called when the child panel's close button is clicked
+     */
+  onClose: PropTypes.func.isRequired,
+  /**
+     * Use to display a banner at the top of the child. It is suggested to use `EuiCallOut` for it.
+     */
+  banner: PropTypes.node,
+  /**
+     * Hides the default close button. You must provide another close button somewhere within the child flyout.
+     * @default false
+     */
+  hideCloseButton: PropTypes.bool,
+  /**
+     * [Scrollable regions (or their children) should be focusable](https://dequeuniversity.com/rules/axe/4.0/scrollable-region-focusable)
+     * to allow keyboard users to scroll the region via arrow keys.
+     *
+     * By default, EuiFlyoutChild's scroll overflow wrapper sets a `tabIndex` of `0`.
+     * If you know your flyout child content already contains focusable children
+     * that satisfy keyboard accessibility requirements, you can use this prop
+     * to override this default.
+     */
+  scrollableTabIndex: PropTypes.number,
+  /**
+     * Size of the child flyout panel.
+     * When the parent flyout is 'm', child is limited to 's'.
+     * @default 's'
+     */
+  size: PropTypes.oneOf(["s", "m"]),
+  /**
+     * Children are implicitly part of FunctionComponent, but good to have if props type is standalone.
+     */
+  children: PropTypes.node,
+  className: PropTypes.string,
+  "aria-label": PropTypes.string,
+  "data-test-subj": PropTypes.string,
+  css: PropTypes.any
+};
+EuiFlyoutChild.displayName = 'EuiFlyoutChild';

package/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/es/components/flyout/flyout_child_manager.js

@@ -0,0 +1,112 @@
+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.
+ */
+
+import React, { useEffect, useMemo, useState } from 'react';
+import PropTypes from "prop-types";
+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);
+};
+EuiFlyoutChildProvider.propTypes = {
+  parentSize: PropTypes.oneOf(["s", "m"]).isRequired,
+  parentFlyoutRef: PropTypes.any.isRequired,
+  childElement: PropTypes.element.isRequired,
+  childrenToRender: PropTypes.node.isRequired,
+  reportIsChildOpen: PropTypes.func.isRequired,
+  reportChildLayoutMode: PropTypes.func.isRequired
+};

package/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/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/es/components/flyout/sessions/flyout_provider.js

@@ -0,0 +1,109 @@
+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 _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.
+ */
+
+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)));
+};