@elastic/eui 108.0.0 → 109.1.0-snapshot.1763390960850

package/test-env/test/enzyme/enzyme_matchers.js

@@ -0,0 +1,50 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setupEuiEnzymeMatchers = exports.hasEuiDisabledProp = exports.euiEnzymeMatchers = void 0;
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+/*
+ * 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 || (0, _typeof2.default)(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/test-env/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/test-env/test/rtl/index.js

@@ -12,8 +12,17 @@ var _exportNames = {
   findByTestSubject: true,
   render: true,
   screen: true,
-  within: true
+  within: true,
+  euiMatchers: true,
+  setupEuiMatchers: true,
+  isEuiDisabled: true
 };
+Object.defineProperty(exports, "euiMatchers", {
+  enumerable: true,
+  get: function get() {
+    return _matchers.euiMatchers;
+  }
+});
 Object.defineProperty(exports, "findAllByTestSubject", {
   enumerable: true,
   get: function get() {
@@ -38,6 +47,12 @@ Object.defineProperty(exports, "getByTestSubject", {
     return _data_test_subj_queries.getByTestSubject;
   }
 });
+Object.defineProperty(exports, "isEuiDisabled", {
+  enumerable: true,
+  get: function get() {
+    return _matchers.isEuiDisabled;
+  }
+});
 Object.defineProperty(exports, "queryAllByTestSubject", {
   enumerable: true,
   get: function get() {
@@ -62,6 +77,12 @@ Object.defineProperty(exports, "screen", {
     return _custom_render.screen;
   }
 });
+Object.defineProperty(exports, "setupEuiMatchers", {
+  enumerable: true,
+  get: function get() {
+    return _matchers.setupEuiMatchers;
+  }
+});
 Object.defineProperty(exports, "within", {
   enumerable: true,
   get: function get() {
@@ -93,4 +114,5 @@ Object.keys(_render_hook).forEach(function (key) {
       return _render_hook[key];
     }
   });
-});
+});
+var _matchers = require("./matchers");

package/test-env/test/rtl/matchers.js

@@ -0,0 +1,86 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setupEuiMatchers = exports.isEuiDisabled = exports.getEuiDisabledState = exports.euiMatchers = exports.default = void 0;
+var _utils = require("../../utils");
+/*
+ * 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 NATIVE_DISABLED_ATTR = 'disabled';
+var CUSTOM_DISABLED_ATTR = 'aria-disabled';
+var toBeEuiDisabled = function toBeEuiDisabled(element) {
+  var _getEuiDisabledState = getEuiDisabledState(element),
+    isDisabled = _getEuiDisabledState.isDisabled,
+    canBeDisabled = _getEuiDisabledState.canBeDisabled,
+    isNativelyDisabled = _getEuiDisabledState.isNativelyDisabled;
+  return {
+    message: function message() {
+      if (isDisabled) {
+        var method = isNativelyDisabled ? "`".concat(NATIVE_DISABLED_ATTR, "`") : "`".concat(CUSTOM_DISABLED_ATTR, "=\"true\"`");
+        if (!canBeDisabled) {
+          return "Element cannot be disabled (based on its role), but it was disabled via ".concat(method);
+        } else {
+          return "Expected element NOT to be disabled, but it was disabled via ".concat(method);
+        }
+      } else {
+        return "Expected element to be disabled via either `".concat(NATIVE_DISABLED_ATTR, "` or `").concat(CUSTOM_DISABLED_ATTR, "=\"true\"` attribute, but found neither");
+      }
+    },
+    pass: isDisabled
+  };
+};
+var toBeEuiEnabled = function toBeEuiEnabled(element) {
+  var _getEuiDisabledState2 = getEuiDisabledState(element),
+    isDisabled = _getEuiDisabledState2.isDisabled,
+    isNativelyDisabled = _getEuiDisabledState2.isNativelyDisabled,
+    isAriaDisabled = _getEuiDisabledState2.isAriaDisabled;
+  return {
+    message: function message() {
+      var attributes = [isNativelyDisabled ? "`".concat(NATIVE_DISABLED_ATTR, "`") : undefined, isAriaDisabled ? "`".concat(CUSTOM_DISABLED_ATTR, "=\"true\"`") : undefined].filter(function (item) {
+        return item !== undefined;
+      }).join(' and ');
+      return "Expected element NOT to have attributes: ".concat(attributes, ".");
+    },
+    pass: !isDisabled
+  };
+};
+var euiMatchers = exports.euiMatchers = {
+  toBeEuiDisabled: toBeEuiDisabled,
+  toBeEuiEnabled: toBeEuiEnabled
+};
+var setupEuiMatchers = exports.setupEuiMatchers = function setupEuiMatchers() {
+  expect.extend(euiMatchers);
+};
+var _default = exports.default = euiMatchers;
+/* Utilities */
+/**
+ * Retrieve an element's disabled state details.
+ * Checks wheather the element has an `disabled` attribute or `aria-disabled="true"` attribute
+ * @returns { isDisabled: boolean; canBeDisabled: boolean; isNativelyDisabled: boolean; isAriaDisabled: boolean }
+ */
+var getEuiDisabledState = exports.getEuiDisabledState = function getEuiDisabledState(element) {
+  var canBeDisabled = (0, _utils.elementCanBeDisabled)(element);
+  var isNativelyDisabled = element.hasAttribute('disabled');
+  var isAriaDisabled = element.getAttribute('aria-disabled') === 'true';
+  var isDisabled = canBeDisabled && (isNativelyDisabled || isAriaDisabled);
+  return {
+    isDisabled: isDisabled,
+    canBeDisabled: canBeDisabled,
+    isNativelyDisabled: isNativelyDisabled,
+    isAriaDisabled: isAriaDisabled
+  };
+};
+
+/**
+ * Checks if an element is disabled via `disabled` attribute or `aria-disabled="true"`.
+ */
+var isEuiDisabled = exports.isEuiDisabled = function isEuiDisabled(element) {
+  return getEuiDisabledState(element).isDisabled;
+};

package/test-env/utils/element_can_be_disabled.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.elementCanBeDisabled = 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.
+ */
+
+var SUPPORTED_ELEMENTS = ['fieldset', 'input', 'select', 'optgroup', 'option', 'button', 'textarea'];
+var elementCanBeDisabled = exports.elementCanBeDisabled = function elementCanBeDisabled(htmlElement) {
+  var _htmlElement$getAttri;
+  if (!htmlElement) return false;
+  var tagName = htmlElement.tagName && htmlElement.tagName.toLowerCase();
+  var roleName = (_htmlElement$getAttri = htmlElement.getAttribute('role')) !== null && _htmlElement$getAttri !== void 0 ? _htmlElement$getAttri : '';
+  return SUPPORTED_ELEMENTS.includes(roleName) || SUPPORTED_ELEMENTS.includes(tagName);
+};

package/test-env/utils/index.js

@@ -3,9 +3,19 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _exportNames = {
+  elementCanBeDisabled: true
+};
+Object.defineProperty(exports, "elementCanBeDisabled", {
+  enumerable: true,
+  get: function get() {
+    return _element_can_be_disabled.elementCanBeDisabled;
+  }
+});
 var _prop_types = require("./prop_types");
 Object.keys(_prop_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _prop_types[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -17,6 +27,7 @@ Object.keys(_prop_types).forEach(function (key) {
 var _is_jest = require("./is_jest");
 Object.keys(_is_jest).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _is_jest[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -28,6 +39,7 @@ Object.keys(_is_jest).forEach(function (key) {
 var _type_guards = require("./type_guards");
 Object.keys(_type_guards).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _type_guards[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
@@ -35,4 +47,5 @@ Object.keys(_type_guards).forEach(function (key) {
       return _type_guards[key];
     }
   });
-});
+});
+var _element_can_be_disabled = require("./element_can_be_disabled");