@elastic/eui 110.0.0 → 111.0.0

package/lib/components/collapsible_nav/collapsible_nav.js

@@ -101,6 +101,7 @@ var EuiCollapsibleNav = exports.EuiCollapsibleNav = function EuiCollapsibleNav(_
   });
   var flyout = (0, _react2.jsx)(_flyout.EuiFlyout, _extends({
     id: flyoutID,
+    session: "never",
     css: cssStyles,
     className: classes
     // Flyout props we set different defaults for
@@ -122,113 +123,28 @@ var EuiCollapsibleNav = exports.EuiCollapsibleNav = function EuiCollapsibleNav(_
   return (0, _react2.jsx)(_react.default.Fragment, null, trigger, (isOpen || navIsDocked) && flyout);
 };
 EuiCollapsibleNav.propTypes = {
-  className: _propTypes.default.string,
-  "aria-label": _propTypes.default.string,
-  "data-test-subj": _propTypes.default.string,
-  css: _propTypes.default.any,
   /**
-     * Sets the HTML element for `EuiFlyout`
-     */
-  as: _propTypes.default.any,
-  onClose: _propTypes.default.func.isRequired,
-  /**
-     * Defines the width of the panel.
-     * Pass a predefined size of `s | m | l`, or pass any number/string compatible with the CSS `width` attribute
-     * @default m
-     */
-  size: _propTypes.default.oneOfType([_propTypes.default.any.isRequired, _propTypes.default.any.isRequired]),
-  /**
-     * Sets the max-width of the panel,
-     * set to `true` to use the default size,
-     * set to `false` to not restrict the width,
-     * set to a number for a custom width in px,
-     * set to a string for a custom width in custom measurement.
-     * @default false
-     */
-  maxWidth: _propTypes.default.oneOfType([_propTypes.default.bool.isRequired, _propTypes.default.number.isRequired, _propTypes.default.string.isRequired]),
-  /**
-     * Customize the padding around the content of the flyout header, body and footer
-     * @default l
-     */
-  paddingSize: _propTypes.default.any,
-  /**
-     * Adds an EuiOverlayMask and wraps in an EuiPortal
-     * @default true
-     */
-  ownFocus: _propTypes.default.bool,
-  /**
-     * Hides the default close button. You must provide another close button somewhere within the flyout.
-     * @default false
-     */
-  hideCloseButton: _propTypes.default.bool,
-  /**
-     * Extends EuiButtonIconProps onto the close button
-     */
-  closeButtonProps: _propTypes.default.any,
-  /**
-     * Position of close button.
-     * `inside`: Floating to just inside the flyout, always top right;
-     * `outside`: Floating just outside the flyout near the top (side dependent on `side`). Helpful when the close button may cover other interactable content.
-     * @default inside
-     */
-  closeButtonPosition: _propTypes.default.oneOf(["inside", "outside"]),
-  /**
-     * Adjustments to the EuiOverlayMask that is added when `ownFocus = true`
-     */
-  maskProps: _propTypes.default.shape({
-    /**
-       * ReactNode to render as this component's content
-       */
-    children: _propTypes.default.node,
-    /**
-       * Should the mask visually sit above or below the EuiHeader (controlled by z-index)
-       */
-    headerZindexLocation: _propTypes.default.oneOf(["above", "below"]),
-    /**
-       * React ref to be passed to the wrapping container
-       */
-    maskRef: _propTypes.default.oneOfType([_propTypes.default.any.isRequired, _propTypes.default.any.isRequired])
-  }),
-  /**
-     * Forces this interaction on the mask overlay or body content.
-     * Defaults depend on `ownFocus` and `type` values
-     */
-  outsideClickCloses: _propTypes.default.bool,
-  /**
-     * Which side of the window to attach to.
-     * The `left` option should only be used for navigation.
-     * @default right
-     */
-  side: _propTypes.default.any,
-  /**
-     * Named breakpoint (`xs` through `xl`) for customizing the minimum window width to enable docking
-     */
-  pushMinBreakpoint: _propTypes.default.any,
-  /**
-     * Enables a slide in animation on push flyouts
-     * @default false
-     */
-  pushAnimation: _propTypes.default.bool,
-  style: _propTypes.default.any,
-  /**
-     * Object of props passed to EuiFocusTrap.
-     * `shards` specifies an array of elements that will be considered part of the flyout, preventing the flyout from being closed when clicked.
-     * `closeOnMouseup` will delay the close callback, allowing time for external toggle buttons to handle close behavior.
-     * `returnFocus` defines the return focus behavior and provides the possibility to check the available target element or opt out of the behavior in favor of manually returning focus
+     * Controls the way the session is managed for this flyout.
+     * - `start`: Creates a new flyout session. Use this for the main flyout.
+     * - `inherit`: Inherits an existing session if one is active, otherwise functions as a standard flyout.
+     * - `never`: Disregards session management and always functions as a standard flyout.
+     *
+     * When the `session` prop is undefined (not set), the flyout will automatically inherit from
+     * a parent flyout if it's nested inside one. Otherwise, it defaults to `never`.
+     *
+     * Check out [EuiFlyout session management](https://eui.elastic.co/docs/components/containers/flyout/session-management)
+     * documentation to learn more.
+     * @default undefined (auto-inherit when nested, otherwise 'never')
      */
-  focusTrapProps: _propTypes.default.any,
+  session: _propTypes.default.oneOfType([_propTypes.default.any.isRequired, _propTypes.default.any.isRequired, _propTypes.default.any.isRequired]),
   /**
-     * By default, EuiFlyout will consider any fixed `EuiHeader`s that sit alongside or above the EuiFlyout
-     * as part of the flyout's focus trap. This prevents focus fighting with interactive elements
-     * within fixed headers.
-     *
-     * Set this to `false` if you need to disable this behavior for a specific reason.
+     * Callback fired when the flyout becomes active/visible, which may happen programmatically from history navigation.
      */
-  includeFixedHeadersInFocusTrap: _propTypes.default.bool,
+  onActive: _propTypes.default.func,
   /**
-     * Specify additional css selectors to include in the focus trap.
+     * The HTML element to render as the flyout container.
      */
-  includeSelectorInFocusTrap: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.string.isRequired).isRequired, _propTypes.default.string.isRequired]),
+  as: _propTypes.default.any,
   /**
      * ReactNode to render as this component's content
      */
@@ -241,6 +157,9 @@ EuiCollapsibleNav.propTypes = {
      * Keeps navigation flyout visible and push `<body>` content via padding
      */
   isDocked: _propTypes.default.bool,
+  /**
+     * Named breakpoint (`xs` through `xl`) for customizing the minimum window width to enable docking
+     */
   dockedBreakpoint: _propTypes.default.any,
   /**
      * Button for controlling visible state of the nav

package/lib/components/collapsible_nav_beta/collapsible_nav_beta.js

@@ -169,6 +169,7 @@ var _EuiCollapsibleNavBeta = function _EuiCollapsibleNavBeta(_ref) {
   }, rest, {
     // EuiCollapsibleNav is significantly less permissive than EuiFlyout
     id: flyoutID,
+    session: "never",
     css: cssStyles,
     className: classes,
     size: width,

package/lib/components/flyout/_flyout_overlay.js

@@ -0,0 +1,59 @@
+"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.EuiFlyoutOverlay = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _css = require("@emotion/css");
+var _overlay_mask = require("../overlay_mask");
+var _portal = require("../portal");
+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); } /*
+ * 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 getEuiFlyoutOverlayStyles = function getEuiFlyoutOverlayStyles(zIndex) {
+  /*
+  This needs to have !important to override the default EuiOverlayMask
+  z-index based on the headerZindexLocation prop. Using the style attribute
+  doesn't work since EuiOverlayMask requires a string style prop that
+  causes React errors in the test environment.
+  */
+  return /*#__PURE__*/(0, _css.css)("z-index:", zIndex, "!important;;label:getEuiFlyoutOverlayStyles;");
+};
+
+/**
+ * Light wrapper for conditionally rendering portals or overlay masks:
+ *  - If ownFocus is set, wrap with an overlay and allow the user to click it to close it.
+ *  - Otherwise still wrap within an EuiPortal so it appends to the bottom of the window.
+ * Push flyouts have no overlay OR portal behavior.
+ *
+ * @internal
+ */
+var EuiFlyoutOverlay = exports.EuiFlyoutOverlay = function EuiFlyoutOverlay(_ref) {
+  var children = _ref.children,
+    isPushed = _ref.isPushed,
+    maskProps = _ref.maskProps,
+    hasOverlayMask = _ref.hasOverlayMask,
+    maskZIndex = _ref.maskZIndex;
+  var styles = (0, _react.useMemo)(function () {
+    return getEuiFlyoutOverlayStyles(maskZIndex);
+  }, [maskZIndex]);
+  var content = children;
+  if (!isPushed || hasOverlayMask) {
+    content = (0, _react2.jsx)(_portal.EuiPortal, null, content);
+  }
+  var classes = (0, _css.cx)(maskProps === null || maskProps === void 0 ? void 0 : maskProps.className, styles);
+  return (0, _react2.jsx)(_react.default.Fragment, null, hasOverlayMask && (0, _react2.jsx)(_overlay_mask.EuiOverlayMask, _extends({
+    headerZindexLocation: "below"
+  }, maskProps, {
+    className: classes
+  })), content);
+};

package/lib/components/flyout/_flyout_resize_button.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.EuiFlyoutResizeButton = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _services = require("../../services");
+var _resizable_container = require("../resizable_container");
+var _flyout_resize_button = require("./_flyout_resize_button.styles");
+var _react2 = require("@emotion/react");
+var _excluded = ["type", "side", "ownFocus", "isPushed"];
+/*
+ * 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.
+ */
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+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; }
+var EuiFlyoutResizeButton = exports.EuiFlyoutResizeButton = function EuiFlyoutResizeButton(_ref) {
+  var type = _ref.type,
+    side = _ref.side,
+    ownFocus = _ref.ownFocus,
+    isPushed = _ref.isPushed,
+    resizableButtonProps = _objectWithoutProperties(_ref, _excluded);
+  var hasOverlay = ownFocus && type === 'overlay';
+  var styles = (0, _services.useEuiMemoizedStyles)(_flyout_resize_button.euiFlyoutResizeButtonStyles);
+  var cssStyles = [styles.root, styles[type][side], !hasOverlay && styles.noOverlay.root, !hasOverlay && styles.noOverlay[side]];
+  return (0, _react2.jsx)(_resizable_container.EuiResizableButton, _extends({
+    isHorizontal: true,
+    indicator: "border",
+    css: cssStyles
+  }, resizableButtonProps));
+};

package/{test-env/components/flyout/flyout_resizable.styles.js → lib/components/flyout/_flyout_resize_button.styles.js}

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.euiFlyoutResizableButtonStyles = void 0;
+exports.euiFlyoutResizeButtonStyles = void 0;
 var _react = require("@emotion/react");
 var _global_styling = require("../../global_styling");
 function _EMOTION_STRINGIFIED_CSS_ERROR__() { return "You have tried to stringify object returned from `css` function. It isn't supposed to be used directly (e.g. as value of the `className` prop), but rather handed to emotion so it can handle it (e.g. as value of `css` prop)."; } /*
@@ -30,25 +30,25 @@ var _ref2 = process.env.NODE_ENV === "production" ? {
   toString: _EMOTION_STRINGIFIED_CSS_ERROR__
 };
 var _ref3 = process.env.NODE_ENV === "production" ? {
-  name: "1cw850z-noOverlay",
-  styles: "margin-inline:0;label:noOverlay;"
+  name: "10l1ho9-root",
+  styles: "margin-inline:0;label:root;"
 } : {
-  name: "1cw850z-noOverlay",
-  styles: "margin-inline:0;label:noOverlay;",
+  name: "10l1ho9-root",
+  styles: "margin-inline:0;label:root;",
   toString: _EMOTION_STRINGIFIED_CSS_ERROR__
 };
 var _ref4 = process.env.NODE_ENV === "production" ? {
-  name: "1gfwqnd-euiFlyoutResizableButton",
-  styles: "position:absolute;label:euiFlyoutResizableButton;"
+  name: "1yicr0l-root",
+  styles: "position:absolute;label:root;"
 } : {
-  name: "1gfwqnd-euiFlyoutResizableButton",
-  styles: "position:absolute;label:euiFlyoutResizableButton;",
+  name: "1yicr0l-root",
+  styles: "position:absolute;label:root;",
   toString: _EMOTION_STRINGIFIED_CSS_ERROR__
 };
-var euiFlyoutResizableButtonStyles = exports.euiFlyoutResizableButtonStyles = function euiFlyoutResizableButtonStyles(_ref5) {
+var euiFlyoutResizeButtonStyles = exports.euiFlyoutResizeButtonStyles = function euiFlyoutResizeButtonStyles(_ref5) {
   var euiTheme = _ref5.euiTheme;
   return {
-    euiFlyoutResizableButton: _ref4,
+    root: _ref4,
     overlay: {
       left: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('right', 0), ";;label:left;"),
       right: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('left', 0), ";;label:right;")
@@ -58,7 +58,7 @@ var euiFlyoutResizableButtonStyles = exports.euiFlyoutResizableButtonStyles = fu
       right: /*#__PURE__*/(0, _react.css)((0, _global_styling.logicalCSS)('left', "-".concat(euiTheme.border.width.thick)), ";;label:right;")
     },
     noOverlay: {
-      noOverlay: _ref3,
+      root: _ref3,
       left: _ref2,
       right: _ref
     }

package/lib/components/flyout/const.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FLYOUT_TYPES = exports.FLYOUT_SIZES = exports.FLYOUT_SIDES = exports.FLYOUT_PADDING_SIZES = exports.DEFAULT_TYPE = exports.DEFAULT_SIZE = exports.DEFAULT_SIDE = exports.DEFAULT_PUSH_MIN_BREAKPOINT = exports.DEFAULT_PADDING_SIZE = void 0;
+exports.isEuiFlyoutSizeNamed = isEuiFlyoutSizeNamed;
+/*
+ * 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.
+ */
+
+/** Allowed flyout render types. */
+var FLYOUT_TYPES = exports.FLYOUT_TYPES = ['push', 'overlay'];
+/** Type representing a supported flyout render type. */
+
+/** Allowed flyout attachment sides. */
+var FLYOUT_SIDES = exports.FLYOUT_SIDES = ['left', 'right'];
+/** Type representing a supported flyout side. */
+
+/** Allowed named flyout sizes used by the manager. */
+var FLYOUT_SIZES = exports.FLYOUT_SIZES = ['s', 'm', 'l', 'fill'];
+/** Type representing a supported named flyout size. */
+
+/** Allowed padding sizes for flyout content. */
+var FLYOUT_PADDING_SIZES = exports.FLYOUT_PADDING_SIZES = ['none', 's', 'm', 'l'];
+/** Type representing a supported flyout padding size. */
+
+/** Default minimum breakpoint at which push-type flyouts begin to push content. */
+var DEFAULT_PUSH_MIN_BREAKPOINT = exports.DEFAULT_PUSH_MIN_BREAKPOINT = 'l';
+/** Default flyout type when none is provided. */
+var DEFAULT_TYPE = exports.DEFAULT_TYPE = 'overlay';
+/** Default side where flyouts anchor when none is provided. */
+var DEFAULT_SIDE = exports.DEFAULT_SIDE = 'right';
+/** Default named flyout size. */
+var DEFAULT_SIZE = exports.DEFAULT_SIZE = 'm';
+/** Default padding size inside flyouts. */
+var DEFAULT_PADDING_SIZE = exports.DEFAULT_PADDING_SIZE = 'l';
+
+/**
+ * Custom type checker for named flyout sizes since the prop
+ * `size` can also be CSSProperties['width'] (string | number)
+ */
+function isEuiFlyoutSizeNamed(value) {
+  return FLYOUT_SIZES.includes(value);
+}