@elastic/eui 113.2.1 → 114.0.0

package/lib/services/index.js

@@ -69,6 +69,16 @@ var _exportNames = {
   formatDate: true,
   formatNumber: true,
   formatText: true,
+  useDependentState: true,
+  useCombinedRefs: true,
+  setMultipleRefs: true,
+  useForceRender: true,
+  useLatest: true,
+  useDeepEqual: true,
+  isMouseEvent: true,
+  useMouseMove: true,
+  useUpdateEffect: true,
+  useEuiDisabledElement: true,
   isEvenlyDivisibleBy: true,
   isWithinRange: true,
   Pager: true,
@@ -426,6 +436,12 @@ Object.defineProperty(exports, "isEvenlyDivisibleBy", {
     return _number.isEvenlyDivisibleBy;
   }
 });
+Object.defineProperty(exports, "isMouseEvent", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.isMouseEvent;
+  }
+});
 Object.defineProperty(exports, "isValidHex", {
   enumerable: true,
   get: function get() {
@@ -481,6 +497,12 @@ Object.defineProperty(exports, "saturate", {
     return _color.saturate;
   }
 });
+Object.defineProperty(exports, "setMultipleRefs", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.setMultipleRefs;
+  }
+});
 Object.defineProperty(exports, "shade", {
   enumerable: true,
   get: function get() {
@@ -547,18 +569,48 @@ Object.defineProperty(exports, "useColorStopsState", {
     return _color_picker.useColorStopsState;
   }
 });
+Object.defineProperty(exports, "useCombinedRefs", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useCombinedRefs;
+  }
+});
 Object.defineProperty(exports, "useCurrentEuiBreakpoint", {
   enumerable: true,
   get: function get() {
     return _breakpoint.useCurrentEuiBreakpoint;
   }
 });
+Object.defineProperty(exports, "useDeepEqual", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useDeepEqual;
+  }
+});
+Object.defineProperty(exports, "useDependentState", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useDependentState;
+  }
+});
 Object.defineProperty(exports, "useEuiContainerQuery", {
   enumerable: true,
   get: function get() {
     return _container_query_hook.useEuiContainerQuery;
   }
 });
+Object.defineProperty(exports, "useEuiDisabledElement", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useEuiDisabledElement;
+  }
+});
+Object.defineProperty(exports, "useForceRender", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useForceRender;
+  }
+});
 Object.defineProperty(exports, "useGeneratedHtmlId", {
   enumerable: true,
   get: function get() {
@@ -583,6 +635,24 @@ Object.defineProperty(exports, "useIsWithinMinBreakpoint", {
     return _breakpoint.useIsWithinMinBreakpoint;
   }
 });
+Object.defineProperty(exports, "useLatest", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useLatest;
+  }
+});
+Object.defineProperty(exports, "useMouseMove", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useMouseMove;
+  }
+});
+Object.defineProperty(exports, "useUpdateEffect", {
+  enumerable: true,
+  get: function get() {
+    return _hooks.useUpdateEffect;
+  }
+});
 Object.defineProperty(exports, "wcagContrastMin", {
   enumerable: true,
   get: function get() {
@@ -661,17 +731,6 @@ Object.keys(_findElement).forEach(function (key) {
 var _focus_trap = require("./focus_trap");
 var _format = require("./format");
 var _hooks = require("./hooks");
-Object.keys(_hooks).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _hooks[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _hooks[key];
-    }
-  });
-});
 var _number = require("./number");
 var _paging = require("./paging");
 var _popover = require("./popover");

package/optimize/es/components/basic_table/collapsed_item_actions.js

@@ -59,6 +59,7 @@ export var CollapsedItemActions = function CollapsedItemActions(_ref) {
         var toolTipContent = callWithItemIfFunction(item)(action.description);
         var href = callWithItemIfFunction(item)(action.href);
         var dataTestSubj = callWithItemIfFunction(item)(action['data-test-subj']);
+        var color = action.color ? callWithItemIfFunction(item)(action.color) : undefined;
         var _onClick = action.onClick,
           target = action.target;
         controls.push(___EmotionJSX(EuiContextMenuItem, {
@@ -68,6 +69,7 @@ export var CollapsedItemActions = function CollapsedItemActions(_ref) {
           href: href,
           target: target,
           icon: icon,
+          color: color,
           "data-test-subj": dataTestSubj,
           onClick: function onClick(event) {
             event.persist();

package/optimize/es/components/color_picker/color_picker.js

@@ -12,7 +12,7 @@ import _typeof from "@babel/runtime/helpers/typeof";
 import React, { cloneElement, useEffect, useMemo, useRef, useState } from 'react';
 import classNames from 'classnames';
 import chroma from 'chroma-js';
-import { useEuiMemoizedStyles, keys, useEuiPaletteColorBlind } from '../../services';
+import { useEuiMemoizedStyles, keys, useEuiPaletteColorBlind, useGeneratedHtmlId } from '../../services';
 import { EuiFieldText, EuiFormControlLayout, EuiFormRow, EuiRange } from '../form';
 import { useEuiI18n } from '../i18n';
 import { EuiPopover } from '../popover';
@@ -85,9 +85,12 @@ export var EuiColorPicker = function EuiColorPicker(_ref) {
     _ref$isClearable = _ref.isClearable,
     isClearable = _ref$isClearable === void 0 ? false : _ref$isClearable,
     placeholder = _ref.placeholder,
-    dataTestSubj = _ref['data-test-subj'];
-  var _useEuiI18n = useEuiI18n(['euiColorPicker.popoverLabel', 'euiColorPicker.colorLabel', 'euiColorPicker.selectedColorLabel', 'euiColorPicker.colorErrorMessage', 'euiColorPicker.transparent', 'euiColorPicker.alphaLabel', 'euiColorPicker.openLabel', 'euiColorPicker.closeLabel'], ['Color selection dialog', 'Color value', 'Selected color', 'Invalid color value', 'Transparent', 'Alpha channel (opacity) value', 'Press the escape key to close the popover', 'Press the down key to open a popover containing color options']),
-    _useEuiI18n2 = _slicedToArray(_useEuiI18n, 8),
+    dataTestSubj = _ref['data-test-subj'],
+    _ariaLabel = _ref['aria-label'],
+    ariaLabelledby = _ref['aria-labelledby'],
+    ariaDescribedby = _ref['aria-describedby'];
+  var _useEuiI18n = useEuiI18n(['euiColorPicker.popoverLabel', 'euiColorPicker.colorLabel', 'euiColorPicker.selectedColorLabel', 'euiColorPicker.colorErrorMessage', 'euiColorPicker.transparent', 'euiColorPicker.alphaLabel', 'euiColorPicker.openLabel', 'euiColorPicker.closeLabel', 'euiColorPicker.ariaLabel'], ['Color selection dialog', 'Color value', 'Selected color', 'Invalid color value', 'Transparent', 'Alpha channel (opacity) value', 'Press the escape key to close the popover', 'Press the down key to open a popover containing color options', 'Select a color']),
+    _useEuiI18n2 = _slicedToArray(_useEuiI18n, 9),
     popoverLabel = _useEuiI18n2[0],
     colorLabel = _useEuiI18n2[1],
     selectedColorLabel = _useEuiI18n2[2],
@@ -95,7 +98,16 @@ export var EuiColorPicker = function EuiColorPicker(_ref) {
     transparent = _useEuiI18n2[4],
     alphaLabel = _useEuiI18n2[5],
     openLabel = _useEuiI18n2[6],
-    closeLabel = _useEuiI18n2[7];
+    closeLabel = _useEuiI18n2[7],
+    ariaLabel = _useEuiI18n2[8];
+  var openLabelId = useGeneratedHtmlId({
+    prefix: 'colorPicker',
+    suffix: 'openLabel'
+  });
+  var closeLabelId = useGeneratedHtmlId({
+    prefix: 'colorPicker',
+    suffix: 'closeLabel'
+  });
   var defaultSwatches = useEuiPaletteColorBlind();
   var swatches = _swatches !== null && _swatches !== void 0 ? _swatches : defaultSwatches;
   var preferredFormat = useMemo(function () {
@@ -424,10 +436,21 @@ export var EuiColorPicker = function EuiColorPicker(_ref) {
       readOnly: readOnly,
       fullWidth: fullWidth,
       autoComplete: "off",
-      "data-test-subj": testSubjAnchor,
-      "aria-label": isColorSelectorShown ? openLabel : closeLabel,
+      "data-test-subj": testSubjAnchor
+      // if an id is provided it might be used in combination with `htmlFor` on a label,
+      // so we don't want to override it with a fallback `aria-label`
+      ,
+      "aria-label": _ariaLabel ? _ariaLabel : id || ariaLabelledby ? undefined : ariaLabel,
+      "aria-labelledby": ariaLabelledby,
+      "aria-describedby": classNames(isColorSelectorShown ? openLabelId : closeLabelId, ariaDescribedby),
       controlOnly: true // Don't need two EuiFormControlwrappers
-    }));
+    }), ___EmotionJSX(EuiScreenReaderOnly, null, ___EmotionJSX("span", null, ___EmotionJSX("span", {
+      id: openLabelId,
+      "aria-hidden": !isColorSelectorShown
+    }, openLabel), ___EmotionJSX("span", {
+      id: closeLabelId,
+      "aria-hidden": isColorSelectorShown
+    }, closeLabel))));
   }
   return display === 'inline' ? ___EmotionJSX("div", {
     css: styles.euiColorPicker,

package/optimize/es/components/context_menu/context_menu_item.js

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/extends";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["children", "className", "hasPanel", "icon", "buttonRef", "disabled", "layoutAlign", "toolTipContent", "toolTipProps", "href", "target", "rel", "size"];
+var _excluded = ["children", "className", "hasPanel", "icon", "buttonRef", "disabled", "layoutAlign", "toolTipContent", "toolTipProps", "href", "target", "rel", "size", "color"];
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -41,12 +41,13 @@ export var EuiContextMenuItem = function EuiContextMenuItem(_ref) {
     rel = _ref.rel,
     _ref$size = _ref.size,
     size = _ref$size === void 0 ? 'm' : _ref$size,
+    color = _ref.color,
     rest = _objectWithoutProperties(_ref, _excluded);
   var isHrefValid = !href || validateHref(href);
   var disabled = _disabled || !isHrefValid;
   var classes = classNames('euiContextMenuItem', className);
   var styles = useEuiMemoizedStyles(euiContextMenuItemStyles);
-  var cssStyles = [styles.euiContextMenuItem, styles.sizes[size], styles.layoutAlign[layoutAlign], disabled && styles.disabled];
+  var cssStyles = [styles.euiContextMenuItem, styles.sizes[size], styles.layoutAlign[layoutAlign], disabled && styles.disabled, !disabled && color && styles.colors[color]];
   var iconInstance = icon && (typeof icon === 'string' ? ___EmotionJSX(EuiIcon, {
     type: icon,
     size: "m",

package/optimize/es/components/context_menu/context_menu_item.styles.js

@@ -8,7 +8,7 @@ function _EMOTION_STRINGIFIED_CSS_ERROR__() { return "You have tried to stringif
  */
 
 import { css } from '@emotion/react';
-import { logicalCSS, logicalTextAlignCSS, euiFontSize } from '../../global_styling';
+import { logicalCSS, logicalTextAlignCSS, euiFontSize, EXTENDED_BUTTON_COLORS, euiButtonEmptyColor } from '../../global_styling';
 var _ref = process.env.NODE_ENV === "production" ? {
   name: "4ak4s8-euiContextMenuItem__arrow",
   styles: "align-self:flex-end;label:euiContextMenuItem__arrow;"
@@ -77,6 +77,10 @@ export var euiContextMenuItemStyles = function euiContextMenuItemStyles(euiTheme
       euiContextMenuItem__text: _ref2,
       s: /*#__PURE__*/css(euiFontSize(euiThemeContext, 's'), ";;label:s;")
     },
-    euiContextMenuItem__arrow: _ref
+    euiContextMenuItem__arrow: _ref,
+    // Colors - maps button color names to text color overrides
+    colors: Object.fromEntries(EXTENDED_BUTTON_COLORS.map(function (color) {
+      return [color, /*#__PURE__*/css("color:", euiButtonEmptyColor(euiThemeContext, color).color, ";;label:colors;")];
+    }))
   };
 };

package/optimize/es/components/datagrid/utils/scrolling.js

@@ -8,8 +8,9 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
  * Side Public License, v 1.
  */
 
-import React, { useContext, useEffect, useCallback, useMemo } from 'react';
-import { useEuiMemoizedStyles, useIsPointerDown } from '../../../services';
+import React, { useContext, useEffect, useCallback, useMemo, useRef } from 'react';
+import { useEuiMemoizedStyles } from '../../../services';
+import { useIsPointerDown } from '../../../services/hooks';
 import { logicalStyles } from '../../../global_styling';
 import { DataGridCellPopoverContext } from '../body/cell';
 import { DataGridFocusContext } from './focus';
@@ -27,20 +28,48 @@ export var useScroll = function useScroll(args) {
     scrollCellIntoView = _useScrollCellIntoVie.scrollCellIntoView;
   var _useContext = useContext(DataGridFocusContext),
     focusedCell = _useContext.focusedCell;
-  var isPointerDown = useIsPointerDown(args.outerGridRef);
+  var isPointerDownRef = useIsPointerDown(args.outerGridRef);
+
+  /**
+   * Set when `focusedCell` changes while the pointer is held down (e.g. clicking a cell).
+   * Allows the `pointerup` listener below to scroll on release without
+   * causing snap-back when the user scrolls the grid without changing focus.
+   */
+  var pendingScrollRef = useRef(false);
+  useEffect(function () {
+    if (!focusedCell) return;
+    if (isPointerDownRef.current) {
+      // Pointer is down - defer scroll decision to the pointerup listener
+      pendingScrollRef.current = true;
+      return;
+    }
+    scrollCellIntoView({
+      rowIndex: focusedCell[1],
+      colIndex: focusedCell[0]
+    });
+  }, [focusedCell, scrollCellIntoView, isPointerDownRef]);
   useEffect(function () {
-    if (focusedCell) {
+    var handlePointerUp = function handlePointerUp() {
       var _window;
-      // do not scroll if text is being selected
-      if (isPointerDown || ((_window = window) === null || _window === void 0 || (_window = _window.getSelection()) === null || _window === void 0 ? void 0 : _window.type) === 'Range') {
-        return;
-      }
+      if (!pendingScrollRef.current || !focusedCell) return;
+      pendingScrollRef.current = false;
+
+      // Skip if the interaction resulted in text being selected
+      if (((_window = window) === null || _window === void 0 || (_window = _window.getSelection()) === null || _window === void 0 ? void 0 : _window.type) === 'Range') return;
       scrollCellIntoView({
         rowIndex: focusedCell[1],
         colIndex: focusedCell[0]
       });
-    }
-  }, [focusedCell, isPointerDown, scrollCellIntoView]);
+    };
+    document.addEventListener('pointerup', handlePointerUp, {
+      capture: true
+    });
+    return function () {
+      return document.removeEventListener('pointerup', handlePointerUp, {
+        capture: true
+      });
+    };
+  }, [focusedCell, scrollCellIntoView]);
   var _useContext2 = useContext(DataGridCellPopoverContext),
     popoverIsOpen = _useContext2.popoverIsOpen,
     cellLocation = _useContext2.cellLocation;

package/optimize/es/components/date_picker/super_date_picker/time_window_buttons.js

@@ -152,11 +152,20 @@ export var EuiTimeWindowButtons = function EuiTimeWindowButtons(_ref) {
 export function useEuiTimeWindow(start, end, apply, options) {
   var _options$zoomFactor;
   var min = dateMath.parse(start);
+
+  /* `roundUp: true` will result in an "inclusive" time (e.g. 23:59:59.999 for 'now/d').
+  It only changes the value for relative expressions (e.g. 'now/d') but not absolute ISO strings. */
   var max = dateMath.parse(end, {
     roundUp: true
   });
   var isInvalid = !min || !min.isValid() || !max || !max.isValid();
-  var windowDuration = isInvalid ? -1 : max.diff(min);
+  /* An end at .999ms is always considered an inclusive boundary (either as result of `roundUp: true`
+  or entered manually). 
+  To avoid a 1ms drift on every time window or zoom step, windowDuration has to be increased by 1ms.
+  This ensures the window is always at a clean boundary (e.g. 00:00:00.000 - 23:59:59.999). */
+  var isInclusiveBoundary = !isInvalid && max.milliseconds() === 999;
+  var endBoundary = !isInvalid ? isInclusiveBoundary ? moment(max).add(1, 'ms') : moment(max) : null;
+  var windowDuration = isInvalid || !endBoundary ? -1 : endBoundary.diff(min);
   var isWindowDurationZero = windowDuration === 0;
   var zoomFactor = getPercentageMultiplier((_options$zoomFactor = options === null || options === void 0 ? void 0 : options.zoomFactor) !== null && _options$zoomFactor !== void 0 ? _options$zoomFactor : ZOOM_FACTOR_DEFAULT);
   var zoomDelta = windowDuration * (zoomFactor / 2); // Gets added to each end, that's why it's split in half
@@ -177,7 +186,10 @@ export function useEuiTimeWindow(start, end, apply, options) {
   function stepForward() {
     if (isInvalid || isWindowDurationZero) return;
     apply({
-      start: moment(max).toISOString(),
+      /* Prevent 1ms drifts for inclusive boundaries by using the exclusive max (+ 1ms)
+      as the start of the next window (e.g. 00:00:00.000 instead of 23:59:59.999) */
+      start: (isInclusiveBoundary ? endBoundary // `!` is safe here because we early return on `isInvalid`
+      : moment(max)).toISOString(),
       end: moment(max).add(windowDuration, 'ms').toISOString()
     });
   }
@@ -185,7 +197,9 @@ export function useEuiTimeWindow(start, end, apply, options) {
     if (isInvalid || isWindowDurationZero) return;
     apply({
       start: moment(min).subtract(windowDuration, 'ms').toISOString(),
-      end: moment(min).toISOString()
+      /* Prevent 1ms drifts for inclusive boundaries by using the exclusive min (- 1ms)
+      as the end of the previous window (e.g. 23:59:59.999 instead of 00:00:00.000) */
+      end: (isInclusiveBoundary ? moment(min).subtract(1, 'ms') : moment(min)).toISOString()
     });
   }
   function expandWindow() {

package/optimize/es/components/flyout/_flyout_overlay.js

@@ -7,8 +7,9 @@ import _extends from "@babel/runtime/helpers/extends";
  * Side Public License, v 1.
  */
 
-import React, { useMemo } from 'react';
+import React, { useEffect, useMemo, useRef } from 'react';
 import { css, cx } from '@emotion/css';
+import { useCombinedRefs } from '../../services';
 import { EuiOverlayMask } from '../overlay_mask';
 import { EuiPortal } from '../portal';
 import { jsx as ___EmotionJSX } from "@emotion/react";
@@ -16,8 +17,7 @@ var getEuiFlyoutOverlayStyles = function getEuiFlyoutOverlayStyles(zIndex) {
   /*
   This needs to have !important to override the default EuiOverlayMask
   z-index based on the headerZindexLocation prop. Using the style attribute
-  doesn't work since EuiOverlayMask requires a string style prop that
-  causes React errors in the test environment.
+  doesn't work since EuiOverlayMask requires the styles to be provided via className
   */
   return /*#__PURE__*/css("z-index:", zIndex, "!important;;label:getEuiFlyoutOverlayStyles;");
 };
@@ -38,10 +38,39 @@ export var EuiFlyoutOverlay = function EuiFlyoutOverlay(_ref) {
     hasOverlayMask = _ref.hasOverlayMask,
     maskZIndex = _ref.maskZIndex,
     _ref$headerZindexLoca = _ref.headerZindexLocation,
-    headerZindexLocation = _ref$headerZindexLoca === void 0 ? 'below' : _ref$headerZindexLoca;
+    headerZindexLocation = _ref$headerZindexLoca === void 0 ? 'below' : _ref$headerZindexLoca,
+    containerRect = _ref.containerRect;
   var styles = useMemo(function () {
     return getEuiFlyoutOverlayStyles(maskZIndex);
   }, [maskZIndex]);
+
+  // Internal ref so we can apply containerRect positioning directly on the DOM
+  // node, avoiding new Emotion CSS class generation on every scroll/resize.
+  var internalMaskRef = useRef(null);
+  var combinedMaskRef = useCombinedRefs([internalMaskRef, maskProps === null || maskProps === void 0 ? void 0 : maskProps.maskRef]);
+  useEffect(function () {
+    var node = internalMaskRef.current;
+    if (!node) return;
+
+    //  containerRect positioning must be applied via node.style.setProperty rather than
+    //  through the style prop - EuiOverlayMask requires styles to be passed via className
+    if (containerRect) {
+      node.style.setProperty('inset-block-start', "".concat(containerRect.top, "px"));
+      node.style.setProperty('inset-inline-start', "".concat(containerRect.left, "px"));
+      node.style.setProperty('inline-size', "".concat(containerRect.width, "px"));
+      node.style.setProperty('block-size', "".concat(containerRect.height, "px"));
+      node.style.setProperty('inset-inline-end', 'auto');
+      node.style.setProperty('inset-block-end', 'auto');
+    } else {
+      node.style.removeProperty('inset-block-start');
+      node.style.removeProperty('inset-inline-start');
+      node.style.removeProperty('inline-size');
+      node.style.removeProperty('block-size');
+      node.style.removeProperty('inset-inline-end');
+      node.style.removeProperty('inset-block-end');
+    }
+  }, [containerRect, hasOverlayMask]); // toggling ownFocus while the flyout is already open should cause re-render
+
   var content = children;
   if (!isPushed || hasOverlayMask) {
     content = ___EmotionJSX(EuiPortal, null, content);
@@ -50,6 +79,7 @@ export var EuiFlyoutOverlay = function EuiFlyoutOverlay(_ref) {
   return ___EmotionJSX(React.Fragment, null, hasOverlayMask && ___EmotionJSX(EuiOverlayMask, _extends({
     headerZindexLocation: (_maskProps$headerZind = maskProps === null || maskProps === void 0 ? void 0 : maskProps.headerZindexLocation) !== null && _maskProps$headerZind !== void 0 ? _maskProps$headerZind : headerZindexLocation
   }, maskProps, {
+    maskRef: combinedMaskRef,
     className: classes
   })), content);
 };

package/optimize/es/components/flyout/const.js

@@ -18,6 +18,14 @@ export var FLYOUT_SIDES = ['left', 'right'];
 export var FLYOUT_SIZES = ['s', 'm', 'l', 'fill'];
 /** Type representing a supported named flyout size. */
 
+/** Menu display mode: always render menu when flyoutMenuProps is provided. */
+export var MENU_DISPLAY_ALWAYS = 'always';
+/** Menu display mode: only render menu when it has content (back button, history, title, or custom actions). */
+export var MENU_DISPLAY_AUTO = 'auto';
+/** Allowed flyout menu display modes. */
+export var FLYOUT_MENU_DISPLAY_MODES = [MENU_DISPLAY_ALWAYS, MENU_DISPLAY_AUTO];
+/** Type representing a supported flyout menu display mode. */
+
 /** Allowed padding sizes for flyout content. */
 export var FLYOUT_PADDING_SIZES = ['none', 's', 'm', 'l'];
 /** Type representing a supported flyout padding size. */
@@ -32,6 +40,8 @@ export var DEFAULT_SIDE = 'right';
 export var DEFAULT_SIZE = 'm';
 /** Default padding size inside flyouts. */
 export var DEFAULT_PADDING_SIZE = 'l';
+/** Default flyout menu display mode. */
+export var DEFAULT_MENU_DISPLAY_MODE = MENU_DISPLAY_AUTO;
 
 /**
  * Custom type checker for named flyout sizes since the prop