@elastic/eslint-plugin-eui 2.2.1 → 2.4.0

package/README.md

@@ -129,7 +129,7 @@ It's worth pointing out that although the examples provided are specific to EUI
 
 ### `@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.
+Ensures that EUI modal components (`EuiModal`, `EuiFlyout`, `EuiFlyoutResizable` ,`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`
 
@@ -143,6 +143,18 @@ Ensures `disableScreenReaderOutput` is set when `EuiToolTip` content matches `Eu
 
 Ensure `EuiIconTip` is used rather than `<EuiToolTip><EuiIcon/></EuiToolTip>`, as it provides better accessibility and improved support for assistive technologies.
 
+### `@elastic/eui/no-unnamed-radio-group`
+
+Ensure that all radio input components (`EuiRadio`, `EuiRadioGroup`) have a `name` attribute. The `name` attribute is required for radio inputs to be grouped correctly, allowing users to select only one option from a set. Without a `name`, radios may not behave as expected and can cause accessibility issues for assistive technologies.
+
+### `@elastic/eui/callout-announce-on-mount`
+
+Ensures that `EuiCallOut` components rendered conditionally have the `announceOnMount` prop for better accessibility. When callouts appear dynamically (e.g., after user interactions, form validation errors, or status changes), screen readers may not announce their content to users. The `announceOnMount` prop ensures these messages are properly announced to users with assistive technologies.
+
+### `@elastic/eui/no-unnamed-interactive-element`
+
+Ensure that appropriate aria-attributes are set for `EuiBetaBadge`, `EuiButtonIcon`, `EuiComboBox`, `EuiSelect`, `EuiSelectWithWidth`,`EuiSuperSelect`,`EuiPagination`, `EuiTreeView`, `EuiBreadcrumbs`. Without this rule, screen reader users lose context, keyboard navigation can be confusing.
+
 ## Testing
 
 ### Running unit tests

package/lib/cjs/index.js

@@ -1,5 +1,6 @@
 "use strict";
 
+var _callout_announce_on_mount = require("./rules/a11y/callout_announce_on_mount");
 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");
@@ -7,6 +8,8 @@ var _require_aria_label_for_modals = require("./rules/a11y/require_aria_label_fo
 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");
+var _no_unnamed_radio_group = require("./rules/a11y/no_unnamed_radio_group");
+var _no_unnamed_interactive_element = require("./rules/a11y/no_unnamed_interactive_element");
 /*
  * Licensed to Elasticsearch B.V. under one or more contributor
  * license agreements. See the NOTICE file distributed with
@@ -34,7 +37,10 @@ const config = {
     '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
+    'prefer-eui-icon-tip': _prefer_eui_icon_tip.PreferEuiIconTip,
+    'no-unnamed-radio-group': _no_unnamed_radio_group.NoUnnamedRadioGroup,
+    'callout-announce-on-mount': _callout_announce_on_mount.CallOutAnnounceOnMount,
+    'no-unnamed-interactive-element': _no_unnamed_interactive_element.NoUnnamedInteractiveElement
   },
   configs: {
     recommended: {
@@ -46,7 +52,10 @@ const config = {
         '@elastic/eui/require-aria-label-for-modals': 'warn',
         '@elastic/eui/consistent-is-invalid-props': 'warn',
         '@elastic/eui/sr-output-disabled-tooltip': 'warn',
-        '@elastic/eui/prefer-eui-icon-tip': 'warn'
+        '@elastic/eui/prefer-eui-icon-tip': 'warn',
+        '@elastic/eui/no-unnamed-radio-group': 'warn',
+        '@elastic/eui/callout-announce-on-mount': 'warn',
+        '@elastic/eui/no-unnamed-interactive-element': 'warn'
       }
     }
   }

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"callout_announce_on_mount.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/callout_announce_on_mount.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAG,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAMxD,eAAO,MAAM,sBAAsB,yFAsDjC,CAAC"}

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

@@ -0,0 +1,67 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CallOutAnnounceOnMount = void 0;
+var _utils = require("@typescript-eslint/utils");
+var _is_in_conditional_rendering = require("../../utils/is_in_conditional_rendering");
+var _has_spread = require("../../utils/has_spread");
+/*
+ * 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 CALLOUT_COMPONENT = 'EuiCallOut';
+const CallOutAnnounceOnMount = exports.CallOutAnnounceOnMount = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    return {
+      JSXElement(node) {
+        const {
+          openingElement
+        } = node;
+        if (openingElement.name.type !== 'JSXIdentifier' || openingElement.name.name !== CALLOUT_COMPONENT) {
+          return;
+        }
+        if (openingElement.attributes.some(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && attr.name.name === 'announceOnMount')) {
+          return;
+        }
+        if ((0, _is_in_conditional_rendering.isInConditionalRendering)(node)) {
+          context.report({
+            node: openingElement,
+            messageId: 'missingAnnounceOnMount',
+            fix: (0, _has_spread.hasSpread)(openingElement.attributes) ? undefined : fixer => {
+              return fixer.insertTextAfterRange([openingElement.name.range[1], openingElement.name.range[1]], ' announceOnMount');
+            }
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    type: 'problem',
+    docs: {
+      description: `Ensure ${CALLOUT_COMPONENT} components that are conditionally rendered have announceOnMount prop for better accessibility`
+    },
+    fixable: 'code',
+    schema: [],
+    messages: {
+      missingAnnounceOnMount: [`${CALLOUT_COMPONENT} should have \`announceOnMount\` prop when conditionally rendered for better accessibility.`, '\n', `When ${CALLOUT_COMPONENT} appears dynamically (e.g., after user interaction, form validation, etc.),`, 'screen readers may not announce its content. Adding `announceOnMount` ensures the callout', 'is properly announced to users with assistive technologies.', '\n', 'Example:', `  <${CALLOUT_COMPONENT} announceOnMount title="Error" color="danger">`, '    This message will be announced when it appears', `  </${CALLOUT_COMPONENT}>`].join('\n')
+    }
+  },
+  defaultOptions: []
+});

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

@@ -1 +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"}
+{"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;AAiBtE,eAAO,MAAM,wBAAwB,wFA6FnC,CAAC"}

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.ConsistentIsInvalidProps = void 0;
 var _utils = require("@typescript-eslint/utils");
 var _get_attr_value = require("../../utils/get_attr_value");
+var _are_attrs_equal = require("../../utils/are_attrs_equal");
 /*
  * Licensed to Elasticsearch B.V. under one or more contributor
  * license agreements. See the NOTICE file distributed with
@@ -44,7 +45,7 @@ const ConsistentIsInvalidProps = exports.ConsistentIsInvalidProps = _utils.ESLin
           return;
         }
         const childIsInvalid = (0, _get_attr_value.getAttrValue)(context, childElement.openingElement.attributes, 'isInvalid');
-        if (childIsInvalid !== formRowIsInvalid) {
+        if (!(0, _are_attrs_equal.areAttrsEqual)(childIsInvalid, formRowIsInvalid)) {
           const componentName = childElement.openingElement.name.name;
           context.report({
             node: childElement,

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"no_unnamed_interactive_element.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/no_unnamed_interactive_element.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,WAAW,EAAiB,MAAM,0BAA0B,CAAC;AAgCtE,eAAO,MAAM,2BAA2B,8EAyEtC,CAAC"}

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

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NoUnnamedInteractiveElement = void 0;
+var _utils = require("@typescript-eslint/utils");
+var _has_spread = require("../../utils/has_spread");
+var _get_allowed_a11y_prop_names_for_component = require("../../utils/get_allowed_a11y_prop_names_for_component");
+var _has_a11y_prop_for_component = require("../../utils/has_a11y_prop_for_component");
+/*
+ * 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 interactiveComponents = ['EuiBetaBadge', 'EuiButtonEmpty', 'EuiButtonIcon', 'EuiComboBox', 'EuiSelect', 'EuiSelectWithWidth', 'EuiSuperSelect', 'EuiPagination', 'EuiTreeView', 'EuiBreadcrumbs'];
+const wrappingComponents = ['EuiFormRow'];
+const interactiveComponentsWithLabel = ['EuiBetaBadge'];
+const baseA11yProps = ['aria-label', 'aria-labelledby'];
+
+// Single source of truth for the utils (keeps them reusable)
+const a11yConfig = {
+  interactiveComponentsWithLabel: [...interactiveComponentsWithLabel],
+  wrappingComponents: [...wrappingComponents],
+  baseA11yProps: [...baseA11yProps]
+};
+const NoUnnamedInteractiveElement = exports.NoUnnamedInteractiveElement = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  meta: {
+    type: 'problem',
+    hasSuggestions: false,
+    schema: [],
+    messages: {
+      missingA11y: '{{component}} must include an accessible label. Use one of: {{a11yProps}}'
+    }
+  },
+  defaultOptions: [],
+  create(context) {
+    const sourceCode = context.sourceCode;
+    function report(opening) {
+      if (opening.name.type !== 'JSXIdentifier') return;
+      const component = opening.name.name;
+      const allowed = (0, _get_allowed_a11y_prop_names_for_component.getAllowedA11yPropNamesForComponent)(component, a11yConfig).join(', ');
+      context.report({
+        node: opening,
+        messageId: 'missingA11y',
+        data: {
+          component,
+          a11yProps: allowed
+        }
+      });
+    }
+    return {
+      JSXOpeningElement(node) {
+        if (node.name.type !== 'JSXIdentifier') return;
+        const componentName = node.name.name;
+        const isInteractive = interactiveComponents.includes(componentName);
+        if (!isInteractive) return;
+        if ((0, _has_spread.hasSpread)(node.attributes) || (0, _has_a11y_prop_for_component.hasA11yPropForComponent)(componentName, node.attributes, a11yConfig)) {
+          return;
+        }
+        const ancestors = sourceCode.getAncestors(node);
+        const wrapper = [...ancestors].reverse().find(a => a.type === 'JSXElement' && a.openingElement.name.type === 'JSXIdentifier' && wrappingComponents.includes(a.openingElement.name.name));
+        if (wrapper) {
+          const open = wrapper.openingElement;
+          const wrapperName = open.name.type === 'JSXIdentifier' ? open.name.name : '';
+          if (!(0, _has_spread.hasSpread)(open.attributes) && !(0, _has_a11y_prop_for_component.hasA11yPropForComponent)(wrapperName, open.attributes, a11yConfig)) {
+            report(open);
+          }
+        } else {
+          report(node);
+        }
+      }
+    };
+  }
+});

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"no_unnamed_radio_group.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/no_unnamed_radio_group.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIvD,eAAO,MAAM,mBAAmB,mFAuC9B,CAAC"}

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

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NoUnnamedRadioGroup = 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 radioComponents = ['EuiRadio', 'EuiRadioGroup'];
+const NoUnnamedRadioGroup = exports.NoUnnamedRadioGroup = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    return {
+      JSXOpeningElement(node) {
+        if (node.name.type === 'JSXIdentifier' && radioComponents.includes(node.name.name)) {
+          const hasNameAttr = node.attributes.some(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && attr.name.name === 'name');
+          if (!hasNameAttr) {
+            context.report({
+              node,
+              messageId: 'missingRadioName',
+              data: {
+                component: node.name.name
+              }
+            });
+          }
+        }
+      }
+    };
+  },
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Ensure that all radio input components have a `name` attribute. The `name` attribute is required for radio inputs to be grouped correctly, allowing users to select only one option from a set. Without a `name`, radios may not behave as expected and can cause accessibility issues for assistive technologies.'
+    },
+    schema: [],
+    messages: {
+      missingRadioName: '{{ component }} must have a `name` attribute. The `name` attribute is required for radio inputs to be grouped correctly, ensuring only one option can be selected and improving accessibility for all users.'
+    }
+  },
+  defaultOptions: []
+});

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

@@ -24,7 +24,7 @@ var _utils = require("@typescript-eslint/utils");
  * under the License.
  */
 
-const modalComponents = ['EuiModal', 'EuiFlyout'];
+const modalComponents = ['EuiModal', 'EuiFlyout', 'EuiFlyoutResizable'];
 const confirmModalComponents = ['EuiConfirmModal'];
 const RequireAriaLabelForModals = exports.RequireAriaLabelForModals = _utils.ESLintUtils.RuleCreator.withoutDocs({
   create(context) {

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

@@ -1 +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"}
+{"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;AAQtE,eAAO,MAAM,iCAAiC,6FA6F1C,CAAC"}

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.ScreenReaderOutputDisabledTooltip = void 0;
 var _utils = require("@typescript-eslint/utils");
 var _get_attr_value = require("../../utils/get_attr_value");
+var _are_attrs_equal = require("../../utils/are_attrs_equal");
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -17,7 +18,6 @@ var _get_attr_value = require("../../utils/get_attr_value");
 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 {
@@ -36,7 +36,7 @@ const ScreenReaderOutputDisabledTooltip = exports.ScreenReaderOutputDisabledTool
           return;
         }
         const ariaLabel = (0, _get_attr_value.getAttrValue)(context, buttonElement.openingElement.attributes, 'aria-label');
-        if (tooltipContent && ariaLabel && normalizeAttrString(tooltipContent) === normalizeAttrString(ariaLabel)) {
+        if (tooltipContent && ariaLabel && (0, _are_attrs_equal.areAttrsEqual)(tooltipContent, ariaLabel)) {
           const buttonElementName = buttonElement.openingElement.name.name;
           context.report({
             node: openingElement,

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

@@ -0,0 +1,2 @@
+export declare const areAttrsEqual: (...strings: Array<string | undefined>) => boolean;
+//# sourceMappingURL=are_attrs_equal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"are_attrs_equal.d.ts","sourceRoot":"","sources":["../../../src/utils/are_attrs_equal.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,aAAa,GAAI,GAAG,SAAS,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAG,OAGrE,CAAC"}

package/lib/cjs/utils/are_attrs_equal.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.areAttrsEqual = void 0;
+/*
+ * 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 normalizeAttrString = str => str?.trim().replace(/\s+/g, ' ');
+const areAttrsEqual = (...strings) => {
+  const [first, ...rest] = strings.map(normalizeAttrString);
+  return rest.every(s => s === first);
+};
+exports.areAttrsEqual = areAttrsEqual;

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

@@ -0,0 +1,24 @@
+/**
+ * Configuration describing which components accept a `label` prop
+ * and the baseline set of accessibility prop names allowed across components.
+ */
+export type A11yConfig = {
+    interactiveComponentsWithLabel: ReadonlyArray<string>;
+    wrappingComponents: ReadonlyArray<string>;
+    baseA11yProps: ReadonlyArray<string>;
+};
+/**
+ * Compute the set of allowed accessibility prop names for a given component.
+ *
+ * - Always includes the provided `baseA11yProps`.
+ * - Conditionally includes `label` if the component is listed in either
+ *   `interactiveComponentsWithLabel` or `wrappingComponents`.
+ * - Does **not** mutate the provided configuration; a new array is returned.
+ *
+ * @param componentName - The EUI component name (e.g., `'EuiButtonIcon'`).
+ * @param cfg - The accessibility configuration to use when resolving allowed props.
+ * @returns A new array of allowed prop names for `componentName`.
+ *
+ */
+export declare function getAllowedA11yPropNamesForComponent(componentName: string, cfg: A11yConfig): string[];
+//# sourceMappingURL=get_allowed_a11y_prop_names_for_component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_allowed_a11y_prop_names_for_component.d.ts","sourceRoot":"","sources":["../../../src/utils/get_allowed_a11y_prop_names_for_component.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,8BAA8B,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtD,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,UAAU,GACd,MAAM,EAAE,CAUV"}

package/lib/cjs/utils/get_allowed_a11y_prop_names_for_component.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAllowedA11yPropNamesForComponent = getAllowedA11yPropNamesForComponent;
+/*
+ * 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.
+ */
+
+/**
+ * Configuration describing which components accept a `label` prop
+ * and the baseline set of accessibility prop names allowed across components.
+ */
+
+/**
+ * Compute the set of allowed accessibility prop names for a given component.
+ *
+ * - Always includes the provided `baseA11yProps`.
+ * - Conditionally includes `label` if the component is listed in either
+ *   `interactiveComponentsWithLabel` or `wrappingComponents`.
+ * - Does **not** mutate the provided configuration; a new array is returned.
+ *
+ * @param componentName - The EUI component name (e.g., `'EuiButtonIcon'`).
+ * @param cfg - The accessibility configuration to use when resolving allowed props.
+ * @returns A new array of allowed prop names for `componentName`.
+ *
+ */
+function getAllowedA11yPropNamesForComponent(componentName, cfg) {
+  const componentsWithLabel = new Set([...cfg.interactiveComponentsWithLabel, ...cfg.wrappingComponents]);
+  if (componentsWithLabel.has(componentName)) {
+    return [...cfg.baseA11yProps, 'label'];
+  }
+  return [...cfg.baseA11yProps];
+}

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

@@ -0,0 +1,20 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+import { type A11yConfig } from './get_allowed_a11y_prop_names_for_component';
+/**
+ * Determines whether a JSX element declares at least one **allowed**
+ * accessibility-related prop for a given component.
+ *
+ * Allowed prop names are resolved via {@link getAllowedA11yPropNamesForComponent},
+ * which combines baseline a11y props (e.g. `aria-*`) and conditionally adds
+ * `label` for components that support it per the provided configuration.
+ *
+ * Only plain `JSXAttribute` nodes are considered—spread attributes are ignored here.
+ *
+ * @param componentName - The component name being checked (e.g., `"EuiButtonIcon"`).
+ * @param attrs - The attributes array from a `JSXOpeningElement` (ESTree).
+ * @param cfg - Accessibility configuration that defines base props and which
+ *              components may accept a `label` prop.
+ * @returns `true` if any attribute name on the element is in the allowed set; otherwise `false`.
+ */
+export declare function hasA11yPropForComponent(componentName: string, attrs: TSESTree.JSXOpeningElement['attributes'], cfg: A11yConfig): boolean;
+//# sourceMappingURL=has_a11y_prop_for_component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"has_a11y_prop_for_component.d.ts","sourceRoot":"","sources":["../../../src/utils/has_a11y_prop_for_component.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,6CAA6C,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AAEH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,QAAQ,CAAC,iBAAiB,CAAC,YAAY,CAAC,EAC/C,GAAG,EAAE,UAAU,GACd,OAAO,CAUT"}

package/lib/cjs/utils/has_a11y_prop_for_component.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasA11yPropForComponent = hasA11yPropForComponent;
+var _get_allowed_a11y_prop_names_for_component = require("./get_allowed_a11y_prop_names_for_component");
+/*
+ * 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.
+ */
+
+/**
+ * Determines whether a JSX element declares at least one **allowed**
+ * accessibility-related prop for a given component.
+ *
+ * Allowed prop names are resolved via {@link getAllowedA11yPropNamesForComponent},
+ * which combines baseline a11y props (e.g. `aria-*`) and conditionally adds
+ * `label` for components that support it per the provided configuration.
+ *
+ * Only plain `JSXAttribute` nodes are considered—spread attributes are ignored here.
+ *
+ * @param componentName - The component name being checked (e.g., `"EuiButtonIcon"`).
+ * @param attrs - The attributes array from a `JSXOpeningElement` (ESTree).
+ * @param cfg - Accessibility configuration that defines base props and which
+ *              components may accept a `label` prop.
+ * @returns `true` if any attribute name on the element is in the allowed set; otherwise `false`.
+ */
+
+function hasA11yPropForComponent(componentName, attrs, cfg) {
+  const allowed = new Set((0, _get_allowed_a11y_prop_names_for_component.getAllowedA11yPropNamesForComponent)(componentName, cfg));
+  return attrs.some(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && allowed.has(attr.name.name));
+}

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

@@ -0,0 +1,12 @@
+import type { TSESTree } from '@typescript-eslint/utils';
+/**
+ * Checks whether a JSX opening element contains a spread attribute
+ * (e.g., `...props`). Spreads make it impossible to statically know
+ * all props present on an element, so ESLint rules often use this as
+ * a quick bail-out to avoid false positives.
+ *
+ * @param attrs - The attributes array from a `JSXOpeningElement` node (ESTree).
+ * @returns `true` if any attribute is a `JSXSpreadAttribute`; otherwise `false`.
+ */
+export declare function hasSpread(attrs: TSESTree.JSXOpeningElement['attributes']): boolean;
+//# sourceMappingURL=has_spread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"has_spread.d.ts","sourceRoot":"","sources":["../../../src/utils/has_spread.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;;;;GAQG;AAEH,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,iBAAiB,CAAC,YAAY,CAAC,GAC9C,OAAO,CAET"}

package/lib/cjs/utils/has_spread.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasSpread = hasSpread;
+/*
+ * 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.
+ */
+
+/**
+ * Checks whether a JSX opening element contains a spread attribute
+ * (e.g., `...props`). Spreads make it impossible to statically know
+ * all props present on an element, so ESLint rules often use this as
+ * a quick bail-out to avoid false positives.
+ *
+ * @param attrs - The attributes array from a `JSXOpeningElement` node (ESTree).
+ * @returns `true` if any attribute is a `JSXSpreadAttribute`; otherwise `false`.
+ */
+
+function hasSpread(attrs) {
+  return attrs.some(a => a.type === 'JSXSpreadAttribute');
+}

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

@@ -0,0 +1,3 @@
+import { TSESTree } from '@typescript-eslint/utils';
+export declare function isInConditionalRendering(node: TSESTree.JSXElement): boolean;
+//# sourceMappingURL=is_in_conditional_rendering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is_in_conditional_rendering.d.ts","sourceRoot":"","sources":["../../../src/utils/is_in_conditional_rendering.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,GAAG,OAAO,CAW3E"}