eslint-plugin-react-x 1.37.1-next.3 → 1.37.1-next.5

package/dist/index.js

@@ -115,7 +115,6 @@ __export(recommended_typescript_exports, {
 var name2 = "react-x/recommended-typescript";
 var rules2 = {
   ...rules,
-  "react-x/dom/no-unknown-property": "off",
   "react-x/no-duplicate-jsx-props": "off",
   "react-x/use-jsx-vars": "off"
 };
@@ -136,7 +135,7 @@ var settings3 = {
 
 // package.json
 var name4 = "eslint-plugin-react-x";
-var version = "1.37.1-next.3";
+var version = "1.37.1-next.5";
 var createRule = shared.createRuleForPlugin("x");
 
 // src/rules/avoid-shorthand-boolean.ts
@@ -146,7 +145,7 @@ var avoid_shorthand_boolean_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using shorthand boolean attributes",
+      description: "Enforces explicit boolean values for boolean attributes.",
       [Symbol.for("rule_features")]: RULE_FEATURES
     },
     fixable: "code",
@@ -183,7 +182,7 @@ var avoid_shorthand_fragment_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using shorthand fragment syntax",
+      description: "Enforces explicit `<Fragment>` components instead of the shorthand `<>` or `</>` syntax.",
       [Symbol.for("rule_features")]: RULE_FEATURES2
     },
     messages: {
@@ -214,7 +213,7 @@ var no_access_state_in_setstate_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow accessing 'this.state' within 'setState'",
+      description: "Disallow accessing `this.state` inside `setState` calls.",
       [Symbol.for("rule_features")]: RULE_FEATURES3
     },
     messages: {
@@ -401,7 +400,7 @@ var no_array_index_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using an item's index in the array as its key",
+      description: "Disallow an item's index in the array as its key.",
       [Symbol.for("rule_features")]: RULE_FEATURES4
     },
     messages: {
@@ -517,7 +516,7 @@ var no_children_count_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.count'",
+      description: "Disallow `Children.count`.",
       [Symbol.for("rule_features")]: RULE_FEATURES5
     },
     messages: {
@@ -547,7 +546,7 @@ var no_children_for_each_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.forEach'",
+      description: "Disallow 'Children.forEach'.",
       [Symbol.for("rule_features")]: RULE_FEATURES6
     },
     messages: {
@@ -577,7 +576,7 @@ var no_children_map_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.map'",
+      description: "Disallow `Children.map`.",
       [Symbol.for("rule_features")]: RULE_FEATURES7
     },
     messages: {
@@ -606,7 +605,7 @@ var no_children_only_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.only'",
+      description: "Disallow `Children.only`.",
       [Symbol.for("rule_features")]: RULE_FEATURES8
     },
     messages: {
@@ -636,7 +635,7 @@ var no_children_prop_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow passing 'children' as props",
+      description: "Disallow passing `children` as a prop.",
       [Symbol.for("rule_features")]: RULE_FEATURES9
     },
     messages: {
@@ -671,7 +670,7 @@ var no_children_to_array_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.toArray'",
+      description: "Disallow `Children.toArray`.",
       [Symbol.for("rule_features")]: RULE_FEATURES10
     },
     messages: {
@@ -701,7 +700,7 @@ var no_class_component_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using class components",
+      description: "Disallow class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES11
     },
     messages: {
@@ -741,7 +740,7 @@ var no_clone_element_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'cloneElement'",
+      description: "Disallow `cloneElement`.",
       [Symbol.for("rule_features")]: RULE_FEATURES12
     },
     messages: {
@@ -772,7 +771,7 @@ var no_comment_textnodes_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow comments from being inserted as text nodes",
+      description: "Prevents comments from being inserted as text nodes.",
       [Symbol.for("rule_features")]: RULE_FEATURES13
     },
     messages: {
@@ -817,7 +816,7 @@ var no_complex_conditional_rendering_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow complex conditional rendering",
+      description: "Disallow complex conditional rendering in JSX expressions.",
       [Symbol.for("rule_features")]: RULE_FEATURES14
     },
     messages: {
@@ -865,7 +864,7 @@ var no_component_will_mount_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'componentWillMount' with 'UNSAFE_componentWillMount'",
+      description: "Replace usages of `componentWillMount` with `UNSAFE_componentWillMount`.",
       [Symbol.for("rule_features")]: RULE_FEATURES15
     },
     fixable: "code",
@@ -916,7 +915,7 @@ var no_component_will_receive_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'componentWillReceiveProps' with 'UNSAFE_componentWillReceiveProps'",
+      description: "Replace usages of `componentWillReceiveProps` with `UNSAFE_componentWillReceiveProps`.",
       [Symbol.for("rule_features")]: RULE_FEATURES16
     },
     fixable: "code",
@@ -967,7 +966,7 @@ var no_component_will_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'componentWillUpdate' with 'UNSAFE_componentWillUpdate'",
+      description: "Replace usages of `componentWillUpdate` with `UNSAFE_componentWillUpdate`.",
       [Symbol.for("rule_features")]: RULE_FEATURES17
     },
     fixable: "code",
@@ -1015,7 +1014,7 @@ var no_context_provider_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of '<Context.Provider>' with '<Context>'",
+      description: "Replace usages of `<Context.Provider>` with `<Context>`.",
       [Symbol.for("rule_features")]: RULE_FEATURES18
     },
     fixable: "code",
@@ -1066,7 +1065,7 @@ var no_create_ref_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'createRef' in function components",
+      description: "Disallow `createRef` in function components.",
       [Symbol.for("rule_features")]: RULE_FEATURES19
     },
     messages: {
@@ -1093,7 +1092,7 @@ var no_default_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'defaultProps' property in components",
+      description: "Disallow `defaultProps` property in favor of ES6 default parameters.",
       [Symbol.for("rule_features")]: RULE_FEATURES20
     },
     messages: {
@@ -1148,7 +1147,7 @@ var no_direct_mutation_state_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow direct mutation of state",
+      description: "Disallow direct mutation of `this.state`.",
       [Symbol.for("rule_features")]: RULE_FEATURES21
     },
     messages: {
@@ -1187,7 +1186,7 @@ var no_duplicate_jsx_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow duplicate props",
+      description: "Disallow duplicate props in JSX elements.",
       [Symbol.for("rule_features")]: RULE_FEATURES22
     },
     messages: {
@@ -1229,7 +1228,7 @@ var no_duplicate_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow duplicate keys when rendering list",
+      description: "Disallow duplicate `key` on elements in the same array or a list of `children`.",
       [Symbol.for("rule_features")]: RULE_FEATURES23
     },
     messages: {
@@ -1313,7 +1312,7 @@ var no_forward_ref_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'forwardRef' with passing 'ref' as a prop",
+      description: "Replaces usages of `forwardRef` with passing `ref` as a prop.",
       [Symbol.for("rule_features")]: RULE_FEATURES24
     },
     fixable: "code",
@@ -1420,7 +1419,7 @@ var no_implicit_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow implicit 'key' props",
+      description: "Prevents `key` from not being explicitly specified (e.g. spreading `key` from objects).",
       [Symbol.for("rule_features")]: RULE_FEATURES25
     },
     messages: {
@@ -1532,7 +1531,7 @@ var no_leaked_conditional_rendering_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow problematic leaked values from being rendered",
+      description: "Prevents problematic leaked values from being rendered.",
       [Symbol.for("rule_features")]: RULE_FEATURES26
     },
     messages: {
@@ -1607,7 +1606,7 @@ var no_missing_component_display_name_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require 'displayName' for 'memo' and 'forwardRef' components",
+      description: "Enforces that all components have a `displayName` which can be used in devtools.",
       [Symbol.for("rule_features")]: RULE_FEATURES27
     },
     messages: {
@@ -1660,7 +1659,7 @@ var no_missing_context_display_name_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require 'displayName' for contexts.",
+      description: "Enforces that all contexts have a `displayName` which can be used in devtools.",
       [Symbol.for("rule_features")]: RULE_FEATURES28
     },
     messages: {
@@ -1716,7 +1715,7 @@ var no_missing_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require 'key' when rendering list",
+      description: "Disallow missing `key` on items in list rendering.",
       [Symbol.for("rule_features")]: RULE_FEATURES29
     },
     messages: {
@@ -1848,7 +1847,7 @@ var no_nested_component_definitions_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "prevents nesting component definitions inside other components",
+      description: "Disallow nesting component definitions inside other components.",
       [Symbol.for("rule_features")]: RULE_FEATURES30
     },
     messages: {
@@ -1958,7 +1957,7 @@ var no_prop_types_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'propTypes' property in components",
+      description: "Disallow `propTypes` in favor of TypeScript or another type-checking solution.",
       [Symbol.for("rule_features")]: RULE_FEATURES31
     },
     messages: {
@@ -2015,7 +2014,7 @@ var no_redundant_should_component_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'shouldComponentUpdate' in class component extends 'React.PureComponent'",
+      description: "Disallow `shouldComponentUpdate` when extending `React.PureComponent`.",
       [Symbol.for("rule_features")]: RULE_FEATURES32
     },
     messages: {
@@ -2063,7 +2062,7 @@ var no_set_state_in_component_did_mount_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'setState' in 'componentDidMount'",
+      description: "Disallow calling `this.setState` in `componentDidMount` outside of functions, such as callbacks.",
       [Symbol.for("rule_features")]: RULE_FEATURES33
     },
     messages: {
@@ -2105,7 +2104,7 @@ var no_set_state_in_component_did_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'setState' in 'componentDidUpdate'",
+      description: "Disallows calling `this.setState` in `componentDidUpdate` outside of functions, such as callbacks.",
       [Symbol.for("rule_features")]: RULE_FEATURES34
     },
     messages: {
@@ -2147,7 +2146,7 @@ var no_set_state_in_component_will_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'setState' in 'componentWillUpdate'",
+      description: "Disallows calling `this.setState` in `componentWillUpdate` outside of functions, such as callbacks.",
       [Symbol.for("rule_features")]: RULE_FEATURES35
     },
     messages: {
@@ -2198,7 +2197,7 @@ var no_string_refs_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using deprecated string refs",
+      description: "Disallow deprecated string `refs`.",
       [Symbol.for("rule_features")]: RULE_FEATURES36
     },
     messages: {
@@ -2234,7 +2233,7 @@ var no_unsafe_component_will_mount_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'UNSAFE_componentWillMount'",
+      description: "Warns the usage of `UNSAFE_componentWillMount` in class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES37
     },
     messages: {
@@ -2276,7 +2275,7 @@ var no_unsafe_component_will_receive_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'UNSAFE_componentWillReceiveProps'",
+      description: "Warns the usage of `UNSAFE_componentWillReceiveProps` in class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES38
     },
     messages: {
@@ -2320,7 +2319,7 @@ var no_unsafe_component_will_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'UNSAFE_componentWillUpdate'",
+      description: "Warns the usage of `UNSAFE_componentWillUpdate` in class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES39
     },
     messages: {
@@ -2359,7 +2358,7 @@ var no_unstable_context_value_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow passing constructed values to context providers",
+      description: "Prevents non-stable values (i.e. object literals) from being used as a value for `Context.Provider`.",
       [Symbol.for("rule_features")]: RULE_FEATURES40
     },
     messages: {
@@ -2432,7 +2431,7 @@ var no_unstable_default_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using unstable value as default param in function component",
+      description: "Prevents using referential-type values as default props in object destructuring.",
       [Symbol.for("rule_features")]: RULE_FEATURES41
     },
     messages: {
@@ -2526,7 +2525,7 @@ var no_unused_class_component_members_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow unused class component members",
+      description: "Warns unused class component methods and properties.",
       [Symbol.for("rule_features")]: RULE_FEATURES42
     },
     messages: {
@@ -2657,7 +2656,7 @@ var no_unused_state_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow unused state of class component",
+      description: "Warns unused class component state.",
       [Symbol.for("rule_features")]: RULE_FEATURES43
     },
     messages: {
@@ -2811,7 +2810,7 @@ var no_use_context_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'useContext' with 'use'",
+      description: "Replaces usages of `useContext` with `use`.",
       [Symbol.for("rule_features")]: RULE_FEATURES44
     },
     fixable: "code",
@@ -2908,7 +2907,7 @@ var no_useless_forward_ref_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require a 'ref' parameter to be set when using 'forwardRef'",
+      description: "Disallow useless `forwardRef` calls on components that don't use `ref`s.",
       [Symbol.for("rule_features")]: RULE_FEATURES45
     },
     messages: {
@@ -2945,6 +2944,44 @@ var RULE_NAME46 = "no-useless-fragment";
 var defaultOptions = [{
   allowExpressions: true
 }];
+var no_useless_fragment_default = createRule({
+  meta: {
+    type: "problem",
+    defaultOptions: [...defaultOptions],
+    docs: {
+      description: "Disallow useless fragment elements."
+    },
+    fixable: "code",
+    messages: {
+      uselessFragment: "A fragment {{reason}} is useless."
+    },
+    schema: [{
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        allowExpressions: {
+          type: "boolean",
+          description: "Allow fragments with a single expression child"
+        }
+      }
+    }]
+  },
+  name: RULE_NAME46,
+  create: create44,
+  defaultOptions
+});
+function create44(context, [option]) {
+  const { allowExpressions = true } = option;
+  return {
+    JSXElement(node) {
+      if (!JSX8__namespace.isFragmentElement(node)) return;
+      doCheck(context, node, allowExpressions);
+    },
+    JSXFragment(node) {
+      doCheck(context, node, allowExpressions);
+    }
+  };
+}
 function trimLikeReact(text) {
   const leadingSpaces = /^\s*/.exec(text)?.[0] ?? "";
   const trailingSpaces = /\s*$/.exec(text)?.[0] ?? "";
@@ -3045,44 +3082,6 @@ function doCheck(context, node, allowExpressions) {
   }
   return;
 }
-var no_useless_fragment_default = createRule({
-  meta: {
-    type: "problem",
-    defaultOptions: [...defaultOptions],
-    docs: {
-      description: "disallow useless fragments"
-    },
-    fixable: "code",
-    messages: {
-      uselessFragment: "A fragment {{reason}} is useless."
-    },
-    schema: [{
-      type: "object",
-      additionalProperties: false,
-      properties: {
-        allowExpressions: {
-          type: "boolean",
-          description: "Allow fragments with a single expression child"
-        }
-      }
-    }]
-  },
-  name: RULE_NAME46,
-  create: create44,
-  defaultOptions
-});
-function create44(context, [option]) {
-  const { allowExpressions = true } = option;
-  return {
-    JSXElement(node) {
-      if (!JSX8__namespace.isFragmentElement(node)) return;
-      doCheck(context, node, allowExpressions);
-    },
-    JSXFragment(node) {
-      doCheck(context, node, allowExpressions);
-    }
-  };
-}
 var RULE_NAME47 = "prefer-destructuring-assignment";
 var RULE_FEATURES46 = [];
 function isMemberExpressionWithObjectName(node) {
@@ -3092,7 +3091,7 @@ var prefer_destructuring_assignment_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce using destructuring assignment in component props and context",
+      description: "Enforces destructuring assignment for component props and context.",
       [Symbol.for("rule_features")]: RULE_FEATURES46
     },
     messages: {
@@ -3172,7 +3171,7 @@ var prefer_react_namespace_import_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce React is imported via a namespace import",
+      description: "Enforces React is imported via a namespace import.",
       [Symbol.for("rule_features")]: RULE_FEATURES47
     },
     fixable: "code",
@@ -3226,7 +3225,7 @@ var prefer_read_only_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce read-only props in components",
+      description: "Enforces read-only props in components.",
       [Symbol.for("rule_features")]: RULE_FEATURES48
     },
     messages: {
@@ -3267,7 +3266,7 @@ var prefer_shorthand_boolean_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce the use of shorthand syntax for boolean attributes",
+      description: "Enforces shorthand syntax for boolean attributes.",
       [Symbol.for("rule_features")]: RULE_FEATURES49
     },
     fixable: "code",
@@ -3308,7 +3307,7 @@ var prefer_shorthand_fragment_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce the use of shorthand syntax for fragments",
+      description: "Enforces shorthand syntax for fragments.",
       [Symbol.for("rule_features")]: RULE_FEATURES50
     },
     fixable: "code",
@@ -3352,7 +3351,7 @@ var use_jsx_vars_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "marks variables used in JSX as used",
+      description: "Marks variables used in JSX as used.",
       [Symbol.for("rule_features")]: RULE_FEATURES51
     },
     messages: {

package/dist/index.mjs

@@ -88,7 +88,6 @@ __export(recommended_typescript_exports, {
 var name2 = "react-x/recommended-typescript";
 var rules2 = {
   ...rules,
-  "react-x/dom/no-unknown-property": "off",
   "react-x/no-duplicate-jsx-props": "off",
   "react-x/use-jsx-vars": "off"
 };
@@ -109,7 +108,7 @@ var settings3 = {
 
 // package.json
 var name4 = "eslint-plugin-react-x";
-var version = "1.37.1-next.3";
+var version = "1.37.1-next.5";
 var createRule = createRuleForPlugin("x");
 
 // src/rules/avoid-shorthand-boolean.ts
@@ -119,7 +118,7 @@ var avoid_shorthand_boolean_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using shorthand boolean attributes",
+      description: "Enforces explicit boolean values for boolean attributes.",
       [Symbol.for("rule_features")]: RULE_FEATURES
     },
     fixable: "code",
@@ -156,7 +155,7 @@ var avoid_shorthand_fragment_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using shorthand fragment syntax",
+      description: "Enforces explicit `<Fragment>` components instead of the shorthand `<>` or `</>` syntax.",
       [Symbol.for("rule_features")]: RULE_FEATURES2
     },
     messages: {
@@ -187,7 +186,7 @@ var no_access_state_in_setstate_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow accessing 'this.state' within 'setState'",
+      description: "Disallow accessing `this.state` inside `setState` calls.",
       [Symbol.for("rule_features")]: RULE_FEATURES3
     },
     messages: {
@@ -374,7 +373,7 @@ var no_array_index_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using an item's index in the array as its key",
+      description: "Disallow an item's index in the array as its key.",
       [Symbol.for("rule_features")]: RULE_FEATURES4
     },
     messages: {
@@ -490,7 +489,7 @@ var no_children_count_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.count'",
+      description: "Disallow `Children.count`.",
       [Symbol.for("rule_features")]: RULE_FEATURES5
     },
     messages: {
@@ -520,7 +519,7 @@ var no_children_for_each_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.forEach'",
+      description: "Disallow 'Children.forEach'.",
       [Symbol.for("rule_features")]: RULE_FEATURES6
     },
     messages: {
@@ -550,7 +549,7 @@ var no_children_map_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.map'",
+      description: "Disallow `Children.map`.",
       [Symbol.for("rule_features")]: RULE_FEATURES7
     },
     messages: {
@@ -579,7 +578,7 @@ var no_children_only_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.only'",
+      description: "Disallow `Children.only`.",
       [Symbol.for("rule_features")]: RULE_FEATURES8
     },
     messages: {
@@ -609,7 +608,7 @@ var no_children_prop_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow passing 'children' as props",
+      description: "Disallow passing `children` as a prop.",
       [Symbol.for("rule_features")]: RULE_FEATURES9
     },
     messages: {
@@ -644,7 +643,7 @@ var no_children_to_array_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'Children.toArray'",
+      description: "Disallow `Children.toArray`.",
       [Symbol.for("rule_features")]: RULE_FEATURES10
     },
     messages: {
@@ -674,7 +673,7 @@ var no_class_component_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using class components",
+      description: "Disallow class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES11
     },
     messages: {
@@ -714,7 +713,7 @@ var no_clone_element_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'cloneElement'",
+      description: "Disallow `cloneElement`.",
       [Symbol.for("rule_features")]: RULE_FEATURES12
     },
     messages: {
@@ -745,7 +744,7 @@ var no_comment_textnodes_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow comments from being inserted as text nodes",
+      description: "Prevents comments from being inserted as text nodes.",
       [Symbol.for("rule_features")]: RULE_FEATURES13
     },
     messages: {
@@ -790,7 +789,7 @@ var no_complex_conditional_rendering_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow complex conditional rendering",
+      description: "Disallow complex conditional rendering in JSX expressions.",
       [Symbol.for("rule_features")]: RULE_FEATURES14
     },
     messages: {
@@ -838,7 +837,7 @@ var no_component_will_mount_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'componentWillMount' with 'UNSAFE_componentWillMount'",
+      description: "Replace usages of `componentWillMount` with `UNSAFE_componentWillMount`.",
       [Symbol.for("rule_features")]: RULE_FEATURES15
     },
     fixable: "code",
@@ -889,7 +888,7 @@ var no_component_will_receive_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'componentWillReceiveProps' with 'UNSAFE_componentWillReceiveProps'",
+      description: "Replace usages of `componentWillReceiveProps` with `UNSAFE_componentWillReceiveProps`.",
       [Symbol.for("rule_features")]: RULE_FEATURES16
     },
     fixable: "code",
@@ -940,7 +939,7 @@ var no_component_will_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'componentWillUpdate' with 'UNSAFE_componentWillUpdate'",
+      description: "Replace usages of `componentWillUpdate` with `UNSAFE_componentWillUpdate`.",
       [Symbol.for("rule_features")]: RULE_FEATURES17
     },
     fixable: "code",
@@ -988,7 +987,7 @@ var no_context_provider_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of '<Context.Provider>' with '<Context>'",
+      description: "Replace usages of `<Context.Provider>` with `<Context>`.",
       [Symbol.for("rule_features")]: RULE_FEATURES18
     },
     fixable: "code",
@@ -1039,7 +1038,7 @@ var no_create_ref_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'createRef' in function components",
+      description: "Disallow `createRef` in function components.",
       [Symbol.for("rule_features")]: RULE_FEATURES19
     },
     messages: {
@@ -1066,7 +1065,7 @@ var no_default_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'defaultProps' property in components",
+      description: "Disallow `defaultProps` property in favor of ES6 default parameters.",
       [Symbol.for("rule_features")]: RULE_FEATURES20
     },
     messages: {
@@ -1121,7 +1120,7 @@ var no_direct_mutation_state_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow direct mutation of state",
+      description: "Disallow direct mutation of `this.state`.",
       [Symbol.for("rule_features")]: RULE_FEATURES21
     },
     messages: {
@@ -1160,7 +1159,7 @@ var no_duplicate_jsx_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow duplicate props",
+      description: "Disallow duplicate props in JSX elements.",
       [Symbol.for("rule_features")]: RULE_FEATURES22
     },
     messages: {
@@ -1202,7 +1201,7 @@ var no_duplicate_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow duplicate keys when rendering list",
+      description: "Disallow duplicate `key` on elements in the same array or a list of `children`.",
       [Symbol.for("rule_features")]: RULE_FEATURES23
     },
     messages: {
@@ -1286,7 +1285,7 @@ var no_forward_ref_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'forwardRef' with passing 'ref' as a prop",
+      description: "Replaces usages of `forwardRef` with passing `ref` as a prop.",
       [Symbol.for("rule_features")]: RULE_FEATURES24
     },
     fixable: "code",
@@ -1393,7 +1392,7 @@ var no_implicit_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow implicit 'key' props",
+      description: "Prevents `key` from not being explicitly specified (e.g. spreading `key` from objects).",
       [Symbol.for("rule_features")]: RULE_FEATURES25
     },
     messages: {
@@ -1505,7 +1504,7 @@ var no_leaked_conditional_rendering_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow problematic leaked values from being rendered",
+      description: "Prevents problematic leaked values from being rendered.",
       [Symbol.for("rule_features")]: RULE_FEATURES26
     },
     messages: {
@@ -1580,7 +1579,7 @@ var no_missing_component_display_name_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require 'displayName' for 'memo' and 'forwardRef' components",
+      description: "Enforces that all components have a `displayName` which can be used in devtools.",
       [Symbol.for("rule_features")]: RULE_FEATURES27
     },
     messages: {
@@ -1633,7 +1632,7 @@ var no_missing_context_display_name_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require 'displayName' for contexts.",
+      description: "Enforces that all contexts have a `displayName` which can be used in devtools.",
       [Symbol.for("rule_features")]: RULE_FEATURES28
     },
     messages: {
@@ -1689,7 +1688,7 @@ var no_missing_key_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require 'key' when rendering list",
+      description: "Disallow missing `key` on items in list rendering.",
       [Symbol.for("rule_features")]: RULE_FEATURES29
     },
     messages: {
@@ -1821,7 +1820,7 @@ var no_nested_component_definitions_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "prevents nesting component definitions inside other components",
+      description: "Disallow nesting component definitions inside other components.",
       [Symbol.for("rule_features")]: RULE_FEATURES30
     },
     messages: {
@@ -1931,7 +1930,7 @@ var no_prop_types_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'propTypes' property in components",
+      description: "Disallow `propTypes` in favor of TypeScript or another type-checking solution.",
       [Symbol.for("rule_features")]: RULE_FEATURES31
     },
     messages: {
@@ -1988,7 +1987,7 @@ var no_redundant_should_component_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'shouldComponentUpdate' in class component extends 'React.PureComponent'",
+      description: "Disallow `shouldComponentUpdate` when extending `React.PureComponent`.",
       [Symbol.for("rule_features")]: RULE_FEATURES32
     },
     messages: {
@@ -2036,7 +2035,7 @@ var no_set_state_in_component_did_mount_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'setState' in 'componentDidMount'",
+      description: "Disallow calling `this.setState` in `componentDidMount` outside of functions, such as callbacks.",
       [Symbol.for("rule_features")]: RULE_FEATURES33
     },
     messages: {
@@ -2078,7 +2077,7 @@ var no_set_state_in_component_did_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'setState' in 'componentDidUpdate'",
+      description: "Disallows calling `this.setState` in `componentDidUpdate` outside of functions, such as callbacks.",
       [Symbol.for("rule_features")]: RULE_FEATURES34
     },
     messages: {
@@ -2120,7 +2119,7 @@ var no_set_state_in_component_will_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'setState' in 'componentWillUpdate'",
+      description: "Disallows calling `this.setState` in `componentWillUpdate` outside of functions, such as callbacks.",
       [Symbol.for("rule_features")]: RULE_FEATURES35
     },
     messages: {
@@ -2171,7 +2170,7 @@ var no_string_refs_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using deprecated string refs",
+      description: "Disallow deprecated string `refs`.",
       [Symbol.for("rule_features")]: RULE_FEATURES36
     },
     messages: {
@@ -2207,7 +2206,7 @@ var no_unsafe_component_will_mount_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'UNSAFE_componentWillMount'",
+      description: "Warns the usage of `UNSAFE_componentWillMount` in class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES37
     },
     messages: {
@@ -2249,7 +2248,7 @@ var no_unsafe_component_will_receive_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'UNSAFE_componentWillReceiveProps'",
+      description: "Warns the usage of `UNSAFE_componentWillReceiveProps` in class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES38
     },
     messages: {
@@ -2293,7 +2292,7 @@ var no_unsafe_component_will_update_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using 'UNSAFE_componentWillUpdate'",
+      description: "Warns the usage of `UNSAFE_componentWillUpdate` in class components.",
       [Symbol.for("rule_features")]: RULE_FEATURES39
     },
     messages: {
@@ -2332,7 +2331,7 @@ var no_unstable_context_value_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow passing constructed values to context providers",
+      description: "Prevents non-stable values (i.e. object literals) from being used as a value for `Context.Provider`.",
       [Symbol.for("rule_features")]: RULE_FEATURES40
     },
     messages: {
@@ -2405,7 +2404,7 @@ var no_unstable_default_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow using unstable value as default param in function component",
+      description: "Prevents using referential-type values as default props in object destructuring.",
       [Symbol.for("rule_features")]: RULE_FEATURES41
     },
     messages: {
@@ -2499,7 +2498,7 @@ var no_unused_class_component_members_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow unused class component members",
+      description: "Warns unused class component methods and properties.",
       [Symbol.for("rule_features")]: RULE_FEATURES42
     },
     messages: {
@@ -2630,7 +2629,7 @@ var no_unused_state_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "disallow unused state of class component",
+      description: "Warns unused class component state.",
       [Symbol.for("rule_features")]: RULE_FEATURES43
     },
     messages: {
@@ -2784,7 +2783,7 @@ var no_use_context_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "replace usages of 'useContext' with 'use'",
+      description: "Replaces usages of `useContext` with `use`.",
       [Symbol.for("rule_features")]: RULE_FEATURES44
     },
     fixable: "code",
@@ -2881,7 +2880,7 @@ var no_useless_forward_ref_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "require a 'ref' parameter to be set when using 'forwardRef'",
+      description: "Disallow useless `forwardRef` calls on components that don't use `ref`s.",
       [Symbol.for("rule_features")]: RULE_FEATURES45
     },
     messages: {
@@ -2918,6 +2917,44 @@ var RULE_NAME46 = "no-useless-fragment";
 var defaultOptions = [{
   allowExpressions: true
 }];
+var no_useless_fragment_default = createRule({
+  meta: {
+    type: "problem",
+    defaultOptions: [...defaultOptions],
+    docs: {
+      description: "Disallow useless fragment elements."
+    },
+    fixable: "code",
+    messages: {
+      uselessFragment: "A fragment {{reason}} is useless."
+    },
+    schema: [{
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        allowExpressions: {
+          type: "boolean",
+          description: "Allow fragments with a single expression child"
+        }
+      }
+    }]
+  },
+  name: RULE_NAME46,
+  create: create44,
+  defaultOptions
+});
+function create44(context, [option]) {
+  const { allowExpressions = true } = option;
+  return {
+    JSXElement(node) {
+      if (!JSX8.isFragmentElement(node)) return;
+      doCheck(context, node, allowExpressions);
+    },
+    JSXFragment(node) {
+      doCheck(context, node, allowExpressions);
+    }
+  };
+}
 function trimLikeReact(text) {
   const leadingSpaces = /^\s*/.exec(text)?.[0] ?? "";
   const trailingSpaces = /\s*$/.exec(text)?.[0] ?? "";
@@ -3018,44 +3055,6 @@ function doCheck(context, node, allowExpressions) {
   }
   return;
 }
-var no_useless_fragment_default = createRule({
-  meta: {
-    type: "problem",
-    defaultOptions: [...defaultOptions],
-    docs: {
-      description: "disallow useless fragments"
-    },
-    fixable: "code",
-    messages: {
-      uselessFragment: "A fragment {{reason}} is useless."
-    },
-    schema: [{
-      type: "object",
-      additionalProperties: false,
-      properties: {
-        allowExpressions: {
-          type: "boolean",
-          description: "Allow fragments with a single expression child"
-        }
-      }
-    }]
-  },
-  name: RULE_NAME46,
-  create: create44,
-  defaultOptions
-});
-function create44(context, [option]) {
-  const { allowExpressions = true } = option;
-  return {
-    JSXElement(node) {
-      if (!JSX8.isFragmentElement(node)) return;
-      doCheck(context, node, allowExpressions);
-    },
-    JSXFragment(node) {
-      doCheck(context, node, allowExpressions);
-    }
-  };
-}
 var RULE_NAME47 = "prefer-destructuring-assignment";
 var RULE_FEATURES46 = [];
 function isMemberExpressionWithObjectName(node) {
@@ -3065,7 +3064,7 @@ var prefer_destructuring_assignment_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce using destructuring assignment in component props and context",
+      description: "Enforces destructuring assignment for component props and context.",
       [Symbol.for("rule_features")]: RULE_FEATURES46
     },
     messages: {
@@ -3145,7 +3144,7 @@ var prefer_react_namespace_import_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce React is imported via a namespace import",
+      description: "Enforces React is imported via a namespace import.",
       [Symbol.for("rule_features")]: RULE_FEATURES47
     },
     fixable: "code",
@@ -3199,7 +3198,7 @@ var prefer_read_only_props_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce read-only props in components",
+      description: "Enforces read-only props in components.",
       [Symbol.for("rule_features")]: RULE_FEATURES48
     },
     messages: {
@@ -3240,7 +3239,7 @@ var prefer_shorthand_boolean_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce the use of shorthand syntax for boolean attributes",
+      description: "Enforces shorthand syntax for boolean attributes.",
       [Symbol.for("rule_features")]: RULE_FEATURES49
     },
     fixable: "code",
@@ -3281,7 +3280,7 @@ var prefer_shorthand_fragment_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "enforce the use of shorthand syntax for fragments",
+      description: "Enforces shorthand syntax for fragments.",
       [Symbol.for("rule_features")]: RULE_FEATURES50
     },
     fixable: "code",
@@ -3325,7 +3324,7 @@ var use_jsx_vars_default = createRule({
   meta: {
     type: "problem",
     docs: {
-      description: "marks variables used in JSX as used",
+      description: "Marks variables used in JSX as used.",
       [Symbol.for("rule_features")]: RULE_FEATURES51
     },
     messages: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-react-x",
-  "version": "1.37.1-next.3",
+  "version": "1.37.1-next.5",
   "description": "A set of composable linting rules for libraries and frameworks that use React as a UI runtime.",
   "keywords": [
     "react",
@@ -49,12 +49,12 @@
     "compare-versions": "^6.1.1",
     "string-ts": "^2.2.1",
     "ts-pattern": "^5.6.2",
-    "@eslint-react/ast": "1.37.1-next.3",
-    "@eslint-react/core": "1.37.1-next.3",
-    "@eslint-react/eff": "1.37.1-next.3",
-    "@eslint-react/jsx": "1.37.1-next.3",
-    "@eslint-react/shared": "1.37.1-next.3",
-    "@eslint-react/var": "1.37.1-next.3"
+    "@eslint-react/ast": "1.37.1-next.5",
+    "@eslint-react/core": "1.37.1-next.5",
+    "@eslint-react/jsx": "1.37.1-next.5",
+    "@eslint-react/eff": "1.37.1-next.5",
+    "@eslint-react/var": "1.37.1-next.5",
+    "@eslint-react/shared": "1.37.1-next.5"
   },
   "devDependencies": {
     "@types/react": "^19.0.12",