@elastic/eui 102.1.0 → 102.2.0

package/es/components/loading/loading_elastic.styles.js

@@ -10,7 +10,7 @@ function _taggedTemplateLiteral(e, t) { return t || (t = e.slice(0)), Object.fre
 
 import { css, keyframes } from '@emotion/react';
 import { euiCanAnimate } from '../../global_styling';
-var loadingElastic = keyframes(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n  0% {\n    transform: scale3d(.2, .2, -.7);\n    opacity: .2;\n  }\n\n  40% {\n    transform: scale3d(1, 1, 2);\n    opacity: 1;\n  }\n\n  50% {\n    transform: scale3d(.99, .99, 2);\n  }\n\n  70% {\n    transform: scale3d(.96, .96, -2.5);\n  }\n\n  100% {\n    transform: scale3d(.98, .98, 2);\n  }\n"])));
+var loadingElastic = keyframes(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n  0% {\n    transform: scale3d(.2, .2, -.7);\n  }\n\n  40% {\n    transform: scale3d(1, 1, 2);\n  }\n\n  50% {\n    transform: scale3d(.99, .99, 2);\n  }\n\n  70% {\n    transform: scale3d(.96, .96, -2.5);\n  }\n\n  100% {\n    transform: scale3d(.98, .98, 2);\n  }\n"])));
 export var euiLoadingElasticStyles = {
-  euiLoadingElastic: /*#__PURE__*/css("position:relative;display:inline-block;& path{", euiCanAnimate, "{animation-name:", loadingElastic, ";animation-fill-mode:forwards;animation-direction:alternate;transform-style:preserve-3d;animation-duration:1s;animation-timing-function:cubic-bezier(0, 0.63, 0.49, 1);animation-iteration-count:infinite;transform-origin:50% 50%;}&:nth-of-type(1){display:none;}&:nth-of-type(2){animation-delay:0.035s;}&:nth-of-type(3){animation-delay:0.125s;}&:nth-of-type(4){animation-delay:0.155s;}&:nth-of-type(5){animation-delay:0.075s;}&:nth-of-type(6){animation-delay:0.06s;}};label:euiLoadingElastic;")
+  euiLoadingElastic: /*#__PURE__*/css("position:relative;display:inline-block;& path{", euiCanAnimate, "{animation-name:", loadingElastic, ";animation-fill-mode:forwards;animation-direction:alternate;transform-style:preserve-3d;animation-duration:1s;animation-timing-function:cubic-bezier(0, 0.63, 0.49, 1);animation-iteration-count:infinite;transform-origin:50% 50%;}&:nth-of-type(1){animation-delay:0;}&:nth-of-type(2){animation-delay:0.035s;}&:nth-of-type(3){animation-delay:0.125s;}&:nth-of-type(4){animation-delay:0.155s;}&:nth-of-type(5){animation-delay:0.075s;}&:nth-of-type(6){animation-delay:0.06s;}};label:euiLoadingElastic;")
 };

package/es/components/loading/loading_spinner.js

@@ -57,7 +57,7 @@ EuiLoadingSpinner.propTypes = {
   /**
        * Sets the color of the border and highlight.
        * Each key accepts any valid CSS color value as a `string`
-       * See #EuiLoadingSpinnerColor
+       * See {@link EuiLoadingSpinnerColor}
        */
   color: PropTypes.shape({
     border: PropTypes.any,

package/es/components/page/page_header/page_header_content.js

@@ -372,7 +372,7 @@ EuiPageHeaderContent.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/components/popover/popover.js

@@ -612,7 +612,7 @@ EuiPopover.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/components/responsive/hide_for.js

@@ -27,7 +27,7 @@ EuiHideFor.propTypes = {
   children: PropTypes.node.isRequired,
   /**
      * List of all the responsive sizes to hide the children for.
-     * Array of #EuiBreakpointSize
+     * Array of {@link EuiBreakpointSize}
      */
   sizes: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.any.isRequired).isRequired, PropTypes.oneOf(["all", "none"])]).isRequired
 };

package/es/components/responsive/show_for.js

@@ -27,7 +27,7 @@ EuiShowFor.propTypes = {
   children: PropTypes.node.isRequired,
   /**
      * List of all the responsive sizes to show the children for.
-     * Array of #EuiBreakpointSize
+     * Array of {@link EuiBreakpointSize}
      */
   sizes: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.any.isRequired).isRequired, PropTypes.oneOf(["all", "none"])]).isRequired
 };

package/es/components/search_bar/filters/field_value_selection_filter.js

@@ -404,7 +404,7 @@ FieldValueSelectionFilter.propTypes = {
     field: PropTypes.string,
     name: PropTypes.string.isRequired,
     /**
-       * See #FieldValueOptionType
+       * See {@link FieldValueOptionType}
        */
     options: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.shape({
       field: PropTypes.string,

package/es/components/search_bar/filters/field_value_toggle_group_filter.js

@@ -93,7 +93,7 @@ FieldValueToggleGroupFilter.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_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/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,7 +7,7 @@
  */
 
 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';