@elastic/eslint-plugin-eui 2.15.0 → 2.16.0

package/README.md

@@ -29,6 +29,16 @@ We don't use `no-restricted-imports` because ESLint doesn't allow multiple error
 
 All deprecations still must follow our [deprecation process](../../wiki/eui-team-processes/deprecations.md).
 
+### `@elastic/eui/no-deprecated-icon-aliases`
+
+Disallows deprecated EUI icon aliases in static JSX props on components imported
+from `@elastic/eui`. The rule checks props ending in `IconType`, the `type` prop
+on `EuiIcon` and `EuiIconTip`, and component-specific icon props such as
+`timelineAvatar`, `icon`, `logo`, `iconLeft`, and `iconRight`. It automatically
+replaces deprecated aliases with their supported icon handles.
+
+See the full table of icon replacements here: https://github.com/elastic/eui/issues/9561
+
 ### `@elastic/eui/no-css-color`
 
 This rule warns engineers to not use literal css color in the codebase, particularly for CSS properties that apply color to either the html element or text nodes, but rather urge users to defer to using the color tokens provided by EUI.
@@ -256,6 +266,8 @@ The rule reports two situations:
 
 Buttons with spread props (`{...props}`) are intentionally skipped when no `title` prop is explicitly present because their final prop set cannot be statically determined.
 
+**Exception**: an `EuiButtonIcon` rendered as the render-prop child of an `EuiCopy` that sets a non-empty `beforeMessage` is not flagged for a missing wrapper. `EuiCopy` wraps its child in an `EuiToolTip` using `beforeMessage` as the content, so adding another `EuiToolTip` would create nested, conflicting tooltips — see `@elastic/eui/no-nested-copy-tooltip`. This exception is conditional: because `EuiToolTip` suppresses itself when its content is empty, an `EuiButtonIcon` inside an `EuiCopy` with a missing or statically empty/falsy `beforeMessage` (e.g. `""`, `{null}`, `{undefined}`, `{false}`) has no visible tooltip and is still reported. A button passed through the `beforeMessage` prop itself (rather than the render-prop child) is also still reported, since it is not the element `EuiCopy`'s tooltip wraps. A `title` prop is always reported in this case, since browser-native tooltips remain discouraged.
+
 #### Examples
 
 ```tsx
@@ -266,6 +278,11 @@ Buttons with spread props (`{...props}`) are intentionally skipped when no `titl
 <EuiToolTip content="Edit item">
   <EuiButtonIcon aria-label="Edit item" iconType="pencil" />
 </EuiToolTip>
+
+// ✓ Good - EuiCopy provides the tooltip via `beforeMessage`, no wrapper needed
+<EuiCopy textToCopy="some text" beforeMessage="Copy me">
+  {(copy) => <EuiButtonIcon onClick={copy} aria-label="Copy" iconType="copy" />}
+</EuiCopy>
 ```
 
 ```tsx
@@ -328,6 +345,114 @@ it('shows tooltip on focus', async () => {
 ```
 
 
+### `@elastic/eui/no-nested-copy-tooltip`
+
+Disallow wrapping the `EuiCopy` render-prop child in an `EuiToolTip` when the `beforeMessage` prop is set.
+
+`EuiCopy` already wraps its child in an `EuiToolTip` internally and uses `beforeMessage` as that tooltip's content. If the render-prop returns its own `EuiToolTip` as the first child, the result is a nested, conflicting tooltip. Remove the `EuiToolTip` wrapper and move its message into the `beforeMessage` prop so `EuiCopy`'s built-in tooltip is the single source of truth.
+
+This rule reports the pattern but does not autofix it, because the tooltip's `content` and the existing `beforeMessage` value cannot always be merged safely (e.g. when either is a variable or JSX). Apply the fix manually.
+
+#### Examples
+
+```tsx
+// ✗ Bad - nested tooltips, the child EuiToolTip conflicts with `beforeMessage`
+<EuiCopy textToCopy="some text" beforeMessage="Click to copy">
+  {(copy) => (
+    <EuiToolTip content="Copy me">
+      <EuiButton onClick={copy}>Copy</EuiButton>
+    </EuiToolTip>
+  )}
+</EuiCopy>
+
+// ✓ Good - drop the EuiToolTip wrapper and let `beforeMessage` drive the tooltip
+<EuiCopy textToCopy="some text" beforeMessage="Copy me">
+  {(copy) => <EuiButton onClick={copy}>Copy</EuiButton>}
+</EuiCopy>
+```
+
+When the render-prop child is not an `EuiToolTip`, `beforeMessage` simply configures `EuiCopy`'s own tooltip and the pattern is left untouched.
+
+### `@elastic/eui/button-group-no-invalid-children`
+
+Enforce that `EuiButtonGroup` children (when using the Children API) are valid button components.
+
+Valid direct children are:
+- `variant="default"`: `EuiButton`, `EuiButtonEmpty`, and `EuiButtonIcon`
+
+Besides those button components, these three wrapper components are also allowed: `EuiPopover`, `EuiToolTip` and `EuiCopy`.
+
+#### Examples
+
+```tsx
+// ✗ Bad - non-button elements
+<EuiButtonGroup legend="Actions">
+  <div>Not a button</div>
+  <EuiFlexGroup>...</EuiFlexGroup>
+</EuiButtonGroup>
+
+// ✓ Good - direct buttons
+<EuiButtonGroup legend="Actions">
+  <EuiButton>Save</EuiButton>
+  <EuiButtonEmpty color="text">Cancel</EuiButtonEmpty>
+</EuiButtonGroup>
+
+// ✓ Good - icon button with tooltip
+<EuiButtonGroup legend="Actions">
+  <EuiButton>Save</EuiButton>
+  <EuiToolTip content="Delete">
+    <EuiButtonIcon iconType="trash" aria-label="Delete" />
+  </EuiToolTip>
+</EuiButtonGroup>
+
+// ✓ Good - EuiCopy with render prop (expression or block body)
+<EuiButtonGroup legend="Actions">
+  <EuiCopy textToCopy="text">
+    {(copy) => <EuiButton onClick={copy}>Copy</EuiButton>}
+  </EuiCopy>
+</EuiButtonGroup>
+
+// ✓ Good - .map() with expression or block body
+<EuiButtonGroup legend="Actions">
+  {buttons.map((b) => <EuiButton key={b.id} onClick={b.onClick}>{b.label}</EuiButton>)}
+</EuiButtonGroup>
+
+// ✓ Good - EuiPopover with a button trigger
+<EuiButtonGroup legend="Actions">
+  <EuiPopover
+    button={<EuiButton onClick={togglePopover}>More</EuiButton>}
+    isOpen={isOpen}
+    closePopover={closePopover}
+  >
+    Panel content
+  </EuiPopover>
+</EuiButtonGroup>
+
+// ✓ Good - EuiPopover with an EuiToolTip-wrapped icon trigger
+<EuiButtonGroup legend="Actions">
+  <EuiPopover
+    button={
+      <EuiToolTip content="More options">
+        <EuiButtonIcon iconType="boxesVertical" aria-label="More options" />
+      </EuiToolTip>
+    }
+    isOpen={isOpen}
+    closePopover={closePopover}
+  >
+    Panel content
+  </EuiPopover>
+</EuiButtonGroup>
+```
+
+#### Custom button wrapper components
+
+If a project-specific button component (e.g. `<SaveButton />`) is used as a child and the rule cannot resolve it statically, it reports `invalidUnresolvableChild` which suggests suppressing the rule inline with a comment:
+
+```tsx
+// eslint-disable-next-line @elastic/eui/button-group-no-invalid-children -- SaveButton returns EuiButton
+<SaveButton />
+```
+
 ## Testing
 
 ### Running unit tests

package/lib/cjs/index.js

@@ -7,6 +7,7 @@ var _consistent_is_invalid_props = require("./rules/a11y/consistent_is_invalid_p
 var _href_or_on_click = require("./rules/href_or_on_click");
 var _require_href_for_link = require("./rules/require_href_for_link");
 var _no_css_color = require("./rules/no_css_color");
+var _no_nested_copy_tooltip = require("./rules/a11y/no_nested_copy_tooltip");
 var _no_restricted_eui_imports = require("./rules/no_restricted_eui_imports");
 var _no_static_z_index = require("./rules/no_static_z_index");
 var _no_unnamed_interactive_element = require("./rules/a11y/no_unnamed_interactive_element");
@@ -21,6 +22,8 @@ var _badge_accessibility_rules = require("./rules/a11y/badge_accessibility_rules
 var _icon_accessibility_rules = require("./rules/a11y/icon_accessibility_rules");
 var _tooltip_no_interactive_content = require("./rules/a11y/tooltip_no_interactive_content");
 var _tooltip_button_icon_wrap = require("./rules/a11y/tooltip_button_icon_wrap");
+var _no_deprecated_icon_aliases = require("./rules/no_deprecated_icon_aliases");
+var _button_group_no_invalid_children = require("./rules/button_group_no_invalid_children");
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -37,6 +40,8 @@ const config = {
     'consistent-is-invalid-props': _consistent_is_invalid_props.ConsistentIsInvalidProps,
     'href-or-on-click': _href_or_on_click.HrefOnClick,
     'no-css-color': _no_css_color.NoCssColor,
+    'no-deprecated-icon-aliases': _no_deprecated_icon_aliases.NoDeprecatedIconAliases,
+    'no-nested-copy-tooltip': _no_nested_copy_tooltip.NoNestedCopyTooltip,
     'no-restricted-eui-imports': _no_restricted_eui_imports.NoRestrictedEuiImports,
     'no-static-z-index': _no_static_z_index.NoStaticZIndex,
     'no-unnamed-interactive-element': _no_unnamed_interactive_element.NoUnnamedInteractiveElement,
@@ -51,18 +56,22 @@ const config = {
     'icon-accessibility-rules': _icon_accessibility_rules.EuiIconAccessibilityRules,
     'require-href-for-link': _require_href_for_link.RequireHrefForLink,
     'tooltip-no-interactive-content': _tooltip_no_interactive_content.TooltipNoInteractiveContent,
-    'tooltip-button-icon-wrap': _tooltip_button_icon_wrap.TooltipButtonIconWrap
+    'tooltip-button-icon-wrap': _tooltip_button_icon_wrap.TooltipButtonIconWrap,
+    'button-group-no-invalid-children': _button_group_no_invalid_children.ButtonGroupNoInvalidChildren
   },
   configs: {
     recommended: {
       plugins: ['@elastic/eslint-plugin-eui'],
       rules: {
         '@elastic/eui/accessible-interactive-element': 'warn',
+        '@elastic/eui/button-group-no-invalid-children': 'error',
         '@elastic/eui/callout-announce-on-mount': 'warn',
         '@elastic/eui/callout-prefer-props-for-content': 'warn',
         '@elastic/eui/consistent-is-invalid-props': 'warn',
         '@elastic/eui/href-or-on-click': 'warn',
         '@elastic/eui/no-css-color': 'warn',
+        '@elastic/eui/no-deprecated-icon-aliases': 'warn',
+        '@elastic/eui/no-nested-copy-tooltip': 'warn',
         '@elastic/eui/no-restricted-eui-imports': 'warn',
         '@elastic/eui/no-static-z-index': 'warn',
         '@elastic/eui/no-unnamed-interactive-element': 'warn',

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"no_nested_copy_tooltip.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/no_nested_copy_tooltip.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAsDtE,eAAO,MAAM,mBAAmB,0FA6C/B,CAAC"}

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

@@ -0,0 +1,84 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NoNestedCopyTooltip = void 0;
+var _utils = require("@typescript-eslint/utils");
+var _has_meaningful_attr = require("../../utils/has_meaningful_attr");
+/*
+ * 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 COPY = 'EuiCopy';
+const TOOLTIP = 'EuiToolTip';
+const BEFORE_MESSAGE = 'beforeMessage';
+
+/**
+ * Resolves the JSX element returned by the `EuiCopy` render-prop child.
+ *
+ * `EuiCopy` renders its children through a function (`children(copy)`), so the
+ * "first child" is the root JSX element that function returns. This handles
+ * both implicit arrow returns (`(copy) => <El />`) and block bodies with an
+ * explicit `return` statement. Non-render-prop children (e.g. a leading JSX
+ * comment) are skipped so the render-prop function is still found.
+ */
+function getRenderPropRootElement(node) {
+  const renderProp = node.children.find(child => child.type === 'JSXExpressionContainer' && (child.expression.type === 'ArrowFunctionExpression' || child.expression.type === 'FunctionExpression'));
+  if (!renderProp) return null;
+  const expression = renderProp.expression;
+  let {
+    body
+  } = expression;
+  if (body.type === 'BlockStatement') {
+    const returnStatement = body.body.find(statement => statement.type === 'ReturnStatement');
+    if (!returnStatement?.argument) return null;
+    body = returnStatement.argument;
+  }
+  return body.type === 'JSXElement' ? body : null;
+}
+function isToolTipElement(element) {
+  const {
+    name
+  } = element.openingElement;
+  return name.type === 'JSXIdentifier' && name.name === TOOLTIP;
+}
+const NoNestedCopyTooltip = exports.NoNestedCopyTooltip = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    return {
+      JSXElement(node) {
+        const {
+          openingElement
+        } = node;
+        if (openingElement.name.type !== 'JSXIdentifier' || openingElement.name.name !== COPY) {
+          return;
+        }
+
+        // A statically empty/falsy `beforeMessage` renders no `EuiCopy`
+        // tooltip, so a child `EuiToolTip` is not redundant — skip those.
+        if (!(0, _has_meaningful_attr.hasMeaningfulAttr)(openingElement, BEFORE_MESSAGE)) return;
+        const rootElement = getRenderPropRootElement(node);
+        if (!rootElement || !isToolTipElement(rootElement)) return;
+        context.report({
+          node: rootElement,
+          messageId: 'redundantTooltipWrapper'
+        });
+      }
+    };
+  },
+  meta: {
+    type: 'problem',
+    docs: {
+      description: `Disallow wrapping the ${COPY} render-prop child in an ${TOOLTIP} when \`${BEFORE_MESSAGE}\` is set`
+    },
+    schema: [],
+    messages: {
+      redundantTooltipWrapper: [`${COPY} already wraps its child in an ${TOOLTIP} and uses \`${BEFORE_MESSAGE}\` as that tooltip's content.`, `Wrapping the child in another ${TOOLTIP} creates a nested, conflicting tooltip.`, `Remove the ${TOOLTIP} wrapper and move its message into the \`${BEFORE_MESSAGE}\` prop instead.`].join(' ')
+    }
+  },
+  defaultOptions: []
+});

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

@@ -1 +1 @@
-{"version":3,"file":"tooltip_button_icon_wrap.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/tooltip_button_icon_wrap.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAoCtE,eAAO,MAAM,qBAAqB,qHAiEhC,CAAC"}
+{"version":3,"file":"tooltip_button_icon_wrap.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/tooltip_button_icon_wrap.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA0EtE,eAAO,MAAM,qBAAqB,qHAkEhC,CAAC"}

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

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.TooltipButtonIconWrap = void 0;
 var _utils = require("@typescript-eslint/utils");
 var _has_spread = require("../../utils/has_spread");
+var _has_meaningful_attr = require("../../utils/has_meaningful_attr");
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -16,6 +17,8 @@ var _has_spread = require("../../utils/has_spread");
 
 const BUTTON_ICON = 'EuiButtonIcon';
 const TOOLTIP = 'EuiToolTip';
+const COPY = 'EuiCopy';
+const BEFORE_MESSAGE = 'beforeMessage';
 function isWrappedByTooltip(node) {
   let current = node.parent;
   while (current) {
@@ -41,6 +44,31 @@ function isWrappedByTooltip(node) {
   }
   return false;
 }
+
+/**
+ * `EuiCopy` renders its render-prop child inside its own `EuiToolTip`, but only
+ * when `beforeMessage` is set — that prop is the tooltip's `content`, and
+ * `EuiToolTip` suppresses itself when the content is empty. So an
+ * `EuiButtonIcon` rendered within an `<EuiCopy beforeMessage="…">` already has a
+ * tooltip for sighted users and wrapping it in another `EuiToolTip` would create
+ * nested, conflicting tooltips — see the `no-nested-copy-tooltip` rule. Without
+ * a meaningful `beforeMessage` there is no such tooltip, so the button must
+ * still be wrapped.
+ *
+ * The exemption only applies to buttons in the render-prop output. If the walk
+ * crosses a `JSXAttribute` before reaching the `EuiCopy`, the button lives in a
+ * prop value (e.g. `beforeMessage={<EuiButtonIcon />}`) rather than the child
+ * `EuiCopy` renders, so it is not covered by the built-in tooltip.
+ */
+function isInsideEuiCopyWithBeforeMessage(node) {
+  for (let current = node.parent; current; current = current.parent) {
+    if (current.type === 'JSXAttribute') return false;
+    if (current.type === 'JSXElement' && current.openingElement.name.type === 'JSXIdentifier' && current.openingElement.name.name === COPY) {
+      return (0, _has_meaningful_attr.hasMeaningfulAttr)(current.openingElement, BEFORE_MESSAGE);
+    }
+  }
+  return false;
+}
 const TooltipButtonIconWrap = exports.TooltipButtonIconWrap = _utils.ESLintUtils.RuleCreator.withoutDocs({
   create(context) {
     return {
@@ -63,7 +91,7 @@ const TooltipButtonIconWrap = exports.TooltipButtonIconWrap = _utils.ESLintUtils
           });
           return;
         }
-        if (!isWrappedByTooltip(node) && !(0, _has_spread.hasSpread)(openingElement.attributes)) {
+        if (!isWrappedByTooltip(node) && !isInsideEuiCopyWithBeforeMessage(node) && !(0, _has_spread.hasSpread)(openingElement.attributes)) {
           context.report({
             node: openingElement,
             messageId: 'wrapWithEuiToolTip'

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

@@ -1 +1 @@
-{"version":3,"file":"tooltip_no_interactive_content.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/tooltip_no_interactive_content.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA+DtE,eAAO,MAAM,2BAA2B,uFA8DtC,CAAC"}
+{"version":3,"file":"tooltip_no_interactive_content.d.ts","sourceRoot":"","sources":["../../../../src/rules/a11y/tooltip_no_interactive_content.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA4BtE,eAAO,MAAM,2BAA2B,uFAgFtC,CAAC"}

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

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.TooltipNoInteractiveContent = void 0;
 var _utils = require("@typescript-eslint/utils");
 var _constants = require("../../utils/constants");
+var _walk_jsx_children = require("../../utils/walk_jsx_children");
+var _get_element_name = require("../../utils/get_element_name");
 /*
  * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
  * or more contributor license agreements. Licensed under the Elastic License
@@ -19,46 +21,6 @@ const TOOLTIP_CONTENT_PROPS = ['content', 'title'];
 const INTERACTIVE_HTML_ELEMENTS = ['a', 'button', 'input', 'select', 'textarea'];
 const CONDITIONALLY_INTERACTIVE_SET = new Set(_constants.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS);
 const INTERACTIVE_ELEMENTS = new Set([...INTERACTIVE_HTML_ELEMENTS, ..._constants.INTERACTIVE_EUI_COMPONENTS.filter(c => !CONDITIONALLY_INTERACTIVE_SET.has(c))]);
-function findInteractiveElement(node) {
-  if (node.type === 'JSXElement') {
-    const el = node;
-    const {
-      name
-    } = el.openingElement;
-    if (name.type === 'JSXIdentifier' && INTERACTIVE_ELEMENTS.has(name.name)) {
-      return el.openingElement;
-    }
-    for (const child of el.children) {
-      const found = findInteractiveElement(child);
-      if (found) return found;
-    }
-  } else if (node.type === 'JSXFragment') {
-    for (const child of node.children) {
-      const found = findInteractiveElement(child);
-      if (found) return found;
-    }
-  } else if (node.type === 'JSXExpressionContainer') {
-    const {
-      expression
-    } = node;
-    if (expression.type !== 'JSXEmptyExpression') {
-      return findInteractiveElement(expression);
-    }
-  } else if (node.type === 'LogicalExpression') {
-    const {
-      left,
-      right
-    } = node;
-    return findInteractiveElement(left) ?? findInteractiveElement(right);
-  } else if (node.type === 'ConditionalExpression') {
-    const {
-      consequent,
-      alternate
-    } = node;
-    return findInteractiveElement(consequent) ?? findInteractiveElement(alternate);
-  }
-  return null;
-}
 const TooltipNoInteractiveContent = exports.TooltipNoInteractiveContent = _utils.ESLintUtils.RuleCreator.withoutDocs({
   create(context) {
     return {
@@ -83,18 +45,28 @@ const TooltipNoInteractiveContent = exports.TooltipNoInteractiveContent = _utils
           if (expression.type === 'JSXEmptyExpression') {
             continue;
           }
-          const interactiveEl = findInteractiveElement(expression);
-          if (interactiveEl) {
+          let found = false;
+          (0, _walk_jsx_children.walkJsxChildren)(expression, leaf => {
+            if (found || leaf.type !== 'JSXElement') return;
+            const el = leaf;
+            const name = (0, _get_element_name.getElementName)(el.openingElement);
+            if (!name || !INTERACTIVE_ELEMENTS.has(name)) return;
             context.report({
-              node: interactiveEl,
+              node: el.openingElement,
               messageId: 'noInteractiveContent',
               data: {
                 propName: attr.name.name,
                 componentName,
-                elementName: interactiveEl.name.name
+                elementName: name
               }
             });
-          }
+            found = true;
+          }, {
+            shouldSkip: el => {
+              const name = (0, _get_element_name.getElementName)(el.openingElement);
+              return !name || !INTERACTIVE_ELEMENTS.has(name);
+            }
+          });
         }
       }
     };

package/lib/cjs/rules/button_group_no_invalid_children.d.ts

@@ -0,0 +1,3 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+export declare const ButtonGroupNoInvalidChildren: TSESLint.RuleModule<"invalidUnresolvableWrapperChild" | "invalidWrapperChild" | "invalidChild" | "invalidUnresolvableChild" | "invalidPopoverButton" | "invalidUnresolvablePopoverButton", [], unknown, TSESLint.RuleListener>;
+//# sourceMappingURL=button_group_no_invalid_children.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"button_group_no_invalid_children.d.ts","sourceRoot":"","sources":["../../../src/rules/button_group_no_invalid_children.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAwDlC,eAAO,MAAM,4BAA4B,gOAuLxC,CAAC"}

package/lib/cjs/rules/button_group_no_invalid_children.js

@@ -0,0 +1,159 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ButtonGroupNoInvalidChildren = void 0;
+var _utils = require("@typescript-eslint/utils");
+var _has_spread = require("../utils/has_spread");
+var _flat_map = require("../utils/flat_map");
+var _get_element_name = require("../utils/get_element_name");
+var _walk_jsx_children = require("../utils/walk_jsx_children");
+var _get_attr_value = require("../utils/get_attr_value");
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+
+const BUTTON_GROUP = 'EuiButtonGroup';
+const VALID_BUTTONS = new Set(['EuiButton', 'EuiButtonEmpty', 'EuiButtonIcon']);
+const VALID_WRAPPERS = new Set(['EuiToolTip', 'EuiPopover', 'EuiCopy']);
+const VALID_BUTTONS_LIST = Array.from(VALID_BUTTONS).join(', ');
+const VALID_WRAPPERS_LIST = Array.from(VALID_WRAPPERS).join(', ');
+function isCustomComponent(name) {
+  return name[0] === name[0].toUpperCase();
+}
+function collectJsxChildren(node, sourceCode) {
+  const results = [];
+  (0, _walk_jsx_children.walkJsxChildren)(node, leaf => {
+    if (leaf.type === 'JSXElement') {
+      results.push(leaf);
+    }
+  }, {
+    sourceCode
+  });
+  return results;
+}
+function reportInvalidWrapperChildren(wrapper, wrapperName, context) {
+  const children = (0, _flat_map.flatMap)(wrapper.children, c => collectJsxChildren(c, context.sourceCode));
+  for (const wrapperChild of children) {
+    if ((0, _has_spread.hasSpread)(wrapperChild.openingElement.attributes)) continue;
+    const wrapperChildName = (0, _get_element_name.getElementName)(wrapperChild.openingElement);
+    if (wrapperChildName === null || VALID_BUTTONS.has(wrapperChildName)) continue;
+    context.report({
+      node: wrapperChild.openingElement,
+      messageId: isCustomComponent(wrapperChildName) ? 'invalidUnresolvableWrapperChild' : 'invalidWrapperChild',
+      data: {
+        name: wrapperChildName,
+        wrapper: wrapperName
+      }
+    });
+  }
+}
+const ButtonGroupNoInvalidChildren = exports.ButtonGroupNoInvalidChildren = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    return {
+      JSXElement(node) {
+        const {
+          openingElement
+        } = node;
+        if (openingElement.name.type !== 'JSXIdentifier' || openingElement.name.name !== BUTTON_GROUP) {
+          return;
+        }
+
+        // Only validate when the variant is "default" (or absent — the default).
+        // Rules for "segmented" and "selection" are added in later chunks.
+        // Dynamic variant values (variables) are conservatively skipped.
+        const variant = (0, _get_attr_value.findAttrValue)(context, openingElement.attributes, 'variant');
+        if (variant !== undefined && variant !== 'default') return;
+        const children = (0, _flat_map.flatMap)(node.children, c => collectJsxChildren(c, context.sourceCode));
+        if (children.length === 0) return;
+        for (const child of children) {
+          const name = (0, _get_element_name.getElementName)(child.openingElement);
+          if (name === null) continue;
+          if (VALID_BUTTONS.has(name)) continue;
+          if (VALID_WRAPPERS.has(name)) {
+            if (name === 'EuiToolTip') {
+              // Validate JSX children (expanding fragments/conditionals).
+              reportInvalidWrapperChildren(child, name, context);
+            } else if (name === 'EuiPopover') {
+              // The trigger is the `button` prop, not JSX children (panel
+              // content). The prop value may be a JSXExpressionContainer or
+              // a bare JSX element; collectJsxChildren handles both.
+              // EuiToolTip wrapping the trigger button is also supported.
+              const buttonProp = child.openingElement.attributes.find(attr => attr.type === 'JSXAttribute' && attr.name.type === 'JSXIdentifier' && attr.name.name === 'button');
+              if (buttonProp?.value != null) {
+                const triggerElements = collectJsxChildren(buttonProp.value, context.sourceCode);
+                for (const triggerElement of triggerElements) {
+                  if ((0, _has_spread.hasSpread)(triggerElement.openingElement.attributes)) continue;
+                  const triggerElementName = (0, _get_element_name.getElementName)(triggerElement.openingElement);
+                  if (triggerElementName === null || VALID_BUTTONS.has(triggerElementName)) continue;
+                  if (triggerElementName === 'EuiToolTip') {
+                    // EuiToolTip wrapping the trigger — validate its children.
+                    const tooltipChildren = (0, _flat_map.flatMap)(triggerElement.children, c => collectJsxChildren(c, context.sourceCode));
+                    for (const tooltipChild of tooltipChildren) {
+                      if ((0, _has_spread.hasSpread)(tooltipChild.openingElement.attributes)) continue;
+                      const tooltipChildName = (0, _get_element_name.getElementName)(tooltipChild.openingElement);
+                      if (tooltipChildName === null || VALID_BUTTONS.has(tooltipChildName)) continue;
+                      context.report({
+                        node: tooltipChild.openingElement,
+                        messageId: isCustomComponent(tooltipChildName) ? 'invalidUnresolvablePopoverButton' : 'invalidPopoverButton',
+                        data: {
+                          name: tooltipChildName
+                        }
+                      });
+                    }
+                    continue;
+                  }
+                  context.report({
+                    node: triggerElement.openingElement,
+                    messageId: isCustomComponent(triggerElementName) ? 'invalidUnresolvablePopoverButton' : 'invalidPopoverButton',
+                    data: {
+                      name: triggerElementName
+                    }
+                  });
+                }
+              }
+            } else if (name === 'EuiCopy') {
+              // Children is a render prop: {(copy) => <EuiButton />}
+              // ArrowFunctionExpression with expression body is expanded by
+              // collectJsxChildren, so validation works the same as EuiToolTip.
+              reportInvalidWrapperChildren(child, name, context);
+            }
+            continue;
+          }
+
+          // For elements that aren't known valid buttons or wrappers, a spread
+          // prevents static classification; skip conservatively.
+          if ((0, _has_spread.hasSpread)(child.openingElement.attributes)) continue;
+          context.report({
+            node: child.openingElement,
+            messageId: isCustomComponent(name) ? 'invalidUnresolvableChild' : 'invalidChild',
+            data: {
+              name
+            }
+          });
+        }
+      }
+    };
+  },
+  meta: {
+    type: 'problem',
+    docs: {
+      description: `Enforce that EuiButtonGroup children are ${VALID_BUTTONS_LIST}, or a supported wrapper (${VALID_WRAPPERS_LIST})`
+    },
+    schema: [],
+    messages: {
+      invalidChild: [`{{ name }} is not a valid child of EuiButtonGroup.`, `Allowed children: ${VALID_BUTTONS_LIST}.`, `Allowed wrappers: ${VALID_WRAPPERS_LIST}.`].join(' '),
+      invalidUnresolvableChild: [`{{ name }} cannot be verified as a valid child of EuiButtonGroup.`, `Allowed children: ${VALID_BUTTONS_LIST}.`, `Allowed wrappers: ${VALID_WRAPPERS_LIST}.`, `If {{ name }} is a shared button wrapper component only containing`, `valid button children, suppress this rule inline with a comment`, `explaining why it's valid.`, `// eslint-disable-next-line @elastic/eui/button-group-no-invalid-children -- SaveButton only wraps EuiButton`].join(' '),
+      invalidPopoverButton: [`{{ name }} is not a valid trigger button for EuiPopover in EuiButtonGroup.`, `The \`button\` prop must be ${VALID_BUTTONS_LIST}.`].join(' '),
+      invalidUnresolvablePopoverButton: [`{{ name }} cannot be verified as a valid trigger button for EuiPopover in EuiButtonGroup.`, `The \`button\` prop must be ${VALID_BUTTONS_LIST}.`, `If {{ name }} is a shared button wrapper component only containing`, `valid button children, suppress this rule inline with a comment`, `explaining why it's valid.`, `// eslint-disable-next-line @elastic/eui/button-group-no-invalid-children -- SaveButton only wraps EuiButton`].join(' '),
+      invalidWrapperChild: [`{{ name }} inside {{ wrapper }} is not a valid button for EuiButtonGroup.`, `The wrapper must contain ${VALID_BUTTONS_LIST}.`].join(' '),
+      invalidUnresolvableWrapperChild: [`{{ name }} inside {{ wrapper }} cannot be verified as a valid button for EuiButtonGroup.`, `The wrapper must contain ${VALID_BUTTONS_LIST}.`, `If {{ name }} is a shared button wrapper component, suppress this rule inline`, `with a comment explaining why it renders valid button children:`, `// eslint-disable-next-line @elastic/eui/button-group-no-invalid-children -- SaveButton wraps EuiButton`].join(' ')
+    }
+  },
+  defaultOptions: []
+});

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

@@ -1 +1 @@
-{"version":3,"file":"callout_prefer_props_for_content.d.ts","sourceRoot":"","sources":["../../../src/rules/callout_prefer_props_for_content.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAqBtE,KAAK,UAAU,GACX,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAC1B,KAAK,OAAO,GAAG,CAAC;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAsI3C,eAAO,MAAM,4BAA4B,gFAyExC,CAAC"}
+{"version":3,"file":"callout_prefer_props_for_content.d.ts","sourceRoot":"","sources":["../../../src/rules/callout_prefer_props_for_content.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAoBtE,KAAK,UAAU,GACX,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAC1B,KAAK,OAAO,GAAG,CAAC;IAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAE3C,eAAO,MAAM,4BAA4B,gFA2JvC,CAAC"}