@elastic/eui 102.1.0 → 102.2.0-snapshot.1748601905883

package/es/components/search_bar/search_bar.a11y.js

@@ -189,7 +189,7 @@ describe('EuiSearchBar', function () {
       cy.checkAxe();
     });
     it('has zero violations after filtering on Open items', function () {
-      cy.get('button.euiButtonEmpty').first().focus();
+      cy.get('button.euiFilterButton').first().focus();
       cy.realPress('Enter');
       cy.get('table.euiTable tbody').find('tr').should('have.length', 3);
       cy.checkAxe();
@@ -200,12 +200,12 @@ describe('EuiSearchBar', function () {
       cy.checkAxe();
     });
     it('has zero violations after filtering by Tags', function () {
-      cy.get('button.euiButtonEmpty').last().focus();
+      cy.get('button.euiFilterButton').last().focus();
       cy.realPress('Enter');
       cy.realPress('ArrowDown');
       cy.realPress('Enter');
       cy.realPress('Escape');
-      cy.get('button.euiButtonEmpty').last().should('have.focus');
+      cy.get('button.euiFilterButton').last().should('have.focus');
       cy.get('table.euiTable tbody').find('tr').should('have.length', 3);
       cy.checkAxe();
       cy.repeatRealPress(['Shift', 'Tab'], 3);

package/es/components/search_bar/search_bar.js

@@ -310,7 +310,7 @@ EuiSearchBar.propTypes = {
     }).isRequired, PropTypes.bool.isRequired])
   }),
   /**
-     An array of search filters. See #SearchFilterConfig.
+     An array of search filters. See {@link SearchFilterConfig}.
      */
   filters: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.shape({
     type: PropTypes.oneOf(["is"]).isRequired,
@@ -323,7 +323,7 @@ EuiSearchBar.propTypes = {
     field: PropTypes.string,
     name: PropTypes.string.isRequired,
     /**
-       * See #FieldValueOptionType
+       * See {@link FieldValueOptionType}
        */
     options: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.shape({
       field: PropTypes.string,
@@ -379,7 +379,7 @@ EuiSearchBar.propTypes = {
     type: PropTypes.oneOf(["field_value_toggle_group"]).isRequired,
     field: PropTypes.string.isRequired,
     /**
-       * See #FieldValueToggleGroupFilterItemType
+       * See {@link FieldValueToggleGroupFilterItemType}
        */
     items: PropTypes.arrayOf(PropTypes.shape({
       value: PropTypes.oneOfType([PropTypes.string.isRequired, PropTypes.number.isRequired, PropTypes.bool.isRequired]).isRequired,

package/es/components/search_bar/search_filters.js

@@ -71,7 +71,7 @@ EuiSearchBarFilters.propTypes = {
     field: PropTypes.string,
     name: PropTypes.string.isRequired,
     /**
-       * See #FieldValueOptionType
+       * See {@link FieldValueOptionType}
        */
     options: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.shape({
       field: PropTypes.string,
@@ -127,7 +127,7 @@ EuiSearchBarFilters.propTypes = {
     type: PropTypes.oneOf(["field_value_toggle_group"]).isRequired,
     field: PropTypes.string.isRequired,
     /**
-       * See #FieldValueToggleGroupFilterItemType
+       * See {@link FieldValueToggleGroupFilterItemType}
        */
     items: PropTypes.arrayOf(PropTypes.shape({
       value: PropTypes.oneOfType([PropTypes.string.isRequired, PropTypes.number.isRequired, PropTypes.bool.isRequired]).isRequired,

package/es/components/selectable/selectable.js

@@ -48,15 +48,16 @@ import { EuiSelectableList } from './selectable_list';
 import { createPartialStringEqualityOptionMatcher, getMatchingOptions } from './matching_options';
 import { euiSelectableStyles as styles } from './selectable.styles';
 
-// The `searchable` prop has significant implications for a11y.
-// When present, we effectively change from adhering
-// to the ARIA `listbox` spec (https://www.w3.org/TR/wai-aria-practices-1.2/#Listbox)
-// to the ARIA `combobox` spec (https://www.w3.org/TR/wai-aria-practices-1.2/#combobox)
-// and (re)implement all relevant attributes and keyboard interactions.
-// Take note of logic that relies on `searchable` to ensure that any
-// modifications remain in alignment.
-//
-// `searchProps` can only be specified when `searchable` is true
+/**
+ * The `searchable` prop has significant implications for a11y. When present, we effectively change from adhering to the
+ * - ARIA `listbox` spec (@see https://www.w3.org/TR/wai-aria-practices-1.2/#Listbox)
+ * - ARIA `combobox` spec (@see https://www.w3.org/TR/wai-aria-practices-1.2/#combobox)
+ *
+ * and (re)implement all relevant attributes and keyboard interactions.
+ * Take note of logic that relies on `searchable` to ensure that any modifications remain in alignment.
+ *
+ * `searchProps` can only be specified when `searchable` is `true`.
+ */
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var EuiSelectable = /*#__PURE__*/function (_Component) {
   function EuiSelectable(props) {
@@ -592,7 +593,7 @@ EuiSelectable.propTypes = {
   searchable: PropTypes.oneOfType([PropTypes.oneOf([false]).isRequired, PropTypes.oneOf([true]).isRequired]).isRequired,
   /**
        * Passes props down to the `EuiFieldSearch`.
-       * See #EuiSelectableSearchProps
+       * {@link EuiSelectableSearchProps}
        */
   searchProps: PropTypes.any,
   /**
@@ -601,7 +602,7 @@ EuiSelectable.propTypes = {
        */
   children: PropTypes.func,
   /**
-       * Array of EuiSelectableOption objects. See #EuiSelectableOption
+       * Array of EuiSelectableOption objects. See {@link EuiSelectableOption}
        */
   options: PropTypes.arrayOf(PropTypes.shape({
     /**
@@ -706,7 +707,7 @@ EuiSelectable.propTypes = {
        */
   height: PropTypes.oneOfType([PropTypes.number.isRequired, PropTypes.oneOf(["full"])]),
   /**
-       * See #EuiSelectableOptionsListProps
+       * See {@link EuiSelectableOptionsListPropsWithDefaults}
        */
   listProps: PropTypes.any,
   /**

package/es/components/selectable/selectable_templates/selectable_template_sitewide.js

@@ -227,8 +227,8 @@ export var EuiSelectableTemplateSitewide = function EuiSelectableTemplateSitewid
 };
 EuiSelectableTemplateSitewide.propTypes = {
   /**
-     * Extends the typical #EuiSelectableTemplateSitewideOption with the addition of pre-composed elements
-     * such as `icon`, `avatar`and `meta`
+     * Extends the typical EuiSelectable {@link EuiSelectableTemplateSitewideOption} with the addition of pre-composed elements
+     * such as `icon`, `avatar` and `meta`
      */
   options: PropTypes.arrayOf(PropTypes.shape({
     /**
@@ -326,7 +326,7 @@ EuiSelectableTemplateSitewide.propTypes = {
       isDisabled: PropTypes.bool
     }),
     /**
-       * An array of inline #EuiSelectableTemplateSitewideMetaData displayed beneath the label and separated by bullets.
+       * An array of inline {@link EuiSelectableTemplateSitewideMetaData} displayed beneath the label and separated by bullets.
        */
     meta: PropTypes.arrayOf(PropTypes.shape({
       /**

package/es/components/side_nav/side_nav.js

@@ -200,7 +200,7 @@ EuiSideNavClass.propTypes = {
        */
   heading: PropTypes.node,
   /**
-       * Adds a couple extra #EuiSideNavHeading props and extends the props of EuiTitle that wraps the `heading`
+       * Adds a couple extra {@link EuiSideNavHeading} props and extends the props of EuiTitle that wraps the `heading`
        */
   headingProps: PropTypes.any,
   /**
@@ -221,7 +221,7 @@ EuiSideNavClass.propTypes = {
        */
   mobileBreakpoints: PropTypes.arrayOf(PropTypes.any.isRequired),
   /**
-       *  An array of #EuiSideNavItem objects. Lists navigation menu items.
+       *  An array of {@link EuiSideNavItem} objects. Lists navigation menu items.
        */
   items: PropTypes.arrayOf(PropTypes.shape({
     /**

package/es/components/table/table_row_cell.js

@@ -124,7 +124,7 @@ EuiTableRowCell.propTypes = {
   isExpander: PropTypes.bool,
   /**
      * Mobile options for displaying differently at small screens;
-     * See #EuiTableRowCellMobileOptionsShape
+     * See {@link EuiTableRowCellMobileOptionsShape}
      */
   mobileOptions: PropTypes.shape({
     /**

package/es/components/timeline/timeline.js

@@ -45,7 +45,7 @@ export var EuiTimeline = function EuiTimeline(_ref) {
 };
 EuiTimeline.propTypes = {
   /**
-     * List of timeline items to render. See #EuiTimelineItem
+     * List of timeline items to render. See {@link EuiTimelineItem}
      */
   items: PropTypes.arrayOf(PropTypes.shape({
     /**

package/es/components/toast/global_toast_list.js

@@ -7,6 +7,10 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _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 _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
 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; } }
@@ -58,10 +62,10 @@ export var EuiGlobalToastList = function EuiGlobalToastList(_ref) {
     _useState2 = _slicedToArray(_useState, 2),
     toastIdToDismissedMap = _useState2[0],
     setToastIdToDismissedMap = _useState2[1];
-  var _useState3 = useState(),
+  var _useState3 = useState([]),
     _useState4 = _slicedToArray(_useState3, 2),
-    toastToDismiss = _useState4[0],
-    setToastToDismiss = _useState4[1];
+    toastsToDismiss = _useState4[0],
+    setToastsToDismiss = _useState4[1];
   var prevToasts = useRef([]);
   var dismissTimeoutIds = useRef([]);
   var toastIdToTimerMap = useRef({});
@@ -135,7 +139,9 @@ export var EuiGlobalToastList = function EuiGlobalToastList(_ref) {
   var dismissToast = useCallback(function (toast) {
     // Remove the toast after it's done fading out.
     dismissTimeoutIds.current.push(window.setTimeout(function () {
-      setToastToDismiss(toast);
+      setToastsToDismiss(function (toasts) {
+        return [].concat(_toConsumableArray(toasts), [toast]);
+      });
     }, TOAST_FADE_OUT_MS));
     setToastIdToDismissedMap(function (prev) {
       return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, toast.id, true));
@@ -205,22 +211,23 @@ export var EuiGlobalToastList = function EuiGlobalToastList(_ref) {
   // Toast dismissal side effect
   // Ensure the callback has correct state by not enclosing it in `setTimeout`
   useEffect(function () {
-    var toast = toastToDismiss;
-    // Because this is triggered by a setTimeout, and because React does not guarantee when
-    // state updates happen, it is possible to double-dismiss a toast
-    // including by double-clicking the "x" button on the toast
-    // so, first check to make sure we haven't already dismissed this toast
-    if (toast && toastIdToTimerMap.current.hasOwnProperty(toast.id)) {
-      dismissToastProp(toast);
-      toastIdToTimerMap.current[toast.id].clear();
-      delete toastIdToTimerMap.current[toast.id];
-      setToastIdToDismissedMap(function (prev) {
-        var toastIdToDismissedMap = _objectSpread({}, prev);
-        delete toastIdToDismissedMap[toast.id];
-        return toastIdToDismissedMap;
-      });
-    }
-  }, [toastToDismiss, dismissToastProp]);
+    toastsToDismiss.forEach(function (toast) {
+      // Because this is triggered by a setTimeout, and because React does not guarantee when
+      // state updates happen, it is possible to double-dismiss a toast
+      // including by double-clicking the "x" button on the toast
+      // so, first check to make sure we haven't already dismissed this toast
+      if (toast && toastIdToTimerMap.current.hasOwnProperty(toast.id)) {
+        dismissToastProp(toast);
+        toastIdToTimerMap.current[toast.id].clear();
+        delete toastIdToTimerMap.current[toast.id];
+        setToastIdToDismissedMap(function (prev) {
+          var toastIdToDismissedMap = _objectSpread({}, prev);
+          delete toastIdToDismissedMap[toast.id];
+          return toastIdToDismissedMap;
+        });
+      }
+    });
+  }, [toastsToDismiss, dismissToastProp]);
   var renderedToasts = useMemo(function () {
     return toasts.map(function (toast) {
       var text = toast.text,

package/es/components/tour/tour_step.js

@@ -207,7 +207,7 @@ EuiTourStep.propTypes = {
      */
   panelStyle: PropTypes.any,
   /**
-     * Object of props passed to EuiPanel. See #EuiPopoverPanelProps
+     * Object of props passed to EuiPanel. See {@link EuiPopoverPanelProps}
      */
   panelProps: PropTypes.shape({
     element: PropTypes.oneOf(["div"]),

package/es/global_styling/mixins/_button.js

@@ -21,14 +21,34 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  */
 
 import { css, keyframes } from '@emotion/react';
-import { getTokenName, euiCanAnimate } from '@elastic/eui-theme-common';
-import { makeHighContrastColor, useEuiMemoizedStyles } from '../../services';
+import { getTokenName, euiCanAnimate, mathWithUnits } from '@elastic/eui-theme-common';
+import { makeHighContrastColor, useEuiMemoizedStyles, isEuiThemeRefreshVariant } from '../../services';
+import { highContrastModeStyles, logicalCSS } from '../functions';
 
 /** Tentative usage; these exist only to be used as button directly when used within other components */
 export var SEVERITY_COLORS = ['neutral', 'risk'];
 export var BUTTON_COLORS = ['text', 'accent', 'accentSecondary', 'primary', 'success', 'warning', 'danger'];
 export var EXTENDED_BUTTON_COLORS = [].concat(BUTTON_COLORS, SEVERITY_COLORS);
 export var BUTTON_DISPLAYS = ['base', 'fill', 'empty'];
+var getButtonVariantTokenValues = function getButtonVariantTokenValues(_ref, color, variant) {
+  var euiTheme = _ref.euiTheme,
+    highContrastMode = _ref.highContrastMode;
+  var backgroundTokenBase = variant === 'base' ? 'background' : "background".concat(variant.charAt(0).toUpperCase() + variant.slice(1));
+  var textTokenBase = variant === 'filled' ? 'textColorFilled' : 'textColor';
+  var backgroundTokenName = getTokenName(backgroundTokenBase, color);
+  var textTokenName = getTokenName(textTokenBase, color);
+  var backgroundHoverTokenName = getTokenName(backgroundTokenBase, color, 'hover');
+  var backgroundActiveTokenName = getTokenName(backgroundTokenBase, color, 'active');
+  var highContrastForeground = ['warning', 'neutral', 'risk'].includes(color) ? euiTheme.colors.ink : color === 'disabled' ? euiTheme.components.buttons[textTokenName] : euiTheme.colors.textInverse;
+  var foreground = variant === 'filled' ? highContrastMode ? highContrastForeground : euiTheme.components.buttons[textTokenName] : euiTheme.components.buttons[textTokenName];
+  return {
+    color: foreground,
+    background: euiTheme.components.buttons[backgroundTokenName],
+    backgroundHover: euiTheme.components.buttons[backgroundHoverTokenName],
+    backgroundActive: euiTheme.components.buttons[backgroundActiveTokenName]
+  };
+};
+
 /**
  * Creates the `base` version of button styles with proper text contrast.
  * @param euiThemeContext
@@ -36,11 +56,9 @@ export var BUTTON_DISPLAYS = ['base', 'fill', 'empty'];
  * @returns Style object `{ backgroundColor, color }`
  */
 export var euiButtonColor = function euiButtonColor(euiThemeContext, color) {
-  var euiTheme = euiThemeContext.euiTheme;
-  var backgroundTokenName = getTokenName('background', color);
-  var textTokenName = getTokenName('textColor', color);
-  var foreground = euiTheme.components.buttons[textTokenName];
-  var background = euiTheme.components.buttons[backgroundTokenName];
+  var buttonColors = getButtonVariantTokenValues(euiThemeContext, color, 'base');
+  var foreground = buttonColors.color;
+  var background = buttonColors.background;
   return _objectSpread({
     color: background === 'transparent' || color === 'disabled' ? foreground : makeHighContrastColor(foreground)(background),
     backgroundColor: background
@@ -54,13 +72,9 @@ export var euiButtonColor = function euiButtonColor(euiThemeContext, color) {
  * @returns Style object `{ backgroundColor, color }`
  */
 export var euiButtonFillColor = function euiButtonFillColor(euiThemeContext, color) {
-  var euiTheme = euiThemeContext.euiTheme,
-    highContrastMode = euiThemeContext.highContrastMode;
-  var backgroundTokenName = getTokenName('backgroundFilled', color);
-  var textColorTokenName = getTokenName('textColorFilled', color);
-  var highContrastForeground = ['warning', 'neutral', 'risk'].includes(color) ? euiTheme.colors.ink : color === 'disabled' ? euiTheme.components.buttons[textColorTokenName] : euiTheme.colors.textInverse;
-  var foreground = highContrastMode ? highContrastForeground : euiTheme.components.buttons[textColorTokenName];
-  var background = euiTheme.components.buttons[backgroundTokenName];
+  var buttonColors = getButtonVariantTokenValues(euiThemeContext, color, 'filled');
+  var foreground = buttonColors.color;
+  var background = buttonColors.background;
   return _objectSpread({
     color: foreground,
     backgroundColor: background
@@ -84,9 +98,9 @@ export var euiButtonEmptyColor = function euiButtonEmptyColor(euiThemeContext, c
       break;
     default:
       {
-        var backgroundToken = getTokenName('backgroundEmpty', color, 'hover');
+        var buttonColors = getButtonVariantTokenValues(euiThemeContext, color, 'empty');
         foreground = euiButtonColor(euiThemeContext, color).color;
-        background = euiThemeContext.euiTheme.components.buttons[backgroundToken];
+        background = buttonColors.backgroundHover;
         break;
       }
   }
@@ -109,6 +123,8 @@ export var useEuiButtonColorCSS = function useEuiButtonColorCSS() {
   return colorsDisplaysMap[display];
 };
 var euiButtonDisplaysColors = function euiButtonDisplaysColors(euiThemeContext) {
+  var euiTheme = euiThemeContext.euiTheme;
+  var isRefreshVariant = isEuiThemeRefreshVariant(euiThemeContext, 'buttonVariant');
   var COLORS = [].concat(_toConsumableArray(EXTENDED_BUTTON_COLORS), ['disabled']);
   var displaysColorsMap = {};
   BUTTON_DISPLAYS.forEach(function (display) {
@@ -116,14 +132,28 @@ var euiButtonDisplaysColors = function euiButtonDisplaysColors(euiThemeContext)
     COLORS.forEach(function (color) {
       switch (display) {
         case 'base':
-          displaysColorsMap[display][color] = /*#__PURE__*/css(euiButtonColor(euiThemeContext, color), ";;label:displaysColorsMap-display-color;");
-          break;
+          {
+            var buttonColors = getButtonVariantTokenValues(euiThemeContext, color, 'base');
+            var borderStyle = color === 'text' && "\n              border: ".concat(euiTheme.border.width.thin, " solid ").concat(euiTheme.colors.borderBasePlain, ";\n            ");
+            var refreshVariantStyles = isRefreshVariant && "\n            ".concat(_interactionStyles(euiThemeContext, buttonColors, 'overlay'), "\n            ").concat(borderStyle, "\n          ");
+            displaysColorsMap[display][color] = /*#__PURE__*/css(euiButtonColor(euiThemeContext, color), " ", refreshVariantStyles, ";;label:displaysColorsMap-display-color;");
+            break;
+          }
         case 'fill':
-          displaysColorsMap[display][color] = /*#__PURE__*/css(euiButtonFillColor(euiThemeContext, color), "outline-color:", euiThemeContext.colorMode === 'DARK' && color === 'text' ? 'currentColor' : euiThemeContext.euiTheme.colors.fullShade, ";;label:displaysColorsMap-display-color;");
-          break;
+          {
+            var _buttonColors = getButtonVariantTokenValues(euiThemeContext, color, 'filled');
+            var _refreshVariantStyles = isRefreshVariant && _interactionStyles(euiThemeContext, _buttonColors);
+            displaysColorsMap[display][color] = /*#__PURE__*/css(euiButtonFillColor(euiThemeContext, color), "outline-color:", euiThemeContext.colorMode === 'DARK' && color === 'text' ? 'currentColor' : euiThemeContext.euiTheme.colors.fullShade, ";", _refreshVariantStyles, ";;label:displaysColorsMap-display-color;");
+            break;
+          }
         case 'empty':
-          displaysColorsMap[display][color] = /*#__PURE__*/css("color:", euiButtonEmptyColor(euiThemeContext, color).color, ";&:focus,&:active{background-color:", euiButtonEmptyColor(euiThemeContext, color).backgroundColor, ";};label:displaysColorsMap-display-color;");
-          break;
+          {
+            var _buttonColors2 = getButtonVariantTokenValues(euiThemeContext, color, 'empty');
+            var classicVariantStyles = !isRefreshVariant && "\n              &:focus,\n              &:active {\n                background-color: ".concat(euiButtonEmptyColor(euiThemeContext, color).backgroundColor, ";\n              }\n            ");
+            var _refreshVariantStyles2 = isRefreshVariant && _interactionStyles(euiThemeContext, _buttonColors2, 'overlay');
+            displaysColorsMap[display][color] = /*#__PURE__*/css("color:", euiButtonEmptyColor(euiThemeContext, color).color, ";", classicVariantStyles, " ", _refreshVariantStyles2, ";;label:displaysColorsMap-display-color;");
+            break;
+          }
       }
 
       // Tweak auto-generated Emotion label/className output
@@ -142,9 +172,10 @@ export var useEuiButtonFocusCSS = function useEuiButtonFocusCSS() {
   return useEuiMemoizedStyles(euiButtonFocusCSS);
 };
 var euiButtonFocusAnimation = keyframes(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n  50% {\n    transform: translateY(1px);\n  }\n"])));
-var euiButtonFocusCSS = function euiButtonFocusCSS(_ref) {
-  var euiTheme = _ref.euiTheme;
-  var focusCSS = /*#__PURE__*/css(euiCanAnimate, "{transition:transform ", euiTheme.animation.normal, " ease-in-out,background-color ", euiTheme.animation.normal, " ease-in-out;&:hover:not(:disabled){transform:translateY(-1px);}&:focus{animation:", euiButtonFocusAnimation, " ", euiTheme.animation.normal, " ", euiTheme.animation.bounce, ";}&:active:not(:disabled){transform:translateY(1px);}};label:focusCSS;");
+var euiButtonFocusCSS = function euiButtonFocusCSS(euiThemeContext) {
+  var euiTheme = euiThemeContext.euiTheme;
+  var isRefreshVariant = isEuiThemeRefreshVariant(euiThemeContext, 'buttonVariant');
+  var focusCSS = isRefreshVariant ? /*#__PURE__*/css(";label:focusCSS;") : /*#__PURE__*/css(euiCanAnimate, "{transition:transform ", euiTheme.animation.normal, " ease-in-out,background-color ", euiTheme.animation.normal, " ease-in-out;&:hover:not(:disabled){transform:translateY(-1px);}&:focus{animation:", euiButtonFocusAnimation, " ", euiTheme.animation.normal, " ", euiTheme.animation.bounce, ";}&:active:not(:disabled){transform:translateY(1px);}};label:focusCSS;");
   // Remove the auto-generated label.
   // We could typically avoid a label by using a plain string `` instead of css``,
   // but we need css`` for keyframes`` to work for the focus animation
@@ -156,27 +187,63 @@ var euiButtonFocusCSS = function euiButtonFocusCSS(_ref) {
  * Map of `size` props to various sizings/scales
  * that should remain consistent across all buttons
  */
-export var euiButtonSizeMap = function euiButtonSizeMap(_ref2) {
-  var euiTheme = _ref2.euiTheme;
+export var euiButtonSizeMap = function euiButtonSizeMap(euiThemeContext) {
+  var euiTheme = euiThemeContext.euiTheme;
+  var isRefreshVariant = isEuiThemeRefreshVariant(euiThemeContext, 'buttonVariant');
   return {
     xs: {
+      minWidth: euiTheme.base * (isRefreshVariant ? 6 : 7),
       height: euiTheme.size.l,
       radius: euiTheme.border.radius.small,
       fontScale: 'xs'
     },
     s: {
+      minWidth: euiTheme.base * (isRefreshVariant ? 6 : 7),
       height: euiTheme.size.xl,
       radius: euiTheme.border.radius.small,
       fontScale: 's'
     },
     m: {
+      minWidth: euiTheme.base * 7,
       height: euiTheme.size.xxl,
-      radius: euiTheme.border.radius.medium,
+      radius: isRefreshVariant ? euiTheme.border.radius.small : euiTheme.border.radius.medium,
       fontScale: 's'
     }
   };
 };
 
+/**
+ * internal styles util for applying button background color on hover
+ */
+var _interactionStyles = function _interactionStyles(euiThemeContext, buttonColors) {
+  var type = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'fill';
+  var isRefreshVariant = isEuiThemeRefreshVariant(euiThemeContext, 'buttonVariant');
+  if (!isRefreshVariant) return "";
+  var baseStyles = function baseStyles() {
+    // button hover is applied as pseudo element with a transparent background-color
+    if (type === 'overlay') {
+      return "\n        position: relative;\n        overflow: hidden;\n\n        &:hover:not(:disabled) {\n          &::before {\n            content: '';\n            position: absolute;\n            /* should stay under the content */\n            z-index: 0;\n            inset: 0;\n            background-color: ".concat(buttonColors.backgroundHover, ";\n            pointer-events: none;\n          }\n        }\n\n        &:active:not(:disabled) {\n          &::before {\n            ").concat(logicalCSS('width', '100%'), "\n            ").concat(logicalCSS('height', '100%'), "\n\n            content: '';\n            position: absolute;\n            inset: 0;\n            background-color: ").concat(buttonColors.backgroundActive, ";\n          }\n        }\n      ");
+    }
+
+    // button hover is applied as opaque color
+    return "\n      &:hover:not(:disabled) {\n        background-color: ".concat(buttonColors.backgroundHover, ";\n      }\n\n      &:active:not(:disabled) {\n        background-color: ").concat(buttonColors.backgroundActive, ";\n      }\n    ");
+  };
+  return "    \n    ".concat(highContrastModeStyles(euiThemeContext, {
+    none: baseStyles(),
+    forced: "\n        position: relative;\n        overflow: hidden;\n\n        ".concat(highContrastHoverIndicatorStyles(euiThemeContext), "\n      ")
+  }), "\n  ");
+};
+
+/**
+ * creates a bottom border on hover/focus to ensure a visible change as forced mode removed background colors
+ */
+export var highContrastHoverIndicatorStyles = function highContrastHoverIndicatorStyles(_ref2) {
+  var euiTheme = _ref2.euiTheme;
+  return "\n  &:hover:not(:disabled) {\n    transition: none;\n\n    /* using pseudo border to be able to control the color */\n    &::after {\n      content: '';\n      position: absolute;\n      inset: ".concat(euiTheme.border.width.thin, ";\n      border: ").concat(euiTheme.border.width.thick, " solid var(--highContrastHoverIndicatorColor, ").concat(euiTheme.border.color, ");\n      border-radius: ").concat(mathWithUnits(euiTheme.border.radius.small, function (x) {
+    return x / 2;
+  }), ";\n      background-color: transparent;\n      pointer-events: none;\n    }\n  }\n");
+};
+
 /**
  * Internal util for high contrast button borders
  */

package/es/services/theme/hooks.js

@@ -8,6 +8,7 @@ function _extends() { return _extends = Object.assign ? Object.assign.bind() : f
  */
 
 import React, { forwardRef, useContext, useMemo } from 'react';
+import { COLOR_MODES_STANDARD } from '@elastic/eui-theme-common';
 import { EuiThemeContext, EuiModificationsContext, EuiColorModeContext, EuiHighContrastModeContext, defaultComputedTheme, EuiNestedThemeContext } from './context';
 import { emitEuiProviderWarning } from './warning';
 import { jsx as ___EmotionJSX } from "@emotion/react";
@@ -83,4 +84,14 @@ export var useEuiThemeCSSVariables = function useEuiThemeCSSVariables() {
     setNearestThemeCSSVariables: setNearestThemeCSSVariables,
     themeCSSVariables: themeCSSVariables
   };
+};
+
+/**
+ * Checks whether the current active `colorMode` is set to `DARK`;
+ * In case of nested providers this returns the value of the nearest provider context.
+ */
+export var useIsDarkMode = function useIsDarkMode() {
+  var _useEuiTheme = useEuiTheme(),
+    colorMode = _useEuiTheme.colorMode;
+  return colorMode === COLOR_MODES_STANDARD.dark;
 };

package/es/services/theme/index.js

@@ -7,9 +7,10 @@
  */
 
 export { EuiSystemContext, EuiThemeContext, EuiNestedThemeContext, EuiModificationsContext, EuiColorModeContext, EuiHighContrastModeContext } from './context';
-export { useEuiTheme, withEuiTheme, RenderWithEuiTheme, useEuiThemeCSSVariables } from './hooks';
+export { useEuiTheme, withEuiTheme, RenderWithEuiTheme, useEuiThemeCSSVariables, useIsDarkMode } from './hooks';
 export { EuiThemeProvider } from './provider';
 export { useEuiMemoizedStyles, withEuiStylesMemoizer, RenderWithEuiStylesMemoizer } from './style_memoization';
 export { getEuiDevProviderWarning, setEuiDevProviderWarning } from './warning';
 export { buildTheme, computed, isInverseColorMode, getColorMode, getComputed, getOn, mergeDeep, setOn, Computed } from './utils';
-export { COLOR_MODES_STANDARD } from './types';
+export { COLOR_MODES_STANDARD } from './types';
+export * from './theme_variant';

package/es/services/theme/provider.js

@@ -143,9 +143,35 @@ export var EuiThemeProvider = function EuiThemeProvider(_ref) {
   }, [highContrastMode]);
   useEffect(function () {
     if (!isParentTheme.current) {
-      setTheme(getComputed(system, buildTheme(modificationsWithHighContrast, "_".concat(system.key)), colorMode, highContrastMode));
+      /* Enables recomputation of component colors when flags are overridden on the provider 
+      by adding the respective key to modifications to trigger a recomputation. */
+      // TODO: remove once visual refresh is completed and flags are obsolete
+      var flagsToRecompute = [{
+        flag: 'buttonVariant',
+        componentKey: 'buttons'
+      }];
+      var keys = {};
+      var forceRecomputeComponents = flagsToRecompute.some(function (item) {
+        var _modifications$flags, _modifications$compon;
+        if (Object.keys((_modifications$flags = modifications.flags) !== null && _modifications$flags !== void 0 ? _modifications$flags : {}).includes(item.flag) && !Object.keys((_modifications$compon = modifications.components) !== null && _modifications$compon !== void 0 ? _modifications$compon : {}).includes(item.componentKey)) {
+          keys[item.componentKey] = {
+            LIGHT: {},
+            DARK: {}
+          };
+          return true;
+        }
+        return false;
+      });
+      var componentModifications = forceRecomputeComponents ? {
+        components: keys
+      } : {};
+
+      // force recomputing of color & component tokens based on flag changes
+      var enhancedModifications = _objectSpread(_objectSpread({}, modificationsWithHighContrast), componentModifications);
+      var rebuiltTheme = getComputed(system, buildTheme(enhancedModifications, "_".concat(system.key)), colorMode, highContrastMode);
+      setTheme(rebuiltTheme);
     }
-  }, [colorMode, highContrastMode, system, modificationsWithHighContrast]);
+  }, [colorMode, highContrastMode, system, modificationsWithHighContrast, modifications]);
   var _useState9 = useState(),
     _useState10 = _slicedToArray(_useState9, 2),
     themeCSSVariables = _useState10[0],

package/es/services/theme/theme_variant.js

@@ -0,0 +1,22 @@
+/*
+ * 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 { useEuiTheme } from './hooks';
+export var isEuiThemeRefreshVariant = function isEuiThemeRefreshVariant(_ref, flag) {
+  var euiTheme = _ref.euiTheme;
+  return euiTheme.flags[flag] === 'refresh';
+};
+
+/**
+ * Util to retrieve visual variant for UI elements
+ * Note: Temporary only - will be removed once the visual refresh is completed.
+ */
+export var useEuiThemeRefreshVariant = function useEuiThemeRefreshVariant(flag) {
+  var euiThemeContext = useEuiTheme();
+  return isEuiThemeRefreshVariant(euiThemeContext, flag);
+};