@elastic/eui 87.1.0 → 88.0.0

package/es/components/resizable_container/resizable_button.js

@@ -1,4 +1,5 @@
-var _excluded = ["isHorizontal", "className", "id", "registration", "disabled", "onFocus", "onBlur"];
+var _excluded = ["isHorizontal", "alignIndicator", "className"],
+  _excluded2 = ["registration", "id", "disabled", "onFocus"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _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."); }
@@ -16,22 +17,77 @@ function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) r
  * Side Public License, v 1.
  */
 
-import React, { useCallback, useMemo, useRef } from 'react';
+import React, { useCallback, useMemo, useRef, forwardRef } from 'react';
 import PropTypes from "prop-types";
 import classNames from 'classnames';
 import { EuiI18n } from '../i18n';
-import { useGeneratedHtmlId } from '../../services';
+import { useEuiTheme, useGeneratedHtmlId } from '../../services';
 import { useEuiResizableContainerContext } from './context';
+import { euiResizableButtonStyles } from './resizable_button.styles';
 import { jsx as ___EmotionJSX } from "@emotion/react";
-export var EuiResizableButton = function EuiResizableButton(_ref) {
+/**
+ * A generic button for indicating/facilitating resizable content,
+ * usable outside of the EuiResizableContainer context
+ */
+export var EuiResizableButton = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var isHorizontal = _ref.isHorizontal,
+    _ref$alignIndicator = _ref.alignIndicator,
+    alignIndicator = _ref$alignIndicator === void 0 ? 'center' : _ref$alignIndicator,
     className = _ref.className,
-    id = _ref.id,
-    registration = _ref.registration,
-    disabled = _ref.disabled,
-    onFocus = _ref.onFocus,
-    onBlur = _ref.onBlur,
     rest = _objectWithoutProperties(_ref, _excluded);
+  var classes = classNames('euiResizableButton', className);
+  var euiTheme = useEuiTheme();
+  var styles = euiResizableButtonStyles(euiTheme);
+  var cssStyles = [styles.euiResizableButton, isHorizontal ? styles.horizontal : styles.vertical, styles.alignIndicator[alignIndicator]];
+  return ___EmotionJSX(EuiI18n, {
+    tokens: ['euiResizableButton.horizontalResizerAriaLabel', 'euiResizableButton.verticalResizerAriaLabel'],
+    defaults: ['Press the left or right arrow keys to adjust panels size', 'Press the up or down arrow keys to adjust panels size']
+  }, function (_ref2) {
+    var _ref3 = _slicedToArray(_ref2, 2),
+      horizontalResizerAriaLabel = _ref3[0],
+      verticalResizerAriaLabel = _ref3[1];
+    return ___EmotionJSX("button", _extends({
+      ref: ref,
+      "aria-label": isHorizontal ? horizontalResizerAriaLabel : verticalResizerAriaLabel,
+      className: classes,
+      css: cssStyles,
+      "data-test-subj": "euiResizableButton",
+      type: "button"
+    }, rest));
+  });
+});
+EuiResizableButton.propTypes = {
+  className: PropTypes.string,
+  "aria-label": PropTypes.string,
+  "data-test-subj": PropTypes.string,
+  css: PropTypes.any,
+  /**
+       * Defaults to displaying a resizer for vertical (y-axis) resizing.
+       * Set to `true` to display a resizer for horizontal (x-axis) resizing.
+       */
+  isHorizontal: PropTypes.bool,
+  /**
+       * Specify the alignment of the initial resize indicator. Defaults to `center`,
+       * but consider using `start` for extremely tall content that scrolls off-screen
+       */
+  alignIndicator: PropTypes.oneOf(["center", "start", "end"]),
+  /**
+       * When disabled, the resizer button will be completely hidden
+       */
+  disabled: PropTypes.bool
+};
+EuiResizableButton.displayName = 'EuiResizableButton';
+
+/**
+ * Resizer button specific to controlled EuiResizableContainer usage
+ */
+
+export var EuiResizableButtonControlled = function EuiResizableButtonControlled(_ref4) {
+  var registration = _ref4.registration,
+    id = _ref4.id,
+    disabled = _ref4.disabled,
+    _onFocus = _ref4.onFocus,
+    rest = _objectWithoutProperties(_ref4, _excluded2);
   var resizerId = useGeneratedHtmlId({
     prefix: 'resizable-button',
     conditionalId: id
@@ -43,13 +99,9 @@ export var EuiResizableButton = function EuiResizableButton(_ref) {
     } : _useEuiResizableConta2,
     resizers = _useEuiResizableConta3.resizers;
   var isDisabled = useMemo(function () {
-    return disabled || resizers[resizerId] && resizers[resizerId].isDisabled;
+    var _resizers$resizerId;
+    return disabled || ((_resizers$resizerId = resizers[resizerId]) === null || _resizers$resizerId === void 0 ? void 0 : _resizers$resizerId.isDisabled);
   }, [resizers, resizerId, disabled]);
-  var classes = classNames('euiResizableButton', {
-    'euiResizableButton--vertical': !isHorizontal,
-    'euiResizableButton--horizontal': isHorizontal,
-    'euiResizableButton--disabled': isDisabled
-  }, className);
   var previousRef = useRef();
   var onRef = useCallback(function (ref) {
     if (!registration) return;
@@ -68,41 +120,20 @@ export var EuiResizableButton = function EuiResizableButton(_ref) {
       }
     }
   }, [registration, resizerId, disabled]);
-  var setFocus = function setFocus(e) {
-    return e.currentTarget.focus();
-  };
-  var handleFocus = function handleFocus() {
-    onFocus && onFocus(resizerId);
-  };
-  return ___EmotionJSX(EuiI18n, {
-    tokens: ['euiResizableButton.horizontalResizerAriaLabel', 'euiResizableButton.verticalResizerAriaLabel'],
-    defaults: ['Press left or right to adjust panels size', 'Press up or down to adjust panels size']
-  }, function (_ref2) {
-    var _ref3 = _slicedToArray(_ref2, 2),
-      horizontalResizerAriaLabel = _ref3[0],
-      verticalResizerAriaLabel = _ref3[1];
-    return ___EmotionJSX("button", _extends({
-      id: resizerId,
-      ref: onRef,
-      "aria-label": isHorizontal ? horizontalResizerAriaLabel : verticalResizerAriaLabel,
-      className: classes,
-      "data-test-subj": "euiResizableButton",
-      type: "button",
-      onClick: setFocus,
-      onFocus: handleFocus,
-      onBlur: onBlur,
-      disabled: isDisabled
-    }, rest));
-  });
-};
-EuiResizableButton.propTypes = {
-  className: PropTypes.string,
-  "aria-label": PropTypes.string,
-  "data-test-subj": PropTypes.string,
-  css: PropTypes.any
+  return ___EmotionJSX(EuiResizableButton, _extends({
+    id: resizerId,
+    ref: onRef,
+    disabled: isDisabled,
+    onClick: function onClick(e) {
+      return e.currentTarget.focus();
+    },
+    onFocus: function onFocus() {
+      return _onFocus === null || _onFocus === void 0 ? void 0 : _onFocus(resizerId);
+    }
+  }, rest));
 };
-export function euiResizableButtonWithControls(controls) {
+export var euiResizableButtonWithControls = function euiResizableButtonWithControls(controls) {
   return function (props) {
-    return ___EmotionJSX(EuiResizableButton, _extends({}, controls, props));
+    return ___EmotionJSX(EuiResizableButtonControlled, _extends({}, controls, props));
   };
-}
+};

package/es/components/resizable_container/resizable_button.styles.js

@@ -0,0 +1,66 @@
+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)."; }
+/*
+ * 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 { transparentize } from '../../services';
+import { logicalCSS, mathWithUnits, euiCanAnimate } from '../../global_styling';
+var _ref = process.env.NODE_ENV === "production" ? {
+  name: "1fvu7sv-end",
+  styles: "align-items:flex-end;label:end;"
+} : {
+  name: "1fvu7sv-end",
+  styles: "align-items:flex-end;label:end;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+var _ref2 = process.env.NODE_ENV === "production" ? {
+  name: "h0ntv8-start",
+  styles: "align-items:flex-start;label:start;"
+} : {
+  name: "h0ntv8-start",
+  styles: "align-items:flex-start;label:start;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+var _ref3 = process.env.NODE_ENV === "production" ? {
+  name: "8391db-center",
+  styles: "align-items:center;label:center;"
+} : {
+  name: "8391db-center",
+  styles: "align-items:center;label:center;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+export var euiResizableButtonStyles = function euiResizableButtonStyles(euiThemeContext) {
+  var euiTheme = euiThemeContext.euiTheme;
+  var buttonSize = euiTheme.size.base;
+  var grabHandleWidth = euiTheme.size.m;
+  var grabHandleHeight = euiTheme.border.width.thin;
+  var transitionSpeed = euiTheme.animation.fast;
+  var transition = "".concat(transitionSpeed, " ease");
+  return {
+    // Mimics the "grab" icon with CSS psuedo-elements.
+    // 1. The "grab" icon transforms into a thicker straight line on :hover and :focus
+    // 2. Start/end aligned handles should have a slight margin offset that disappears on hover/focus
+    // 3. CSS hack to smooth out/anti-alias the 1px wide handles at various zoom levels
+    euiResizableButton: /*#__PURE__*/css("z-index:1;flex-shrink:0;display:flex;justify-content:center;gap:", mathWithUnits(grabHandleHeight, function (x) {
+      return x * 2;
+    }), ";&:disabled{display:none;}&:hover,&:focus{gap:0;justify-content:center;}", euiCanAnimate, "{transition:gap ", transition, ",justify-content ", transition, ";}&::before,&::after{content:'';display:block;background-color:", euiTheme.colors.darkestShade, ";transform:translateZ(0);", euiCanAnimate, "{transition:width ", transition, ",height ", transition, ",margin ", transition, ",background-color ", transition, ";}}&:hover{&::before,&::after{background-color:", euiTheme.colors.mediumShade, ";", euiCanAnimate, "{transition-delay:", transitionSpeed, ";}}}&:focus,&:active{background-color:", transparentize(euiTheme.colors.primary, 0.1), ";&::before,&::after{background-color:", euiTheme.colors.primary, ";", euiCanAnimate, "{transition:width ", transition, ",height ", transition, ";transition-delay:", mathWithUnits(transitionSpeed, function (x) {
+      return x / 2;
+    }), ";}}};label:euiResizableButton;"),
+    horizontal: /*#__PURE__*/css("cursor:col-resize;", logicalCSS('height', '100%'), " ", logicalCSS('width', buttonSize), " margin-inline:", mathWithUnits(buttonSize, function (x) {
+      return x / -2;
+    }), ";&::before,&::after{", logicalCSS('width', grabHandleHeight), " ", logicalCSS('height', grabHandleWidth), " margin-block:", euiTheme.size.base, ";}&:hover,&:focus,&:active{&::before,&::after{", logicalCSS('height', '100%'), " margin-block:0;transform:none;}};label:horizontal;"),
+    vertical: /*#__PURE__*/css("flex-direction:column;cursor:row-resize;", logicalCSS('width', '100%'), " ", logicalCSS('height', buttonSize), " margin-block:", mathWithUnits(buttonSize, function (x) {
+      return x / -2;
+    }), ";&::before,&::after{", logicalCSS('height', grabHandleHeight), " ", logicalCSS('width', grabHandleWidth), " margin-inline:", euiTheme.size.base, ";}&:hover,&:focus,&:active{&::before,&::after{", logicalCSS('width', '100%'), " margin-inline:0;transform:none;}};label:vertical;"),
+    alignIndicator: {
+      center: _ref3,
+      start: _ref2,
+      end: _ref
+    }
+  };
+};

package/es/components/resizable_container/resizable_collapse_button.js

@@ -1,5 +1,11 @@
 var _excluded = ["className", "externalPosition", "internalPosition", "direction", "isVisible", "isCollapsed"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 /*
@@ -13,11 +19,15 @@ function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) r
 import React from 'react';
 import PropTypes from "prop-types";
 import classNames from 'classnames';
+import { useEuiTheme } from '../../services';
 import { EuiButtonIcon } from '../button';
+import { euiScreenReaderOnlyStyles } from '../accessibility/screen_reader_only/screen_reader_only.styles';
+import { euiResizableCollapseButtonStyles } from './resizable_collapse_button.styles';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var EuiResizableCollapseButton = function EuiResizableCollapseButton(_ref) {
   var className = _ref.className,
-    externalPosition = _ref.externalPosition,
+    _ref$externalPosition = _ref.externalPosition,
+    externalPosition = _ref$externalPosition === void 0 ? 'before' : _ref$externalPosition,
     _ref$internalPosition = _ref.internalPosition,
     internalPosition = _ref$internalPosition === void 0 ? 'middle' : _ref$internalPosition,
     _ref$direction = _ref.direction,
@@ -26,14 +36,15 @@ export var EuiResizableCollapseButton = function EuiResizableCollapseButton(_ref
     isCollapsed = _ref.isCollapsed,
     rest = _objectWithoutProperties(_ref, _excluded);
   var isHorizontal = direction === 'horizontal';
-  var classes = classNames('euiResizableToggleButton', "euiResizableToggleButton--".concat(direction), "euiResizableToggleButton--".concat(externalPosition), "euiResizableToggleButton--".concat(internalPosition), {
-    'euiResizableToggleButton-isVisible': isVisible,
-    'euiResizableToggleButton-isCollapsed': isCollapsed
-  }, className);
-
-  // Default to simiple grab icon in case there is no externalPosition specified
-  var COLLAPSED_ICON = isHorizontal ? 'grab' : 'grabHorizontal';
-  var NOT_COLLAPSED_ICON = isHorizontal ? 'grab' : 'grabHorizontal';
+  var showOnFocus = !isCollapsed && !isVisible;
+  var screenReaderOnlyStyles = euiScreenReaderOnlyStyles(showOnFocus).euiScreenReaderOnly;
+  var euiTheme = useEuiTheme();
+  var styles = euiResizableCollapseButtonStyles(euiTheme);
+  var collapsedStyles = [styles.collapsed.collapsed, styles.collapsed[direction], styles.collapsed["".concat(direction, "Positions")][internalPosition]];
+  var collapsibleStyles = [styles.collapsible.collapsible, styles.collapsible[direction][externalPosition], styles.collapsible[direction][internalPosition]];
+  var cssStyles = [styles.euiResizableCollapseButton, showOnFocus && screenReaderOnlyStyles].concat(_toConsumableArray(isCollapsed ? collapsedStyles : collapsibleStyles));
+  var COLLAPSED_ICON = '';
+  var NOT_COLLAPSED_ICON = '';
   switch (externalPosition) {
     case 'before':
       COLLAPSED_ICON = isHorizontal ? 'menuLeft' : 'menuUp';
@@ -44,11 +55,13 @@ export var EuiResizableCollapseButton = function EuiResizableCollapseButton(_ref
       NOT_COLLAPSED_ICON = isHorizontal ? 'menuLeft' : 'menuUp';
       break;
   }
+  var classes = classNames('euiResizableCollapseButton', className);
   return ___EmotionJSX(EuiButtonIcon, _extends({
     display: isCollapsed ? 'empty' : 'base',
-    color: "text"
-  }, rest, {
+    color: "text",
     className: classes,
+    css: cssStyles
+  }, rest, {
     iconType: isCollapsed ? COLLAPSED_ICON : NOT_COLLAPSED_ICON
   }));
 };
@@ -67,9 +80,6 @@ EuiResizableCollapseButton.propTypes = {
      * Same direction derived from EuiResizableContainer
      */
   direction: PropTypes.oneOf(["vertical", "horizontal"]),
-  /**
-     *
-     */
   isVisible: PropTypes.bool,
   isCollapsed: PropTypes.bool
 };

package/es/components/resizable_container/resizable_collapse_button.styles.js

@@ -0,0 +1,85 @@
+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)."; }
+/*
+ * 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, mathWithUnits } from '../../global_styling';
+import { euiShadowXSmall, euiSlightShadowHover } from '../../themes/amsterdam';
+var _ref = process.env.NODE_ENV === "production" ? {
+  name: "fuwsll-euiResizableCollapseButton",
+  styles: "z-index:2;position:absolute;&:focus{animation:none;};label:euiResizableCollapseButton;"
+} : {
+  name: "fuwsll-euiResizableCollapseButton",
+  styles: "z-index:2;position:absolute;&:focus{animation:none;};label:euiResizableCollapseButton;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+export var euiResizableCollapseButtonStyles = function euiResizableCollapseButtonStyles(euiThemeContext) {
+  var euiTheme = euiThemeContext.euiTheme;
+  var buttonSize = euiTheme.size.l;
+  var centeringOffset = mathWithUnits(buttonSize, function (x) {
+    return x / -2;
+  }); // Use negative margins instead of transforms to avoid having to override EuiButtonIcon's CSS
+  var buttonOffset = euiTheme.size.base;
+  return {
+    euiResizableCollapseButton: _ref,
+    collapsible: {
+      collapsible: /*#__PURE__*/css("background:", euiTheme.colors.emptyShade, ";", euiShadowXSmall(euiThemeContext), " &:focus{", euiSlightShadowHover(euiThemeContext), ";};label:collapsible;"),
+      horizontal: {
+        after: /*#__PURE__*/css(logicalCSS('right', 0), " ", logicalCSS('margin-right', centeringOffset), ";;label:after;"),
+        before: /*#__PURE__*/css(logicalCSS('left', 0), " ", logicalCSS('margin-left', centeringOffset), ";;label:before;"),
+        middle: /*#__PURE__*/css(logicalCSS('top', '50%'), " ", logicalCSS('margin-top', centeringOffset), ";;label:middle;"),
+        top: /*#__PURE__*/css(logicalCSS('top', 0), " ", logicalCSS('margin-top', buttonOffset), ";;label:top;"),
+        bottom: /*#__PURE__*/css(logicalCSS('bottom', 0), " ", logicalCSS('margin-bottom', buttonOffset), ";;label:bottom;"),
+        // `left/right` aren't valid positions for the horizontal direction,
+        // so we're using getters to fall back to the `middle` CSS
+        get left() {
+          return this.middle;
+        },
+        get right() {
+          return this.middle;
+        }
+      },
+      vertical: {
+        after: /*#__PURE__*/css(logicalCSS('top', '100%'), " ", logicalCSS('margin-top', centeringOffset), ";;label:after;"),
+        before: /*#__PURE__*/css(logicalCSS('bottom', '100%'), " ", logicalCSS('margin-bottom', centeringOffset), ";;label:before;"),
+        middle: /*#__PURE__*/css(logicalCSS('left', '50%'), " ", logicalCSS('margin-left', centeringOffset), ";;label:middle;"),
+        left: /*#__PURE__*/css(logicalCSS('left', 0), " ", logicalCSS('margin-left', buttonOffset), ";;label:left;"),
+        right: /*#__PURE__*/css(logicalCSS('right', 0), " ", logicalCSS('margin-right', buttonOffset), ";;label:right;"),
+        // `top/bottom` aren't valid positions for the horizontal direction,
+        // so we're using getters to fall back to the `middle` CSS
+        get top() {
+          return this.middle;
+        },
+        get bottom() {
+          return this.middle;
+        }
+      }
+    },
+    collapsed: {
+      // When collapsed, the button itself is the full collapsed area
+      // and we use flex to align the icon within
+      collapsed: /*#__PURE__*/css("border-radius:0;", logicalCSS('top', 0), ";;label:collapsed;"),
+      horizontal: /*#__PURE__*/css(logicalCSS('height', '100%'), ";;label:horizontal;"),
+      vertical: /*#__PURE__*/css(logicalCSS('width', '100%'), ";;label:vertical;"),
+      horizontalPositions: {
+        top: /*#__PURE__*/css(logicalCSS('padding-top', buttonOffset), " align-items:flex-start;;label:top;"),
+        bottom: /*#__PURE__*/css(logicalCSS('padding-bottom', buttonOffset), " align-items:flex-end;;label:bottom;"),
+        middle: /*#__PURE__*/css(";label:middle;"),
+        left: /*#__PURE__*/css(";label:left;"),
+        right: /*#__PURE__*/css(";label:right;")
+      },
+      verticalPositions: {
+        left: /*#__PURE__*/css(logicalCSS('padding-left', buttonOffset), " justify-content:flex-start;;label:left;"),
+        right: /*#__PURE__*/css(logicalCSS('padding-right', buttonOffset), " justify-content:flex-end;;label:right;"),
+        middle: /*#__PURE__*/css(";label:middle;"),
+        top: /*#__PURE__*/css(";label:top;"),
+        bottom: /*#__PURE__*/css(";label:bottom;")
+      }
+    }
+  };
+};

package/es/components/steps/step.styles.js

@@ -40,7 +40,7 @@ export var euiStepStyles = function euiStepStyles(euiThemeContext) {
 export var euiStepContentStyles = function euiStepContentStyles(euiThemeContext) {
   var euiTheme = euiThemeContext.euiTheme;
   var euiStep = euiStepVariables(euiTheme);
-  var styles = {
+  return {
     euiStep__content: /*#__PURE__*/css(logicalCSS('margin-top', euiTheme.size.s), " ", logicalCSS('padding-top', euiTheme.size.base), " ", logicalCSS('padding-bottom', mathWithUnits([euiTheme.size.xl, euiTheme.size.s], function (x, y) {
       return x + y;
     })), " ", logicalCSS('padding-right', euiTheme.size.base), ";;label:euiStep__content;"),
@@ -50,16 +50,16 @@ export var euiStepContentStyles = function euiStepContentStyles(euiThemeContext)
     })), logicalCSS('margin-left', mathWithUnits(euiStep.numberSize, function (x) {
       return x / 2;
     })), ";;label:m;"),
-    s: /*#__PURE__*/css(";label:s;"),
-    // s is the same as m, so we'll programmatically duplicate it below
+    // `s` is the same as `m` - use a getter to duplicate its content
+    get s() {
+      return this.m;
+    },
     xs: /*#__PURE__*/css(logicalCSS('padding-left', mathWithUnits([euiStep.numberXSSize, euiStep.numberMargin], function (x, y) {
       return x / 2 + y;
     })), logicalCSS('margin-left', mathWithUnits(euiStep.numberXSSize, function (x) {
       return x / 2;
     })), ";;label:xs;")
   };
-  styles.s = styles.m;
-  return styles;
 };
 export var euiStepTitleStyles = function euiStepTitleStyles(euiThemeContext) {
   var euiTheme = euiThemeContext.euiTheme;

package/es/components/suggest/suggest.js

@@ -49,6 +49,22 @@ var statusMap = {
 
 // keys of _EuiSuggestItemPropsBase
 var suggestItemPropsKeys = ['label', 'type', 'description', 'labelDisplay', 'labelWidth', 'descriptionDisplay'];
+
+/**
+ * @deprecated
+ */
+
+/**
+ * @deprecated
+ */
+
+/**
+ * @deprecated - EuiSuggest is scheduled for deprecation due to low internal usage and high
+ * overlap with other existing EUI components. We recommend using EuiSelectable instead,
+ * or copying this component into your own application for usage if necessary.
+ *
+ * The component will be permanently removed in October 2023.
+ */
 export var EuiSuggest = function EuiSuggest(_ref) {
   var onItemClick = _ref.onItemClick,
     onBlur = _ref.onBlur,

package/es/components/suggest/suggest_item.js

@@ -15,6 +15,10 @@ import PropTypes from "prop-types";
 import { keysOf } from '../common';
 import classNames from 'classnames';
 import { EuiIcon } from '../icon';
+
+/**
+ * @deprecated
+ */
 import { jsx as ___EmotionJSX } from "@emotion/react";
 var colorToClassNameMap = {
   tint0: 'euiSuggestItem__type--tint0',
@@ -30,6 +34,14 @@ var colorToClassNameMap = {
   tint10: 'euiSuggestItem__type--tint10'
 };
 export var COLORS = keysOf(colorToClassNameMap);
+
+/**
+ * @deprecated - EuiSuggest is scheduled for deprecation due to low internal usage and high
+ * overlap with other existing EUI components. We recommend using EuiSelectable instead,
+ * or copying this component into your own application for usage if necessary.
+ *
+ * The component will be permanently removed in October 2023.
+ */
 export var EuiSuggestItem = function EuiSuggestItem(_ref) {
   var className = _ref.className,
     label = _ref.label,

package/es/services/accessibility/html_id_generator.js

@@ -6,8 +6,8 @@
  * Side Public License, v 1.
  */
 
+import React, { useMemo } from 'react';
 import { v1 as uuidv1 } from 'uuid';
-import { useMemo } from 'react';
 
 /**
  * This function returns a function to generate ids.
@@ -32,7 +32,8 @@ export function htmlIdGenerator() {
  * This prevents IDs from being re-randomized on every component update.
  */
 
-export var useGeneratedHtmlId = function useGeneratedHtmlId() {
+// We can remove this deprecated hook once EUI no longer needs to support React 16-17
+var useDeprecatedGeneratedHtmlId = function useDeprecatedGeneratedHtmlId() {
   var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
     prefix = _ref.prefix,
     suffix = _ref.suffix,
@@ -40,4 +41,19 @@ export var useGeneratedHtmlId = function useGeneratedHtmlId() {
   return useMemo(function () {
     return conditionalId || htmlIdGenerator(prefix)(suffix);
   }, [conditionalId, prefix, suffix]);
-};
+};
+var useNewGeneratedHtmlId = function useNewGeneratedHtmlId() {
+  var _ref2 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+    _ref2$prefix = _ref2.prefix,
+    prefix = _ref2$prefix === void 0 ? '' : _ref2$prefix,
+    _ref2$suffix = _ref2.suffix,
+    suffix = _ref2$suffix === void 0 ? '' : _ref2$suffix,
+    conditionalId = _ref2.conditionalId;
+  // Using the default export and dot notation here is intentional
+  // to prevent React <18 import errors.
+  var id = React.useId();
+  return useMemo(function () {
+    return conditionalId || "".concat(prefix).concat(id).concat(suffix);
+  }, [id, conditionalId, prefix, suffix]);
+};
+export var useGeneratedHtmlId = 'useId' in React ? useNewGeneratedHtmlId : useDeprecatedGeneratedHtmlId;

package/es/services/color_picker/color_picker.js

@@ -18,6 +18,10 @@ var generateRandomColor = function generateRandomColor() {
     "#".concat(Math.floor(Math.random() * 16777215).toString(16))
   );
 };
+
+/**
+ * @deprecated
+ */
 export var useColorStopsState = function useColorStopsState() {
   var useRandomColor = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
   var initialColorStops = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [{

package/es/themes/amsterdam/global_styling/mixins/shadow.js

@@ -78,7 +78,6 @@ export var euiShadowXLarge = function euiShadowXLarge(_ref9) {
 
 /**
  * slightShadowHover
- * TODO: I think this is only used by panels/cards in the Amsterdam theme, move there
  */
 export var euiSlightShadowHover = function euiSlightShadowHover(_ref11) {
   var euiTheme = _ref11.euiTheme,