@elastic/eslint-plugin-eui 2.3.0 → 2.5.0

package/lib/cjs/rules/no_restricted_eui_imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no_restricted_eui_imports.d.ts","sourceRoot":"","sources":["../../../src/rules/no_restricted_eui_imports.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAY,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE9D,KAAK,MAAM,GAAG;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAUF,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CA4CjF,CAAC"}
+{"version":3,"file":"no_restricted_eui_imports.d.ts","sourceRoot":"","sources":["../../../src/rules/no_restricted_eui_imports.ts"],"names":[],"mappings":"AASA,OAAO,EAAY,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE9D,KAAK,MAAM,GAAG;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAUF,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CA4CjF,CAAC"}

package/lib/cjs/rules/no_restricted_eui_imports.js

@@ -7,22 +7,11 @@ exports.NoRestrictedEuiImports = void 0;
 var _micromatch = _interopRequireDefault(require("micromatch"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /*
- * 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.
+ * 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 DEFAULT_RESTRICTED_IMPORT_OPTIONS = [{

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

@@ -1 +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"}
+{"version":3,"file":"are_attrs_equal.d.ts","sourceRoot":"","sources":["../../../src/utils/are_attrs_equal.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,aAAa,GAAI,GAAG,SAAS,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,KAAG,OAGrE,CAAC"}

package/lib/cjs/utils/are_attrs_equal.js

@@ -5,22 +5,11 @@ Object.defineProperty(exports, "__esModule", {
 });
 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.
+ * 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 normalizeAttrString = str => str?.trim().replace(/\s+/g, ' ');

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

@@ -0,0 +1,27 @@
+/**
+ * A list of standard HTML tags that are considered **non-interactive** elements.
+ *
+ * These tags generally do not provide any built-in user interaction
+ * (such as click, input, or focus behavior) and are typically used for
+ * layout, structure, or content presentation rather than direct
+ * interactivity.
+ *
+ * This constant can be useful when:
+ * - Determining whether an element should be treated as interactive.
+ * - Enforcing accessibility rules (e.g., ensuring interactive behavior is only applied to proper elements).
+ * - Filtering DOM nodes when processing or analyzing HTML structures.
+ */
+export declare const NON_INTERACTIVE_HTML_TAGS: string[];
+/**
+ * A list of Elastic UI (EUI) React components that are considered **interactive**.
+ *
+ * These components are designed to be focusable and respond to user actions
+ * such as clicks, keyboard events, or other interactions. Use this constant
+ * when you need to determine if a given EUI component is inherently interactive,
+ * for example, when enforcing accessibility rules or filtering components
+ * for focus management.
+ *
+ * This list should be kept up to date with EUI's interactive component offerings.
+ */
+export declare const INTERACTIVE_EUI_COMPONENTS: string[];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,UAyCrC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,UAyCtC,CAAC"}

package/lib/cjs/utils/constants.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NON_INTERACTIVE_HTML_TAGS = exports.INTERACTIVE_EUI_COMPONENTS = void 0;
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+/**
+ * A list of standard HTML tags that are considered **non-interactive** elements.
+ *
+ * These tags generally do not provide any built-in user interaction
+ * (such as click, input, or focus behavior) and are typically used for
+ * layout, structure, or content presentation rather than direct
+ * interactivity.
+ *
+ * This constant can be useful when:
+ * - Determining whether an element should be treated as interactive.
+ * - Enforcing accessibility rules (e.g., ensuring interactive behavior is only applied to proper elements).
+ * - Filtering DOM nodes when processing or analyzing HTML structures.
+ */
+const NON_INTERACTIVE_HTML_TAGS = exports.NON_INTERACTIVE_HTML_TAGS = ['div', 'span', 'p', 'article', 'aside', 'blockquote', 'br', 'caption', 'code', 'dd', 'dl', 'dt', 'figcaption', 'figure', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'hr', 'img', 'li', 'main', 'nav', 'ol', 'pre', 'section', 'small', 'strong', 'sub', 'sup', 'table', 'tbody', 'td', 'tfoot', 'th', 'thead', 'tr', 'ul'];
+
+/**
+ * A list of Elastic UI (EUI) React components that are considered **interactive**.
+ *
+ * These components are designed to be focusable and respond to user actions
+ * such as clicks, keyboard events, or other interactions. Use this constant
+ * when you need to determine if a given EUI component is inherently interactive,
+ * for example, when enforcing accessibility rules or filtering components
+ * for focus management.
+ *
+ * This list should be kept up to date with EUI's interactive component offerings.
+ */
+const INTERACTIVE_EUI_COMPONENTS = exports.INTERACTIVE_EUI_COMPONENTS = ['EuiLink', 'EuiButton', 'EuiButtonEmpty', 'EuiButtonIcon', 'EuiFacetButton', 'EuiHeaderLink', 'EuiHeaderSectionItemButton', 'EuiHeaderLogo', 'EuiListGroupItem', 'EuiPinnableListGroup', 'EuiSideNav', 'EuiBreadcrumbs', 'EuiTab', 'EuiContextMenuItem', 'EuiKeyPadMenuItem', 'EuiPagination', 'EuiTreeView', 'EuiStepHorizontal', 'EuiCard', 'EuiCheckableCard', 'EuiBasicTable', 'EuiInMemoryTable', 'EuiFilterButton', 'EuiFilterSelectItem', 'EuiFilterSelectable', 'EuiBadge', 'EuiBetaBadge', 'EuiSelectable', 'EuiComboBox', 'EuiSuperSelect', 'EuiSelect', 'EuiCheckbox', 'EuiRadio', 'EuiSwitch', 'EuiButtonGroup', 'EuiRange', 'EuiDualRange', 'EuiColorPicker', 'EuiDatePicker', 'EuiSuperDatePicker'];

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":"AAQA;;;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,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAllowedA11yPropNamesForComponent = getAllowedA11yPropNamesForComponent;
+/*
+ * 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.
+ */
+
+/**
+ * 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/get_attr_value.d.ts

@@ -1,3 +1,4 @@
 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;
+export declare function findAttrValue<TContext extends TSESLint.RuleContext<string, unknown[]>>(context: TContext, attributes: TSESTree.JSXOpeningElement['attributes'], attrName: string): string | undefined;
+export declare function extractAttrValue<TContext extends TSESLint.RuleContext<string, unknown[]>>(context: TContext, attr: TSESTree.JSXAttribute | undefined): string | undefined;
 //# sourceMappingURL=get_attr_value.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"get_attr_value.d.ts","sourceRoot":"","sources":["../../../src/utils/get_attr_value.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAEvE,wBAAgB,aAAa,CAC3B,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,sBAUjB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAExD,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAqBpB"}

package/lib/cjs/utils/get_attr_value.js

@@ -3,28 +3,21 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.getAttrValue = getAttrValue;
+exports.extractAttrValue = extractAttrValue;
+exports.findAttrValue = findAttrValue;
 /*
- * 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.
+ * 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.
  */
 
-function getAttrValue(context, attributes, attrName) {
+function findAttrValue(context, attributes, attrName) {
   const attr = attributes.find(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && attr.name.name === attrName);
+  return extractAttrValue(context, attr);
+}
+function extractAttrValue(context, attr) {
   if (!attr?.value) {
     return undefined;
   }

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":"AAQA,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,36 @@
+"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");
+/*
+ * 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.
+ */
+
+/**
+ * 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":"AAQA,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,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasSpread = hasSpread;
+/*
+ * 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.
+ */
+
+/**
+ * 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":"AAQA,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,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isInConditionalRendering = isInConditionalRendering;
+/*
+ * 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.
+ */
+
+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/cjs/utils/resolve_member_expression_root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve_member_expression_root.d.ts","sourceRoot":"","sources":["../../../src/utils/resolve_member_expression_root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAEhE,eAAO,MAAM,2BAA2B,GACtC,MAAM,QAAQ,CAAC,gBAAgB,KAC9B,QAAQ,CAAC,UAMX,CAAC"}
+{"version":3,"file":"resolve_member_expression_root.d.ts","sourceRoot":"","sources":["../../../src/utils/resolve_member_expression_root.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAEhE,eAAO,MAAM,2BAA2B,GACtC,MAAM,QAAQ,CAAC,gBAAgB,KAC9B,QAAQ,CAAC,UAMX,CAAC"}

package/lib/cjs/utils/resolve_member_expression_root.js

@@ -4,6 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.resolveMemberExpressionRoot = void 0;
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
 const resolveMemberExpressionRoot = node => {
   if (node.object.type === 'MemberExpression') {
     return resolveMemberExpressionRoot(node.object);

package/lib/esm/index.js

@@ -1,21 +1,10 @@
 "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.
+ * 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 });
 const href_or_on_click_1 = require("./rules/href_or_on_click");
@@ -26,6 +15,10 @@ 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 tooltip_focusable_anchor_1 = require("./rules/a11y/tooltip_focusable_anchor");
+const callout_announce_on_mount_1 = require("./rules/a11y/callout_announce_on_mount");
+const accessible_interactive_element_1 = require("./rules/a11y/accessible_interactive_element");
 const config = {
     rules: {
         'href-or-on-click': href_or_on_click_1.HrefOnClick,
@@ -36,6 +29,10 @@ 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,
+        'tooltip-focusable-anchor': tooltip_focusable_anchor_1.TooltipFocusableAnchor,
+        'accessible-interactive-element': accessible_interactive_element_1.AccessibleInteractiveElements,
     },
     configs: {
         recommended: {
@@ -49,6 +46,10 @@ 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',
+                '@elastic/eui/tooltip-focusable-anchor': 'warn',
+                '@elastic/eui/accessible-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;;;;;;GAMG;;AAGH,+DAAuD;AACvD,iFAA2E;AAC3E,uDAAkD;AAElD,8FAAuF;AACvF,0FAAoF;AACpF,wFAA4F;AAC5F,0EAAoE;AACpE,gFAA0E;AAC1E,gGAA0F;AAC1F,oFAA+E;AAC/E,sFAAgF;AAChF,gGAA4F;AAE5F,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;QAC7D,0BAA0B,EAAE,iDAAsB;QAClD,gCAAgC,EAAE,8DAA6B;KAChE;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;gBACrD,uCAAuC,EAAE,MAAM;gBAC/C,6CAA6C,EAAE,MAAM;aACtD;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC"}

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

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

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

@@ -0,0 +1,50 @@
+"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.AccessibleInteractiveElements = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const constants_1 = require("../../utils/constants");
+const get_attr_value_1 = require("../../utils/get_attr_value");
+exports.AccessibleInteractiveElements = utils_1.ESLintUtils.RuleCreator.withoutDocs({
+    create(context) {
+        return {
+            JSXOpeningElement(node) {
+                if (node.name.type !== 'JSXIdentifier')
+                    return;
+                const componentName = node.name.name;
+                if (!constants_1.INTERACTIVE_EUI_COMPONENTS.includes(componentName))
+                    return;
+                const tabIndexAttribute = node.attributes.find((attr) => attr.type === 'JSXAttribute' &&
+                    attr.name.type === 'JSXIdentifier' &&
+                    attr.name.name === 'tabIndex');
+                if (tabIndexAttribute && (Number((0, get_attr_value_1.extractAttrValue)(context, tabIndexAttribute)) || 0) === -1) {
+                    context.report({
+                        node: node,
+                        messageId: 'disallowTabIndex',
+                        data: { component: componentName },
+                        fix: fixer => fixer.remove(tabIndexAttribute),
+                    });
+                }
+            },
+        };
+    },
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Ensure interactive EUI components remain accessible by prohibiting tabIndex={-1}, which removes them from keyboard navigation.',
+        },
+        fixable: 'code',
+        schema: [],
+        messages: {
+            disallowTabIndex: '{{component}} is an interactive EUI component and must not use tabIndex={-1}, as this removes it from keyboard navigation and impairs accessibility.',
+        },
+    },
+    defaultOptions: [],
+});
+//# sourceMappingURL=accessible_interactive_element.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accessible_interactive_element.js","sourceRoot":"","sources":["../../../../src/rules/a11y/accessible_interactive_element.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,oDAAsE;AACtE,qDAAmE;AACnE,+DAA8D;AAEjD,QAAA,6BAA6B,GAAG,mBAAW,CAAC,WAAW,CAAC,WAAW,CAAC;IAC/E,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,iBAAiB,CAAC,IAAI;gBACpB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;oBAAE,OAAO;gBAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrC,IAAI,CAAC,sCAA0B,CAAC,QAAQ,CAAC,aAAa,CAAC;oBAAE,OAAO;gBAEhE,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAC5C,CAAC,IAAI,EAAiC,EAAE,CACtC,IAAI,CAAC,IAAI,KAAK,cAAc;oBAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe;oBAClC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAChC,CAAC;gBAGF,IAAI,iBAAiB,IAAI,CAAC,MAAM,CAAC,IAAA,iCAAgB,EAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC5F,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI,EAAG,IAAI;wBACX,SAAS,EAAE,kBAAkB;wBAC7B,IAAI,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE;wBAClC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EAAE,gIAAgI;SAC9I;QACD,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,EAAE;QACV,QAAQ,EAAE;YACR,gBAAgB,EAAE,sJAAsJ;SACzK;KACF;IACD,cAAc,EAAE,EAAE;CACnB,CAAC,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>;