@elastic/eslint-plugin-eui 2.3.0 → 2.4.0

package/README.md

@@ -147,6 +147,14 @@ Ensure `EuiIconTip` is used rather than `<EuiToolTip><EuiIcon/></EuiToolTip>`, a
 
 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");
@@ -8,6 +9,7 @@ var _consistent_is_invalid_props = require("./rules/a11y/consistent_is_invalid_p
 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
@@ -36,7 +38,9 @@ const config = {
     '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,
-    'no-unnamed-radio-group': _no_unnamed_radio_group.NoUnnamedRadioGroup
+    '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: {
@@ -49,7 +53,9 @@ const config = {
         '@elastic/eui/consistent-is-invalid-props': 'warn',
         '@elastic/eui/sr-output-disabled-tooltip': 'warn',
         '@elastic/eui/prefer-eui-icon-tip': 'warn',
-        '@elastic/eui/no-unnamed-radio-group': '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/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/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"}

package/lib/cjs/utils/is_in_conditional_rendering.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isInConditionalRendering = isInConditionalRendering;
+/*
+ * 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 isInConditionalRendering(node) {
+  let parent = node.parent;
+  while (parent) {
+    if (parent.type === 'ConditionalExpression' || parent.type === 'IfStatement' || parent.type === 'LogicalExpression' && parent.operator === '&&') {
+      return true;
+    }
+    parent = parent.parent;
+  }
+  return false;
+}

package/lib/esm/index.js

@@ -18,6 +18,7 @@
  * under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+const callout_announce_on_mount_1 = require("./rules/a11y/callout_announce_on_mount");
 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");
@@ -26,6 +27,7 @@ const consistent_is_invalid_props_1 = require("./rules/a11y/consistent_is_invali
 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 no_unnamed_radio_group_1 = require("./rules/a11y/no_unnamed_radio_group");
+const no_unnamed_interactive_element_1 = require("./rules/a11y/no_unnamed_interactive_element");
 const config = {
     rules: {
         'href-or-on-click': href_or_on_click_1.HrefOnClick,
@@ -36,6 +38,8 @@ const config = {
         'sr-output-disabled-tooltip': sr_output_disabled_tooltip_1.ScreenReaderOutputDisabledTooltip,
         'prefer-eui-icon-tip': prefer_eui_icon_tip_1.PreferEuiIconTip,
         'no-unnamed-radio-group': no_unnamed_radio_group_1.NoUnnamedRadioGroup,
+        'callout-announce-on-mount': callout_announce_on_mount_1.CallOutAnnounceOnMount,
+        'no-unnamed-interactive-element': no_unnamed_interactive_element_1.NoUnnamedInteractiveElement,
     },
     configs: {
         recommended: {
@@ -49,6 +53,8 @@ const config = {
                 '@elastic/eui/sr-output-disabled-tooltip': '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/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,8FAAuF;AACvF,0FAAoF;AACpF,wFAA4F;AAC5F,0EAAoE;AACpE,gFAA0E;AAE1E,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;QACvC,wBAAwB,EAAG,4CAAmB;KAC/C;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,kCAAkC,EAAE,MAAM;gBAC1C,qCAAqC,EAAE,MAAM;aAC9C;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,sFAAgF;AAChF,+DAAuD;AACvD,iFAA2E;AAC3E,uDAAkD;AAElD,8FAAuF;AACvF,0FAAoF;AACpF,wFAA4F;AAC5F,0EAAoE;AACpE,gFAA0E;AAC1E,gGAA0F;AAG1F,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;QACvC,wBAAwB,EAAG,4CAAmB;QAC9C,2BAA2B,EAAE,kDAAsB;QACnD,gCAAgC,EAAE,4DAA2B;KAC9D;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,kCAAkC,EAAE,MAAM;gBAC1C,qCAAqC,EAAE,MAAM;gBAC7C,wCAAwC,EAAE,MAAM;gBAChD,6CAA6C,EAAE,MAAM;aACtD;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC"}

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

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

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

@@ -0,0 +1,76 @@
+"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.CallOutAnnounceOnMount = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const is_in_conditional_rendering_1 = require("../../utils/is_in_conditional_rendering");
+const has_spread_1 = require("../../utils/has_spread");
+const CALLOUT_COMPONENT = 'EuiCallOut';
+exports.CallOutAnnounceOnMount = utils_1.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_1.isInConditionalRendering)(node)) {
+                    context.report({
+                        node: openingElement,
+                        messageId: 'missingAnnounceOnMount',
+                        fix: (0, has_spread_1.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: [],
+});
+//# sourceMappingURL=callout_announce_on_mount.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callout_announce_on_mount.js","sourceRoot":"","sources":["../../../../src/rules/a11y/callout_announce_on_mount.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,oDAAwD;AACxD,yFAAmF;AACnF,uDAAmD;AAEnD,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE1B,QAAA,sBAAsB,GAAG,mBAAW,CAAC,WAAW,CAAC,WAAW,CAAC;IACxE,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,UAAU,CAAC,IAAI;gBACb,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;gBAChC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;oBAC5C,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;oBACnD,OAAO;gBACT,CAAC;gBACD,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxC,IAAI,CAAC,IAAI,KAAK,cAAc;oBAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;oBAClC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,CACrC,EAAE,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,IAAI,IAAA,sDAAwB,EAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI,EAAE,cAAc;wBACpB,SAAS,EAAE,wBAAwB;wBACnC,GAAG,EAAE,IAAA,sBAAS,EAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE;4BAChE,OAAO,KAAK,CAAC,oBAAoB,CAC/B,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC5D,kBAAkB,CACnB,CAAC;wBACJ,CAAC;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EAAE,UAAU,iBAAiB,gGAAgG;SACzI;QACD,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,sBAAsB,EAAE;gBACtB,GAAG,iBAAiB,6FAA6F;gBACjH,IAAI;gBACJ,QAAQ,iBAAiB,6EAA6E;gBACtG,2FAA2F;gBAC3F,6DAA6D;gBAC7D,IAAI;gBACJ,UAAU;gBACV,MAAM,iBAAiB,gDAAgD;gBACvE,oDAAoD;gBACpD,OAAO,iBAAiB,GAAG;aAC5B,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;KACF;IACD,cAAc,EAAE,EAAE;CACnB,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,106 @@
+"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.NoUnnamedInteractiveElement = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const has_spread_1 = require("../../utils/has_spread");
+const get_allowed_a11y_prop_names_for_component_1 = require("../../utils/get_allowed_a11y_prop_names_for_component");
+const has_a11y_prop_for_component_1 = require("../../utils/has_a11y_prop_for_component");
+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],
+};
+exports.NoUnnamedInteractiveElement = utils_1.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_1.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_1.hasSpread)(node.attributes) ||
+                    (0, has_a11y_prop_for_component_1.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_1.hasSpread)(open.attributes) &&
+                        !(0, has_a11y_prop_for_component_1.hasA11yPropForComponent)(wrapperName, open.attributes, a11yConfig)) {
+                        report(open);
+                    }
+                }
+                else {
+                    report(node);
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=no_unnamed_interactive_element.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * 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[];

package/lib/esm/utils/get_allowed_a11y_prop_names_for_component.js

@@ -0,0 +1,45 @@
+"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.getAllowedA11yPropNamesForComponent = getAllowedA11yPropNamesForComponent;
+/**
+ * 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];
+}
+//# sourceMappingURL=get_allowed_a11y_prop_names_for_component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_allowed_a11y_prop_names_for_component.js","sourceRoot":"","sources":["../../../src/utils/get_allowed_a11y_prop_names_for_component.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAyBH,kFAaC;AA1BD;;;;;;;;;;;;GAYG;AACH,SAAgB,mCAAmC,CACjD,aAAqB,EACrB,GAAe;IAEf,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS;QAC1C,GAAG,GAAG,CAAC,8BAA8B;QACrC,GAAG,GAAG,CAAC,kBAAkB;KAC1B,CAAC,CAAC;IAEH,IAAI,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,19 @@
+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;

package/lib/esm/utils/has_a11y_prop_for_component.js

@@ -0,0 +1,45 @@
+"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.hasA11yPropForComponent = hasA11yPropForComponent;
+const get_allowed_a11y_prop_names_for_component_1 = require("./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`.
+ */
+function hasA11yPropForComponent(componentName, attrs, cfg) {
+    const allowed = new Set((0, get_allowed_a11y_prop_names_for_component_1.getAllowedA11yPropNamesForComponent)(componentName, cfg));
+    return attrs.some((attr) => attr.type === 'JSXAttribute' &&
+        attr.name.type === 'JSXIdentifier' &&
+        allowed.has(attr.name.name));
+}
+//# sourceMappingURL=has_a11y_prop_for_component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"has_a11y_prop_for_component.js","sourceRoot":"","sources":["../../../src/utils/has_a11y_prop_for_component.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAyBH,0DAcC;AApCD,2GAGqD;AAErD;;;;;;;;;;;;;;;GAeG;AAEH,SAAgB,uBAAuB,CACrC,aAAqB,EACrB,KAA+C,EAC/C,GAAe;IAEf,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,IAAA,+EAAmC,EAAC,aAAa,EAAE,GAAG,CAAC,CACxD,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,IAAI,EAAiC,EAAE,CACtC,IAAI,CAAC,IAAI,KAAK,cAAc;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;QAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+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;

package/lib/esm/utils/has_spread.js

@@ -0,0 +1,34 @@
+"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.hasSpread = hasSpread;
+/**
+ * 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');
+}
+//# sourceMappingURL=has_spread.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"has_spread.js","sourceRoot":"","sources":["../../../src/utils/has_spread.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAcH,8BAIC;AAdD;;;;;;;;GAQG;AAEH,SAAgB,SAAS,CACvB,KAA+C;IAE/C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,2 @@
+import { TSESTree } from '@typescript-eslint/utils';
+export declare function isInConditionalRendering(node: TSESTree.JSXElement): boolean;

package/lib/esm/utils/is_in_conditional_rendering.js

@@ -0,0 +1,34 @@
+"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.isInConditionalRendering = isInConditionalRendering;
+function isInConditionalRendering(node) {
+    let parent = node.parent;
+    while (parent) {
+        if (parent.type === 'ConditionalExpression' ||
+            parent.type === 'IfStatement' ||
+            (parent.type === 'LogicalExpression' && parent.operator === '&&')) {
+            return true;
+        }
+        parent = parent.parent;
+    }
+    return false;
+}
+//# sourceMappingURL=is_in_conditional_rendering.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is_in_conditional_rendering.js","sourceRoot":"","sources":["../../../src/utils/is_in_conditional_rendering.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAIH,4DAWC;AAXD,SAAgB,wBAAwB,CAAC,IAAyB;IAChE,IAAI,MAAM,GAA8B,IAAI,CAAC,MAAM,CAAC;IACpD,OAAO,MAAM,EAAE,CAAC;QACd,IAAI,MAAM,CAAC,IAAI,KAAK,uBAAuB;YACzC,MAAM,CAAC,IAAI,KAAK,aAAa;YAC7B,CAAC,MAAM,CAAC,IAAI,KAAK,mBAAmB,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

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