@elastic/eui 108.0.0 → 109.1.0-snapshot.1763390960850

package/lib/services/hooks/useEuiDisabledElement.js

@@ -0,0 +1,199 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useEuiDisabledElement = void 0;
+var _react = require("react");
+var _keys = require("../../services/keys");
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /*
+ * 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 DISABLED_ELEMENT_EVENTS = {
+  click: 'onClick',
+  mousedown: 'onMouseDown',
+  mouseup: 'onMouseUp',
+  mouseenter: 'onMouseEnter',
+  mouseleave: 'onMouseLeave',
+  mouseout: 'onMouseOut',
+  mousemove: 'onMouseMove',
+  mouseover: 'onMouseOver',
+  pointerdown: 'onPointerDown',
+  pointerup: 'onPointerUp',
+  pointerenter: 'onPointerEnter',
+  pointerleave: 'onPointerLeave',
+  pointermove: 'onPointerMove',
+  pointerover: 'onPointerOver',
+  touchstart: 'onTouchStart',
+  touchend: 'onTouchEnd',
+  touchmove: 'onTouchMove',
+  keydown: 'onKeyDown',
+  keyup: 'onKeyUp',
+  keypress: 'onKeyPress',
+  submit: 'onSubmit'
+};
+var ALLOWED_KEY_EVENTS = [_keys.keys.TAB, _keys.keys.ESCAPE];
+var getReactEventHandlers = function getReactEventHandlers() {
+  return Object.values(DISABLED_ELEMENT_EVENTS).reduce(function (acc, curr) {
+    acc[curr] = undefined;
+    return acc;
+  }, {});
+};
+var UNSET_REACT_EVENT_HANDLERS = getReactEventHandlers();
+var useCustomDisabledEvents = function useCustomDisabledEvents() {
+  var elementMethodsRef = (0, _react.useRef)(null);
+  var isAllowedKeyEvent = function isAllowedKeyEvent(event) {
+    return event instanceof KeyboardEvent && ALLOWED_KEY_EVENTS.includes(event.key);
+  };
+  var preventEvent = (0, _react.useCallback)(function (event) {
+    if (isAllowedKeyEvent(event)) {
+      return;
+    }
+    event.stopImmediatePropagation();
+    event.preventDefault();
+    event.stopPropagation();
+  }, []);
+  var preventElementEvents = (0, _react.useCallback)(function (element) {
+    if (elementMethodsRef.current) return;
+    var originalEvents = {
+      click: 'click' in element ? element.click : undefined,
+      dispatchEvent: element.dispatchEvent
+    };
+    try {
+      elementMethodsRef.current = originalEvents;
+
+      // Add prevention listeners
+      Object.keys(DISABLED_ELEMENT_EVENTS).forEach(function (eventType) {
+        element.addEventListener(eventType, preventEvent, {
+          capture: true
+        });
+      });
+      if ('click' in element && typeof element.click === 'function') {
+        element.click = function () {};
+      }
+      element.dispatchEvent = function (event) {
+        if (Object.keys(DISABLED_ELEMENT_EVENTS).includes(event.type)) {
+          if (isAllowedKeyEvent(event)) {
+            return originalEvents.dispatchEvent.call(element, event);
+          }
+          return false;
+        }
+        return originalEvents.dispatchEvent.call(element, event);
+      };
+    } catch (error) {
+      elementMethodsRef.current = null;
+    }
+  }, [preventEvent]);
+  var resetElementEvents = (0, _react.useCallback)(function (element) {
+    if (!elementMethodsRef.current) return;
+    var _elementMethodsRef$cu = elementMethodsRef.current,
+      click = _elementMethodsRef$cu.click,
+      dispatchEvent = _elementMethodsRef$cu.dispatchEvent;
+    try {
+      // remove prevention listeners
+      Object.keys(DISABLED_ELEMENT_EVENTS).forEach(function (eventType) {
+        element.removeEventListener(eventType, preventEvent, {
+          capture: true
+        });
+      });
+
+      // restore click method
+      if (click && 'click' in element) {
+        element.click = click;
+      }
+
+      // restore dispatchEvent
+      element.dispatchEvent = dispatchEvent;
+    } catch (error) {}
+    elementMethodsRef.current = null;
+  }, [preventEvent]);
+  return {
+    preventElementEvents: preventElementEvents,
+    resetElementEvents: resetElementEvents
+  };
+};
+
+/**
+ * NOTE: Beta feature, may be changed or removed in the future
+ *
+ * Utility to apply either the native or a custom semantic disabled state.
+ *
+ * It applies `aria-disabled` instead of `disabled`  when `hasAriaDisabled=true`
+ * to ensure the element is semantically disabled while still focusable.
+ *
+ * It mimics the native `disabled` behavior by removing any programmatic mouse, pointer, touch
+ * or keyboard event handler but it differs to the native `disabled` behavior in that it preserves
+ * the focus, blur and tabIndex behavior.
+ */
+var useEuiDisabledElement = exports.useEuiDisabledElement = function useEuiDisabledElement(_ref) {
+  var _ref$isDisabled = _ref.isDisabled,
+    isDisabled = _ref$isDisabled === void 0 ? false : _ref$isDisabled,
+    _ref$hasAriaDisabled = _ref.hasAriaDisabled,
+    hasAriaDisabled = _ref$hasAriaDisabled === void 0 ? false : _ref$hasAriaDisabled,
+    onKeyDown = _ref.onKeyDown,
+    onKeyUp = _ref.onKeyUp,
+    onKeyPress = _ref.onKeyPress;
+  var elementRef = (0, _react.useRef)(null);
+  var _useCustomDisabledEve = useCustomDisabledEvents(),
+    preventElementEvents = _useCustomDisabledEve.preventElementEvents,
+    resetElementEvents = _useCustomDisabledEve.resetElementEvents;
+  var shouldBeDisabled = hasAriaDisabled && isDisabled;
+  var setRef = (0, _react.useCallback)(function (node) {
+    if (elementRef.current) {
+      resetElementEvents(elementRef.current);
+    }
+    elementRef.current = node;
+    if (node && shouldBeDisabled) {
+      preventElementEvents(node);
+    }
+  }, [shouldBeDisabled, preventElementEvents, resetElementEvents]);
+  (0, _react.useEffect)(function () {
+    if (!elementRef.current) return;
+    if (shouldBeDisabled) {
+      preventElementEvents(elementRef.current);
+    } else {
+      resetElementEvents(elementRef.current);
+    }
+    return function () {
+      if (elementRef.current) {
+        resetElementEvents(elementRef.current);
+      }
+    };
+  }, [shouldBeDisabled, preventElementEvents, resetElementEvents]);
+  if (!hasAriaDisabled) {
+    return {
+      ref: setRef,
+      disabled: isDisabled
+    };
+  }
+  var onKeyboardEvent = function onKeyboardEvent(e, callback) {
+    if (ALLOWED_KEY_EVENTS.includes(e.key)) {
+      callback === null || callback === void 0 || callback(e);
+    }
+  };
+  var eventHandlers = shouldBeDisabled && _objectSpread(_objectSpread({}, UNSET_REACT_EVENT_HANDLERS), {}, {
+    onKeyDown: onKeyDown ? function (e) {
+      return onKeyboardEvent(e, onKeyDown);
+    } : undefined,
+    onKeyUp: onKeyUp ? function (e) {
+      return onKeyboardEvent(e, onKeyUp);
+    } : undefined,
+    onKeyPress: onKeyPress ? function (e) {
+      return onKeyboardEvent(e, onKeyPress);
+    } : undefined
+  });
+  return _objectSpread({
+    ref: setRef,
+    'aria-disabled': isDisabled ? true : undefined,
+    disabled: isDisabled ? undefined : false
+  }, eventHandlers);
+};

package/lib/services/index.js

@@ -63,6 +63,7 @@ var _exportNames = {
   wcagContrastMin: true,
   useColorPickerState: true,
   useColorStopsState: true,
+  focusTrapPubSub: true,
   dateFormatAliases: true,
   formatAuto: true,
   formatBoolean: true,
@@ -330,6 +331,12 @@ Object.defineProperty(exports, "findPopoverPosition", {
     return _popover.findPopoverPosition;
   }
 });
+Object.defineProperty(exports, "focusTrapPubSub", {
+  enumerable: true,
+  get: function get() {
+    return _focus_trap.focusTrapPubSub;
+  }
+});
 Object.defineProperty(exports, "formatAuto", {
   enumerable: true,
   get: function get() {
@@ -657,6 +664,7 @@ 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) {

package/lib/services/popover/reposition_on_scroll.js

@@ -0,0 +1,67 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getRepositionOnScroll = exports.createRepositionOnScroll = 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.
+ */
+
+/**
+ * Returns the value of the `repositionOnScroll` from the props, component's defaults context
+ * or default to `false`.
+ *
+ * @param args The arguments for `getRepositionOnScroll`. See {@link RepositionOnScrollArgs}.
+ * @returns The value of the `repositionOnScroll`.
+ */
+var getRepositionOnScroll = exports.getRepositionOnScroll = function getRepositionOnScroll(args) {
+  var repositionOnScroll = args.repositionOnScroll,
+    componentDefaults = args.componentDefaults;
+  if (repositionOnScroll !== undefined) return repositionOnScroll;
+  if (componentDefaults && 'repositionOnScroll' in componentDefaults && typeof componentDefaults.repositionOnScroll === 'boolean') {
+    var contextValue = componentDefaults.repositionOnScroll;
+    return contextValue !== null && contextValue !== void 0 ? contextValue : false;
+  }
+  return false;
+};
+/**
+ * Creates a manager for handling `repositionOnScroll` logic in overlay components.
+ * This utility abstracts the adding, updating, and removing of window scroll event listeners.
+ *
+ * @param getArgs A function that returns the arguments for `getRepositionOnScroll`. See {@link RepositionOnScrollArgs}.
+ * @returns An object with `subscribe`, `update`, and `cleanup` methods to manage the scroll listener.
+ */
+var createRepositionOnScroll = exports.createRepositionOnScroll = function createRepositionOnScroll(getArgs) {
+  var lastResolvedRepositionOnScroll;
+  var subscribe = function subscribe() {
+    var repositionOnScroll = getRepositionOnScroll(getArgs());
+    lastResolvedRepositionOnScroll = repositionOnScroll;
+    if (repositionOnScroll) {
+      window.addEventListener('scroll', getArgs().repositionFn, true);
+    }
+  };
+  var update = function update() {
+    var repositionOnScroll = getRepositionOnScroll(getArgs());
+    if (lastResolvedRepositionOnScroll !== repositionOnScroll) {
+      if (repositionOnScroll) {
+        window.addEventListener('scroll', getArgs().repositionFn, true);
+      } else {
+        window.removeEventListener('scroll', getArgs().repositionFn, true);
+      }
+      lastResolvedRepositionOnScroll = repositionOnScroll;
+    }
+  };
+  var cleanup = function cleanup() {
+    window.removeEventListener('scroll', getArgs().repositionFn, true);
+  };
+  return {
+    subscribe: subscribe,
+    update: update,
+    cleanup: cleanup
+  };
+};

package/lib/services/theme/high_contrast_overrides.js

@@ -39,19 +39,23 @@ var useHighContrastModifications = exports.useHighContrastModifications = functi
       borderBasePrimary: systemTheme.colors.textPrimary,
       borderBaseAccent: systemTheme.colors.textAccent,
       borderBaseAccentSecondary: systemTheme.colors.textAccentSecondary,
+      borderBaseNeutral: systemTheme.colors.textNeutral,
       borderBaseSuccess: systemTheme.colors.textSuccess,
       borderBaseWarning: systemTheme.colors.textWarning,
+      borderBaseRisk: systemTheme.colors.textRisk,
       borderBaseDanger: systemTheme.colors.textDanger,
       borderBasePlain: borderColor,
       borderBaseSubdued: borderColor,
+      borderBaseProminent: borderColor,
       borderBaseDisabled: systemTheme.colors.textDisabled,
       borderBaseFloating: borderColor,
-      borderBaseFormsControl: borderColor,
       borderStrongPrimary: systemTheme.colors.textPrimary,
       borderStrongAccent: systemTheme.colors.textAccent,
       borderStrongAccentSecondary: systemTheme.colors.textAccentSecondary,
+      borderStrongNeutral: systemTheme.colors.textNeutral,
       borderStrongSuccess: systemTheme.colors.textSuccess,
       borderStrongWarning: systemTheme.colors.textWarning,
+      borderStrongRisk: systemTheme.colors.textRisk,
       borderStrongDanger: systemTheme.colors.textDanger
     };
     return {

package/lib/test/cypress/index.d.ts

@@ -0,0 +1,12 @@
+/*
+ * 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.
+ */
+
+export {
+  registerEuiCypressMatchers,
+  setupEuiCypressMatchers,
+} from './matchers';

package/lib/test/cypress/index.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "registerEuiCypressMatchers", {
+  enumerable: true,
+  get: function get() {
+    return _matchers.registerEuiCypressMatchers;
+  }
+});
+Object.defineProperty(exports, "setupEuiCypressMatchers", {
+  enumerable: true,
+  get: function get() {
+    return _matchers.setupEuiCypressMatchers;
+  }
+});
+var _matchers = require("./matchers");

package/lib/test/cypress/matchers.d.ts

@@ -0,0 +1,20 @@
+/*
+ * 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", the "GNU Affero General Public License v3.0 only", 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", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+declare global {
+  namespace Chai {
+    interface Assertion {
+      euiDisabled: Assertion;
+      euiEnabled: Assertion;
+    }
+  }
+}
+
+export declare const registerEuiCypressMatchers: () => void;
+export declare const setupEuiCypressMatchers: () => void;

package/lib/test/cypress/matchers.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.registerEuiCypressMatchers = registerEuiCypressMatchers;
+exports.setupEuiCypressMatchers = 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.
+ */
+
+/// <reference types="cypress" />
+
+function registerEuiCypressMatchers() {
+  var chai = window.chai;
+  if (chai && !chai.__euiMatchersRegistered) {
+    chai.use(function (_chai) {
+      _chai.Assertion.addProperty('euiDisabled', function () {
+        var element = this._obj[0] || this._obj;
+        var hasDisabledAttribute = element.hasAttribute('disabled');
+        var hasAriaDisabled = element.getAttribute('aria-disabled') === 'true';
+        var isDisabled = hasDisabledAttribute || hasAriaDisabled;
+        this.assert(isDisabled, 'expected element to be EUI disabled (= have `disabled` attribute or `aria-disabled="true"`)', 'expected element not to be EUI disabled (= not have `disabled` attribute or `aria-disabled="true"`)', true, isDisabled);
+      });
+      _chai.Assertion.addProperty('euiEnabled', function () {
+        var element = this._obj[0] || this._obj;
+        var hasDisabledAttribute = element.hasAttribute('disabled');
+        var hasAriaDisabled = element.getAttribute('aria-disabled') === 'true';
+        var isDisabled = hasDisabledAttribute || hasAriaDisabled;
+        this.assert(!isDisabled, 'expected element to be EUI enabled (= not have `disabled` attribute or `aria-disabled="true"`)', 'expected element not to be EUI enabled (= have `disabled` attribute or `aria-disabled="true"`)', false, isDisabled);
+      });
+    });
+
+    // Mark as registered to prevent double registration
+    chai.__euiMatchersRegistered = true;
+  }
+}
+
+// Register matchers when support file loads
+var setupEuiCypressMatchers = exports.setupEuiCypressMatchers = function setupEuiCypressMatchers() {
+  if (typeof window !== 'undefined') {
+    // Try to register immediately
+    if (window.chai) {
+      registerEuiCypressMatchers();
+    } else {
+      // Wait for chai to be available
+      var pollForChai = function pollForChai() {
+        if (window.chai) {
+          registerEuiCypressMatchers();
+        } else {
+          setTimeout(pollForChai, 10);
+        }
+      };
+      pollForChai();
+    }
+  }
+};

package/lib/test/cypress/test_reposition_on_scroll.js

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.testRepositionOnScroll = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _react2 = require("@emotion/react");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /*
+ * 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.
+ */ /// <reference types="cypress" />
+/// <reference types="cypress-real-events" />
+/// <reference types="../../../cypress/support" />
+var testRepositionOnScroll = exports.testRepositionOnScroll = function testRepositionOnScroll(_ref) {
+  var shouldReposition = _ref.shouldReposition,
+    propValue = _ref.propValue,
+    componentDefaultValue = _ref.componentDefaultValue,
+    componentName = _ref.componentName,
+    triggerSelector = _ref.triggerSelector,
+    panelSelector = _ref.panelSelector,
+    renderComponent = _ref.renderComponent;
+  var repositionProps = {
+    repositionOnScroll: typeof propValue === 'boolean' ? propValue : undefined
+  };
+  var providerProps = typeof componentDefaultValue === 'boolean' ? {
+    providerProps: {
+      componentDefaults: _defineProperty({}, componentName, {
+        repositionOnScroll: componentDefaultValue
+      })
+    }
+  } : undefined;
+  cy.mount((0, _react2.jsx)(_react.default.Fragment, null, (0, _react2.jsx)("div", {
+    style: {
+      height: '200vh'
+    }
+  }), (0, _react2.jsx)("div", {
+    style: {
+      position: 'fixed',
+      bottom: '16px',
+      right: '16px'
+    }
+  }, renderComponent(repositionProps))), providerProps);
+  cy.get(triggerSelector).click();
+
+  // Wait for positioning to finish
+  cy.get(panelSelector).as('panel').should('exist').waitForPositionToSettle();
+  cy.get('@panel').then(function ($panel) {
+    var initialRect = $panel[0].getBoundingClientRect();
+    cy.scrollTo(0, 500);
+
+    // Wait for re-positioning to finish
+    cy.get('@panel').waitForPositionToSettle().then(function ($repositionedPanel) {
+      var finalRect = $repositionedPanel[0].getBoundingClientRect();
+      if (shouldReposition) {
+        expect(finalRect.top).to.equal(initialRect.top);
+      } else {
+        expect(finalRect.top).to.not.equal(initialRect.top);
+      }
+    });
+  });
+};

package/lib/test/enzyme/enzyme_matchers.d.ts

@@ -0,0 +1,36 @@
+/*
+ * 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", the "GNU Affero General Public License v3.0 only", 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", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+import { ReactWrapper } from 'enzyme';
+
+declare global {
+  namespace jest {
+    interface Matchers<R> {
+      /**
+       * Checks if an Enzyme wrapper has EUI disabled state (it checks `disabled`, `isDisabled` and `aria-disabled` props)
+       */
+      toHaveEuiDisabledProp(): R;
+    }
+  }
+}
+
+export declare const toHaveEuiDisabledProp: (wrapper: ReactWrapper<any>) => {
+  message: () => string;
+  pass: boolean;
+};
+
+export declare const hasEuiDisabledProp: (
+  props: Record<string, any>
+) => boolean;
+
+export declare const euiEnzymeMatchers: {
+  toHaveEuiDisabledProp: typeof toHaveEuiDisabledProp;
+};
+
+export declare const setupEuiEnzymeMatchers: () => void;

package/lib/test/enzyme/enzyme_matchers.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setupEuiEnzymeMatchers = exports.hasEuiDisabledProp = exports.euiEnzymeMatchers = void 0;
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+/*
+ * 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", the "GNU Affero General Public License v3.0 only", 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", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+/* eslint-env jest */
+
+var euiEnzymeMatchers = exports.euiEnzymeMatchers = {
+  /**
+   * Checks if an Enzyme wrapper has an EUI disabled state.
+   * It looks for `disabled`, `isDisabled` and `aria-disabled` props
+   */
+  toHaveEuiDisabledProp: function toHaveEuiDisabledProp(props) {
+    if (!props || _typeof(props) !== 'object') {
+      throw new Error('toHaveEuiDisabledProp() must be called with the props value from ReactWrapper.props()');
+    }
+    var isDisabled = hasEuiDisabledProp(props);
+    return {
+      message: function message() {
+        return isDisabled ? 'Expected component NOT to have EUI disabled prop, but it was disabled' : 'Expected component to have EUI disabled prop (`disabled`, `isDisabled` or `aria-disabled="true"`)';
+      },
+      pass: isDisabled
+    };
+  }
+};
+var setupEuiEnzymeMatchers = exports.setupEuiEnzymeMatchers = function setupEuiEnzymeMatchers() {
+  expect.extend(euiEnzymeMatchers);
+};
+
+/* Utilities */
+
+/**
+ * Checks if a ReactWrapper has one of the following disabled props enabled:
+ * `disabled`, `isDisabled` or attribute or `aria-disabled="true"`.
+ */
+var hasEuiDisabledProp = exports.hasEuiDisabledProp = function hasEuiDisabledProp(props) {
+  return props.disabled === true || props.isDisabled === true || props['aria-disabled'] === true || props['aria-disabled'] === 'true';
+};

package/lib/test/enzyme/index.d.ts

@@ -0,0 +1,14 @@
+/*
+ * 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", the "GNU Affero General Public License v3.0 only", 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", the "GNU Affero General Public
+ * License v3.0 only", or the "Server Side Public License, v 1".
+ */
+
+export {
+  euiEnzymeMatchers,
+  setupEuiEnzymeMatchers,
+  hasEuiDisabledProp,
+} from './enzyme_matchers';

package/lib/test/enzyme/index.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "euiEnzymeMatchers", {
+  enumerable: true,
+  get: function get() {
+    return _enzyme_matchers.euiEnzymeMatchers;
+  }
+});
+Object.defineProperty(exports, "hasEuiDisabledProp", {
+  enumerable: true,
+  get: function get() {
+    return _enzyme_matchers.hasEuiDisabledProp;
+  }
+});
+Object.defineProperty(exports, "setupEuiEnzymeMatchers", {
+  enumerable: true,
+  get: function get() {
+    return _enzyme_matchers.setupEuiEnzymeMatchers;
+  }
+});
+var _enzyme_matchers = require("./enzyme_matchers");

package/lib/test/rtl/index.d.ts

@@ -1,3 +1,11 @@
 export * from './component_helpers';
-export { queryByTestSubject, queryAllByTestSubject, getByTestSubject, getAllByTestSubject, findAllByTestSubject, findByTestSubject, } from './data_test_subj_queries';
+export {
+  queryByTestSubject,
+  queryAllByTestSubject,
+  getByTestSubject,
+  getAllByTestSubject,
+  findAllByTestSubject,
+  findByTestSubject,
+} from './data_test_subj_queries';
 export { render, screen, within } from './custom_render';
+export { euiMatchers, setupEuiMatchers, isEuiDisabled } from './matchers';