@elastic/eui 109.0.0 → 109.1.0

package/lib/components/date_picker/super_date_picker/super_date_picker.js

@@ -16,6 +16,7 @@ var _date_picker_range = require("../date_picker_range");
 var _form = require("../../form");
 var _time_options = require("./time_options");
 var _pretty_duration = require("./pretty_duration");
+var _time_window_buttons = require("./time_window_buttons");
 var _async_interval = require("./async_interval");
 var _super_update_button = require("./super_update_button");
 var _quick_select_popover = require("./quick_select_popover/quick_select_popover");
@@ -283,7 +284,9 @@ var EuiSuperDatePickerInternal = exports.EuiSuperDatePickerInternal = /*#__PURE_
         maxDate = _this$props3.maxDate,
         compressed = _this$props3.compressed,
         onFocus = _this$props3.onFocus,
-        styles = _this$props3.memoizedStyles;
+        styles = _this$props3.memoizedStyles,
+        _this$props3$timeZone = _this$props3.timeZoneDisplayProps,
+        timeZoneDisplayProps = _this$props3$timeZone === void 0 ? {} : _this$props3$timeZone;
       var autoRefreshAppend = !isPaused ? (0, _react2.jsx)(_auto_refresh.EuiAutoRefreshButton, {
         refreshInterval: refreshInterval,
         minInterval: refreshMinInterval,
@@ -360,7 +363,8 @@ var EuiSuperDatePickerInternal = exports.EuiSuperDatePickerInternal = /*#__PURE_
             timeOptions: timeOptions,
             buttonProps: {
               onFocus: onFocus
-            }
+            },
+            timeZoneDisplayProps: timeZoneDisplayProps
           }),
           endDateControl: isQuickSelectOnly ? undefined : (0, _react2.jsx)(_date_popover_button.EuiDatePopoverButton, {
             css: styles.euiSuperDatePicker__rangeInput,
@@ -385,7 +389,8 @@ var EuiSuperDatePickerInternal = exports.EuiSuperDatePickerInternal = /*#__PURE_
             timeOptions: timeOptions,
             buttonProps: {
               onFocus: onFocus
-            }
+            },
+            timeZoneDisplayProps: timeZoneDisplayProps
           })
         }));
       });
@@ -405,13 +410,32 @@ var EuiSuperDatePickerInternal = exports.EuiSuperDatePickerInternal = /*#__PURE_
         _this.applyTime();
       }
     });
-    _defineProperty(_this, "renderUpdateButton", function () {
+    _defineProperty(_this, "renderTimeWindowButtons", function () {
+      if (!_this.props.showTimeWindowButtons || _this.props.isAutoRefreshOnly) {
+        return null;
+      }
       var _this$props5 = _this.props,
-        isLoading = _this$props5.isLoading,
-        isDisabled = _this$props5.isDisabled,
-        updateButtonProps = _this$props5.updateButtonProps,
-        showUpdateButton = _this$props5.showUpdateButton,
-        compressed = _this$props5.compressed;
+        start = _this$props5.start,
+        end = _this$props5.end,
+        showTimeWindowButtons = _this$props5.showTimeWindowButtons,
+        compressed = _this$props5.compressed,
+        isDisabled = _this$props5.isDisabled;
+      var config = typeof showTimeWindowButtons === 'boolean' ? {} : showTimeWindowButtons;
+      return (0, _react2.jsx)(_time_window_buttons.EuiTimeWindowButtons, _extends({
+        applyTime: _this.applyQuickTime,
+        start: start,
+        end: end,
+        compressed: compressed,
+        isDisabled: !!isDisabled || _this.state.isInvalid
+      }, config));
+    });
+    _defineProperty(_this, "renderUpdateButton", function () {
+      var _this$props6 = _this.props,
+        isLoading = _this$props6.isLoading,
+        isDisabled = _this$props6.isDisabled,
+        updateButtonProps = _this$props6.updateButtonProps,
+        showUpdateButton = _this$props6.showUpdateButton,
+        compressed = _this$props6.compressed;
       if (!showUpdateButton) return null;
       return (0, _react2.jsx)(_super_update_button.EuiSuperUpdateButton, _extends({
         needsUpdate: _this.state.hasChanged,
@@ -430,21 +454,21 @@ var EuiSuperDatePickerInternal = exports.EuiSuperDatePickerInternal = /*#__PURE_
   return _createClass(EuiSuperDatePickerInternal, [{
     key: "render",
     value: function render() {
-      var _this$props6 = this.props,
-        isAutoRefreshOnly = _this$props6.isAutoRefreshOnly,
-        isDisabled = _this$props6.isDisabled,
-        isPaused = _this$props6.isPaused,
-        onRefreshChange = _this$props6.onRefreshChange,
-        refreshInterval = _this$props6.refreshInterval,
-        refreshMinInterval = _this$props6.refreshMinInterval,
-        refreshIntervalUnits = _this$props6.refreshIntervalUnits,
-        showUpdateButton = _this$props6.showUpdateButton,
-        dataTestSubj = _this$props6['data-test-subj'],
-        _width = _this$props6.width,
-        isQuickSelectOnly = _this$props6.isQuickSelectOnly,
-        compressed = _this$props6.compressed,
-        className = _this$props6.className,
-        styles = _this$props6.memoizedStyles;
+      var _this$props7 = this.props,
+        isAutoRefreshOnly = _this$props7.isAutoRefreshOnly,
+        isDisabled = _this$props7.isDisabled,
+        isPaused = _this$props7.isPaused,
+        onRefreshChange = _this$props7.onRefreshChange,
+        refreshInterval = _this$props7.refreshInterval,
+        refreshMinInterval = _this$props7.refreshMinInterval,
+        refreshIntervalUnits = _this$props7.refreshIntervalUnits,
+        showUpdateButton = _this$props7.showUpdateButton,
+        dataTestSubj = _this$props7['data-test-subj'],
+        _width = _this$props7.width,
+        isQuickSelectOnly = _this$props7.isQuickSelectOnly,
+        compressed = _this$props7.compressed,
+        className = _this$props7.className,
+        styles = _this$props7.memoizedStyles;
       var _this$state2 = this.state,
         hasChanged = _this$state2.hasChanged,
         isInvalid = _this$state2.isInvalid;
@@ -469,7 +493,7 @@ var EuiSuperDatePickerInternal = exports.EuiSuperDatePickerInternal = /*#__PURE_
         compressed: compressed,
         isDisabled: !!isDisabled,
         className: className
-      }) : (0, _react2.jsx)(_react.default.Fragment, null, this.renderDatePickerRange(), this.renderUpdateButton()));
+      }) : (0, _react2.jsx)(_react.default.Fragment, null, this.renderDatePickerRange(), this.renderTimeWindowButtons(), this.renderUpdateButton()));
     }
   }], [{
     key: "getDerivedStateFromProps",
@@ -632,6 +656,28 @@ EuiSuperDatePickerInternal.propTypes = {
      * @default true
      */
   showUpdateButton: _propTypes.default.oneOfType([_propTypes.default.bool.isRequired, _propTypes.default.oneOf(["iconOnly"])]),
+  /**
+     * Set to true to display buttons for time shifting and zooming out,
+     * next to the top-level control.
+     */
+  showTimeWindowButtons: _propTypes.default.oneOfType([_propTypes.default.bool.isRequired, _propTypes.default.shape({
+    /**
+       * Show button for zooming out
+       * @default true
+       */
+    showZoomOut: _propTypes.default.bool,
+    /**
+       * Show buttons for shifting the time window forward and backward
+       * @default true
+       */
+    showShiftArrows: _propTypes.default.bool,
+    /**
+       * How much the time window is increased when zooming.
+       * A number between 0 and 1 e.g. 0.25, or a string representing a percentage e.g. 25%
+       * @default 0.5
+       * */
+    zoomFactor: _propTypes.default.oneOfType([_propTypes.default.number.isRequired, _propTypes.default.string.isRequired])
+  }).isRequired]),
   /**
      * Hides the actual input reducing to just the quick select button.
      */
@@ -678,6 +724,31 @@ EuiSuperDatePickerInternal.propTypes = {
      * input by the user, set this flag to `false`.
      */
   canRoundRelativeUnits: _propTypes.default.bool,
+  /**
+     * Props passed to the time zone display in the popovers {@link EuiTimeZoneDisplayProps}
+     *
+     * Setting `timeZoneDisplayProps.timeZone` with a valid time zone name will make
+     * the time zone information be visible below the start and end input fields.
+     * This is informational only, it will not affect how date/times are handled.
+     */
+  timeZoneDisplayProps: _propTypes.default.shape({
+    /**
+       * A valid time zone name, from the IANA database, e.g. "America/Los_Angeles".
+       *
+       * @link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+       */
+    timeZone: _propTypes.default.string,
+    /**
+       * Render prop function to add additional content to the time zone display.
+       * Useful for e.g. adding links to documentation or setting pages.
+       */
+    customRender: _propTypes.default.func,
+    /**
+       * Reference date to be used while resolving the UTC offset.
+       * Only useful for edge cases involving daylight saving time.
+       */
+    date: _propTypes.default.any
+  }),
   memoizedStyles: _propTypes.default.any.isRequired,
   timeOptions: _propTypes.default.shape({
     timeTenseOptions: _propTypes.default.arrayOf(_propTypes.default.any.isRequired).isRequired,
@@ -827,6 +898,15 @@ EuiSuperDatePicker.propTypes = {
      * @default true
      */
   showUpdateButton: _propTypes.default.oneOfType([_propTypes.default.bool.isRequired, _propTypes.default.oneOf(["iconOnly"])]),
+  /**
+     * Set to true to display buttons for time shifting and zooming out,
+     * next to the top-level control.
+     */
+  showTimeWindowButtons: _propTypes.default.oneOfType([_propTypes.default.bool.isRequired, _propTypes.default.shape({
+    showZoomOut: _propTypes.default.bool,
+    showShiftArrows: _propTypes.default.bool,
+    zoomFactor: _propTypes.default.oneOfType([_propTypes.default.number.isRequired, _propTypes.default.string.isRequired])
+  }).isRequired]),
   /**
      * Hides the actual input reducing to just the quick select button.
      */
@@ -852,5 +932,17 @@ EuiSuperDatePicker.propTypes = {
      * If you do not want this behavior and instead wish to keep the exact units
      * input by the user, set this flag to `false`.
      */
-  canRoundRelativeUnits: _propTypes.default.bool
+  canRoundRelativeUnits: _propTypes.default.bool,
+  /**
+     * Props passed to the time zone display in the popovers {@link EuiTimeZoneDisplayProps}
+     *
+     * Setting `timeZoneDisplayProps.timeZone` with a valid time zone name will make
+     * the time zone information be visible below the start and end input fields.
+     * This is informational only, it will not affect how date/times are handled.
+     */
+  timeZoneDisplayProps: _propTypes.default.shape({
+    timeZone: _propTypes.default.string,
+    customRender: _propTypes.default.func,
+    date: _propTypes.default.any
+  })
 };

package/lib/components/date_picker/super_date_picker/time_window_buttons.js

@@ -0,0 +1,193 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ZOOM_FACTOR_DEFAULT = exports.EuiTimeWindowButtons = void 0;
+exports.useEuiTimeWindow = useEuiTimeWindow;
+var _react = _interopRequireDefault(require("react"));
+var _datemath = _interopRequireDefault(require("@elastic/datemath"));
+var _moment = _interopRequireDefault(require("moment"));
+var _pretty_interval = require("./pretty_interval");
+var _relative_utils = require("./relative_utils");
+var _button_group_button = require("../../button/button_group/button_group_button");
+var _button_group = require("../../button/button_group/button_group.styles");
+var _services = require("../../../services");
+var _i18n = require("../../i18n");
+var _react2 = require("@emotion/react");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/*
+ * 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 ZOOM_FACTOR_DEFAULT = exports.ZOOM_FACTOR_DEFAULT = 0.5;
+/**
+ * Button group with time window controls for shifting the time window
+ * forwards and backwards, and zooming out.
+ */
+var EuiTimeWindowButtons = exports.EuiTimeWindowButtons = function EuiTimeWindowButtons(_ref) {
+  var applyTime = _ref.applyTime,
+    start = _ref.start,
+    end = _ref.end,
+    compressed = _ref.compressed,
+    isDisabled = _ref.isDisabled,
+    _ref$showZoomOut = _ref.showZoomOut,
+    showZoomOut = _ref$showZoomOut === void 0 ? true : _ref$showZoomOut,
+    _ref$showShiftArrows = _ref.showShiftArrows,
+    showShiftArrows = _ref$showShiftArrows === void 0 ? true : _ref$showShiftArrows,
+    _ref$zoomFactor = _ref.zoomFactor,
+    zoomFactor = _ref$zoomFactor === void 0 ? ZOOM_FACTOR_DEFAULT : _ref$zoomFactor;
+  var buttonColor = 'text';
+  var buttonSize = compressed ? 's' : 'm';
+  var iconSize = compressed ? 's' : 'm';
+  var styles = (0, _services.useEuiMemoizedStyles)(_button_group.euiButtonGroupButtonsStyles);
+  var _useEuiTimeWindow = useEuiTimeWindow(start, end, applyTime, {
+      zoomFactor: zoomFactor
+    }),
+    displayInterval = _useEuiTimeWindow.displayInterval,
+    isInvalid = _useEuiTimeWindow.isInvalid,
+    stepForward = _useEuiTimeWindow.stepForward,
+    stepBackward = _useEuiTimeWindow.stepBackward,
+    expandWindow = _useEuiTimeWindow.expandWindow;
+  var invalidShiftDescription = (0, _i18n.useEuiI18n)('euiTimeWindowButtons.invalidShiftLabel', 'Cannot shift invalid time window');
+  var invalidZoomOutDescription = (0, _i18n.useEuiI18n)('euiTimeWindowButtons.invalidZoomOutLabel', 'Cannot zoom out invalid time window');
+  var previousId = (0, _services.useGeneratedHtmlId)({
+    prefix: 'previous'
+  });
+  var previousLabel = (0, _i18n.useEuiI18n)('euiTimeWindowButtons.previousLabel', 'Previous');
+  var previousTooltipContent = (0, _i18n.useEuiI18n)('euiTimeWindowButtons.previousDescription', 'Previous {displayInterval}', {
+    displayInterval: displayInterval
+  });
+  var zoomOutId = (0, _services.useGeneratedHtmlId)({
+    prefix: 'zoom_out'
+  });
+  var zoomOutLabel = (0, _i18n.useEuiI18n)('euiTimeWindowButtons.zoomOutLabel', 'Zoom out');
+  var zoomOutTooltipContent = isInvalid ? invalidZoomOutDescription : zoomOutLabel;
+  var nextId = (0, _services.useGeneratedHtmlId)({
+    prefix: 'next'
+  });
+  var nextLabel = (0, _i18n.useEuiI18n)('euiTimeWindowButtons.nextLabel', 'Next');
+  var nextTooltipContent = (0, _i18n.useEuiI18n)('euiTimeWindowButtons.nextDescription', 'Next {displayInterval}', {
+    displayInterval: displayInterval
+  });
+  if (!showZoomOut && !showShiftArrows) return null;
+  return (0, _react2.jsx)("div", {
+    className: "euiSuperDatePicker__timeWindowButtons",
+    css: [styles.euiButtonGroup__buttons, styles[buttonSize], ";label:EuiTimeWindowButtons;"],
+    "data-test-subj": "timeWindowButtons"
+  }, showShiftArrows && (0, _react2.jsx)(_button_group_button.EuiButtonGroupButton, {
+    id: previousId,
+    "data-test-subj": "timeWindowButtonsPrevious",
+    label: previousLabel,
+    title: "",
+    toolTipContent: !isDisabled && (isInvalid ? invalidShiftDescription : previousTooltipContent),
+    color: buttonColor,
+    size: buttonSize,
+    iconType: "arrowLeft",
+    iconSize: iconSize,
+    isIconOnly: true,
+    isSelected: false,
+    isDisabled: isDisabled,
+    onClick: stepBackward
+  }), showZoomOut && (0, _react2.jsx)(_button_group_button.EuiButtonGroupButton, {
+    id: zoomOutId,
+    "data-test-subj": "timeWindowButtonsZoomOut",
+    label: zoomOutLabel,
+    title: "",
+    toolTipContent: !isDisabled && zoomOutTooltipContent,
+    toolTipProps: {
+      disableScreenReaderOutput: zoomOutLabel === zoomOutTooltipContent
+    },
+    color: buttonColor,
+    size: buttonSize,
+    iconType: "magnifyWithMinus",
+    iconSize: iconSize,
+    isIconOnly: true,
+    isSelected: false,
+    isDisabled: isDisabled,
+    onClick: expandWindow
+  }), showShiftArrows && (0, _react2.jsx)(_button_group_button.EuiButtonGroupButton, {
+    id: nextId,
+    "data-test-subj": "timeWindowButtonsNext",
+    label: nextLabel,
+    title: "",
+    toolTipContent: !isDisabled && (isInvalid ? invalidShiftDescription : nextTooltipContent),
+    color: buttonColor,
+    size: buttonSize,
+    iconType: "arrowRight",
+    iconSize: iconSize,
+    isIconOnly: true,
+    isSelected: false,
+    isDisabled: isDisabled,
+    onClick: stepForward
+  }));
+};
+
+/**
+ * Partly adapted from date_picker/super_date_picker/quick_select_popover/quick_select.tsx
+ */
+function useEuiTimeWindow(start, end, apply, options) {
+  var _options$zoomFactor;
+  var min = _datemath.default.parse(start);
+  var max = _datemath.default.parse(end, {
+    roundUp: true
+  });
+  var isInvalid = !min || !min.isValid() || !max || !max.isValid();
+  var windowDuration = isInvalid ? 1 : max.diff(min);
+  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 zoomAddition = windowDuration * (zoomFactor / 2); // Gets added to each end, that's why it's split in half
+  var prettyInterval = (0, _pretty_interval.usePrettyInterval)(false, windowDuration);
+  var displayInterval = isInvalid ? '' : prettyInterval;
+  if (!isInvalid && !(0, _relative_utils.isRelativeToNow)(start, end) && !isExactMinuteRange(windowDuration)) {
+    displayInterval = "~".concat(displayInterval);
+  }
+  return {
+    displayInterval: displayInterval,
+    isInvalid: isInvalid,
+    stepForward: stepForward,
+    stepBackward: stepBackward,
+    expandWindow: expandWindow
+  };
+  function stepForward() {
+    if (isInvalid) return;
+    apply({
+      start: (0, _moment.default)(max).toISOString(),
+      end: (0, _moment.default)(max).add(windowDuration, 'ms').toISOString()
+    });
+  }
+  function stepBackward() {
+    if (isInvalid) return;
+    apply({
+      start: (0, _moment.default)(min).subtract(windowDuration, 'ms').toISOString(),
+      end: (0, _moment.default)(min).toISOString()
+    });
+  }
+  function expandWindow() {
+    if (isInvalid) return;
+    apply({
+      start: (0, _moment.default)(min).subtract(zoomAddition, 'ms').toISOString(),
+      end: (0, _moment.default)(max).add(zoomAddition, 'ms').toISOString()
+    });
+  }
+}
+
+/**
+ * Get a number out of either 0.2 or "20%"
+ */
+function getPercentageMultiplier(value) {
+  var result = typeof value === 'number' ? value : parseFloat(String(value).replace('%', '').trim());
+  if (isNaN(result)) throw new TypeError('Please provide a valid number or percentage string e.g. "25%"');
+  return result > 1 ? result / 100 : result;
+}
+
+/**
+ * Useful to determine whether to show the tilde in the display
+ */
+function isExactMinuteRange(diffMs) {
+  // 60 * 1000 = ms per minute
+  return diffMs % (60 * 1000) === 0;
+}

package/lib/components/facet/facet_button.js

@@ -116,6 +116,9 @@ EuiFacetButton.propTypes = {
      * Any node, but preferably a `EuiIcon` or `EuiAvatar`
      */
   icon: _propTypes.default.node,
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
   isDisabled: _propTypes.default.oneOfType([_propTypes.default.bool, _propTypes.default.bool]),
   /**
      * Force disables the button and changes the icon to a loading spinner
@@ -158,27 +161,14 @@ EuiFacetButton.propTypes = {
   style: _propTypes.default.any,
   type: _propTypes.default.any,
   /**
-     * Any `type` accepted by EuiIcon
-     */
-  iconType: _propTypes.default.oneOfType([_propTypes.default.oneOf(["accessibility", "addDataApp", "advancedSettingsApp", "agentApp", "aggregate", "alert", "analyzeEvent", "annotation", "anomalyChart", "anomalySwimLane", "apmApp", "apmTrace", "appSearchApp", "apps", "arrowDown", "arrowLeft", "arrowRight", "arrowUp", "arrowStart", "arrowEnd", "article", "asterisk", "at", "auditbeatApp", "backgroundTask", "beaker", "bell", "bellSlash", "beta", "bolt", "boxesHorizontal", "boxesVertical", "branch", "branchUser", "broom", "brush", "bug", "bullseye", "calendar", "canvasApp", "casesApp", "changePointDetection", "check", "checkCircle", "checkInCircleFilled", "cheer", "classificationJob", "clickLeft", "clickRight", "clock", "clockCounter", "cloudDrizzle", "cloudStormy", "cloudSunny", "cluster", "code", "codeApp", "color", "comment", "compute", "console", "consoleApp", "container", "continuityAbove", "continuityAboveBelow", "continuityBelow", "continuityWithin", "contrast", "contrastHigh", "controls", "controlsHorizontal", "controlsVertical", "copy", "copyClipboard", "createAdvancedJob", "createGenericJob", "createGeoJob", "createMultiMetricJob", "createPopulationJob", "createSingleMetricJob", "cross", "crossClusterReplicationApp", "crossInCircle", "crosshairs", "currency", "cut", "dashboardApp", "dataVisualizer", "database", "desktop", "devToolsApp", "diff", "discoverApp", "discuss", "document", "documentEdit", "documentation", "documents", "dot", "dotInCircle", "doubleArrowLeft", "doubleArrowRight", "download", "editorAlignCenter", "editorAlignLeft", "editorAlignRight", "editorBold", "editorChecklist", "editorCodeBlock", "editorComment", "editorDistributeHorizontal", "editorDistributeVertical", "editorHeading", "editorItalic", "editorItemAlignBottom", "editorItemAlignCenter", "editorItemAlignLeft", "editorItemAlignMiddle", "editorItemAlignRight", "editorItemAlignTop", "editorLink", "editorOrderedList", "editorPositionBottomLeft", "editorPositionBottomRight", "editorPositionTopLeft", "editorPositionTopRight", "editorRedo", "editorStrike", "editorTable", "editorUnderline", "editorUndo", "editorUnorderedList", "email", "empty", "emsApp", "endpoint", "eql", "eraser", "error", "errorFilled", "esqlVis", "exit", "expand", "expandMini", "export", "exportAction", "eye", "eyeClosed", "faceHappy", "faceNeutral", "faceSad", "fieldStatistics", "filebeatApp", "filter", "filterExclude", "filterIgnore", "filterInclude", "filterInCircle", "flask", "flag", "fleetApp", "fold", "folderCheck", "folderClosed", "folderExclamation", "folderOpen", "frameNext", "framePrevious", "fullScreen", "fullScreenExit", "function", "gear", "gisApp", "glasses", "globe", "grab", "grabHorizontal", "grabOmnidirectional", "gradient", "graphApp", "grid", "grokApp", "heart", "heartbeatApp", "heatmap", "help", "home", "info", "image", "importAction", "index", "indexClose", "indexEdit", "indexFlush", "indexManagementApp", "indexMapping", "indexOpen", "indexPatternApp", "indexRollupApp", "indexRuntime", "indexSettings", "indexTemporary", "infinity", "inputOutput", "inspect", "invert", "ip", "key", "keyboard", "kqlField", "kqlFunction", "kqlOperand", "kqlSelector", "kqlValue", "kubernetesNode", "kubernetesPod", "launch", "layers", "lensApp", "lettering", "lineDashed", "lineDotted", "lineSolid", "link", "list", "listAdd", "lock", "lockOpen", "logPatternAnalysis", "logRateAnalysis", "logoAWS", "logoAWSMono", "logoAerospike", "logoApache", "logoAppSearch", "logoAzure", "logoAzureMono", "logoBeats", "logoBusinessAnalytics", "logoCeph", "logoCloud", "logoCloudEnterprise", "logoCode", "logoCodesandbox", "logoCouchbase", "logoDocker", "logoDropwizard", "logoElastic", "logoElasticStack", "logoElasticsearch", "logoEnterpriseSearch", "logoEtcd", "logoGCP", "logoGCPMono", "logoGithub", "logoGmail", "logoGolang", "logoGoogleG", "logoHAproxy", "logoIBM", "logoIBMMono", "logoKafka", "logoKibana", "logoKubernetes", "logoLogging", "logoLogstash", "logoMaps", "logoMemcached", "logoMetrics", "logoMongodb", "logoMySQL", "logoNginx", "logoObservability", "logoOsquery", "logoPhp", "logoPostgres", "logoPrometheus", "logoRabbitmq", "logoRedis", "logoSecurity", "logoSiteSearch", "logoSketch", "logoSlack", "logoUptime", "logoVulnerabilityManagement", "logoWebhook", "logoWindows", "logoWorkplaceSearch", "logsApp", "logstashFilter", "logstashIf", "logstashInput", "logstashOutput", "logstashQueue", "machineLearningApp", "magnet", "magnifyWithExclamation", "magnifyWithMinus", "magnifyWithPlus", "managementApp", "mapMarker", "memory", "menu", "menuDown", "menuLeft", "menuRight", "menuUp", "merge", "metricbeatApp", "metricsApp", "minimize", "minus", "minusInCircle", "minusInCircleFilled", "minusInSquare", "mobile", "monitoringApp", "moon", "move", "namespace", "nested", "newChat", "node", "notebookApp", "number", "offline", "online", "outlierDetectionJob", "package", "packetbeatApp", "pageSelect", "pagesSelect", "palette", "paperClip", "partial", "pause", "payment", "pencil", "percent", "pin", "pinFilled", "pipeBreaks", "pipelineApp", "pipeNoBreaks", "pivot", "play", "playFilled", "plugs", "plus", "plusInCircle", "plusInCircleFilled", "plusInSquare", "popout", "push", "question", "quote", "readOnly", "recentlyViewedApp", "refresh", "regressionJob", "reporter", "reportingApp", "returnKey", "save", "savedObjectsApp", "scale", "search", "searchProfilerApp", "section", "securityAnalyticsApp", "securityApp", "securitySignal", "securitySignalDetected", "securitySignalResolved", "sessionViewer", "shard", "share", "singleMetricViewer", "snowflake", "sortAscending", "sortDescending", "sortDown", "sortLeft", "sortRight", "sortUp", "sortable", "spaces", "spacesApp", "sparkles", "sqlApp", "starEmpty", "starEmptySpace", "starFilled", "starFilledSpace", "starMinusEmpty", "starMinusFilled", "starPlusEmpty", "starPlusFilled", "stats", "stop", "stopFilled", "stopSlash", "storage", "streamsClassic", "streamsWired", "string", "submodule", "sun", "swatchInput", "symlink", "tableDensityCompact", "tableDensityExpanded", "tableDensityNormal", "tableOfContents", "tag", "tear", "temperature", "thumbDown", "thumbUp", "timeline", "timelineWithArrow", "timelionApp", "timeRefresh", "timeslider", "training", "transitionLeftIn", "transitionLeftOut", "transitionTopIn", "transitionTopOut", "trash", "unfold", "unlink", "upgradeAssistantApp", "uptimeApp", "user", "userAvatar", "users", "usersRolesApp", "vector", "videoPlayer", "visArea", "visAreaStacked", "visBarHorizontal", "visBarHorizontalStacked", "visBarVertical", "visBarVerticalStacked", "visGauge", "visGoal", "visLine", "visMapCoordinate", "visMapRegion", "visMetric", "visPie", "visTable", "visTagCloud", "visText", "visTimelion", "visVega", "visVisualBuilder", "visualizeApp", "vulnerabilityManagementApp", "warning", "warningFilled", "watchesApp", "web", "wordWrap", "wordWrapDisabled", "workflowsApp", "workplaceSearchApp", "wrench", "tokenAlias", "tokenAnnotation", "tokenArray", "tokenBinary", "tokenBoolean", "tokenClass", "tokenCompletionSuggester", "tokenConstant", "tokenDate", "tokenDimension", "tokenElement", "tokenEnum", "tokenEnumMember", "tokenEvent", "tokenException", "tokenField", "tokenFile", "tokenFlattened", "tokenFunction", "tokenGeo", "tokenHistogram", "tokenInterface", "tokenIP", "tokenJoin", "tokenKey", "tokenKeyword", "tokenMethod", "tokenMetricCounter", "tokenMetricGauge", "tokenModule", "tokenNamespace", "tokenNested", "tokenNull", "tokenNumber", "tokenObject", "tokenOperator", "tokenPackage", "tokenParameter", "tokenPercolator", "tokenProperty", "tokenRange", "tokenRankFeature", "tokenRankFeatures", "tokenRepo", "tokenSearchType", "tokenSemanticText", "tokenShape", "tokenString", "tokenStruct", "tokenSymbol", "tokenTag", "tokenText", "tokenTokenCount", "tokenVariable", "tokenVectorDense", "tokenDenseVector", "tokenVectorSparse"]).isRequired, _propTypes.default.string.isRequired, _propTypes.default.elementType.isRequired]),
-  /**
-     * Can only be one side `left` or `right`
-     */
-  iconSide: _propTypes.default.oneOfType([_propTypes.default.any.isRequired, _propTypes.default.oneOf([undefined])]),
-  /**
-     * Object of props passed to the `<span>` wrapping the content's text/children only (not icon)
+     * NOTE: Beta feature, may be changed or removed in the future
+     *
+     * Changes the native `disabled` attribute to `aria-disabled` to preserve focusability.
+     * This results in a semantically disabled button without the default browser handling of the disabled state.
      *
-     * This span wrapper can be removed by passing `textProps={false}`.
+     * Use e.g. when a disabled button should have a tooltip.
      */
-  textProps: _propTypes.default.oneOfType([_propTypes.default.shape({
-    className: _propTypes.default.string,
-    "aria-label": _propTypes.default.string,
-    "data-test-subj": _propTypes.default.string,
-    css: _propTypes.default.any,
-    ref: _propTypes.default.any,
-    "data-text": _propTypes.default.string
-  }).isRequired, _propTypes.default.oneOf([false])]),
-  iconSize: _propTypes.default.any,
+  hasAriaDisabled: _propTypes.default.bool,
   className: _propTypes.default.string,
   "aria-label": _propTypes.default.string,
   "data-test-subj": _propTypes.default.string,

package/lib/components/filter_group/filter_button.js

@@ -234,5 +234,18 @@ EuiFilterButton.propTypes = {
      *  - accent
      *  - warning
      */
-  color: _propTypes.default.any
+  color: _propTypes.default.any,
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
+  isDisabled: _propTypes.default.bool,
+  /**
+     * NOTE: Beta feature, may be changed or removed in the future
+     *
+     * Changes the native `disabled` attribute to `aria-disabled` to preserve focusability.
+     * This results in a semantically disabled button without the default browser handling of the disabled state.
+     *
+     * Use e.g. when a disabled button should have a tooltip.
+     */
+  hasAriaDisabled: _propTypes.default.bool
 };

package/lib/components/flyout/flyout.js

@@ -231,20 +231,28 @@ var EuiFlyout = exports.EuiFlyout = /*#__PURE__*/(0, _react.forwardRef)(function
     }
     return selectors;
   }, [includeSelectorInFocusTrap, includeFixedHeadersInFocusTrap]);
-  (0, _react.useEffect)(function () {
+
+  /**
+   * Finds the shards to include in the focus trap by querying by `focusTrapSelectors`.
+   *
+   * @param shouldAutoFocus Whether to auto-focus the flyout wrapper when the focus trap is activated.
+   * This is necessary because when a flyout is toggled from within a shard, the focus trap's `autoFocus`
+   * feature doesn't work. This logic manually focuses the flyout as a workaround.
+   */
+  var findShards = (0, _react.useCallback)(function () {
+    var shouldAutoFocus = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
     if (focusTrapSelectors.length > 0) {
       var shardsEls = focusTrapSelectors.flatMap(function (selector) {
         return Array.from(document.querySelectorAll(selector));
       });
       setFocusTrapShards(Array.from(shardsEls));
-
-      // Flyouts that are toggled from shards do not have working
-      // focus trap autoFocus, so we need to focus the flyout wrapper ourselves
-      shardsEls.forEach(function (shard) {
-        if (shard.contains(flyoutToggle.current)) {
-          resizeRef === null || resizeRef === void 0 || resizeRef.focus();
-        }
-      });
+      if (shouldAutoFocus) {
+        shardsEls.forEach(function (shard) {
+          if (shard.contains(flyoutToggle.current)) {
+            resizeRef === null || resizeRef === void 0 || resizeRef.focus();
+          }
+        });
+      }
     } else {
       // Clear existing shards if necessary, e.g. switching to `false`
       setFocusTrapShards(function (shards) {
@@ -252,6 +260,15 @@ var EuiFlyout = exports.EuiFlyout = /*#__PURE__*/(0, _react.forwardRef)(function
       });
     }
   }, [focusTrapSelectors, resizeRef]);
+  (0, _react.useEffect)(function () {
+    // Auto-focus should only happen on initial flyout mount (or when the dependencies change)
+    // because it snaps focus to the flyout wrapper, which steals it from subsequently focused elements.
+    findShards(true);
+    var unsubscribe = _services.focusTrapPubSub.subscribe(function () {
+      return findShards();
+    });
+    return unsubscribe;
+  }, [findShards]);
   var focusTrapProps = (0, _react.useMemo)(function () {
     return _objectSpread(_objectSpread({}, _focusTrapProps), {}, {
       shards: [].concat(_toConsumableArray(focusTrapShards), _toConsumableArray((_focusTrapProps === null || _focusTrapProps === void 0 ? void 0 : _focusTrapProps.shards) || []))

package/lib/components/form/form_control_button/form_control_button.js

@@ -108,13 +108,6 @@ EuiFormControlButton.propTypes = {
   fullWidth: _propTypes.default.bool,
   href: _propTypes.default.string,
   onClick: _propTypes.default.func,
-  /**
-     * `disabled` is also allowed
-     */
-  /**
-     * `disabled` is also allowed
-     */
-  isDisabled: _propTypes.default.bool,
   target: _propTypes.default.string,
   rel: _propTypes.default.string,
   type: _propTypes.default.any,
@@ -153,10 +146,23 @@ EuiFormControlButton.propTypes = {
     "data-text": _propTypes.default.string
   }).isRequired, _propTypes.default.oneOf([false])]),
   iconSize: _propTypes.default.any,
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
+  isDisabled: _propTypes.default.bool,
   className: _propTypes.default.string,
   "aria-label": _propTypes.default.string,
   "data-test-subj": _propTypes.default.string,
   css: _propTypes.default.any,
+  /**
+     * NOTE: Beta feature, may be changed or removed in the future
+     *
+     * Changes the native `disabled` attribute to `aria-disabled` to preserve focusability.
+     * This results in a semantically disabled button without the default browser handling of the disabled state.
+     *
+     * Use e.g. when a disabled button should have a tooltip.
+     */
+  hasAriaDisabled: _propTypes.default.bool,
   /**
        * Defines the button label when used like an input in combination with `placeholder`
        */

package/lib/components/header/header_links/header_link.js

@@ -39,13 +39,6 @@ var EuiHeaderLink = exports.EuiHeaderLink = function EuiHeaderLink(_ref) {
 EuiHeaderLink.propTypes = {
   href: _propTypes.default.string,
   onClick: _propTypes.default.func,
-  /**
-     * `disabled` is also allowed
-     */
-  /**
-     * `disabled` is also allowed
-     */
-  isDisabled: _propTypes.default.bool,
   target: _propTypes.default.string,
   rel: _propTypes.default.string,
   type: _propTypes.default.any,
@@ -84,10 +77,23 @@ EuiHeaderLink.propTypes = {
     "data-text": _propTypes.default.string
   }).isRequired, _propTypes.default.oneOf([false])]),
   iconSize: _propTypes.default.any,
+  /**
+     * Controls the disabled behavior via the native `disabled` attribute.
+     */
+  isDisabled: _propTypes.default.bool,
   className: _propTypes.default.string,
   "aria-label": _propTypes.default.string,
   "data-test-subj": _propTypes.default.string,
   css: _propTypes.default.any,
+  /**
+     * NOTE: Beta feature, may be changed or removed in the future
+     *
+     * Changes the native `disabled` attribute to `aria-disabled` to preserve focusability.
+     * This results in a semantically disabled button without the default browser handling of the disabled state.
+     *
+     * Use e.g. when a disabled button should have a tooltip.
+     */
+  hasAriaDisabled: _propTypes.default.bool,
   /**
      * Simple prop to update color based on active state.
      * Can be overridden with `color`