@elastic/eslint-plugin-eui 2.0.0 → 2.2.0

package/README.md

@@ -125,9 +125,24 @@ function MyComponent() {
     )
 }
 ```
-
 It's worth pointing out that although the examples provided are specific to EUI components, this rule applies to all JSX elements.
 
+### `@elastic/eui/require-aria-label-for-modals`
+
+Ensures that EUI modal components (`EuiModal`, `EuiFlyout`, `EuiConfirmModal`) have either an `aria-label` or `aria-labelledby` prop for accessibility. This helps screen reader users understand the purpose and content of modal dialogs.
+
+### `@elastic/eui/consistent-is-invalid-props`
+
+Ensures that form control components within `EuiFormRow` components have matching `isInvalid` prop values. This maintains consistent validation state between parent form rows and their child form controls, leading to a more predictable and accessible user experience.
+
+### `@elastic/eui/sr-output-disabled-tooltip`
+
+Ensures `disableScreenReaderOutput` is set when `EuiToolTip` content matches `EuiButtonIcon` "aria-label".
+
+### `@elastic/eui/prefer-eui-icon-tip`
+
+Ensure `EuiIconTip` is used rather than `<EuiToolTip><EuiIcon/></EuiToolTip>`, as it provides better accessibility and improved support for assistive technologies.
+
 ## Testing
 
 ### Running unit tests

package/lib/cjs/index.js

@@ -3,6 +3,10 @@
 var _href_or_on_click = require("./rules/href_or_on_click");
 var _no_restricted_eui_imports = require("./rules/no_restricted_eui_imports");
 var _no_css_color = require("./rules/no_css_color");
+var _require_aria_label_for_modals = require("./rules/a11y/require_aria_label_for_modals");
+var _consistent_is_invalid_props = require("./rules/a11y/consistent_is_invalid_props");
+var _sr_output_disabled_tooltip = require("./rules/a11y/sr_output_disabled_tooltip");
+var _prefer_eui_icon_tip = require("./rules/a11y/prefer_eui_icon_tip");
 /*
  * Licensed to Elasticsearch B.V. under one or more contributor
  * license agreements. See the NOTICE file distributed with
@@ -26,7 +30,11 @@ const config = {
   rules: {
     'href-or-on-click': _href_or_on_click.HrefOnClick,
     'no-restricted-eui-imports': _no_restricted_eui_imports.NoRestrictedEuiImports,
-    'no-css-color': _no_css_color.NoCssColor
+    'no-css-color': _no_css_color.NoCssColor,
+    'require-aria-label-for-modals': _require_aria_label_for_modals.RequireAriaLabelForModals,
+    'consistent-is-invalid-props': _consistent_is_invalid_props.ConsistentIsInvalidProps,
+    'sr-output-disabled-tooltip': _sr_output_disabled_tooltip.ScreenReaderOutputDisabledTooltip,
+    'prefer-eui-icon-tip': _prefer_eui_icon_tip.PreferEuiIconTip
   },
   configs: {
     recommended: {
@@ -34,7 +42,12 @@ const config = {
       rules: {
         '@elastic/eui/href-or-on-click': 'warn',
         '@elastic/eui/no-restricted-eui-imports': 'warn',
-        '@elastic/eui/no-css-color': 'warn'
+        '@elastic/eui/no-css-color': 'warn',
+        '@elastic/eui/require-aria-label-for-modals': 'warn',
+        '@elastic/eui/consistent-is-invalid-props': 'warn',
+        '@elastic/eui/sr-output-disabled-tooltip': 'warn',
+        '@elastic/eui/no-css_color': 'warn',
+        '@elastic/eui/prefer-eui-icon-tip': 'warn'
       }
     }
   }

package/lib/cjs/rules/a11y/consistent_is_invalid_props.d.ts

@@ -0,0 +1,3 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const ConsistentIsInvalidProps: ESLintUtils.RuleModule<"inconsistentIsInvalid", [], unknown, ESLintUtils.RuleListener>;
+//# sourceMappingURL=consistent_is_invalid_props.d.ts.map

package/lib/cjs/rules/a11y/consistent_is_invalid_props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistent_is_invalid_props.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/consistent_is_invalid_props.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAetE,eAAO,MAAM,wBAAwB,wFA6FnC,CAAC"}

package/lib/cjs/rules/a11y/consistent_is_invalid_props.js

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ConsistentIsInvalidProps = void 0;
+var _utils = require("@typescript-eslint/utils");
+var _get_attr_value = require("../../utils/get_attr_value");
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+const formControlComponent = 'EuiFormRow';
+const formControlChildComponents = ['EuiFieldNumber', 'EuiFilePicker', 'EuiFieldText', 'EuiComboBox', 'EuiTextArea', 'EuiFormControlLayoutDelimited', 'SingleFieldSelect', 'EuiSelect'];
+const ConsistentIsInvalidProps = exports.ConsistentIsInvalidProps = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    return {
+      JSXElement(node) {
+        const openingElement = node.openingElement;
+        if (openingElement?.name.type !== 'JSXIdentifier' || openingElement.name.name !== formControlComponent || openingElement.attributes.length === 0) {
+          return;
+        }
+        const formRowIsInvalid = (0, _get_attr_value.getAttrValue)(context, openingElement.attributes, 'isInvalid');
+        if (formRowIsInvalid === undefined) {
+          return;
+        }
+        const childElement = node.children.find(child => child.type === 'JSXElement' && child.openingElement?.name.type === 'JSXIdentifier' && formControlChildComponents.includes(child.openingElement.name.name));
+        if (!childElement) {
+          return;
+        }
+        const childIsInvalid = (0, _get_attr_value.getAttrValue)(context, childElement.openingElement.attributes, 'isInvalid');
+        if (childIsInvalid !== formRowIsInvalid) {
+          const componentName = childElement.openingElement.name.name;
+          context.report({
+            node: childElement,
+            messageId: 'inconsistentIsInvalid',
+            fix: fixer => {
+              const childIsInvalidAttr = childElement.openingElement.attributes.find(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && attr.name.name === 'isInvalid');
+              if (childIsInvalidAttr) {
+                return fixer.replaceText(childIsInvalidAttr, `isInvalid={${formRowIsInvalid}}`);
+              }
+              const insertPosition = childElement.openingElement.name.range[1];
+              return fixer.insertTextAfterRange([insertPosition, insertPosition], ` isInvalid={${formRowIsInvalid}}`);
+            },
+            data: {
+              formControlComponent: formControlComponent,
+              component: componentName
+            }
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    type: 'problem',
+    docs: {
+      description: `Ensure {{component}} inherit "isInvalid" prop from parent {{formControlComponent}}`
+    },
+    fixable: 'code',
+    schema: [],
+    messages: {
+      inconsistentIsInvalid: `{{component}} should have the same "isInvalid" prop value as its parent {{formControlComponent}}.`
+    }
+  },
+  defaultOptions: []
+});

package/lib/cjs/rules/a11y/prefer_eui_icon_tip.d.ts

@@ -0,0 +1,3 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const PreferEuiIconTip: ESLintUtils.RuleModule<"preferEuiIconTip", [], unknown, ESLintUtils.RuleListener>;
+//# sourceMappingURL=prefer_eui_icon_tip.d.ts.map

package/lib/cjs/rules/a11y/prefer_eui_icon_tip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer_eui_icon_tip.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/prefer_eui_icon_tip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAMtE,eAAO,MAAM,gBAAgB,mFA0C3B,CAAC"}

package/lib/cjs/rules/a11y/prefer_eui_icon_tip.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PreferEuiIconTip = void 0;
+var _utils = require("@typescript-eslint/utils");
+const TOOLTIP_COMPONENT = 'EuiToolTip';
+const ICON_COMPONENT = 'EuiIcon';
+const ICON_TIP_COMPONENT = 'EuiIconTip';
+const PreferEuiIconTip = exports.PreferEuiIconTip = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    return {
+      JSXElement(node) {
+        const openingElement = node.openingElement;
+        if (openingElement.name.type !== 'JSXIdentifier' || openingElement.name.name !== TOOLTIP_COMPONENT) {
+          return;
+        }
+
+        // Find first JSX child
+        const firstChild = node.children.find(child => child.type === 'JSXElement');
+        if (firstChild && firstChild.openingElement.name.type === 'JSXIdentifier' && firstChild.openingElement.name.name === ICON_COMPONENT) {
+          context.report({
+            node: firstChild,
+            messageId: 'preferEuiIconTip'
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: `Prefer using ${ICON_TIP_COMPONENT} over <${TOOLTIP_COMPONENT}><${ICON_COMPONENT}/></${TOOLTIP_COMPONENT}>, as it delivers better accessibility and improved support for assistive technologies.`
+    },
+    schema: [],
+    messages: {
+      preferEuiIconTip: `Ensure ${ICON_TIP_COMPONENT} is used rather than <${TOOLTIP_COMPONENT}><${ICON_COMPONENT}/></${TOOLTIP_COMPONENT}>, as it delivers better accessibility and improved support for assistive technologies.`
+    }
+  },
+  defaultOptions: []
+});

package/lib/cjs/rules/a11y/require_aria_label_for_modals.d.ts

@@ -0,0 +1,3 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const RequireAriaLabelForModals: ESLintUtils.RuleModule<"modalAriaMissing" | "confirmModalAriaMissing", [], unknown, ESLintUtils.RuleListener>;
+//# sourceMappingURL=require_aria_label_for_modals.d.ts.map

package/lib/cjs/rules/a11y/require_aria_label_for_modals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require_aria_label_for_modals.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/require_aria_label_for_modals.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAY,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKjE,eAAO,MAAM,yBAAyB,+GA0FpC,CAAC"}

package/lib/cjs/rules/a11y/require_aria_label_for_modals.js

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RequireAriaLabelForModals = void 0;
+var _utils = require("@typescript-eslint/utils");
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+const modalComponents = ['EuiModal', 'EuiFlyout'];
+const confirmModalComponents = ['EuiConfirmModal'];
+const RequireAriaLabelForModals = exports.RequireAriaLabelForModals = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    function checkAttributes(node, componentName, messageId) {
+      const hasAriaLabel = node.attributes.some(attr => attr.type === 'JSXAttribute' && typeof attr.name.name === 'string' && ['aria-label', 'aria-labelledby'].includes(attr.name.name));
+      if (!hasAriaLabel) {
+        context.report({
+          node,
+          messageId: messageId,
+          data: {
+            component: componentName
+          }
+        });
+      }
+    }
+    return {
+      JSXOpeningElement(node) {
+        if (node.name.type === 'JSXIdentifier') {
+          if (modalComponents.includes(node.name.name)) {
+            checkAttributes(node, node.name.name, 'modalAriaMissing');
+          }
+          if (confirmModalComponents.includes(node.name.name)) {
+            checkAttributes(node, node.name.name, 'confirmModalAriaMissing');
+          }
+        }
+        return;
+      }
+    };
+  },
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Ensure modals have \'aria-label\' or \'aria-labelledby\''
+    },
+    schema: [],
+    messages: {
+      modalAriaMissing: ['{{ component }} must have either \'aria-label\' or \'aria-labelledby\' prop for accessibility.', '\n', 'Option 1: Using \'aria-labelledby\' (preferred):', '1. Import \'useGeneratedHtmlId\':', '   import { useGeneratedHtmlId } from \'@elastic/eui\';', '2. Update your component:', '   const modalTitleId = useGeneratedHtmlId();', '   ...', '   <{{ component }}', '    aria-labelledby={modalTitleId}', '    {...props} ', '   />', '     <{{ component }}Header>', '       <EuiTitle id={modalTitleId}>', '         {\'Descriptive title for the {{ component }}\'}', '       </EuiTitle>', '     </{ component }}Header>', '     ...', '   </{{ component }}>', '\n', 'Option 2: Using \'aria-label\':', '   <{{ component }} aria-label="Descriptive title for the {{ component }}" {...props} />'].join('\n'),
+      confirmModalAriaMissing: ['{{ component }} must have either \'aria-label\' or \'aria-labelledby\' prop for accessibility.', '\n', 'Option 1: Using \'aria-labelledby\' (preferred):', '1. Import \'useGeneratedHtmlId\':', '   import { useGeneratedHtmlId } from \'@elastic/eui\';', '2. Update your component:', '   const modalTitleId = useGeneratedHtmlId();', '   ...', '   <{{ component }}', '     title="Descriptive title for the {{ component }}"', '     aria-labelledby={modalTitleId}', '     titleProps={({id: modalTitleId })}', '     {...props} ', '   />', '\n', 'Option 2: Using \'aria-label\':', '   <{{ component }} aria-label="Descriptive title for the {{ component }}" {...props} />'].join('\n')
+    }
+  },
+  defaultOptions: []
+});

package/lib/cjs/rules/a11y/sr_output_disabled_tooltip.d.ts

@@ -0,0 +1,3 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const ScreenReaderOutputDisabledTooltip: ESLintUtils.RuleModule<"requireDisableScreenReader", [], unknown, ESLintUtils.RuleListener>;
+//# sourceMappingURL=sr_output_disabled_tooltip.d.ts.map

package/lib/cjs/rules/a11y/sr_output_disabled_tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sr_output_disabled_tooltip.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/sr_output_disabled_tooltip.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAStE,eAAO,MAAM,iCAAiC,6FA6F1C,CAAC"}

package/lib/cjs/rules/a11y/sr_output_disabled_tooltip.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ScreenReaderOutputDisabledTooltip = void 0;
+var _utils = require("@typescript-eslint/utils");
+var _get_attr_value = require("../../utils/get_attr_value");
+/*
+ * 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.
+ */
+
+const tooltipComponent = 'EuiToolTip';
+const disabledTooltipComponentProp = 'disableScreenReaderOutput';
+const buttonComponents = ['EuiButtonIcon'];
+const normalizeAttrString = str => str?.trim().replace(/\s+/g, ' ');
+const ScreenReaderOutputDisabledTooltip = exports.ScreenReaderOutputDisabledTooltip = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    return {
+      JSXElement(node) {
+        const openingElement = node.openingElement;
+        if (openingElement?.name.type !== 'JSXIdentifier' || openingElement.name.name !== tooltipComponent) {
+          return;
+        }
+        const tooltipContent = (0, _get_attr_value.getAttrValue)(context, openingElement.attributes, 'content');
+        const hasDisableScreenReader = openingElement.attributes.some(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && attr.name.name === disabledTooltipComponentProp);
+        if (hasDisableScreenReader) {
+          return;
+        }
+        const buttonElement = node.children.find(child => child.type === 'JSXElement' && child.openingElement?.name.type === 'JSXIdentifier' && buttonComponents.includes(child.openingElement.name.name));
+        if (!buttonElement) {
+          return;
+        }
+        const ariaLabel = (0, _get_attr_value.getAttrValue)(context, buttonElement.openingElement.attributes, 'aria-label');
+        if (tooltipContent && ariaLabel && normalizeAttrString(tooltipContent) === normalizeAttrString(ariaLabel)) {
+          const buttonElementName = buttonElement.openingElement.name.name;
+          context.report({
+            node: openingElement,
+            messageId: 'requireDisableScreenReader',
+            fix: fixer => {
+              const lastAttr = openingElement.attributes[openingElement.attributes.length - 1];
+              const insertPosition = lastAttr ? lastAttr.range[1] : openingElement.name.range[1];
+              return fixer.insertTextAfterRange([insertPosition, insertPosition], ` ${disabledTooltipComponentProp}`);
+            },
+            data: {
+              tooltipComponent,
+              disabledTooltipComponentProp,
+              buttonElementName
+            }
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Ensure "{{disabledTooltipComponentProp}}" attribute is set when {{tooltipComponent}} content matches {{buttonElementName}} "aria-label"'
+    },
+    fixable: 'code',
+    schema: [],
+    messages: {
+      requireDisableScreenReader: '{{tooltipComponent}} should include "{{disabledTooltipComponentProp}}" attribute when its content matches the "aria-label" of {{buttonElementName}} to avoid redundant announcements.'
+    }
+  },
+  defaultOptions: []
+});

package/lib/cjs/utils/get_attr_value.d.ts

@@ -0,0 +1,3 @@
+import { type TSESTree, type TSESLint } from '@typescript-eslint/utils';
+export declare function getAttrValue<TContext extends TSESLint.RuleContext<string, unknown[]>>(context: TContext, attributes: TSESTree.JSXOpeningElement['attributes'], attrName: string): string | undefined;
+//# sourceMappingURL=get_attr_value.d.ts.map

package/lib/cjs/utils/get_attr_value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_attr_value.d.ts","sourceRoot":"","sources":["../../../src/utils/get_attr_value.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAEvE,wBAAgB,YAAY,CAC1B,QAAQ,SAAS,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAExD,OAAO,EAAE,QAAQ,EACjB,UAAU,EAAE,QAAQ,CAAC,iBAAiB,CAAC,YAAY,CAAC,EACpD,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CA2BpB"}

package/lib/cjs/utils/get_attr_value.js

@@ -0,0 +1,42 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAttrValue = getAttrValue;
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+function getAttrValue(context, attributes, attrName) {
+  const attr = attributes.find(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && attr.name.name === attrName);
+  if (!attr?.value) {
+    return undefined;
+  }
+  if (attr.value.type === 'Literal') {
+    return String(attr.value.value);
+  }
+  if (attr.value.type === 'JSXExpressionContainer') {
+    const expression = attr.value.expression;
+    if (expression.type === 'Literal') {
+      return String(expression.value);
+    }
+    return context.sourceCode.getText(expression);
+  }
+  return undefined;
+}

package/lib/esm/index.js

@@ -21,11 +21,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const href_or_on_click_1 = require("./rules/href_or_on_click");
 const no_restricted_eui_imports_1 = require("./rules/no_restricted_eui_imports");
 const no_css_color_1 = require("./rules/no_css_color");
+const require_aria_label_for_modals_1 = require("./rules/a11y/require_aria_label_for_modals");
+const consistent_is_invalid_props_1 = require("./rules/a11y/consistent_is_invalid_props");
+const sr_output_disabled_tooltip_1 = require("./rules/a11y/sr_output_disabled_tooltip");
+const prefer_eui_icon_tip_1 = require("./rules/a11y/prefer_eui_icon_tip");
 const config = {
     rules: {
         'href-or-on-click': href_or_on_click_1.HrefOnClick,
         'no-restricted-eui-imports': no_restricted_eui_imports_1.NoRestrictedEuiImports,
         'no-css-color': no_css_color_1.NoCssColor,
+        'require-aria-label-for-modals': require_aria_label_for_modals_1.RequireAriaLabelForModals,
+        'consistent-is-invalid-props': consistent_is_invalid_props_1.ConsistentIsInvalidProps,
+        'sr-output-disabled-tooltip': sr_output_disabled_tooltip_1.ScreenReaderOutputDisabledTooltip,
+        'prefer-eui-icon-tip': prefer_eui_icon_tip_1.PreferEuiIconTip,
     },
     configs: {
         recommended: {
@@ -34,6 +42,11 @@ const config = {
                 '@elastic/eui/href-or-on-click': 'warn',
                 '@elastic/eui/no-restricted-eui-imports': 'warn',
                 '@elastic/eui/no-css-color': 'warn',
+                '@elastic/eui/require-aria-label-for-modals': 'warn',
+                '@elastic/eui/consistent-is-invalid-props': 'warn',
+                '@elastic/eui/sr-output-disabled-tooltip': 'warn',
+                '@elastic/eui/no-css_color': 'warn',
+                '@elastic/eui/prefer-eui-icon-tip': 'warn',
             },
         },
     },

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAEH,+DAAuD;AACvD,iFAA2E;AAC3E,uDAAkD;AAElD,MAAM,MAAM,GAAG;IACb,KAAK,EAAE;QACL,kBAAkB,EAAE,8BAAW;QAC/B,2BAA2B,EAAE,kDAAsB;QACnD,cAAc,EAAE,yBAAU;KAC3B;IACD,OAAO,EAAE;QACP,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,4BAA4B,CAAC;YACvC,KAAK,EAAE;gBACL,+BAA+B,EAAE,MAAM;gBACvC,wCAAwC,EAAE,MAAM;gBAChD,2BAA2B,EAAE,MAAM;aACpC;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAEH,+DAAuD;AACvD,iFAA2E;AAC3E,uDAAkD;AAElD,8FAAuF;AACvF,0FAAoF;AACpF,wFAA4F;AAC5F,0EAAoE;AAEpE,MAAM,MAAM,GAAG;IACb,KAAK,EAAE;QACL,kBAAkB,EAAE,8BAAW;QAC/B,2BAA2B,EAAE,kDAAsB;QACnD,cAAc,EAAE,yBAAU;QAC1B,+BAA+B,EAAE,yDAAyB;QAC1D,6BAA6B,EAAE,sDAAwB;QACvD,4BAA4B,EAAE,8DAAiC;QAC/D,qBAAqB,EAAE,sCAAgB;KACxC;IACD,OAAO,EAAE;QACP,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,4BAA4B,CAAC;YACvC,KAAK,EAAE;gBACL,+BAA+B,EAAE,MAAM;gBACvC,wCAAwC,EAAE,MAAM;gBAChD,2BAA2B,EAAE,MAAM;gBACnC,4CAA4C,EAAE,MAAM;gBACpD,0CAA0C,EAAE,MAAM;gBAClD,yCAAyC,EAAE,MAAM;gBACjD,2BAA2B,EAAE,MAAM;gBACnC,kCAAkC,EAAE,MAAM;aAC3C;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC"}

package/lib/esm/rules/a11y/consistent_is_invalid_props.d.ts

@@ -0,0 +1,2 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const ConsistentIsInvalidProps: ESLintUtils.RuleModule<"inconsistentIsInvalid", [], unknown, ESLintUtils.RuleListener>;

package/lib/esm/rules/a11y/consistent_is_invalid_props.js

@@ -0,0 +1,93 @@
+"use strict";
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsistentIsInvalidProps = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const get_attr_value_1 = require("../../utils/get_attr_value");
+const formControlComponent = 'EuiFormRow';
+const formControlChildComponents = [
+    'EuiFieldNumber',
+    'EuiFilePicker',
+    'EuiFieldText',
+    'EuiComboBox',
+    'EuiTextArea',
+    'EuiFormControlLayoutDelimited',
+    'SingleFieldSelect',
+    'EuiSelect',
+];
+exports.ConsistentIsInvalidProps = utils_1.ESLintUtils.RuleCreator.withoutDocs({
+    create(context) {
+        return {
+            JSXElement(node) {
+                const openingElement = node.openingElement;
+                if (openingElement?.name.type !== 'JSXIdentifier' ||
+                    openingElement.name.name !== formControlComponent ||
+                    openingElement.attributes.length === 0) {
+                    return;
+                }
+                const formRowIsInvalid = (0, get_attr_value_1.getAttrValue)(context, openingElement.attributes, 'isInvalid');
+                if (formRowIsInvalid === undefined) {
+                    return;
+                }
+                const childElement = node.children.find((child) => child.type === 'JSXElement' &&
+                    child.openingElement?.name.type === 'JSXIdentifier' &&
+                    formControlChildComponents.includes(child.openingElement.name.name));
+                if (!childElement) {
+                    return;
+                }
+                const childIsInvalid = (0, get_attr_value_1.getAttrValue)(context, childElement.openingElement.attributes, 'isInvalid');
+                if (childIsInvalid !== formRowIsInvalid) {
+                    const componentName = childElement.openingElement.name.name;
+                    context.report({
+                        node: childElement,
+                        messageId: 'inconsistentIsInvalid',
+                        fix: (fixer) => {
+                            const childIsInvalidAttr = childElement.openingElement.attributes.find((attr) => attr.type === 'JSXAttribute' &&
+                                attr.name.type === 'JSXIdentifier' &&
+                                attr.name.name === 'isInvalid');
+                            if (childIsInvalidAttr) {
+                                return fixer.replaceText(childIsInvalidAttr, `isInvalid={${formRowIsInvalid}}`);
+                            }
+                            const insertPosition = childElement.openingElement.name.range[1];
+                            return fixer.insertTextAfterRange([insertPosition, insertPosition], ` isInvalid={${formRowIsInvalid}}`);
+                        },
+                        data: {
+                            formControlComponent: formControlComponent,
+                            component: componentName,
+                        },
+                    });
+                }
+            },
+        };
+    },
+    meta: {
+        type: 'problem',
+        docs: {
+            description: `Ensure {{component}} inherit "isInvalid" prop from parent {{formControlComponent}}`,
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            inconsistentIsInvalid: `{{component}} should have the same "isInvalid" prop value as its parent {{formControlComponent}}.`,
+        },
+    },
+    defaultOptions: [],
+});
+//# sourceMappingURL=consistent_is_invalid_props.js.map

package/lib/esm/rules/a11y/consistent_is_invalid_props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistent_is_invalid_props.js","sourceRoot":"","sources":["../../../../src/rules/a11y/consistent_is_invalid_props.ts"],"names":[],"mappings":"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"}

package/lib/esm/rules/a11y/prefer_eui_icon_tip.d.ts

@@ -0,0 +1,2 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const PreferEuiIconTip: ESLintUtils.RuleModule<"preferEuiIconTip", [], unknown, ESLintUtils.RuleListener>;

package/lib/esm/rules/a11y/prefer_eui_icon_tip.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreferEuiIconTip = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const TOOLTIP_COMPONENT = 'EuiToolTip';
+const ICON_COMPONENT = 'EuiIcon';
+const ICON_TIP_COMPONENT = 'EuiIconTip';
+exports.PreferEuiIconTip = utils_1.ESLintUtils.RuleCreator.withoutDocs({
+    create(context) {
+        return {
+            JSXElement(node) {
+                const openingElement = node.openingElement;
+                if (openingElement.name.type !== 'JSXIdentifier' ||
+                    openingElement.name.name !== TOOLTIP_COMPONENT) {
+                    return;
+                }
+                // Find first JSX child
+                const firstChild = node.children.find((child) => child.type === 'JSXElement');
+                if (firstChild &&
+                    firstChild.openingElement.name.type === 'JSXIdentifier' &&
+                    firstChild.openingElement.name.name === ICON_COMPONENT) {
+                    context.report({
+                        node: firstChild,
+                        messageId: 'preferEuiIconTip'
+                    });
+                }
+            },
+        };
+    },
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: `Prefer using ${ICON_TIP_COMPONENT} over <${TOOLTIP_COMPONENT}><${ICON_COMPONENT}/></${TOOLTIP_COMPONENT}>, as it delivers better accessibility and improved support for assistive technologies.`
+        },
+        schema: [],
+        messages: {
+            preferEuiIconTip: `Ensure ${ICON_TIP_COMPONENT} is used rather than <${TOOLTIP_COMPONENT}><${ICON_COMPONENT}/></${TOOLTIP_COMPONENT}>, as it delivers better accessibility and improved support for assistive technologies.`,
+        },
+    },
+    defaultOptions: [],
+});
+//# sourceMappingURL=prefer_eui_icon_tip.js.map

package/lib/esm/rules/a11y/prefer_eui_icon_tip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer_eui_icon_tip.js","sourceRoot":"","sources":["../../../../src/rules/a11y/prefer_eui_icon_tip.ts"],"names":[],"mappings":";;;AAAA,oDAAsE;AAEtE,MAAM,iBAAiB,GAAG,YAAY,CAAC;AACvC,MAAM,cAAc,GAAG,SAAS,CAAC;AACjC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE3B,QAAA,gBAAgB,GAAG,mBAAW,CAAC,WAAW,CAAC,WAAW,CAAC;IAClE,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,UAAU,CAAC,IAAI;gBACb,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;gBAC3C,IACE,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;oBAC5C,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAC9C,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,uBAAuB;gBACvB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CACnC,CAAC,KAAK,EAAgC,EAAE,CACtC,KAAK,CAAC,IAAI,KAAK,YAAY,CAC9B,CAAC;gBAEF,IACE,UAAU;oBACV,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;oBACvD,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,EACtD,CAAC;oBACD,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI,EAAE,UAAU;wBAChB,SAAS,EAAE,kBAAkB;qBAC9B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EAAE,gBAAgB,kBAAkB,UAAU,iBAAiB,KAAK,cAAc,OAAO,iBAAiB,yFAAyF;SAC/M;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,gBAAgB,EAAE,UAAU,kBAAkB,yBAAyB,iBAAiB,KAAK,cAAc,OAAO,iBAAiB,yFAAyF;SAC7N;KACF;IACD,cAAc,EAAE,EAAE;CACnB,CAAC,CAAC"}

package/lib/esm/rules/a11y/require_aria_label_for_modals.d.ts

@@ -0,0 +1,2 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const RequireAriaLabelForModals: ESLintUtils.RuleModule<"modalAriaMissing" | "confirmModalAriaMissing", [], unknown, ESLintUtils.RuleListener>;

package/lib/esm/rules/a11y/require_aria_label_for_modals.js

@@ -0,0 +1,107 @@
+"use strict";
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequireAriaLabelForModals = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const modalComponents = ['EuiModal', 'EuiFlyout'];
+const confirmModalComponents = ['EuiConfirmModal'];
+exports.RequireAriaLabelForModals = utils_1.ESLintUtils.RuleCreator.withoutDocs({
+    create(context) {
+        function checkAttributes(node, componentName, messageId) {
+            const hasAriaLabel = node.attributes.some((attr) => attr.type === 'JSXAttribute' &&
+                typeof attr.name.name === 'string' &&
+                ['aria-label', 'aria-labelledby'].includes(attr.name.name));
+            if (!hasAriaLabel) {
+                context.report({
+                    node,
+                    messageId: messageId,
+                    data: { component: componentName },
+                });
+            }
+        }
+        return {
+            JSXOpeningElement(node) {
+                if (node.name.type === 'JSXIdentifier') {
+                    if (modalComponents.includes(node.name.name)) {
+                        checkAttributes(node, node.name.name, 'modalAriaMissing');
+                    }
+                    if (confirmModalComponents.includes(node.name.name)) {
+                        checkAttributes(node, node.name.name, 'confirmModalAriaMissing');
+                    }
+                }
+                return;
+            },
+        };
+    },
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Ensure modals have \'aria-label\' or \'aria-labelledby\'',
+        },
+        schema: [],
+        messages: {
+            modalAriaMissing: [
+                '{{ component }} must have either \'aria-label\' or \'aria-labelledby\' prop for accessibility.',
+                '\n',
+                'Option 1: Using \'aria-labelledby\' (preferred):',
+                '1. Import \'useGeneratedHtmlId\':',
+                '   import { useGeneratedHtmlId } from \'@elastic/eui\';',
+                '2. Update your component:',
+                '   const modalTitleId = useGeneratedHtmlId();',
+                '   ...',
+                '   <{{ component }}',
+                '    aria-labelledby={modalTitleId}',
+                '    {...props} ',
+                '   />',
+                '     <{{ component }}Header>',
+                '       <EuiTitle id={modalTitleId}>',
+                '         {\'Descriptive title for the {{ component }}\'}',
+                '       </EuiTitle>',
+                '     </{ component }}Header>',
+                '     ...',
+                '   </{{ component }}>',
+                '\n',
+                'Option 2: Using \'aria-label\':',
+                '   <{{ component }} aria-label="Descriptive title for the {{ component }}" {...props} />',
+            ].join('\n'),
+            confirmModalAriaMissing: [
+                '{{ component }} must have either \'aria-label\' or \'aria-labelledby\' prop for accessibility.',
+                '\n',
+                'Option 1: Using \'aria-labelledby\' (preferred):',
+                '1. Import \'useGeneratedHtmlId\':',
+                '   import { useGeneratedHtmlId } from \'@elastic/eui\';',
+                '2. Update your component:',
+                '   const modalTitleId = useGeneratedHtmlId();',
+                '   ...',
+                '   <{{ component }}',
+                '     title="Descriptive title for the {{ component }}"',
+                '     aria-labelledby={modalTitleId}',
+                '     titleProps={({id: modalTitleId })}',
+                '     {...props} ',
+                '   />',
+                '\n',
+                'Option 2: Using \'aria-label\':',
+                '   <{{ component }} aria-label="Descriptive title for the {{ component }}" {...props} />',
+            ].join('\n')
+        },
+    },
+    defaultOptions: [],
+});
+//# sourceMappingURL=require_aria_label_for_modals.js.map

package/lib/esm/rules/a11y/require_aria_label_for_modals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require_aria_label_for_modals.js","sourceRoot":"","sources":["../../../../src/rules/a11y/require_aria_label_for_modals.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,oDAAiE;AAEjE,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAClD,MAAM,sBAAsB,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAEtC,QAAA,yBAAyB,GAAG,mBAAW,CAAC,WAAW,CAAC,WAAW,CAAC;IAC3E,MAAM,CAAC,OAAO;QACZ,SAAS,eAAe,CAAC,IAAgC,EAAE,aAAqB,EAAE,SAAyD;YACzI,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CACvC,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,IAAI,KAAK,cAAc;gBAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAClC,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7D,CAAC;YAEF,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,CAAC,MAAM,CAAC;oBACb,IAAI;oBACJ,SAAS,EAAE,SAAS;oBACpB,IAAI,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,iBAAiB,CAAC,IAAI;gBACpB,IACE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,EAClC,CAAC;oBACD,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7C,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAA;oBAC3D,CAAC;oBAED,IAAI,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpD,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAA;oBAClE,CAAC;gBACH,CAAC;gBACD,OAAM;YACR,CAAC;SACF,CAAC;IACJ,CAAC;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EAAE,0DAA0D;SACxE;QACD,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,gBAAgB,EAAE;gBAChB,gGAAgG;gBAChG,IAAI;gBACJ,kDAAkD;gBAClD,mCAAmC;gBACnC,yDAAyD;gBACzD,2BAA2B;gBAC3B,+CAA+C;gBAC/C,QAAQ;gBACR,qBAAqB;gBACrB,oCAAoC;gBACpC,iBAAiB;gBACjB,OAAO;gBACP,8BAA8B;gBAC9B,qCAAqC;gBACrC,0DAA0D;gBAC1D,oBAAoB;gBACpB,8BAA8B;gBAC9B,UAAU;gBACV,uBAAuB;gBACvB,IAAI;gBACJ,iCAAiC;gBACjC,0FAA0F;aAC3F,CAAC,IAAI,CAAC,IAAI,CAAC;YAEZ,uBAAuB,EAAE;gBACvB,gGAAgG;gBAChG,IAAI;gBACJ,kDAAkD;gBAClD,mCAAmC;gBACnC,yDAAyD;gBACzD,2BAA2B;gBAC3B,+CAA+C;gBAC/C,QAAQ;gBACR,qBAAqB;gBACrB,wDAAwD;gBACxD,qCAAqC;gBACrC,yCAAyC;gBACzC,kBAAkB;gBAClB,OAAO;gBACP,IAAI;gBACJ,iCAAiC;gBACjC,0FAA0F;aAC7F,CAAC,IAAI,CAAC,IAAI,CAAC;SACX;KACF;IACD,cAAc,EAAE,EAAE;CACnB,CAAC,CAAC"}

package/lib/esm/rules/a11y/sr_output_disabled_tooltip.d.ts

@@ -0,0 +1,2 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+export declare const ScreenReaderOutputDisabledTooltip: ESLintUtils.RuleModule<"requireDisableScreenReader", [], unknown, ESLintUtils.RuleListener>;

package/lib/esm/rules/a11y/sr_output_disabled_tooltip.js

@@ -0,0 +1,75 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenReaderOutputDisabledTooltip = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const get_attr_value_1 = require("../../utils/get_attr_value");
+const tooltipComponent = 'EuiToolTip';
+const disabledTooltipComponentProp = 'disableScreenReaderOutput';
+const buttonComponents = ['EuiButtonIcon'];
+const normalizeAttrString = (str) => str?.trim().replace(/\s+/g, ' ');
+exports.ScreenReaderOutputDisabledTooltip = utils_1.ESLintUtils.RuleCreator.withoutDocs({
+    create(context) {
+        return {
+            JSXElement(node) {
+                const openingElement = node.openingElement;
+                if (openingElement?.name.type !== 'JSXIdentifier' ||
+                    openingElement.name.name !== tooltipComponent) {
+                    return;
+                }
+                const tooltipContent = (0, get_attr_value_1.getAttrValue)(context, openingElement.attributes, 'content');
+                const hasDisableScreenReader = openingElement.attributes.some((attr) => attr.type === 'JSXAttribute' &&
+                    attr.name.type === 'JSXIdentifier' &&
+                    attr.name.name === disabledTooltipComponentProp);
+                if (hasDisableScreenReader) {
+                    return;
+                }
+                const buttonElement = node.children.find((child) => child.type === 'JSXElement' &&
+                    child.openingElement?.name.type === 'JSXIdentifier' &&
+                    buttonComponents.includes(child.openingElement.name.name));
+                if (!buttonElement) {
+                    return;
+                }
+                const ariaLabel = (0, get_attr_value_1.getAttrValue)(context, buttonElement.openingElement.attributes, 'aria-label');
+                if (tooltipContent &&
+                    ariaLabel &&
+                    normalizeAttrString(tooltipContent) === normalizeAttrString(ariaLabel)) {
+                    const buttonElementName = buttonElement.openingElement.name.name;
+                    context.report({
+                        node: openingElement,
+                        messageId: 'requireDisableScreenReader',
+                        fix: (fixer) => {
+                            const lastAttr = openingElement.attributes[openingElement.attributes.length - 1];
+                            const insertPosition = lastAttr ? lastAttr.range[1] : openingElement.name.range[1];
+                            return fixer.insertTextAfterRange([insertPosition, insertPosition], ` ${disabledTooltipComponentProp}`);
+                        },
+                        data: {
+                            tooltipComponent,
+                            disabledTooltipComponentProp,
+                            buttonElementName,
+                        },
+                    });
+                }
+            },
+        };
+    },
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Ensure "{{disabledTooltipComponentProp}}" attribute is set when {{tooltipComponent}} content matches {{buttonElementName}} "aria-label"',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            requireDisableScreenReader: '{{tooltipComponent}} should include "{{disabledTooltipComponentProp}}" attribute when its content matches the "aria-label" of {{buttonElementName}} to avoid redundant announcements.',
+        },
+    },
+    defaultOptions: [],
+});
+//# sourceMappingURL=sr_output_disabled_tooltip.js.map

package/lib/esm/rules/a11y/sr_output_disabled_tooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sr_output_disabled_tooltip.js","sourceRoot":"","sources":["../../../../src/rules/a11y/sr_output_disabled_tooltip.ts"],"names":[],"mappings":"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"}

package/lib/esm/utils/get_attr_value.d.ts

@@ -0,0 +1,2 @@
+import { type TSESTree, type TSESLint } from '@typescript-eslint/utils';
+export declare function getAttrValue<TContext extends TSESLint.RuleContext<string, unknown[]>>(context: TContext, attributes: TSESTree.JSXOpeningElement['attributes'], attrName: string): string | undefined;

package/lib/esm/utils/get_attr_value.js

@@ -0,0 +1,41 @@
+"use strict";
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAttrValue = getAttrValue;
+function getAttrValue(context, attributes, attrName) {
+    const attr = attributes.find((attr) => attr.type === 'JSXAttribute' &&
+        attr.name.type === 'JSXIdentifier' &&
+        attr.name.name === attrName);
+    if (!attr?.value) {
+        return undefined;
+    }
+    if (attr.value.type === 'Literal') {
+        return String(attr.value.value);
+    }
+    if (attr.value.type === 'JSXExpressionContainer') {
+        const expression = attr.value.expression;
+        if (expression.type === 'Literal') {
+            return String(expression.value);
+        }
+        return context.sourceCode.getText(expression);
+    }
+    return undefined;
+}
+//# sourceMappingURL=get_attr_value.js.map

package/lib/esm/utils/get_attr_value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_attr_value.js","sourceRoot":"","sources":["../../../src/utils/get_attr_value.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAIH,oCAiCC;AAjCD,SAAgB,YAAY,CAG1B,OAAiB,EACjB,UAAoD,EACpD,QAAgB;IAEhB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAC1B,CAAC,IAAI,EAAiC,EAAE,CACtC,IAAI,CAAC,IAAI,KAAK,cAAc;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAC9B,CAAC;IAEF,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QAEzC,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elastic/eslint-plugin-eui",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",