@elastic/eui 109.0.0 → 109.1.0

package/es/services/hooks/useEuiDisabledElement.js

@@ -0,0 +1,195 @@
+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.
+ */
+
+import { useCallback, useEffect, useRef } from 'react';
+import { keys } from '../../services/keys';
+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.TAB, 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 = useRef(null);
+  var isAllowedKeyEvent = function isAllowedKeyEvent(event) {
+    return event instanceof KeyboardEvent && ALLOWED_KEY_EVENTS.includes(event.key);
+  };
+  var preventEvent = useCallback(function (event) {
+    if (isAllowedKeyEvent(event)) {
+      return;
+    }
+    event.stopImmediatePropagation();
+    event.preventDefault();
+    event.stopPropagation();
+  }, []);
+  var preventElementEvents = 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 = 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.
+ */
+export var 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 = useRef(null);
+  var _useCustomDisabledEve = useCustomDisabledEvents(),
+    preventElementEvents = _useCustomDisabledEve.preventElementEvents,
+    resetElementEvents = _useCustomDisabledEve.resetElementEvents;
+  var shouldBeDisabled = hasAriaDisabled && isDisabled;
+  var setRef = useCallback(function (node) {
+    if (elementRef.current) {
+      resetElementEvents(elementRef.current);
+    }
+    elementRef.current = node;
+    if (node && shouldBeDisabled) {
+      preventElementEvents(node);
+    }
+  }, [shouldBeDisabled, preventElementEvents, resetElementEvents]);
+  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/es/services/index.js

@@ -19,6 +19,7 @@ export * from './console';
 export * from './copy';
 export * from './emotion';
 export * from './findElement';
+export { focusTrapPubSub } from './focus_trap';
 export { dateFormatAliases, formatAuto, formatBoolean, formatDate, formatNumber, formatText } from './format';
 export * from './hooks';
 export { isEvenlyDivisibleBy, isWithinRange } from './number';

package/es/services/popover/reposition_on_scroll.js

@@ -0,0 +1,61 @@
+/*
+ * 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`.
+ */
+export var 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.
+ */
+export var 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/es/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/es/test/cypress/index.js

@@ -0,0 +1,9 @@
+/*
+ * 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/es/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/es/test/cypress/matchers.js

@@ -0,0 +1,54 @@
+/*
+ * 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" />
+
+export 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
+export var 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/es/test/cypress/test_reposition_on_scroll.js

@@ -0,0 +1,66 @@
+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" />
+
+import React from 'react';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export var 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(___EmotionJSX(React.Fragment, null, ___EmotionJSX("div", {
+    style: {
+      height: '200vh'
+    }
+  }), ___EmotionJSX("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/es/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/es/test/enzyme/enzyme_matchers.js

@@ -0,0 +1,43 @@
+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 */
+
+export var 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
+    };
+  }
+};
+export var 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"`.
+ */
+export var hasEuiDisabledProp = function hasEuiDisabledProp(props) {
+  return props.disabled === true || props.isDisabled === true || props['aria-disabled'] === true || props['aria-disabled'] === 'true';
+};

package/es/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/es/test/enzyme/index.js

@@ -0,0 +1,10 @@
+/*
+ * 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/es/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';

package/es/test/rtl/index.js

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

package/es/test/rtl/matchers.d.ts

@@ -0,0 +1,36 @@
+declare global {
+  /* eslint-disable-next-line @typescript-eslint/no-namespace,no-redeclare */
+  namespace jest {
+    interface Matchers<R> {
+      /**
+       * Custom matcher to check the disabled state of a DOM element.
+       * Ensures that both `disabled` and `aria-disabled` attributes are checked.
+       */
+      toBeEuiDisabled(): R;
+      /**
+       * Custom matcher to check a DOM element is enabled (= not disabled).
+       * Ensures that both `disabled` and `aria-disabled` attributes are checked.
+       */
+      toBeEuiEnabled(): R;
+    }
+  }
+}
+
+export declare const toBeEuiDisabled: (element: HTMLElement) => {
+  message: () => string;
+  pass: boolean;
+};
+
+export declare const toBeEuiEnabled: (element: HTMLElement) => {
+  message: () => string;
+  pass: boolean;
+};
+
+export declare const isEuiDisabled: (element: HTMLElement) => boolean;
+
+export declare const euiMatchers: {
+  toBeEuiDisabled: typeof toBeEuiDisabled;
+  toBeEuiEnabled: typeof toBeEuiEnabled;
+};
+
+export declare const setupEuiMatchers: () => void;