@elastic/eslint-plugin-eui 2.14.1 → 2.15.0

package/README.md

@@ -157,6 +157,57 @@ Ensure that all radio input components (`EuiRadio`, `EuiRadioGroup`) have a `nam
 
 Ensure 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/callout-prefer-props-for-content`
+
+Enforce correct usage of `EuiCallOut` `text` and `actionProps` props and discourage using `children` for content.
+
+`EuiCallOut` accepts dedicated `text` and `actionProps` props introduced to standardize callout content:
+
+- **Text content** (plain text, `<p>`, `<span>`, `<strong>`, etc. or EUI text components like `EuiText`) should be passed via the `text` prop.
+- **Action elements** (buttons and non-inline links) should be passed via `actionProps`, which renders standardized primary and secondary action buttons.
+
+The rule warns (rather than errors) to allow incremental migration from the `children` pattern.
+
+#### Examples
+
+```tsx
+// ✗ Flagged — text content via children
+<EuiCallOut title="Title">
+  <p>Callout body text.</p>
+</EuiCallOut>
+
+// ✓ Good
+<EuiCallOut title="Title" text={<p>Callout body text.</p>} />
+```
+
+```tsx
+// ✗ Flagged — action button via children
+<EuiCallOut title="Title">
+  <EuiButton onClick={onClick}>Take action</EuiButton>
+</EuiCallOut>
+
+// ✓ Good
+<EuiCallOut
+  title="Title"
+  actionProps={{ primary: { children: 'Take action', onClick: onClick } }}
+/>
+```
+
+The rule traverses fragments (`<>`, `<React.Fragment>`, `<Fragment>`), layout containers (`EuiFlexGroup`, `EuiFlexGrid`, `EuiFlexItem`, `div`), and conditional/logical expressions. It does not traverse custom component children, since their content cannot be statically analyzed.
+
+#### Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `components` | `string[]` | `['EuiCallOut']` | Component names to check. Replaces the default — include `'EuiCallOut'` explicitly if you also want to keep checking it. |
+
+```js
+// .eslintrc.js
+'@elastic/eui/callout-prefer-props-for-content': ['warn', {
+  components: ['EuiCallOut', 'KbnWarningCallout'],
+}]
+```
+
 ### `@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.

package/lib/cjs/index.js

@@ -2,6 +2,7 @@
 
 var _accessible_interactive_element = require("./rules/a11y/accessible_interactive_element");
 var _callout_announce_on_mount = require("./rules/a11y/callout_announce_on_mount");
+var _callout_prefer_props_for_content = require("./rules/callout_prefer_props_for_content");
 var _consistent_is_invalid_props = require("./rules/a11y/consistent_is_invalid_props");
 var _href_or_on_click = require("./rules/href_or_on_click");
 var _require_href_for_link = require("./rules/require_href_for_link");
@@ -32,6 +33,7 @@ const config = {
   rules: {
     'accessible-interactive-element': _accessible_interactive_element.AccessibleInteractiveElements,
     'callout-announce-on-mount': _callout_announce_on_mount.CallOutAnnounceOnMount,
+    'callout-prefer-props-for-content': _callout_prefer_props_for_content.CallOutPreferPropsForContent,
     '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,
@@ -57,6 +59,7 @@ const config = {
       rules: {
         '@elastic/eui/accessible-interactive-element': 'warn',
         '@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',

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

@@ -0,0 +1,8 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+type MessageIds = 'childrenHavePlainText' | 'childrenHaveText' | 'childrenHaveActions';
+type Options = [{
+    components?: string[];
+}];
+export declare const CallOutPreferPropsForContent: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener>;
+export {};
+//# sourceMappingURL=callout_prefer_props_for_content.d.ts.map

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

@@ -0,0 +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"}

package/lib/cjs/rules/callout_prefer_props_for_content.js

@@ -0,0 +1,219 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CallOutPreferPropsForContent = void 0;
+var _utils = require("@typescript-eslint/utils");
+var _constants = require("../utils/constants");
+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
+ * 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_COMPONENTS = ['EuiCallOut'];
+const EUI_ACTION_COMPONENTS = new Set(_constants.INTERACTIVE_EUI_COMPONENTS.filter(c => c.startsWith('EuiButton') || c === 'EuiLink'));
+/**
+ * Recursively checks a node for text or action elements that should not be in callout children.
+ * It unwraps fragments, layout containers, conditional expressions, and logical expressions.
+ * It does NOT traverse into custom/complex component children.
+ */
+function checkNode(node, context, componentName) {
+  switch (node.type) {
+    case 'JSXText':
+      {
+        // Plain string content
+        if (node.value.trim().length > 0) {
+          context.report({
+            node,
+            messageId: 'childrenHavePlainText',
+            data: {
+              componentName
+            }
+          });
+        }
+        break;
+      }
+    case 'Literal':
+      {
+        const {
+          value
+        } = node;
+        if (typeof value === 'string' && value.trim().length > 0) {
+          context.report({
+            node,
+            messageId: 'childrenHavePlainText',
+            data: {
+              componentName
+            }
+          });
+        }
+        break;
+      }
+    case 'JSXElement':
+      {
+        const el = node;
+        const {
+          name
+        } = el.openingElement;
+        if (name.type === 'JSXMemberExpression' && name.object.type === 'JSXIdentifier' && name.object.name === 'React' && name.property.type === 'JSXIdentifier' && name.property.name === 'Fragment') {
+          for (const child of el.children) {
+            checkNode(child, context, componentName);
+          }
+          break;
+        }
+        const elementName = (0, _get_element_name.getElementName)(el.openingElement);
+        if (!elementName) return;
+        if (_constants.HTML_TEXT_ELEMENTS.has(elementName) || _constants.EUI_TEXT_COMPONENTS.has(elementName) || _constants.I18N_TEXT_COMPONENTS.has(elementName)) {
+          context.report({
+            node,
+            messageId: 'childrenHaveText',
+            data: {
+              elementName,
+              componentName
+            }
+          });
+        } else if (_constants.HTML_ACTION_ELEMENTS.has(elementName) || EUI_ACTION_COMPONENTS.has(elementName)) {
+          context.report({
+            node,
+            messageId: 'childrenHaveActions',
+            data: {
+              elementName,
+              componentName
+            }
+          });
+        } else if (_constants.CALLOUT_LAYOUT_CONTAINERS.has(elementName)) {
+          // Transparent layout wrapper, traverse its children
+          for (const child of el.children) {
+            checkNode(child, context, componentName);
+          }
+        }
+
+        // Custom/complex component, don't traverse its children
+        break;
+      }
+    case 'JSXFragment':
+      {
+        for (const child of node.children) {
+          checkNode(child, context, componentName);
+        }
+        break;
+      }
+    case 'MemberExpression':
+      {
+        const {
+          object
+        } = node;
+        if (object.type === 'Identifier' && object.name === 'i18n') {
+          context.report({
+            node,
+            messageId: 'childrenHavePlainText',
+            data: {
+              componentName
+            }
+          });
+        }
+        break;
+      }
+    case 'TemplateLiteral':
+      {
+        context.report({
+          node,
+          messageId: 'childrenHavePlainText',
+          data: {
+            componentName
+          }
+        });
+        break;
+      }
+    case 'ArrayExpression':
+      {
+        for (const element of node.elements) {
+          if (element) checkNode(element, context, componentName);
+        }
+        break;
+      }
+    case 'JSXExpressionContainer':
+      {
+        const {
+          expression
+        } = node;
+        if (expression.type !== 'JSXEmptyExpression') {
+          checkNode(expression, context, componentName);
+        }
+        break;
+      }
+    case 'LogicalExpression':
+      {
+        const {
+          left,
+          right
+        } = node;
+        checkNode(left, context, componentName);
+        checkNode(right, context, componentName);
+        break;
+      }
+    case 'ConditionalExpression':
+      {
+        // e.g. {condition ? <p>text</p> : null}
+        const {
+          consequent,
+          alternate
+        } = node;
+        checkNode(consequent, context, componentName);
+        checkNode(alternate, context, componentName);
+        break;
+      }
+    default:
+      break;
+  }
+}
+const CallOutPreferPropsForContent = exports.CallOutPreferPropsForContent = _utils.ESLintUtils.RuleCreator.withoutDocs({
+  create(context) {
+    const components = new Set(context.options[0]?.components ?? DEFAULT_COMPONENTS);
+    return {
+      JSXElement(node) {
+        const {
+          openingElement,
+          children
+        } = node;
+        if (openingElement.name.type !== 'JSXIdentifier' || !components.has(openingElement.name.name)) {
+          return;
+        }
+        for (const child of children) {
+          checkNode(child, context, openingElement.name.name);
+        }
+      }
+    };
+  },
+  meta: {
+    type: 'suggestion',
+    docs: {
+      description: ['Enforce correct usage of `text` and `actionProps` props and discourage using `children` for content.', 'Text elements should be passed via the `text` prop.', 'Action elements (buttons, links) should be passed via `actionProps` instead.'].join(' ')
+    },
+    schema: [{
+      type: 'object',
+      properties: {
+        components: {
+          type: 'array',
+          items: {
+            type: 'string',
+            minLength: 1
+          },
+          minItems: 1
+        }
+      },
+      additionalProperties: false
+    }],
+    messages: {
+      childrenHavePlainText: ['Plain text passed as `children` of `{{componentName}}` should be moved to the `text` prop instead.', 'Example:', '  <{{componentName}} title="Callout title" text="Callout text content" />'].join('\n'),
+      childrenHaveText: ['`<{{elementName}}>` passed as `children` of `{{componentName}}` should be moved to the `text` prop instead.', 'The `text` prop accepts string text, block text elements (e.g. `<p>`) or inline elements (e.g. `<span>`, `<strong>`, `<em>`).', 'Use `children` only for complex non-text content that cannot be expressed via `text`.', 'Example:', '  <{{componentName}} title="Callout title" text={<p>Callout text content</p>} />'].join('\n'),
+      childrenHaveActions: ['`<{{elementName}}>` passed as `children` of `{{componentName}}` should be moved to the `actionProps` prop instead.', 'Use `actionProps` to render standardized primary or secondary action buttons, including buttons-as-links via `href`.', 'If a link is part of inline copy, move the surrounding content to the `text` prop instead.', 'Example:', '  <{{componentName}}', '    title="Callout title"', '    actionProps={{ primary: { children: "Primary action", onClick: onClick }, secondary: { children: "Secondary action", href: "/"} }}', '  />'].join('\n')
+    }
+  },
+  defaultOptions: [{}]
+});

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

@@ -31,4 +31,18 @@ export declare const INTERACTIVE_EUI_COMPONENTS: string[];
  * exclude these.
  */
 export declare const CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS: string[];
+export declare const HTML_TEXT_ELEMENTS: Set<string>;
+export declare const EUI_TEXT_COMPONENTS: Set<string>;
+export declare const HTML_ACTION_ELEMENTS: Set<string>;
+/**
+ * Transparent layout wrappers inside `EuiCallOut` children that the rule should
+ * traverse rather than treat as opaque custom components.
+ */
+export declare const CALLOUT_LAYOUT_CONTAINERS: Set<string>;
+/**
+ * Third-party i18n components that render plain text and are common in EUI consumers
+ * (e.g. `FormattedMessage` from react-intl used extensively in Kibana).
+ * Rules treat these the same as `HTML_TEXT_ELEMENTS` / `EUI_TEXT_COMPONENTS`.
+ */
+export declare const I18N_TEXT_COMPONENTS: Set<string>;
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +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,UA8CtC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wCAAwC,UAIpD,CAAC"}
+{"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,UA8CtC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wCAAwC,UAIpD,CAAC;AAEF,eAAO,MAAM,kBAAkB,aAS7B,CAAC;AAEH,eAAO,MAAM,mBAAmB,aAO9B,CAAC;AAEH,eAAO,MAAM,oBAAoB,aAA2B,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAMpC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,aAAgC,CAAC"}

package/lib/cjs/utils/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.NON_INTERACTIVE_HTML_TAGS = exports.INTERACTIVE_EUI_COMPONENTS = exports.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = void 0;
+exports.NON_INTERACTIVE_HTML_TAGS = exports.INTERACTIVE_EUI_COMPONENTS = exports.I18N_TEXT_COMPONENTS = exports.HTML_TEXT_ELEMENTS = exports.HTML_ACTION_ELEMENTS = exports.EUI_TEXT_COMPONENTS = exports.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = exports.CALLOUT_LAYOUT_CONTAINERS = 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
@@ -46,4 +46,20 @@ const INTERACTIVE_EUI_COMPONENTS = exports.INTERACTIVE_EUI_COMPONENTS = ['EuiBad
  * so rules that need to distinguish unconditionally-interactive components should
  * exclude these.
  */
-const CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = exports.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = ['EuiBadge', 'EuiBetaBadge', 'EuiCard'];
+const CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = exports.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = ['EuiBadge', 'EuiBetaBadge', 'EuiCard'];
+const HTML_TEXT_ELEMENTS = exports.HTML_TEXT_ELEMENTS = new Set(['p', 'span', 'strong', 'em', 'b', 'i', 'small', 'code']);
+const EUI_TEXT_COMPONENTS = exports.EUI_TEXT_COMPONENTS = new Set(['EuiText', 'EuiTextColor', 'EuiTextAlign', 'EuiCode', 'EuiMark', 'EuiHighlight']);
+const HTML_ACTION_ELEMENTS = exports.HTML_ACTION_ELEMENTS = new Set(['button', 'a']);
+
+/**
+ * Transparent layout wrappers inside `EuiCallOut` children that the rule should
+ * traverse rather than treat as opaque custom components.
+ */
+const CALLOUT_LAYOUT_CONTAINERS = exports.CALLOUT_LAYOUT_CONTAINERS = new Set(['Fragment', 'EuiFlexGroup', 'EuiFlexGrid', 'EuiFlexItem', 'div']);
+
+/**
+ * Third-party i18n components that render plain text and are common in EUI consumers
+ * (e.g. `FormattedMessage` from react-intl used extensively in Kibana).
+ * Rules treat these the same as `HTML_TEXT_ELEMENTS` / `EUI_TEXT_COMPONENTS`.
+ */
+const I18N_TEXT_COMPONENTS = exports.I18N_TEXT_COMPONENTS = new Set(['FormattedMessage']);

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

@@ -0,0 +1,3 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export declare function getElementName(openingElement: TSESTree.JSXOpeningElement): string | null;
+//# sourceMappingURL=get_element_name.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_element_name.d.ts","sourceRoot":"","sources":["../../../src/utils/get_element_name.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,wBAAgB,cAAc,CAC5B,cAAc,EAAE,QAAQ,CAAC,iBAAiB,GACzC,MAAM,GAAG,IAAI,CAMf"}

package/lib/cjs/utils/get_element_name.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getElementName = getElementName;
+/*
+ * 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 getElementName(openingElement) {
+  const {
+    name
+  } = openingElement;
+  if (name.type === 'JSXIdentifier') return name.name;
+  return null;
+}

package/lib/esm/index.js

@@ -9,6 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const accessible_interactive_element_1 = require("./rules/a11y/accessible_interactive_element");
 const callout_announce_on_mount_1 = require("./rules/a11y/callout_announce_on_mount");
+const callout_prefer_props_for_content_1 = require("./rules/callout_prefer_props_for_content");
 const consistent_is_invalid_props_1 = require("./rules/a11y/consistent_is_invalid_props");
 const href_or_on_click_1 = require("./rules/href_or_on_click");
 const require_href_for_link_1 = require("./rules/require_href_for_link");
@@ -31,6 +32,7 @@ const config = {
     rules: {
         'accessible-interactive-element': accessible_interactive_element_1.AccessibleInteractiveElements,
         'callout-announce-on-mount': callout_announce_on_mount_1.CallOutAnnounceOnMount,
+        'callout-prefer-props-for-content': callout_prefer_props_for_content_1.CallOutPreferPropsForContent,
         'consistent-is-invalid-props': consistent_is_invalid_props_1.ConsistentIsInvalidProps,
         'href-or-on-click': href_or_on_click_1.HrefOnClick,
         'no-css-color': no_css_color_1.NoCssColor,
@@ -56,6 +58,7 @@ const config = {
             rules: {
                 '@elastic/eui/accessible-interactive-element': 'warn',
                 '@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',

package/lib/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAEH,gGAA4F;AAC5F,sFAAgF;AAChF,0FAAoF;AACpF,+DAAuD;AACvD,yEAAmE;AACnE,uDAAkD;AAClD,iFAA2E;AAC3E,iEAA2D;AAC3D,gGAA0F;AAC1F,gFAA0E;AAC1E,0EAAoE;AACpE,8FAAuF;AACvF,8EAAyE;AACzE,wFAA4F;AAC5F,oFAA+E;AAC/E,iHAAyG;AACzG,sFAAoF;AACpF,oFAAkF;AAClF,gGAA0F;AAC1F,oFAA8E;AAE9E,MAAM,MAAM,GAAG;IACb,KAAK,EAAE;QACL,gCAAgC,EAAE,8DAA6B;QAC/D,2BAA2B,EAAE,kDAAsB;QACnD,6BAA6B,EAAE,sDAAwB;QACvD,kBAAkB,EAAE,8BAAW;QAC/B,cAAc,EAAE,yBAAU;QAC1B,2BAA2B,EAAE,kDAAsB;QACnD,mBAAmB,EAAE,kCAAc;QACnC,gCAAgC,EAAE,4DAA2B;QAC7D,wBAAwB,EAAE,4CAAmB;QAC7C,qBAAqB,EAAE,sCAAgB;QACvC,+BAA+B,EAAE,yDAAyB;QAC1D,uBAAuB,EAAE,2CAAmB;QAC5C,4BAA4B,EAAE,8DAAiC;QAC/D,0BAA0B,EAAE,iDAAsB;QAClD,2CAA2C,EACzC,gFAAoC;QACtC,2BAA2B,EAAE,sDAA0B;QACvD,0BAA0B,EAAE,oDAAyB;QACrD,uBAAuB,EAAE,0CAAkB;QAC3C,gCAAgC,EAAE,4DAA2B;QAC7D,0BAA0B,EAAE,gDAAqB;KAClD;IACD,OAAO,EAAE;QACP,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,4BAA4B,CAAC;YACvC,KAAK,EAAE;gBACL,6CAA6C,EAAE,MAAM;gBACrD,wCAAwC,EAAE,MAAM;gBAChD,0CAA0C,EAAE,MAAM;gBAClD,+BAA+B,EAAE,MAAM;gBACvC,2BAA2B,EAAE,MAAM;gBACnC,wCAAwC,EAAE,MAAM;gBAChD,gCAAgC,EAAE,MAAM;gBACxC,6CAA6C,EAAE,MAAM;gBACrD,qCAAqC,EAAE,MAAM;gBAC7C,kCAAkC,EAAE,MAAM;gBAC1C,4CAA4C,EAAE,MAAM;gBACpD,oCAAoC,EAAE,MAAM;gBAC5C,yCAAyC,EAAE,MAAM;gBACjD,uCAAuC,EAAE,MAAM;gBAC/C,wDAAwD,EAAE,MAAM;gBAChE,wCAAwC,EAAE,MAAM;gBAChD,uCAAuC,EAAE,MAAM;gBAC/C,oCAAoC,EAAE,MAAM;gBAC5C,6CAA6C,EAAE,MAAM;gBACrD,uCAAuC,EAAE,MAAM;aAChD;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;;AAEH,gGAA4F;AAC5F,sFAAgF;AAChF,+FAAwF;AACxF,0FAAoF;AACpF,+DAAuD;AACvD,yEAAmE;AACnE,uDAAkD;AAClD,iFAA2E;AAC3E,iEAA2D;AAC3D,gGAA0F;AAC1F,gFAA0E;AAC1E,0EAAoE;AACpE,8FAAuF;AACvF,8EAAyE;AACzE,wFAA4F;AAC5F,oFAA+E;AAC/E,iHAAyG;AACzG,sFAAoF;AACpF,oFAAkF;AAClF,gGAA0F;AAC1F,oFAA8E;AAE9E,MAAM,MAAM,GAAG;IACb,KAAK,EAAE;QACL,gCAAgC,EAAE,8DAA6B;QAC/D,2BAA2B,EAAE,kDAAsB;QACnD,kCAAkC,EAAE,+DAA4B;QAChE,6BAA6B,EAAE,sDAAwB;QACvD,kBAAkB,EAAE,8BAAW;QAC/B,cAAc,EAAE,yBAAU;QAC1B,2BAA2B,EAAE,kDAAsB;QACnD,mBAAmB,EAAE,kCAAc;QACnC,gCAAgC,EAAE,4DAA2B;QAC7D,wBAAwB,EAAE,4CAAmB;QAC7C,qBAAqB,EAAE,sCAAgB;QACvC,+BAA+B,EAAE,yDAAyB;QAC1D,uBAAuB,EAAE,2CAAmB;QAC5C,4BAA4B,EAAE,8DAAiC;QAC/D,0BAA0B,EAAE,iDAAsB;QAClD,2CAA2C,EACzC,gFAAoC;QACtC,2BAA2B,EAAE,sDAA0B;QACvD,0BAA0B,EAAE,oDAAyB;QACrD,uBAAuB,EAAE,0CAAkB;QAC3C,gCAAgC,EAAE,4DAA2B;QAC7D,0BAA0B,EAAE,gDAAqB;KAClD;IACD,OAAO,EAAE;QACP,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,4BAA4B,CAAC;YACvC,KAAK,EAAE;gBACL,6CAA6C,EAAE,MAAM;gBACrD,wCAAwC,EAAE,MAAM;gBAChD,+CAA+C,EAAE,MAAM;gBACvD,0CAA0C,EAAE,MAAM;gBAClD,+BAA+B,EAAE,MAAM;gBACvC,2BAA2B,EAAE,MAAM;gBACnC,wCAAwC,EAAE,MAAM;gBAChD,gCAAgC,EAAE,MAAM;gBACxC,6CAA6C,EAAE,MAAM;gBACrD,qCAAqC,EAAE,MAAM;gBAC7C,kCAAkC,EAAE,MAAM;gBAC1C,4CAA4C,EAAE,MAAM;gBACpD,oCAAoC,EAAE,MAAM;gBAC5C,yCAAyC,EAAE,MAAM;gBACjD,uCAAuC,EAAE,MAAM;gBAC/C,wDAAwD,EAAE,MAAM;gBAChE,wCAAwC,EAAE,MAAM;gBAChD,uCAAuC,EAAE,MAAM;gBAC/C,oCAAoC,EAAE,MAAM;gBAC5C,6CAA6C,EAAE,MAAM;gBACrD,uCAAuC,EAAE,MAAM;aAChD;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC"}

package/lib/esm/rules/callout_prefer_props_for_content.d.ts

@@ -0,0 +1,7 @@
+import { ESLintUtils } from '@typescript-eslint/utils';
+type MessageIds = 'childrenHavePlainText' | 'childrenHaveText' | 'childrenHaveActions';
+type Options = [{
+    components?: string[];
+}];
+export declare const CallOutPreferPropsForContent: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener>;
+export {};

package/lib/esm/rules/callout_prefer_props_for_content.js

@@ -0,0 +1,192 @@
+"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.CallOutPreferPropsForContent = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const constants_1 = require("../utils/constants");
+const get_element_name_1 = require("../utils/get_element_name");
+const DEFAULT_COMPONENTS = ['EuiCallOut'];
+const EUI_ACTION_COMPONENTS = new Set(constants_1.INTERACTIVE_EUI_COMPONENTS.filter((c) => c.startsWith('EuiButton') || c === 'EuiLink'));
+/**
+ * Recursively checks a node for text or action elements that should not be in callout children.
+ * It unwraps fragments, layout containers, conditional expressions, and logical expressions.
+ * It does NOT traverse into custom/complex component children.
+ */
+function checkNode(node, context, componentName) {
+    switch (node.type) {
+        case 'JSXText': {
+            // Plain string content
+            if (node.value.trim().length > 0) {
+                context.report({ node, messageId: 'childrenHavePlainText', data: { componentName } });
+            }
+            break;
+        }
+        case 'Literal': {
+            const { value } = node;
+            if (typeof value === 'string' && value.trim().length > 0) {
+                context.report({ node, messageId: 'childrenHavePlainText', data: { componentName } });
+            }
+            break;
+        }
+        case 'JSXElement': {
+            const el = node;
+            const { name } = el.openingElement;
+            if (name.type === 'JSXMemberExpression' &&
+                name.object.type === 'JSXIdentifier' &&
+                name.object.name === 'React' &&
+                name.property.type === 'JSXIdentifier' &&
+                name.property.name === 'Fragment') {
+                for (const child of el.children) {
+                    checkNode(child, context, componentName);
+                }
+                break;
+            }
+            const elementName = (0, get_element_name_1.getElementName)(el.openingElement);
+            if (!elementName)
+                return;
+            if (constants_1.HTML_TEXT_ELEMENTS.has(elementName) ||
+                constants_1.EUI_TEXT_COMPONENTS.has(elementName) ||
+                constants_1.I18N_TEXT_COMPONENTS.has(elementName)) {
+                context.report({
+                    node,
+                    messageId: 'childrenHaveText',
+                    data: { elementName, componentName },
+                });
+            }
+            else if (constants_1.HTML_ACTION_ELEMENTS.has(elementName) ||
+                EUI_ACTION_COMPONENTS.has(elementName)) {
+                context.report({
+                    node,
+                    messageId: 'childrenHaveActions',
+                    data: { elementName, componentName },
+                });
+            }
+            else if (constants_1.CALLOUT_LAYOUT_CONTAINERS.has(elementName)) {
+                // Transparent layout wrapper, traverse its children
+                for (const child of el.children) {
+                    checkNode(child, context, componentName);
+                }
+            }
+            // Custom/complex component, don't traverse its children
+            break;
+        }
+        case 'JSXFragment': {
+            for (const child of node.children) {
+                checkNode(child, context, componentName);
+            }
+            break;
+        }
+        case 'MemberExpression': {
+            const { object } = node;
+            if (object.type === 'Identifier' && object.name === 'i18n') {
+                context.report({ node, messageId: 'childrenHavePlainText', data: { componentName } });
+            }
+            break;
+        }
+        case 'TemplateLiteral': {
+            context.report({ node, messageId: 'childrenHavePlainText', data: { componentName } });
+            break;
+        }
+        case 'ArrayExpression': {
+            for (const element of node.elements) {
+                if (element)
+                    checkNode(element, context, componentName);
+            }
+            break;
+        }
+        case 'JSXExpressionContainer': {
+            const { expression } = node;
+            if (expression.type !== 'JSXEmptyExpression') {
+                checkNode(expression, context, componentName);
+            }
+            break;
+        }
+        case 'LogicalExpression': {
+            const { left, right } = node;
+            checkNode(left, context, componentName);
+            checkNode(right, context, componentName);
+            break;
+        }
+        case 'ConditionalExpression': {
+            // e.g. {condition ? <p>text</p> : null}
+            const { consequent, alternate } = node;
+            checkNode(consequent, context, componentName);
+            checkNode(alternate, context, componentName);
+            break;
+        }
+        default:
+            break;
+    }
+}
+exports.CallOutPreferPropsForContent = utils_1.ESLintUtils.RuleCreator.withoutDocs({
+    create(context) {
+        const components = new Set(context.options[0]?.components ?? DEFAULT_COMPONENTS);
+        return {
+            JSXElement(node) {
+                const { openingElement, children } = node;
+                if (openingElement.name.type !== 'JSXIdentifier' ||
+                    !components.has(openingElement.name.name)) {
+                    return;
+                }
+                for (const child of children) {
+                    checkNode(child, context, openingElement.name.name);
+                }
+            },
+        };
+    },
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: [
+                'Enforce correct usage of `text` and `actionProps` props and discourage using `children` for content.',
+                'Text elements should be passed via the `text` prop.',
+                'Action elements (buttons, links) should be passed via `actionProps` instead.',
+            ].join(' '),
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    components: {
+                        type: 'array',
+                        items: { type: 'string', minLength: 1 },
+                        minItems: 1,
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+        messages: {
+            childrenHavePlainText: [
+                'Plain text passed as `children` of `{{componentName}}` should be moved to the `text` prop instead.',
+                'Example:',
+                '  <{{componentName}} title="Callout title" text="Callout text content" />',
+            ].join('\n'),
+            childrenHaveText: [
+                '`<{{elementName}}>` passed as `children` of `{{componentName}}` should be moved to the `text` prop instead.',
+                'The `text` prop accepts string text, block text elements (e.g. `<p>`) or inline elements (e.g. `<span>`, `<strong>`, `<em>`).',
+                'Use `children` only for complex non-text content that cannot be expressed via `text`.',
+                'Example:',
+                '  <{{componentName}} title="Callout title" text={<p>Callout text content</p>} />',
+            ].join('\n'),
+            childrenHaveActions: [
+                '`<{{elementName}}>` passed as `children` of `{{componentName}}` should be moved to the `actionProps` prop instead.',
+                'Use `actionProps` to render standardized primary or secondary action buttons, including buttons-as-links via `href`.',
+                'If a link is part of inline copy, move the surrounding content to the `text` prop instead.',
+                'Example:',
+                '  <{{componentName}}',
+                '    title="Callout title"',
+                '    actionProps={{ primary: { children: "Primary action", onClick: onClick }, secondary: { children: "Secondary action", href: "/"} }}',
+                '  />',
+            ].join('\n'),
+        },
+    },
+    defaultOptions: [{}],
+});
+//# sourceMappingURL=callout_prefer_props_for_content.js.map

package/lib/esm/rules/callout_prefer_props_for_content.js.map

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

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

@@ -31,3 +31,17 @@ export declare const INTERACTIVE_EUI_COMPONENTS: string[];
  * exclude these.
  */
 export declare const CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS: string[];
+export declare const HTML_TEXT_ELEMENTS: Set<string>;
+export declare const EUI_TEXT_COMPONENTS: Set<string>;
+export declare const HTML_ACTION_ELEMENTS: Set<string>;
+/**
+ * Transparent layout wrappers inside `EuiCallOut` children that the rule should
+ * traverse rather than treat as opaque custom components.
+ */
+export declare const CALLOUT_LAYOUT_CONTAINERS: Set<string>;
+/**
+ * Third-party i18n components that render plain text and are common in EUI consumers
+ * (e.g. `FormattedMessage` from react-intl used extensively in Kibana).
+ * Rules treat these the same as `HTML_TEXT_ELEMENTS` / `EUI_TEXT_COMPONENTS`.
+ */
+export declare const I18N_TEXT_COMPONENTS: Set<string>;

package/lib/esm/utils/constants.js

@@ -7,7 +7,7 @@
  * Side Public License, v 1.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = exports.INTERACTIVE_EUI_COMPONENTS = exports.NON_INTERACTIVE_HTML_TAGS = void 0;
+exports.I18N_TEXT_COMPONENTS = exports.CALLOUT_LAYOUT_CONTAINERS = exports.HTML_ACTION_ELEMENTS = exports.EUI_TEXT_COMPONENTS = exports.HTML_TEXT_ELEMENTS = exports.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = exports.INTERACTIVE_EUI_COMPONENTS = exports.NON_INTERACTIVE_HTML_TAGS = void 0;
 /**
  * A list of standard HTML tags that are considered **non-interactive** elements.
  *
@@ -132,4 +132,40 @@ exports.CONDITIONALLY_INTERACTIVE_EUI_COMPONENTS = [
     'EuiBetaBadge',
     'EuiCard',
 ];
+exports.HTML_TEXT_ELEMENTS = new Set([
+    'p',
+    'span',
+    'strong',
+    'em',
+    'b',
+    'i',
+    'small',
+    'code',
+]);
+exports.EUI_TEXT_COMPONENTS = new Set([
+    'EuiText',
+    'EuiTextColor',
+    'EuiTextAlign',
+    'EuiCode',
+    'EuiMark',
+    'EuiHighlight',
+]);
+exports.HTML_ACTION_ELEMENTS = new Set(['button', 'a']);
+/**
+ * Transparent layout wrappers inside `EuiCallOut` children that the rule should
+ * traverse rather than treat as opaque custom components.
+ */
+exports.CALLOUT_LAYOUT_CONTAINERS = new Set([
+    'Fragment',
+    'EuiFlexGroup',
+    'EuiFlexGrid',
+    'EuiFlexItem',
+    'div',
+]);
+/**
+ * Third-party i18n components that render plain text and are common in EUI consumers
+ * (e.g. `FormattedMessage` from react-intl used extensively in Kibana).
+ * Rules treat these the same as `HTML_TEXT_ELEMENTS` / `EUI_TEXT_COMPONENTS`.
+ */
+exports.I18N_TEXT_COMPONENTS = new Set(['FormattedMessage']);
 //# sourceMappingURL=constants.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;;;;;;GAYG;AACU,QAAA,yBAAyB,GAAG;IACvC,KAAK;IACL,MAAM;IACN,GAAG;IACH,SAAS;IACT,OAAO;IACP,YAAY;IACZ,IAAI;IACJ,SAAS;IACT,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,YAAY;IACZ,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;IACN,KAAK;IACL,IAAI;IACJ,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,KAAK;IACL,KAAK;IACL,OAAO;IACP,OAAO;IACP,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,IAAI;CACL,CAAC;AAEF;;;;;;;;;;GAUG;AACU,QAAA,0BAA0B,GAAG;IACxC,UAAU;IACV,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,SAAS;IACT,kBAAkB;IAClB,aAAa;IACb,gBAAgB;IAChB,aAAa;IACb,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,qBAAqB;IACrB,qBAAqB;IACrB,eAAe;IACf,eAAe;IACf,4BAA4B;IAC5B,kBAAkB;IAClB,mBAAmB;IACnB,SAAS;IACT,kBAAkB;IAClB,eAAe;IACf,sBAAsB;IACtB,UAAU;IACV,UAAU;IACV,WAAW;IACX,eAAe;IACf,YAAY;IACZ,mBAAmB;IACnB,oBAAoB;IACpB,gBAAgB;IAChB,WAAW;IACX,QAAQ;IACR,aAAa;IACb,aAAa;CACd,CAAC;AAEF;;;;;GAKG;AACU,QAAA,wCAAwC,GAAG;IACtD,UAAU;IACV,cAAc;IACd,SAAS;CACV,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;;;;;;GAYG;AACU,QAAA,yBAAyB,GAAG;IACvC,KAAK;IACL,MAAM;IACN,GAAG;IACH,SAAS;IACT,OAAO;IACP,YAAY;IACZ,IAAI;IACJ,SAAS;IACT,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,YAAY;IACZ,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;IACN,KAAK;IACL,IAAI;IACJ,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,KAAK;IACL,KAAK;IACL,OAAO;IACP,OAAO;IACP,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,IAAI;CACL,CAAC;AAEF;;;;;;;;;;GAUG;AACU,QAAA,0BAA0B,GAAG;IACxC,UAAU;IACV,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,WAAW;IACX,gBAAgB;IAChB,gBAAgB;IAChB,eAAe;IACf,SAAS;IACT,kBAAkB;IAClB,aAAa;IACb,gBAAgB;IAChB,aAAa;IACb,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,qBAAqB;IACrB,qBAAqB;IACrB,eAAe;IACf,eAAe;IACf,4BAA4B;IAC5B,kBAAkB;IAClB,mBAAmB;IACnB,SAAS;IACT,kBAAkB;IAClB,eAAe;IACf,sBAAsB;IACtB,UAAU;IACV,UAAU;IACV,WAAW;IACX,eAAe;IACf,YAAY;IACZ,mBAAmB;IACnB,oBAAoB;IACpB,gBAAgB;IAChB,WAAW;IACX,QAAQ;IACR,aAAa;IACb,aAAa;CACd,CAAC;AAEF;;;;;GAKG;AACU,QAAA,wCAAwC,GAAG;IACtD,UAAU;IACV,cAAc;IACd,SAAS;CACV,CAAC;AAEW,QAAA,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,GAAG;IACH,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,GAAG;IACH,GAAG;IACH,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEU,QAAA,mBAAmB,GAAG,IAAI,GAAG,CAAC;IACzC,SAAS;IACT,cAAc;IACd,cAAc;IACd,SAAS;IACT,SAAS;IACT,cAAc;CACf,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;AAE7D;;;GAGG;AACU,QAAA,yBAAyB,GAAG,IAAI,GAAG,CAAC;IAC/C,UAAU;IACV,cAAc;IACd,aAAa;IACb,aAAa;IACb,KAAK;CACN,CAAC,CAAC;AAEH;;;;GAIG;AACU,QAAA,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+import { type TSESTree } from '@typescript-eslint/utils';
+export declare function getElementName(openingElement: TSESTree.JSXOpeningElement): string | null;

package/lib/esm/utils/get_element_name.js

@@ -0,0 +1,17 @@
+"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.getElementName = getElementName;
+function getElementName(openingElement) {
+    const { name } = openingElement;
+    if (name.type === 'JSXIdentifier')
+        return name.name;
+    return null;
+}
+//# sourceMappingURL=get_element_name.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get_element_name.js","sourceRoot":"","sources":["../../../src/utils/get_element_name.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAIH,wCAQC;AARD,SAAgB,cAAc,CAC5B,cAA0C;IAE1C,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC;IAEhC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IAEpD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

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