@elastic/eui 94.3.0 → 94.4.1

package/lib/components/selectable/selectable_list/selectable_list_item.js

@@ -1,5 +1,6 @@
 "use strict";
 
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -12,35 +13,32 @@ var _i18n = require("../../i18n");
 var _icon = require("../../icon");
 var _accessibility = require("../../accessibility");
 var _badge = require("../../badge");
+var _tool_tip = require("../../tool_tip");
 var _react2 = require("@emotion/react");
-var _excluded = ["children", "className", "disabled", "checked", "isFocused", "showIcons", "prepend", "append", "allowExclusions", "onFocusBadge", "paddingSize", "role", "searchable", "textWrap"],
+var _excluded = ["children", "className", "disabled", "checked", "isFocused", "showIcons", "prepend", "append", "allowExclusions", "onFocusBadge", "paddingSize", "role", "searchable", "textWrap", "toolTipContent", "toolTipProps", "aria-describedby"],
   _excluded2 = ["children", "className"];
+/*
+ * 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 _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+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."); }
+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 _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 _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 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 _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; }
-function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
-function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
-function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
-function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
-function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); } /*
-                                                                                                                                                                                                                                                                                                                                                                                               * 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 _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+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; }
 function resolveIconAndColor(checked) {
   switch (checked) {
     case 'on':
@@ -71,198 +69,223 @@ var paddingSizeToClassNameMap = {
 };
 var PADDING_SIZES = (0, _common.keysOf)(paddingSizeToClassNameMap);
 exports.PADDING_SIZES = PADDING_SIZES;
-var EuiSelectableListItem = /*#__PURE__*/function (_Component) {
-  _inherits(EuiSelectableListItem, _Component);
-  var _super = _createSuper(EuiSelectableListItem);
-  function EuiSelectableListItem(props) {
-    var _this;
-    _classCallCheck(this, EuiSelectableListItem);
-    _this = _super.call(this, props);
-    // aria-checked is intended to be used with role="checkbox" but
-    // the MDN documentation lists it as a possibility for role="option".
-    // See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-checked
-    // and https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/option_role
-    _defineProperty(_assertThisInitialized(_this), "isChecked", function (role, checked) {
-      var rolesThatCanBeMixed = ['option', 'checkbox', 'menuitemcheckbox'];
-      var rolesThatCanBeChecked = [].concat(rolesThatCanBeMixed, ['radio', 'menuitemradio', 'switch']);
-      if (!rolesThatCanBeChecked.includes(role)) return undefined;
-      switch (checked) {
-        case 'on':
-        case 'off':
-          return true;
-        case 'mixed':
-          if (rolesThatCanBeMixed.includes(role)) {
-            return 'mixed';
-          } else {
-            return false;
-          }
-        default:
-          return false;
-      }
-    });
-    return _this;
-  }
-  _createClass(EuiSelectableListItem, [{
-    key: "render",
-    value: function render() {
-      var _this$props = this.props,
-        children = _this$props.children,
-        className = _this$props.className,
-        disabled = _this$props.disabled,
-        checked = _this$props.checked,
-        isFocused = _this$props.isFocused,
-        showIcons = _this$props.showIcons,
-        prepend = _this$props.prepend,
-        append = _this$props.append,
-        allowExclusions = _this$props.allowExclusions,
-        onFocusBadge = _this$props.onFocusBadge,
-        _this$props$paddingSi = _this$props.paddingSize,
-        paddingSize = _this$props$paddingSi === void 0 ? 's' : _this$props$paddingSi,
-        _this$props$role = _this$props.role,
-        role = _this$props$role === void 0 ? 'option' : _this$props$role,
-        searchable = _this$props.searchable,
-        textWrap = _this$props.textWrap,
-        rest = _objectWithoutProperties(_this$props, _excluded);
-      var classes = (0, _classnames.default)('euiSelectableListItem', {
-        'euiSelectableListItem-isFocused': isFocused
-      }, paddingSizeToClassNameMap[paddingSize], className);
-      var textClasses = (0, _classnames.default)('euiSelectableListItem__text', _defineProperty({}, "euiSelectableListItem__text--".concat(textWrap), textWrap));
-      var optionIcon;
-      if (showIcons) {
-        var _resolveIconAndColor = resolveIconAndColor(checked),
-          icon = _resolveIconAndColor.icon,
-          color = _resolveIconAndColor.color;
-        optionIcon = (0, _react2.jsx)(_icon.EuiIcon, {
-          className: "euiSelectableListItem__icon",
-          color: color,
-          type: icon
-        });
-      }
-      var state;
-      var instructions;
-      var screenReaderStrings = {
-        checked: {
-          state: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.checkedOption",
-            default: "Checked option."
-          }),
-          instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.checkOptionInstructions",
-            default: "To check this option, press Enter."
-          })
-        },
-        unchecked: {
-          instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.uncheckOptionInstructions",
-            default: "To uncheck this option, press Enter."
-          })
-        },
-        excluded: {
-          state: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.excludedOption",
-            default: "Excluded option."
-          }),
-          instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.excludeOptionInstructions",
-            default: "To exclude this option, press Enter."
-          })
-        },
-        mixed: {
-          state: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.mixedOption",
-            default: "Mixed (indeterminate) option."
-          }),
-          instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.mixedOptionInstructions",
-            default: "To check this option for all, press Enter once."
-          }),
-          uncheckInstructions: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.mixedOptionUncheckInstructions",
-            default: "To uncheck this option for all, press Enter twice."
-          }),
-          excludeInstructions: (0, _react2.jsx)(_i18n.EuiI18n, {
-            token: "euiSelectableListItem.mixedOptionExcludeInstructions",
-            default: "To exclude this option for all, press Enter twice."
-          })
-        }
-      };
-      switch (checked) {
-        case 'on':
-          state = screenReaderStrings.checked.state;
-          instructions = allowExclusions ? screenReaderStrings.excluded.instructions : searchable ? screenReaderStrings.unchecked.instructions : undefined;
-          break;
-        case 'off':
-          state = screenReaderStrings.excluded.state;
-          instructions = screenReaderStrings.unchecked.instructions;
-          break;
-        case 'mixed':
-          state = screenReaderStrings.mixed.state;
-          instructions = (0, _react2.jsx)(_react.default.Fragment, null, screenReaderStrings.mixed.instructions, ' ', allowExclusions ? screenReaderStrings.mixed.excludeInstructions : screenReaderStrings.mixed.uncheckInstructions);
-          break;
-        case undefined:
-        default:
-          instructions = allowExclusions || searchable ? screenReaderStrings.checked.instructions : undefined;
-          break;
-      }
-      var prependNode;
-      if (prepend) {
-        prependNode = (0, _react2.jsx)("span", {
-          className: "euiSelectableListItem__prepend"
-        }, prepend);
+var EuiSelectableListItem = function EuiSelectableListItem(_ref) {
+  var children = _ref.children,
+    className = _ref.className,
+    disabled = _ref.disabled,
+    checked = _ref.checked,
+    isFocused = _ref.isFocused,
+    _ref$showIcons = _ref.showIcons,
+    showIcons = _ref$showIcons === void 0 ? true : _ref$showIcons,
+    prepend = _ref.prepend,
+    append = _ref.append,
+    allowExclusions = _ref.allowExclusions,
+    _ref$onFocusBadge = _ref.onFocusBadge,
+    onFocusBadge = _ref$onFocusBadge === void 0 ? true : _ref$onFocusBadge,
+    _ref$paddingSize = _ref.paddingSize,
+    paddingSize = _ref$paddingSize === void 0 ? 's' : _ref$paddingSize,
+    _ref$role = _ref.role,
+    role = _ref$role === void 0 ? 'option' : _ref$role,
+    searchable = _ref.searchable,
+    _ref$textWrap = _ref.textWrap,
+    textWrap = _ref$textWrap === void 0 ? 'truncate' : _ref$textWrap,
+    toolTipContent = _ref.toolTipContent,
+    toolTipProps = _ref.toolTipProps,
+    _ariaDescribedBy = _ref['aria-describedby'],
+    rest = _objectWithoutProperties(_ref, _excluded);
+  var classes = (0, _classnames.default)('euiSelectableListItem', {
+    'euiSelectableListItem-isFocused': isFocused
+  }, paddingSizeToClassNameMap[paddingSize], className);
+  var textClasses = (0, _classnames.default)('euiSelectableListItem__text', _defineProperty({}, "euiSelectableListItem__text--".concat(textWrap), textWrap));
+  var optionIcon = (0, _react.useMemo)(function () {
+    if (showIcons) {
+      var _resolveIconAndColor = resolveIconAndColor(checked),
+        icon = _resolveIconAndColor.icon,
+        color = _resolveIconAndColor.color;
+      return (0, _react2.jsx)(_icon.EuiIcon, {
+        className: "euiSelectableListItem__icon",
+        color: color,
+        type: icon
+      });
+    }
+  }, [showIcons, checked]);
+  var prependNode = (0, _react.useMemo)(function () {
+    if (prepend) {
+      return (0, _react2.jsx)("span", {
+        className: "euiSelectableListItem__prepend"
+      }, prepend);
+    }
+  }, [prepend]);
+  var onFocusBadgeNode = (0, _react.useMemo)(function () {
+    var defaultOnFocusBadgeProps = {
+      'aria-hidden': true,
+      iconType: 'returnKey',
+      iconSide: 'left',
+      color: 'hollow'
+    };
+    if (onFocusBadge === true) {
+      return (0, _react2.jsx)(_badge.EuiBadge, _extends({
+        className: "euiSelectableListItem__onFocusBadge"
+      }, defaultOnFocusBadgeProps));
+    } else if (typeof onFocusBadge !== 'boolean' && !!onFocusBadge) {
+      var _children = onFocusBadge.children,
+        _className = onFocusBadge.className,
+        restBadgeProps = _objectWithoutProperties(onFocusBadge, _excluded2);
+      return (0, _react2.jsx)(_badge.EuiBadge, _extends({
+        className: (0, _classnames.default)('euiSelectableListItem__onFocusBadge', _className)
+      }, defaultOnFocusBadgeProps, restBadgeProps), _children);
+    }
+  }, [onFocusBadge]);
+  var showOnFocusBadge = !!(isFocused && !disabled && onFocusBadgeNode);
+  var appendNode = (0, _react.useMemo)(function () {
+    if (append || showOnFocusBadge) {
+      return (0, _react2.jsx)("span", {
+        className: "euiSelectableListItem__append"
+      }, append, " ", showOnFocusBadge ? onFocusBadgeNode : null);
+    }
+  }, [append, showOnFocusBadge, onFocusBadgeNode]);
+  var screenReaderText = (0, _react.useMemo)(function () {
+    var state;
+    var instructions;
+    var screenReaderStrings = {
+      checked: {
+        state: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.checkedOption",
+          default: "Checked option."
+        }),
+        instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.checkOptionInstructions",
+          default: "To check this option, press Enter."
+        })
+      },
+      unchecked: {
+        instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.uncheckOptionInstructions",
+          default: "To uncheck this option, press Enter."
+        })
+      },
+      excluded: {
+        state: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.excludedOption",
+          default: "Excluded option."
+        }),
+        instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.excludeOptionInstructions",
+          default: "To exclude this option, press Enter."
+        })
+      },
+      mixed: {
+        state: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.mixedOption",
+          default: "Mixed (indeterminate) option."
+        }),
+        instructions: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.mixedOptionInstructions",
+          default: "To check this option for all, press Enter once."
+        }),
+        uncheckInstructions: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.mixedOptionUncheckInstructions",
+          default: "To uncheck this option for all, press Enter twice."
+        }),
+        excludeInstructions: (0, _react2.jsx)(_i18n.EuiI18n, {
+          token: "euiSelectableListItem.mixedOptionExcludeInstructions",
+          default: "To exclude this option for all, press Enter twice."
+        })
       }
-      var appendNode;
-      if (append || !!onFocusBadge) {
-        var onFocusBadgeNode;
-        var defaultOnFocusBadgeProps = {
-          'aria-hidden': true,
-          iconType: 'returnKey',
-          iconSide: 'left',
-          color: 'hollow'
-        };
-        if (onFocusBadge === true) {
-          onFocusBadgeNode = (0, _react2.jsx)(_badge.EuiBadge, _extends({
-            className: "euiSelectableListItem__onFocusBadge"
-          }, defaultOnFocusBadgeProps));
-        } else if (typeof onFocusBadge !== 'boolean' && !!onFocusBadge) {
-          var _children = onFocusBadge.children,
-            _className = onFocusBadge.className,
-            restBadgeProps = _objectWithoutProperties(onFocusBadge, _excluded2);
-          onFocusBadgeNode = (0, _react2.jsx)(_badge.EuiBadge, _extends({
-            className: (0, _classnames.default)('euiSelectableListItem__onFocusBadge', _className)
-          }, defaultOnFocusBadgeProps, restBadgeProps), _children);
-        }
+    };
+    switch (checked) {
+      case 'on':
+        state = screenReaderStrings.checked.state;
+        instructions = allowExclusions ? screenReaderStrings.excluded.instructions : searchable ? screenReaderStrings.unchecked.instructions : undefined;
+        break;
+      case 'off':
+        state = screenReaderStrings.excluded.state;
+        instructions = screenReaderStrings.unchecked.instructions;
+        break;
+      case 'mixed':
+        state = screenReaderStrings.mixed.state;
+        instructions = (0, _react2.jsx)(_react.default.Fragment, null, screenReaderStrings.mixed.instructions, ' ', allowExclusions ? screenReaderStrings.mixed.excludeInstructions : screenReaderStrings.mixed.uncheckInstructions);
+        break;
+      case undefined:
+      default:
+        instructions = allowExclusions || searchable ? screenReaderStrings.checked.instructions : undefined;
+        break;
+    }
+    return state || instructions ? (0, _react2.jsx)(_accessibility.EuiScreenReaderOnly, null, (0, _react2.jsx)("div", null, state || instructions ? '. ' : null, state, state && instructions ? ' ' : null, instructions)) : null;
+  }, [checked, searchable, allowExclusions]);
 
-        // Only display the append wrapper if append exists or isFocused
-        if (append || isFocused && !disabled) {
-          appendNode = (0, _react2.jsx)("span", {
-            className: "euiSelectableListItem__append"
-          }, append, " ", isFocused && !disabled ? onFocusBadgeNode : null);
+  // aria-checked is intended to be used with role="checkbox" but
+  // the MDN documentation lists it as a possibility for role="option".
+  // See https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-checked
+  // and https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/option_role
+  var ariaChecked = (0, _react.useMemo)(function () {
+    var rolesThatCanBeMixed = ['option', 'checkbox', 'menuitemcheckbox'];
+    var rolesThatCanBeChecked = [].concat(rolesThatCanBeMixed, ['radio', 'menuitemradio', 'switch']);
+    if (!rolesThatCanBeChecked.includes(role)) return undefined;
+    switch (checked) {
+      case 'on':
+      case 'off':
+        return true;
+      case 'mixed':
+        if (rolesThatCanBeMixed.includes(role)) {
+          return 'mixed';
+        } else {
+          return false;
         }
-      }
-      var screenReaderText = (state || instructions) && (0, _react2.jsx)(_accessibility.EuiScreenReaderOnly, null, (0, _react2.jsx)("div", null, state || instructions ? '. ' : null, state, state && instructions ? ' ' : null, instructions));
-      return (0, _react2.jsx)("li", _extends({
-        role: role,
-        "aria-disabled": disabled,
-        "aria-checked": this.isChecked(role, checked) // Whether the item is "checked"
-        ,
-        "aria-selected": !disabled && isFocused // Whether the item has keyboard focus per W3 spec
-        ,
-        className: classes
-      }, rest), (0, _react2.jsx)("span", {
-        className: "euiSelectableListItem__content"
-      }, optionIcon, prependNode, (0, _react2.jsx)("span", {
-        className: textClasses
-      }, children, screenReaderText), appendNode));
+      default:
+        return false;
+    }
+  }, [role, checked]);
+  var hasToolTip = !!toolTipContent && !disabled;
+  var _useState = (0, _react.useState)(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    tooltipRef = _useState2[0],
+    setTooltipRef = _useState2[1]; // Needs to be state and not a ref to trigger useEffect
+  var _useState3 = (0, _react.useState)(_ariaDescribedBy),
+    _useState4 = _slicedToArray(_useState3, 2),
+    ariaDescribedBy = _useState4[0],
+    setAriaDescribedBy = _useState4[1];
+
+  // Manually trigger the tooltip on keyboard focus
+  (0, _react.useEffect)(function () {
+    if (!tooltipRef) return;
+    if (isFocused) {
+      tooltipRef.showToolTip();
+    } else {
+      tooltipRef.hideToolTip();
     }
-  }]);
-  return EuiSelectableListItem;
-}(_react.Component);
+  }, [isFocused, tooltipRef]);
+
+  // Manually set the `aria-describedby` id on the <li> wrapper
+  (0, _react.useEffect)(function () {
+    if (tooltipRef) {
+      var tooltipId = tooltipRef.state.id;
+      setAriaDescribedBy((0, _classnames.default)(tooltipId, _ariaDescribedBy));
+    }
+  }, [tooltipRef, _ariaDescribedBy]);
+  var content = (0, _react2.jsx)("span", {
+    className: "euiSelectableListItem__content"
+  }, optionIcon, prependNode, (0, _react2.jsx)("span", {
+    className: textClasses
+  }, children, screenReaderText), appendNode);
+  return (0, _react2.jsx)("li", _extends({
+    role: role,
+    "aria-disabled": disabled,
+    "aria-checked": ariaChecked // Whether the item is "checked"
+    ,
+    "aria-selected": !disabled && isFocused // Whether the item has keyboard focus per W3 spec
+    ,
+    className: classes
+  }, rest, {
+    "aria-describedby": ariaDescribedBy
+  }), hasToolTip ? (0, _react2.jsx)(_tool_tip.EuiToolTip, _extends({
+    ref: setTooltipRef,
+    content: toolTipContent,
+    anchorClassName: "euiSelectableListItem__tooltipAnchor",
+    position: "left"
+  }, toolTipProps), content) : content);
+};
 exports.EuiSelectableListItem = EuiSelectableListItem;
-_defineProperty(EuiSelectableListItem, "defaultProps", {
-  showIcons: true,
-  onFocusBadge: true,
-  textWrap: 'truncate'
-});
 EuiSelectableListItem.propTypes = {
   className: _propTypes.default.string,
   "aria-label": _propTypes.default.string,
@@ -272,7 +295,7 @@ EuiSelectableListItem.propTypes = {
   /**
        * Applies an icon and visual styling to activated items
        */
-  checked: _propTypes.default.oneOf(["on", "off", "mixed", undefined]),
+  checked: _propTypes.default.any,
   /**
        * Shows icons based on `checked` type
        */
@@ -355,5 +378,13 @@ EuiSelectableListItem.propTypes = {
        * How to handle long text within the item.
        * Wrapping only works if virtualization is off.
        */
-  textWrap: _propTypes.default.oneOf(["truncate", "wrap"])
+  textWrap: _propTypes.default.oneOf(["truncate", "wrap"]),
+  /**
+       * Optional custom tooltip content for the button
+       */
+  toolTipContent: _propTypes.default.node,
+  /**
+       * Optional props to pass to the underlying **[EuiToolTip](/#/display/tooltip)**
+       */
+  toolTipProps: _propTypes.default.any
 };

package/lib/components/selectable/selectable_option.js

@@ -2,4 +2,15 @@
 
 Object.defineProperty(exports, "__esModule", {
   value: true
-});
+});
+exports.OPTION_CHECKED_STATES = void 0;
+/*
+ * 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 OPTION_CHECKED_STATES = ['on', 'off', 'mixed', undefined];
+exports.OPTION_CHECKED_STATES = OPTION_CHECKED_STATES;

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

@@ -384,7 +384,7 @@ EuiSelectableTemplateSitewide.propTypes = {
        * 'on' to indicate inclusion, 'off' to indicate exclusion,
        * or 'mixed' to indicate inclusion for some.
        */
-    checked: _propTypes.default.oneOf(["on", "off", "mixed", undefined]),
+    checked: _propTypes.default.any,
     disabled: _propTypes.default.bool,
     /**
        * Node to add between the selection icon and the label
@@ -414,7 +414,15 @@ EuiSelectableTemplateSitewide.propTypes = {
        * Note: when searching, custom truncation props are ignored. The highlighted search
        * text will always take precedence.
        */
-    truncationProps: _propTypes.default.any
+    truncationProps: _propTypes.default.any,
+    /**
+       * Optional custom tooltip content for the button
+       */
+    toolTipContent: _propTypes.default.node,
+    /**
+       * Optional props to pass to the underlying **[EuiToolTip](/#/display/tooltip)**
+       */
+    toolTipProps: _propTypes.default.any
   }).isRequired).isRequired,
   /**
      * Override some of the EuiPopover props housing the list.

package/lib/components/text/text_color.js

@@ -4,7 +4,7 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.EuiTextColor = exports.COLORS = void 0;
+exports._isNamedColor = exports.EuiTextColor = exports.COLORS = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _services = require("../../services");
@@ -30,6 +30,10 @@ function _objectWithoutProperties(source, excluded) { if (source == null) return
 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; }
 var COLORS = ['default', 'subdued', 'success', 'accent', 'danger', 'warning', 'ghost', 'inherit'];
 exports.COLORS = COLORS;
+var _isNamedColor = function _isNamedColor(color) {
+  return COLORS.includes(color);
+};
+exports._isNamedColor = _isNamedColor;
 var EuiTextColor = function EuiTextColor(_ref) {
   var children = _ref.children,
     _ref$color = _ref.color,
@@ -40,7 +44,7 @@ var EuiTextColor = function EuiTextColor(_ref) {
     cloneElement = _ref$cloneElement === void 0 ? false : _ref$cloneElement,
     style = _ref.style,
     rest = _objectWithoutProperties(_ref, _excluded);
-  var isNamedColor = COLORS.includes(color);
+  var isNamedColor = _isNamedColor(color);
   var styles = (0, _services.useEuiMemoizedStyles)(_text_color.euiTextColorStyles);
   var cssStyles = [styles.euiTextColor, isNamedColor ? styles[color] : styles.customColor];
 

package/lib/components/toast/global_toast_list_item.js

@@ -39,13 +39,13 @@ var EuiGlobalToastListItem = function EuiGlobalToastListItem(_ref) {
 };
 exports.EuiGlobalToastListItem = EuiGlobalToastListItem;
 EuiGlobalToastListItem.propTypes = {
-  className: _propTypes.default.string,
-  "aria-label": _propTypes.default.string,
-  "data-test-subj": _propTypes.default.string,
-  css: _propTypes.default.any,
   isDismissed: _propTypes.default.bool,
   /**
      * ReactElement to render as this component's content
      */
-  children: _propTypes.default.element
+  children: _propTypes.default.element,
+  className: _propTypes.default.string,
+  "aria-label": _propTypes.default.string,
+  "data-test-subj": _propTypes.default.string,
+  css: _propTypes.default.any
 };