@elastic/eui 104.1.0 → 105.0.0

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

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.euiFlyoutStyles = exports.euiFlyoutSlideInRight = exports.euiFlyoutSlideInLeft = exports.FLYOUT_BREAKPOINT = void 0;
+exports.maxedFlyoutWidth = exports.euiFlyoutStyles = exports.euiFlyoutSlideInRight = exports.euiFlyoutSlideInLeft = exports.composeFlyoutSizing = exports.FLYOUT_BREAKPOINT = void 0;
 var _react = require("@emotion/react");
 var _euiThemeCommon = require("@elastic/eui-theme-common");
 var _global_styling = require("../../global_styling");
@@ -32,14 +32,15 @@ var euiFlyoutStyles = exports.euiFlyoutStyles = function euiFlyoutStyles(euiThem
   var euiTheme = euiThemeContext.euiTheme,
     colorMode = euiThemeContext.colorMode;
   return {
-    euiFlyout: /*#__PURE__*/(0, _react.css)("position:fixed;", (0, _global_styling.logicalCSS)('bottom', 0), " ", (0, _global_styling.logicalCSS)('top', 'var(--euiFixedHeadersOffset, 0)'), " ", (0, _global_styling.logicalCSS)('height', 'inherit'), " z-index:", euiTheme.levels.flyout, ";background:", euiTheme.colors.emptyShade, ";display:flex;flex-direction:column;align-items:stretch;&:focus{outline:none;}", (0, _global_styling.euiMaxBreakpoint)(euiThemeContext, FLYOUT_BREAKPOINT), "{", (0, _global_styling.logicalCSS)('max-width', '90vw !important'), ";};label:euiFlyout;"),
+    euiFlyout: /*#__PURE__*/(0, _react.css)("position:fixed;", (0, _global_styling.logicalCSS)('bottom', 0), " ", (0, _global_styling.logicalCSS)('top', 'var(--euiFixedHeadersOffset, 0)'), " ", (0, _global_styling.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__*/(0, _react.css)(composeFlyoutSizing(euiThemeContext, 's'), ";;label:s;"),
-    m: /*#__PURE__*/(0, _react.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__*/(0, _react.css)(composeFlyoutSizing(euiThemeContext, 's'), " &.euiFlyout--hasChild--stacked.euiFlyout--hasChild--m{", composeFlyoutSizing(euiThemeContext, 'm'), ";};label:s;"),
+    m: /*#__PURE__*/(0, _react.css)(composeFlyoutSizing(euiThemeContext, 'm'), " &.euiFlyout--hasChild--stacked.euiFlyout--hasChild--s{", composeFlyoutSizing(euiThemeContext, 's'), ";};label:m;"),
     l: /*#__PURE__*/(0, _react.css)(composeFlyoutSizing(euiThemeContext, 'l'), ";;label:l;"),
     noMaxWidth: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('max-width', 'none'), ";;label:noMaxWidth;"),
     // Side
-    right: /*#__PURE__*/(0, _react.css)("clip-path:polygon(-50% 0, 100% 0, 100% 100%, -50% 100%);", (0, _global_styling.logicalCSS)('right', 0), " ", _global_styling.euiCanAnimate, "{animation:", euiFlyoutSlideInRight, " ", euiTheme.animation.normal, " ", euiTheme.animation.resistance, ";};label:right;"),
+    right: /*#__PURE__*/(0, _react.css)("clip-path:polygon(-50% 0, 100% 0, 100% 100%, -50% 100%);", (0, _global_styling.logicalCSS)('right', 0), " ", _global_styling.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__*/(0, _react.css)((0, _global_styling.logicalCSS)('left', 0), " clip-path:polygon(0 0, 150% 0, 150% 100%, 0 100%);", _global_styling.euiCanAnimate, "{animation:", euiFlyoutSlideInLeft, " ", euiTheme.animation.normal, " ", euiTheme.animation.resistance, ";};label:left;"),
     // Type
@@ -65,7 +66,10 @@ var euiFlyoutStyles = exports.euiFlyoutStyles = function euiFlyoutStyles(euiThem
     }
   };
 };
-var composeFlyoutSizing = function composeFlyoutSizing(euiThemeContext, size) {
+var maxedFlyoutWidth = exports.maxedFlyoutWidth = function maxedFlyoutWidth(euiThemeContext) {
+  return "\n  ".concat((0, _global_styling.euiMaxBreakpoint)(euiThemeContext, FLYOUT_BREAKPOINT), " {\n    ").concat((0, _global_styling.logicalCSS)('max-width', '90vw !important'), "\n  }\n");
+};
+var composeFlyoutSizing = exports.composeFlyoutSizing = function composeFlyoutSizing(euiThemeContext, size) {
   var euiTheme = euiThemeContext.euiTheme;
   var formMaxWidth = (0, _form.euiFormMaxWidth)(euiThemeContext);
 

package/lib/components/flyout/flyout_child.js

@@ -0,0 +1,217 @@
+"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.EuiFlyoutChild = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _classnames = _interopRequireDefault(require("classnames"));
+var _services = require("../../services");
+var _flyout_child = require("./flyout_child.styles");
+var _flyout_close_button = require("./_flyout_close_button");
+var _flyout_context = require("./flyout_context");
+var _flyout_body = require("./flyout_body");
+var _focus_trap = require("../focus_trap");
+var _react2 = require("@emotion/react");
+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.
+ */
+/**
+ * Props used to render and configure the child flyout panel
+ */
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+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 _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; }
+/**
+ * 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.
+ */
+var EuiFlyoutChild = exports.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 = (0, _react.useContext)(_flyout_context.EuiFlyoutContext);
+  if (!flyoutContext) {
+    throw new Error('EuiFlyoutChild must be used as a child of EuiFlyout.');
+  }
+  var setIsChildFlyoutOpen = flyoutContext.setIsChildFlyoutOpen,
+    parentSize = flyoutContext.parentSize;
+  (0, _react.useEffect)(function () {
+    setIsChildFlyoutOpen === null || setIsChildFlyoutOpen === void 0 || setIsChildFlyoutOpen(true);
+    return function () {
+      setIsChildFlyoutOpen === null || setIsChildFlyoutOpen === void 0 || setIsChildFlyoutOpen(false);
+    };
+  }, [setIsChildFlyoutOpen]);
+  if (_react.default.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;
+  _react.Children.forEach(children, function (child) {
+    if ( /*#__PURE__*/_react.default.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.default.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 === _flyout_body.EuiFlyoutBody) {
+        hasDescribedByBody = true;
+      }
+    }
+  });
+  var titleIdGenerated = (0, _services.useGeneratedHtmlId)({
+    prefix: 'euiFlyoutChildTitle'
+  });
+  var bodyIdGenerated = (0, _services.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 = (0, _react.useMemo)(function () {
+    return _react.Children.map(children, function (child) {
+      if ( /*#__PURE__*/_react.default.isValidElement(child)) {
+        var _child$type2, _child$type3;
+        if ((child.type === _flyout_body.EuiFlyoutBody || ((_child$type2 = child.type) === null || _child$type2 === void 0 ? void 0 : _child$type2.displayName) === 'EuiFlyoutBody') && hasDescribedByBody) {
+          return /*#__PURE__*/_react.default.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.default.cloneElement(child, {
+            id: titleIdGenerated
+          });
+        }
+      }
+      return child;
+    });
+  }, [children, bodyIdGenerated, titleIdGenerated, hasDescribedByBody, flyoutTitleText, ariaLabelledBy]);
+  var flyoutWrapperRef = (0, _react.useRef)(null);
+  var classes = (0, _classnames.default)('euiFlyoutChild', className);
+  var styles = (0, _services.useEuiMemoizedStyles)(_flyout_child.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 (0, _react2.jsx)(_focus_trap.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
+  }, (0, _react2.jsx)("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 && (0, _react2.jsx)("h2", {
+    id: titleIdGenerated,
+    className: "euiScreenReaderOnly"
+  }, flyoutTitleText), !hideCloseButton && (0, _react2.jsx)(_flyout_close_button.EuiFlyoutCloseButton, {
+    className: "euiFlyoutChild__closeButton",
+    css: styles.closeButton,
+    onClose: handleClose,
+    side: "right",
+    closeButtonPosition: "inside",
+    "data-test-subj": "euiFlyoutChildCloseButton"
+  }), (0, _react2.jsx)("div", {
+    tabIndex: scrollableTabIndex,
+    className: "euiFlyoutChild__overflow",
+    css: styles.overflow.overflow
+  }, banner && (0, _react2.jsx)("div", {
+    className: "euiFlyoutChild__banner",
+    css: styles.banner,
+    "data-test-subj": "euiFlyoutChildBanner"
+  }, banner), (0, _react2.jsx)("div", {
+    className: "euiFlyoutChild__overflowContent",
+    css: styles.overflow.wrapper
+  }, processedChildren))));
+};
+EuiFlyoutChild.propTypes = {
+  /**
+     * Called when the child panel's close button is clicked
+     */
+  onClose: _propTypes.default.func.isRequired,
+  /**
+     * Use to display a banner at the top of the child. It is suggested to use `EuiCallOut` for it.
+     */
+  banner: _propTypes.default.node,
+  /**
+     * Hides the default close button. You must provide another close button somewhere within the child flyout.
+     * @default false
+     */
+  hideCloseButton: _propTypes.default.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.default.number,
+  /**
+     * Size of the child flyout panel.
+     * When the parent flyout is 'm', child is limited to 's'.
+     * @default 's'
+     */
+  size: _propTypes.default.oneOf(["s", "m"]),
+  /**
+     * Children are implicitly part of FunctionComponent, but good to have if props type is standalone.
+     */
+  children: _propTypes.default.node,
+  className: _propTypes.default.string,
+  "aria-label": _propTypes.default.string,
+  "data-test-subj": _propTypes.default.string,
+  css: _propTypes.default.any
+};
+EuiFlyoutChild.displayName = 'EuiFlyoutChild';

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

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

package/lib/components/flyout/flyout_child_manager.js

@@ -0,0 +1,120 @@
+"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.EuiFlyoutChildProvider = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _services = require("../../services");
+var _flyout_context = require("./flyout_context");
+var _react2 = require("@emotion/react");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+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.
+ */
+/**
+ * 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.
+ */
+var EuiFlyoutChildProvider = exports.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 = (0, _services.useEuiTheme)(),
+    euiTheme = _useEuiTheme.euiTheme;
+  var _useState = (0, _react.useState)(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    isChildFlyoutOpen = _useState2[0],
+    setIsChildFlyoutOpen = _useState2[1];
+  var _useState3 = (0, _react.useState)(typeof window !== 'undefined' ? window.innerWidth : Infinity),
+    _useState4 = _slicedToArray(_useState3, 2),
+    windowWidth = _useState4[0],
+    setWindowWidth = _useState4[1];
+  var _useState5 = (0, _react.useState)('side-by-side'),
+    _useState6 = _slicedToArray(_useState5, 2),
+    childLayoutMode = _useState6[0],
+    setChildLayoutMode = _useState6[1];
+
+  // update windowWidth on resize
+  (0, _react.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 = (0, _react.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
+  (0, _react.useEffect)(function () {
+    if (windowWidth >= stackingBreakpointValue) {
+      setChildLayoutMode('side-by-side');
+    } else {
+      setChildLayoutMode('stacked');
+    }
+  }, [windowWidth, stackingBreakpointValue]);
+
+  // report isChildFlyoutOpen changes to the parent EuiFlyout
+  (0, _react.useEffect)(function () {
+    reportIsChildOpen(isChildFlyoutOpen);
+  }, [isChildFlyoutOpen, reportIsChildOpen]);
+
+  // report childLayoutMode changes to the parent EuiFlyout
+  (0, _react.useEffect)(function () {
+    reportChildLayoutMode(childLayoutMode);
+  }, [childLayoutMode, reportChildLayoutMode]);
+  var contextValue = (0, _react.useMemo)(function () {
+    return {
+      parentSize: parentSize,
+      parentFlyoutRef: parentFlyoutRef,
+      isChildFlyoutOpen: isChildFlyoutOpen,
+      setIsChildFlyoutOpen: setIsChildFlyoutOpen,
+      childLayoutMode: childLayoutMode
+    };
+  }, [parentSize, parentFlyoutRef, isChildFlyoutOpen, setIsChildFlyoutOpen, childLayoutMode]);
+  return (0, _react2.jsx)(_flyout_context.EuiFlyoutContext.Provider, {
+    value: contextValue
+  }, childrenToRender);
+};
+EuiFlyoutChildProvider.propTypes = {
+  parentSize: _propTypes.default.oneOf(["s", "m"]).isRequired,
+  parentFlyoutRef: _propTypes.default.any.isRequired,
+  childElement: _propTypes.default.element.isRequired,
+  childrenToRender: _propTypes.default.node.isRequired,
+  reportIsChildOpen: _propTypes.default.func.isRequired,
+  reportChildLayoutMode: _propTypes.default.func.isRequired
+};

package/lib/components/flyout/flyout_context.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiFlyoutContext = void 0;
+var _react = require("react");
+/*
+ * 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.
+ */
+
+/**
+ * Context shared between the main and child flyouts
+ * @internal
+ */
+
+var EuiFlyoutContext = exports.EuiFlyoutContext = /*#__PURE__*/(0, _react.createContext)(null);

package/lib/components/flyout/index.js

@@ -15,6 +15,12 @@ Object.defineProperty(exports, "EuiFlyoutBody", {
     return _flyout_body.EuiFlyoutBody;
   }
 });
+Object.defineProperty(exports, "EuiFlyoutChild", {
+  enumerable: true,
+  get: function get() {
+    return _flyout_child.EuiFlyoutChild;
+  }
+});
 Object.defineProperty(exports, "EuiFlyoutFooter", {
   enumerable: true,
   get: function get() {
@@ -33,6 +39,12 @@ Object.defineProperty(exports, "EuiFlyoutResizable", {
     return _flyout_resizable.EuiFlyoutResizable;
   }
 });
+Object.defineProperty(exports, "EuiFlyoutSessionProvider", {
+  enumerable: true,
+  get: function get() {
+    return _sessions.EuiFlyoutSessionProvider;
+  }
+});
 Object.defineProperty(exports, "euiFlyoutSlideInLeft", {
   enumerable: true,
   get: function get() {
@@ -45,9 +57,17 @@ Object.defineProperty(exports, "euiFlyoutSlideInRight", {
     return _flyout2.euiFlyoutSlideInRight;
   }
 });
+Object.defineProperty(exports, "useEuiFlyoutSession", {
+  enumerable: true,
+  get: function get() {
+    return _sessions.useEuiFlyoutSession;
+  }
+});
 var _flyout = require("./flyout");
 var _flyout_body = require("./flyout_body");
 var _flyout_footer = require("./flyout_footer");
 var _flyout_header = require("./flyout_header");
 var _flyout2 = require("./flyout.styles");
-var _flyout_resizable = require("./flyout_resizable");
+var _flyout_resizable = require("./flyout_resizable");
+var _flyout_child = require("./flyout_child");
+var _sessions = require("./sessions");

package/lib/components/flyout/sessions/flyout_provider.js

@@ -0,0 +1,116 @@
+"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.useEuiFlyoutSessionContext = exports.EuiFlyoutSessionProvider = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _index = require("../index");
+var _flyout_reducer = require("./flyout_reducer");
+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; }
+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.
+ */
+var EuiFlyoutSessionContext = /*#__PURE__*/(0, _react.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.
+ */
+var useEuiFlyoutSessionContext = exports.useEuiFlyoutSessionContext = function useEuiFlyoutSessionContext() {
+  var context = (0, _react.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.
+ */
+var EuiFlyoutSessionProvider = exports.EuiFlyoutSessionProvider = function EuiFlyoutSessionProvider(_ref) {
+  var children = _ref.children,
+    renderMainFlyoutContent = _ref.renderMainFlyoutContent,
+    renderChildFlyoutContent = _ref.renderChildFlyoutContent;
+  var _useReducer = (0, _react.useReducer)(_flyout_reducer.flyoutReducer, _flyout_reducer.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 (0, _react2.jsx)(EuiFlyoutSessionContext.Provider, {
+    value: {
+      state: state,
+      dispatch: dispatch
+    }
+  }, children, (activeFlyoutGroup === null || activeFlyoutGroup === void 0 ? void 0 : activeFlyoutGroup.isMainOpen) && (0, _react2.jsx)(_index.EuiFlyout, _extends({
+    onClose: handleClose,
+    size: activeFlyoutGroup.config.mainSize,
+    ownFocus: !activeFlyoutGroup.isChildOpen
+  }, flyoutPropsMain), mainFlyoutContentNode, activeFlyoutGroup.isChildOpen && childFlyoutContentNode && (0, _react2.jsx)(_index.EuiFlyoutChild, _extends({
+    onClose: handleCloseChild,
+    size: activeFlyoutGroup.config.childSize
+  }, flyoutPropsChild), childFlyoutContentNode)));
+};