@elastic/eui 67.1.6 → 67.1.7

package/es/components/badge/beta_badge/beta_badge.js

@@ -15,7 +15,7 @@ function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) r
  * in compliance with, at your election, the Elastic License 2.0 or the Server
  * Side Public License, v 1.
  */
-import React, { Fragment } from 'react';
+import React from 'react';
 import PropTypes from "prop-types";
 import classNames from 'classnames';
 import { keysOf } from '../../common';
@@ -112,7 +112,7 @@ export var EuiBetaBadge = function EuiBetaBadge(_ref) {
         anchorProps: anchorProps
       }, content);
     } else {
-      return ___EmotionJSX(Fragment, null, content);
+      return ___EmotionJSX("span", anchorProps, content);
     }
   } else {
     if (tooltipContent) {
@@ -133,10 +133,10 @@ export var EuiBetaBadge = function EuiBetaBadge(_ref) {
         console.warn("Only string titles are permitted on badges that do not use tooltips. Found: ".concat(_typeof(spanTitle)));
       }
 
-      return ___EmotionJSX("span", _extends({
+      return ___EmotionJSX("span", anchorProps, ___EmotionJSX("span", _extends({
         className: classes,
         title: spanTitle
-      }, rest), icon || label);
+      }, rest), icon || label));
     }
   }
 };

package/es/components/basic_table/in_memory_table.js

@@ -400,7 +400,7 @@ export var EuiInMemoryTable = /*#__PURE__*/function (_Component) {
           sortName = _this$state2.sortName,
           pageIndex = _this$state2.pageIndex,
           pageSize = _this$state2.pageSize;
-      var matchingItems = query ? EuiSearchBar.Query.execute(query, items, executeQueryOptions) : items;
+      var matchingItems = query !== null && (executeQueryOptions === null || executeQueryOptions === void 0 ? void 0 : executeQueryOptions.enabled) !== false ? EuiSearchBar.Query.execute(query, items, executeQueryOptions) : items;
       var sortedItems = sortName ? matchingItems.slice(0) // avoid mutating the source array
       .sort(this.getItemSorter()) // sort, causes mutation
       : matchingItems;
@@ -1134,6 +1134,14 @@ EuiInMemoryTable.propTypes = {
        * Date formatter to use when parsing date values
        */
     dateFormat: PropTypes.any,
+
+    /**
+       * Hint to render below the search bar
+       */
+    hint: PropTypes.shape({
+      content: PropTypes.node.isRequired,
+      popoverProps: PropTypes.any
+    }),
     className: PropTypes.string,
     "aria-label": PropTypes.string,
     "data-test-subj": PropTypes.string,
@@ -1198,7 +1206,13 @@ EuiInMemoryTable.propTypes = {
   executeQueryOptions: PropTypes.shape({
     defaultFields: PropTypes.arrayOf(PropTypes.string.isRequired),
     isClauseMatcher: PropTypes.func,
-    explain: PropTypes.bool
+    explain: PropTypes.bool,
+
+    /**
+         * When the search bar Query is controlled and passed to the `search` prop it is by default executed against the items passed to the table to filter them out.
+         * If the filtering is already done before passing the `items` to the table we can disable the execution by setting `enabled` to `false`.
+         */
+    enabled: PropTypes.bool
   }),
 
   /**

package/es/components/breadcrumbs/breadcrumb.js

@@ -1,5 +1,5 @@
 var _excluded = ["children", "className", "type", "truncate"],
-    _excluded2 = ["text", "truncate", "type", "href", "rel", "onClick", "className", "color", "isFirstBreadcrumb", "isLastBreadcrumb", "isOnlyBreadcrumb", "highlightLastBreadcrumb"];
+    _excluded2 = ["text", "truncate", "type", "href", "rel", "onClick", "className", "color", "isFirstBreadcrumb", "isLastBreadcrumb", "isOnlyBreadcrumb", "highlightLastBreadcrumb", "truncateLastBreadcrumb"];
 
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 
@@ -59,7 +59,8 @@ EuiBreadcrumb.propTypes = {
   isFirstBreadcrumb: PropTypes.bool,
   isLastBreadcrumb: PropTypes.bool,
   isOnlyBreadcrumb: PropTypes.bool,
-  highlightLastBreadcrumb: PropTypes.bool
+  highlightLastBreadcrumb: PropTypes.bool,
+  truncateLastBreadcrumb: PropTypes.bool
 };
 export var EuiBreadcrumbContent = function EuiBreadcrumbContent(_ref2) {
   var text = _ref2.text,
@@ -74,12 +75,13 @@ export var EuiBreadcrumbContent = function EuiBreadcrumbContent(_ref2) {
       isLastBreadcrumb = _ref2.isLastBreadcrumb,
       isOnlyBreadcrumb = _ref2.isOnlyBreadcrumb,
       highlightLastBreadcrumb = _ref2.highlightLastBreadcrumb,
+      truncateLastBreadcrumb = _ref2.truncateLastBreadcrumb,
       rest = _objectWithoutProperties(_ref2, _excluded2);
 
   var classes = classNames('euiBreadcrumb__content', className);
   var euiTheme = useEuiTheme();
   var styles = euiBreadcrumbContentStyles(euiTheme);
-  var cssStyles = [styles.euiBreadcrumb__content, styles[type], truncate && (isLastBreadcrumb ? styles.isTruncatedLast : styles.isTruncated)];
+  var cssStyles = [styles.euiBreadcrumb__content, styles[type], truncate && !truncateLastBreadcrumb && styles.isTruncated, truncateLastBreadcrumb && styles.isTruncatedLast];
 
   if (type === 'application') {
     if (isOnlyBreadcrumb) {
@@ -148,7 +150,8 @@ EuiBreadcrumbContent.propTypes = {
   isFirstBreadcrumb: PropTypes.bool,
   isLastBreadcrumb: PropTypes.bool,
   isOnlyBreadcrumb: PropTypes.bool,
-  highlightLastBreadcrumb: PropTypes.bool
+  highlightLastBreadcrumb: PropTypes.bool,
+  truncateLastBreadcrumb: PropTypes.bool
 };
 export var EuiBreadcrumbCollapsed = function EuiBreadcrumbCollapsed(_ref3) {
   var children = _ref3.children,
@@ -196,5 +199,6 @@ EuiBreadcrumbCollapsed.propTypes = {
   isFirstBreadcrumb: PropTypes.bool,
   isLastBreadcrumb: PropTypes.bool,
   isOnlyBreadcrumb: PropTypes.bool,
-  highlightLastBreadcrumb: PropTypes.bool
+  highlightLastBreadcrumb: PropTypes.bool,
+  truncateLastBreadcrumb: PropTypes.bool
 };

package/es/components/breadcrumbs/breadcrumbs.js

@@ -54,12 +54,14 @@ export var EuiBreadcrumbs = function EuiBreadcrumbs(_ref) {
   }, [breadcrumbs, responsiveMax]);
   var breadcrumbChildren = useMemo(function () {
     return visibleBreadcrumbs.map(function (breadcrumb, index) {
+      var _breadcrumb$truncate;
+
       var isFirstBreadcrumb = index === 0;
       var isLastBreadcrumb = index === visibleBreadcrumbs.length - 1;
       var isOnlyBreadcrumb = visibleBreadcrumbs.length === 1;
       var sharedProps = {
         type: type,
-        truncate: truncate
+        truncate: (_breadcrumb$truncate = breadcrumb.truncate) !== null && _breadcrumb$truncate !== void 0 ? _breadcrumb$truncate : truncate
       };
       return breadcrumb.isCollapsedButton ? ___EmotionJSX(EuiBreadcrumbCollapsed, _extends({
         key: "collapsed"
@@ -73,12 +75,13 @@ export var EuiBreadcrumbs = function EuiBreadcrumbs(_ref) {
         max: 0
       })) : ___EmotionJSX(EuiBreadcrumb, _extends({
         key: index
-      }, sharedProps), ___EmotionJSX(EuiBreadcrumbContent, _extends({
+      }, sharedProps), ___EmotionJSX(EuiBreadcrumbContent, _extends({}, breadcrumb, sharedProps, {
         isFirstBreadcrumb: isFirstBreadcrumb,
         isLastBreadcrumb: isLastBreadcrumb,
         isOnlyBreadcrumb: isOnlyBreadcrumb,
-        highlightLastBreadcrumb: isLastBreadcrumb && lastBreadcrumbIsCurrentPage
-      }, sharedProps, breadcrumb)));
+        highlightLastBreadcrumb: isLastBreadcrumb && lastBreadcrumbIsCurrentPage,
+        truncateLastBreadcrumb: isLastBreadcrumb && truncate && breadcrumb.truncate == null
+      })));
     });
   }, [visibleBreadcrumbs, truncate, type, lastBreadcrumbIsCurrentPage]);
   return ___EmotionJSX("nav", _extends({

package/es/components/datagrid/controls/column_selector.js

@@ -127,7 +127,7 @@ export var useDataGridColumnSelector = function useDataGridColumnSelector(availa
     },
     anchorPosition: "downLeft",
     panelPaddingSize: "s",
-    panelClassName: "euiDataGrid__controlPopoverWithDragDrop",
+    hasDragDrop: true,
     button: ___EmotionJSX(EuiButtonEmpty, {
       size: "xs",
       iconType: allowColumnHiding ? 'listAdd' : 'list',

package/es/components/datagrid/controls/column_sorting.js

@@ -140,7 +140,7 @@ export var useDataGridColumnSorting = function useDataGridColumnSorting(columns,
     },
     anchorPosition: "downLeft",
     panelPaddingSize: "s",
-    panelClassName: "euiDataGrid__controlPopoverWithDragDrop",
+    hasDragDrop: true,
     button: ___EmotionJSX(EuiButtonEmpty, {
       size: "xs",
       iconType: "sortable",

package/es/components/header/header_links/header_links.js

@@ -252,6 +252,12 @@ EuiHeaderLinks.propTypes = {
        */
     repositionOnScroll: PropTypes.bool,
 
+    /**
+       * Must be set to true if using `EuiDragDropContext` within a popover,
+       * otherwise your nested drag & drop will have incorrect positioning
+       */
+    hasDragDrop: PropTypes.bool,
+
     /**
        * By default, popover content inherits the z-index of the anchor
        * component; pass `zIndex` to override

package/es/components/modal/modal.js

@@ -19,7 +19,7 @@ function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) r
  * in compliance with, at your election, the Elastic License 2.0 or the Server
  * Side Public License, v 1.
  */
-import React from 'react';
+import React, { useRef, useCallback } from 'react';
 import PropTypes from "prop-types";
 import classnames from 'classnames';
 import { keys } from '../../services';
@@ -38,6 +38,19 @@ export var EuiModal = function EuiModal(_ref) {
       style = _ref.style,
       rest = _objectWithoutProperties(_ref, _excluded);
 
+  // TODO: Remove this onFocus scroll workaround after react-focus-on supports focusOptions
+  // @see https://github.com/elastic/eui/issues/6304
+  var bodyScrollTop = useRef(typeof window === 'undefined' ? undefined : window.scrollY // Account for SSR
+  );
+  var onFocus = useCallback(function () {
+    if (bodyScrollTop.current != null) {
+      window.scrollTo({
+        top: bodyScrollTop.current
+      });
+      bodyScrollTop.current = undefined; // Unset after first auto focus
+    }
+  }, []);
+
   var onKeyDown = function onKeyDown(event) {
     if (event.key === keys.ESCAPE) {
       event.preventDefault();
@@ -60,11 +73,13 @@ export var EuiModal = function EuiModal(_ref) {
 
   var classes = classnames('euiModal', widthClassName, className);
   return ___EmotionJSX(EuiOverlayMask, null, ___EmotionJSX(EuiFocusTrap, {
-    initialFocus: initialFocus
+    initialFocus: initialFocus,
+    scrollLock: true
   }, ___EmotionJSX("div", _extends({
     className: classes,
     onKeyDown: onKeyDown,
     tabIndex: 0,
+    onFocus: onFocus,
     style: newStyle || style
   }, rest), ___EmotionJSX(EuiI18n, {
     token: "euiModal.closeModal",

package/es/components/page_template/page_template.js

@@ -149,15 +149,12 @@ export var _EuiPageTemplate = function _EuiPageTemplate(_ref) {
   React.Children.toArray(children).forEach(function (child, index) {
     if (! /*#__PURE__*/React.isValidElement(child)) return; // Skip non-components
 
-    switch (child.type) {
-      case EuiPageSidebar:
-        sidebar.push( /*#__PURE__*/React.cloneElement(child, _objectSpread(_objectSpread({
-          key: "sidebar".concat(index)
-        }, getSideBarProps()), child.props)));
-        break;
-
-      default:
-        sections.push(child);
+    if (child.type === EuiPageSidebar || child.props.__EMOTION_TYPE_PLEASE_DO_NOT_USE__ === EuiPageSidebar) {
+      sidebar.push( /*#__PURE__*/React.cloneElement(child, _objectSpread(_objectSpread({
+        key: "sidebar".concat(index)
+      }, getSideBarProps()), child.props)));
+    } else {
+      sections.push(child);
     }
   });
 

package/es/components/popover/popover.js

@@ -1,7 +1,7 @@
 function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
 
 import { css as _css } from "@emotion/react";
-var _excluded = ["anchorClassName", "anchorPosition", "button", "buttonRef", "insert", "isOpen", "ownFocus", "children", "className", "closePopover", "panelClassName", "panelPaddingSize", "panelProps", "panelRef", "panelStyle", "popoverScreenReaderText", "popoverRef", "hasArrow", "arrowChildren", "repositionOnScroll", "zIndex", "attachToAnchor", "display", "offset", "onPositionChange", "onTrapDeactivation", "buffer", "aria-label", "aria-labelledby", "container", "focusTrapProps", "initialFocus", "tabIndex"];
+var _excluded = ["anchorClassName", "anchorPosition", "button", "buttonRef", "insert", "isOpen", "ownFocus", "children", "className", "closePopover", "panelClassName", "panelPaddingSize", "panelProps", "panelRef", "panelStyle", "popoverScreenReaderText", "popoverRef", "hasArrow", "arrowChildren", "repositionOnScroll", "hasDragDrop", "zIndex", "attachToAnchor", "display", "offset", "onPositionChange", "onTrapDeactivation", "buffer", "aria-label", "aria-labelledby", "container", "focusTrapProps", "initialFocus", "tabIndex"];
 
 function _extends() { _extends = Object.assign || 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); }
 
@@ -419,7 +419,8 @@ export var EuiPopover = /*#__PURE__*/function (_Component) {
   }, {
     key: "render",
     value: function render() {
-      var _this4 = this;
+      var _panelProps$tabIndex,
+          _this4 = this;
 
       var _this$props = this.props,
           anchorClassName = _this$props.anchorClassName,
@@ -442,6 +443,7 @@ export var EuiPopover = /*#__PURE__*/function (_Component) {
           hasArrow = _this$props.hasArrow,
           arrowChildren = _this$props.arrowChildren,
           repositionOnScroll = _this$props.repositionOnScroll,
+          hasDragDrop = _this$props.hasDragDrop,
           zIndex = _this$props.zIndex,
           attachToAnchor = _this$props.attachToAnchor,
           display = _this$props.display,
@@ -454,9 +456,10 @@ export var EuiPopover = /*#__PURE__*/function (_Component) {
           container = _this$props.container,
           focusTrapProps = _this$props.focusTrapProps,
           initialFocusProp = _this$props.initialFocus,
-          tabIndexProp = _this$props.tabIndex,
+          _tabIndexProp = _this$props.tabIndex,
           rest = _objectWithoutProperties(_this$props, _excluded);
 
+      var tabIndexProp = (_panelProps$tabIndex = panelProps === null || panelProps === void 0 ? void 0 : panelProps.tabIndex) !== null && _panelProps$tabIndex !== void 0 ? _panelProps$tabIndex : _tabIndexProp;
       var styles = euiPopoverStyles();
       var popoverStyles = [styles.euiPopover, {
         display: display
@@ -520,6 +523,7 @@ export var EuiPopover = /*#__PURE__*/function (_Component) {
           position: this.state.arrowPosition,
           isAttached: attachToAnchor,
           className: classNames(panelClassName, panelProps === null || panelProps === void 0 ? void 0 : panelProps.className),
+          hasDragDrop: hasDragDrop,
           hasShadow: false,
           paddingSize: panelPaddingSize,
           tabIndex: tabIndex,
@@ -738,6 +742,12 @@ EuiPopover.propTypes = {
      */
   repositionOnScroll: PropTypes.bool,
 
+  /**
+     * Must be set to true if using `EuiDragDropContext` within a popover,
+     * otherwise your nested drag & drop will have incorrect positioning
+     */
+  hasDragDrop: PropTypes.bool,
+
   /**
      * By default, popover content inherits the z-index of the anchor
      * component; pass `zIndex` to override

package/es/components/popover/popover_arrow/_popover_arrow.js

@@ -28,6 +28,7 @@ export var EuiPopoverArrow = function EuiPopoverArrow(_ref) {
   var styles = euiPopoverArrowStyles(euiTheme);
   var cssStyles = [styles.euiPopoverArrow, styles[position]];
   return ___EmotionJSX("div", _extends({
+    className: "euiPopover__arrow",
     "data-popover-arrow": position,
     css: cssStyles
   }, rest), children);

package/es/components/popover/popover_panel/_popover_panel.js

@@ -1,4 +1,4 @@
-var _excluded = ["children", "className", "isOpen", "isAttached", "position"];
+var _excluded = ["children", "className", "isOpen", "isAttached", "hasDragDrop", "position"];
 
 function _extends() { _extends = Object.assign || 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); }
 
@@ -45,6 +45,7 @@ export var EuiPopoverPanel = function EuiPopoverPanel(_ref) {
       className = _ref.className,
       isOpen = _ref.isOpen,
       isAttached = _ref.isAttached,
+      hasDragDrop = _ref.hasDragDrop,
       position = _ref.position,
       rest = _objectWithoutProperties(_ref, _excluded);
 
@@ -60,6 +61,10 @@ export var EuiPopoverPanel = function EuiPopoverPanel(_ref) {
     panelCSS = [].concat(_toConsumableArray(panelCSS), [isOpen && styles.attached.isOpen, position && styles.attached[position]]);
   }
 
+  if (hasDragDrop) {
+    panelCSS = [].concat(_toConsumableArray(panelCSS), [styles.hasDragDrop.hasDragDrop, position && styles.hasDragDrop[position]]);
+  }
+
   return ___EmotionJSX(EuiPopoverPanelContext.Provider, {
     value: panelContext
   }, ___EmotionJSX(EuiPanel, _extends({
@@ -111,5 +116,6 @@ EuiPopoverPanel.propTypes = {
   css: PropTypes.any,
   isOpen: PropTypes.bool,
   isAttached: PropTypes.bool,
-  position: PropTypes.oneOfType([PropTypes.any.isRequired, PropTypes.oneOf([null])])
+  position: PropTypes.oneOfType([PropTypes.any.isRequired, PropTypes.oneOf([null])]),
+  hasDragDrop: PropTypes.bool
 };

package/es/components/popover/popover_panel/_popover_panel.styles.js

@@ -7,6 +7,7 @@
  */
 import { css } from '@emotion/react';
 import { euiShadow, euiShadowFlat, euiShadowMedium } from '../../../themes/amsterdam/global_styling/mixins';
+import { getShadowColor } from '../../../themes/amsterdam/global_styling/functions';
 import { euiCanAnimate, logicalCSS } from '../../../global_styling';
 export var openAnimationTiming = 'slow';
 var translateDistance = 's';
@@ -17,7 +18,8 @@ var translateDistance = 's';
  */
 
 export var euiPopoverPanelStyles = function euiPopoverPanelStyles(euiThemeContext) {
-  var euiTheme = euiThemeContext.euiTheme;
+  var euiTheme = euiThemeContext.euiTheme,
+      colorMode = euiThemeContext.colorMode;
   return {
     // Base
     euiPopover__panel: /*#__PURE__*/css("position:absolute;", logicalCSS('min-width', "".concat(euiTheme.base * 7, "px")), ";", logicalCSS('max-width', "calc(100vw - ".concat(euiTheme.size.xl, ")")), ";backface-visibility:hidden;pointer-events:none;opacity:0;transform:translateY(0) translateX(0) translateZ(0);", euiShadowMedium(euiThemeContext, {
@@ -38,6 +40,18 @@ export var euiPopoverPanelStyles = function euiPopoverPanelStyles(euiThemeContex
       // Satisfies TS
       left: /*#__PURE__*/css(";label:left;"),
       right: /*#__PURE__*/css(";label:right;")
+    },
+    // Overrides for drag & drop contexts within popovers. This is required because
+    // the fixed positions of drag and drop don't work inside of transformed elements
+    hasDragDrop: {
+      hasDragDrop: /*#__PURE__*/css("transform:none;filter:none;", euiShadowMedium(euiThemeContext, {
+        property: 'box-shadow'
+      }), ";;label:hasDragDrop;"),
+      // The offset transforms must be recreated in margins
+      top: /*#__PURE__*/css("margin-block-start:", euiTheme.size[translateDistance], ";;label:top;"),
+      bottom: /*#__PURE__*/css("margin-block-start:-", euiTheme.size[translateDistance], ";.euiPopover__arrow{filter:drop-shadow(\n            0 -6px 6px ", getShadowColor(euiTheme.colors.shadow, 0.12, colorMode), "\n          );};label:bottom;"),
+      left: /*#__PURE__*/css("margin-inline-start:", euiTheme.size[translateDistance], ";.euiPopover__arrow{filter:drop-shadow(\n            6px 0 6px ", getShadowColor(euiTheme.colors.shadow, 0.12, colorMode), "\n          );};label:left;"),
+      right: /*#__PURE__*/css("margin-inline-start:-", euiTheme.size[translateDistance], ";.euiPopover__arrow{filter:drop-shadow(\n            -6px 0 6px ", getShadowColor(euiTheme.colors.shadow, 0.12, colorMode), "\n          );};label:right;")
     }
   };
 };

package/es/components/search_bar/query/ast.js

@@ -283,6 +283,10 @@ var arrayIncludesValue = function arrayIncludesValue(array, value) {
     return valuesEqual(item, value);
   });
 };
+
+var mustToMatch = function mustToMatch(must) {
+  return must === true ? Match.MUST : Match.MUST_NOT;
+};
 /**
  * The AST structure is an array of clauses. There are 3 types of clauses that are supported:
  *
@@ -407,9 +411,16 @@ export var _AST = /*#__PURE__*/function () {
     }
   }, {
     key: "getOrFieldClause",
-    value: function getOrFieldClause(field, value) {
+    value: function getOrFieldClause(field, value, must, operator) {
       return this.getFieldClause(field, function (clause) {
-        return isArray(clause.value) && (isNil(value) || arrayIncludesValue(clause.value, value));
+        if (!isArray(clause.value)) {
+          return false;
+        }
+
+        var matchValue = isNil(value) || arrayIncludesValue(clause.value, value);
+        var matchMust = isNil(must) || mustToMatch(must) === clause.match;
+        var matchOperator = isNil(operator) || operator === clause.operator;
+        return matchValue && matchMust && matchOperator;
       });
     }
   }, {
@@ -417,7 +428,7 @@ export var _AST = /*#__PURE__*/function () {
     value: function addOrFieldValue(field, value) {
       var must = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
       var operator = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : Operator.EQ;
-      var existingClause = this.getOrFieldClause(field);
+      var existingClause = this.getOrFieldClause(field, undefined, must, operator);
 
       if (!existingClause) {
         var newClause = must ? Field.must[operator](field, [value]) : Field.mustNot[operator](field, [value]);

package/es/components/search_bar/search_bar.js

@@ -2,6 +2,10 @@ var _excluded = ["schema"];
 
 function _extends() { _extends = Object.assign || 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 ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
 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; }
@@ -40,6 +44,7 @@ import PropTypes from "prop-types";
  * Side Public License, v 1.
  */
 import React, { Component } from 'react';
+import { htmlIdGenerator } from '../../services/accessibility';
 import { isString } from '../../services/predicate';
 import { EuiFlexGroup, EuiFlexItem } from '../flex';
 import { EuiSearchBox } from './search_box';
@@ -80,6 +85,8 @@ export var EuiSearchBar = /*#__PURE__*/function (_Component) {
 
     _this = _super.call(this, props);
 
+    _defineProperty(_assertThisInitialized(_this), "hintId", htmlIdGenerator('__hint')());
+
     _defineProperty(_assertThisInitialized(_this), "onSearch", function (queryText) {
       try {
         var query = parseQuery(queryText, _this.props);
@@ -136,7 +143,8 @@ export var EuiSearchBar = /*#__PURE__*/function (_Component) {
     _this.state = {
       query: _query,
       queryText: _query.text,
-      error: null
+      error: null,
+      isHintVisible: false
     };
     return _this;
   }
@@ -198,10 +206,15 @@ export var EuiSearchBar = /*#__PURE__*/function (_Component) {
   }, {
     key: "render",
     value: function render() {
+      var _hint$popoverProps$is,
+          _hint$popoverProps,
+          _this2 = this;
+
       var _this$state = this.state,
           query = _this$state.query,
           queryText = _this$state.queryText,
-          error = _this$state.error;
+          error = _this$state.error,
+          isHintVisibleState = _this$state.isHintVisible;
       var _this$props = this.props,
           _this$props$box = _this$props.box;
       _this$props$box = _this$props$box === void 0 ? {
@@ -212,7 +225,8 @@ export var EuiSearchBar = /*#__PURE__*/function (_Component) {
           box = _objectWithoutProperties(_this$props$box, _excluded),
           filters = _this$props.filters,
           toolsLeft = _this$props.toolsLeft,
-          toolsRight = _this$props.toolsRight;
+          toolsRight = _this$props.toolsRight,
+          hint = _this$props.hint;
 
       var toolsLeftEl = this.renderTools(toolsLeft);
       var filtersBar = !filters ? undefined : ___EmotionJSX(EuiFlexItem, {
@@ -224,6 +238,7 @@ export var EuiSearchBar = /*#__PURE__*/function (_Component) {
         onChange: this.onFiltersChange
       }));
       var toolsRightEl = this.renderTools(toolsRight);
+      var isHintVisible = (_hint$popoverProps$is = hint === null || hint === void 0 ? void 0 : (_hint$popoverProps = hint.popoverProps) === null || _hint$popoverProps === void 0 ? void 0 : _hint$popoverProps.isOpen) !== null && _hint$popoverProps$is !== void 0 ? _hint$popoverProps$is : isHintVisibleState;
       return ___EmotionJSX(EuiFlexGroup, {
         gutterSize: "m",
         alignItems: "center",
@@ -235,7 +250,17 @@ export var EuiSearchBar = /*#__PURE__*/function (_Component) {
         query: queryText,
         onSearch: this.onSearch,
         isInvalid: error != null,
-        title: error ? error.message : undefined
+        title: error ? error.message : undefined,
+        "aria-describedby": isHintVisible ? "".concat(this.hintId) : undefined,
+        hint: hint ? _objectSpread({
+          isVisible: isHintVisible,
+          setIsVisible: function setIsVisible(isVisible) {
+            _this2.setState({
+              isHintVisible: isVisible
+            });
+          },
+          id: this.hintId
+        }, hint) : undefined
       }))), filtersBar, toolsRightEl);
     }
   }], [{
@@ -246,7 +271,8 @@ export var EuiSearchBar = /*#__PURE__*/function (_Component) {
         return {
           query: query,
           queryText: query.text,
-          error: null
+          error: null,
+          isHintVisible: prevState.isHintVisible
         };
       }
 
@@ -432,6 +458,14 @@ EuiSearchBar.propTypes = {
      * Date formatter to use when parsing date values
      */
   dateFormat: PropTypes.any,
+
+  /**
+     * Hint to render below the search bar
+     */
+  hint: PropTypes.shape({
+    content: PropTypes.node.isRequired,
+    popoverProps: PropTypes.any
+  }),
   className: PropTypes.string,
   "aria-label": PropTypes.string,
   "data-test-subj": PropTypes.string,

package/es/components/search_bar/search_box.js

@@ -1,6 +1,6 @@
 function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
 
-var _excluded = ["query", "incremental"];
+var _excluded = ["query", "incremental", "hint"];
 
 function _extends() { _extends = Object.assign || 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); }
 
@@ -40,6 +40,7 @@ function _defineProperty(obj, key, value) { if (key in obj) { Object.definePrope
 import React, { Component } from 'react';
 import PropTypes from "prop-types";
 import { EuiFieldSearch } from '../form';
+import { EuiInputPopover } from '../popover';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var EuiSearchBox = /*#__PURE__*/function (_Component) {
   _inherits(EuiSearchBox, _Component);
@@ -78,6 +79,7 @@ export var EuiSearchBox = /*#__PURE__*/function (_Component) {
       var _this$props = this.props,
           query = _this$props.query,
           incremental = _this$props.incremental,
+          hint = _this$props.hint,
           rest = _objectWithoutProperties(_this$props, _excluded);
 
       var ariaLabel;
@@ -88,15 +90,39 @@ export var EuiSearchBox = /*#__PURE__*/function (_Component) {
         ariaLabel = 'This is a search bar. After typing your query, hit enter to filter the results lower in the page.';
       }
 
-      return ___EmotionJSX(EuiFieldSearch, _extends({
+      var search = ___EmotionJSX(EuiFieldSearch, _extends({
         inputRef: function inputRef(input) {
           return _this2.inputElement = input;
         },
         fullWidth: true,
         defaultValue: query,
         incremental: incremental,
-        "aria-label": ariaLabel
+        "aria-label": ariaLabel,
+        onFocus: function onFocus() {
+          hint === null || hint === void 0 ? void 0 : hint.setIsVisible(true);
+        }
       }, rest));
+
+      if (hint) {
+        return ___EmotionJSX(EuiInputPopover, _extends({
+          disableFocusTrap: true,
+          input: search,
+          isOpen: hint.isVisible,
+          fullWidth: true,
+          closePopover: function closePopover() {
+            hint.setIsVisible(false);
+          },
+          panelProps: {
+            'aria-live': undefined,
+            'aria-modal': undefined,
+            role: undefined,
+            tabIndex: -1,
+            id: hint.id
+          }
+        }, hint.popoverProps), hint.content);
+      }
+
+      return search;
     }
   }]);
 
@@ -111,5 +137,12 @@ _defineProperty(EuiSearchBox, "defaultProps", {
 EuiSearchBox.propTypes = {
   query: PropTypes.string.isRequired,
   // This is optional in EuiFieldSearchProps
-  onSearch: PropTypes.func.isRequired
+  onSearch: PropTypes.func.isRequired,
+  hint: PropTypes.shape({
+    id: PropTypes.string.isRequired,
+    isVisible: PropTypes.bool.isRequired,
+    setIsVisible: PropTypes.func.isRequired,
+    content: PropTypes.node.isRequired,
+    popoverProps: PropTypes.any
+  })
 };