@eslint-react/core 2.3.13-next.3 → 2.3.13-next.4

package/dist/index.d.ts

@@ -515,11 +515,11 @@ declare function isFunctionOfUseEffectCleanup(node: TSESTree.Node | unit): boole
 //#endregion
 //#region src/jsx/jsx-attribute.d.ts
 /**
- * Get a function to find JSX attributes by name, considering direct attributes and spread attributes.
+ * Creates a helper function to find a specific JSX attribute by name
+ * Handles direct attributes and spread attributes (variables or object literals)
  * @param context The ESLint rule context
  * @param node The JSX element node
- * @param initialScope Optional initial scope for variable resolution
- * @returns A function that takes an attribute name and returns the corresponding JSX attribute node or undefined
+ * @param initialScope (Optional) The initial scope to use for variable resolution
  */
 declare function getJsxAttribute(context: RuleContext, node: TSESTree.JSXElement, initialScope?: Scope): (name: string) => TSESTree.JSXAttribute | TSESTree.JSXSpreadAttribute | undefined;
 //#endregion
@@ -560,6 +560,13 @@ type JsxAttributeValue = {
   node: TSESTree.JSXSpreadChild["expression"];
   toStatic(): unknown;
 };
+/**
+ * Resolves the static value of a JSX attribute or spread attribute
+ *
+ * @param context - The ESLint rule context
+ * @param attribute - The JSX attribute node to resolve
+ * @returns An object containing the value kind, the node (if applicable), and a `toStatic` helper
+ */
 declare function resolveJsxAttributeValue(context: RuleContext, attribute: AST.TSESTreeJSXAttributeLike): {
   readonly kind: "boolean";
   readonly toStatic: () => true;
@@ -602,9 +609,9 @@ interface JsxConfig {
   jsxImportSource?: string;
 }
 /**
- * Get JsxConfig from the rule context by reading compiler options.
- * @param context The RuleContext.
- * @returns JsxConfig derived from compiler options.
+ * Get JsxConfig from the rule context by reading compiler options
+ * @param context The RuleContext
+ * @returns JsxConfig derived from compiler options
  */
 declare function getJsxConfigFromContext(context: RuleContext): {
   jsx: 4 | typescript0.JsxEmit;
@@ -613,9 +620,9 @@ declare function getJsxConfigFromContext(context: RuleContext): {
   jsxImportSource: string;
 };
 /**
- * Get JsxConfig from pragma comments (annotations) in the source code.
- * @param context The RuleContext.
- * @returns JsxConfig derived from pragma comments.
+ * Get JsxConfig from pragma comments (annotations) in the source code
+ * @param context The RuleContext
+ * @returns JsxConfig derived from pragma comments
  */
 declare function getJsxConfigFromAnnotation(context: RuleContext): JsxConfig;
 //#endregion

package/dist/index.js

@@ -253,19 +253,18 @@ function getJsxAttributeName(context, node) {
 //#endregion
 //#region src/jsx/jsx-attribute.ts
 /**
-* Get a function to find JSX attributes by name, considering direct attributes and spread attributes.
+* Creates a helper function to find a specific JSX attribute by name
+* Handles direct attributes and spread attributes (variables or object literals)
 * @param context The ESLint rule context
 * @param node The JSX element node
-* @param initialScope Optional initial scope for variable resolution
-* @returns A function that takes an attribute name and returns the corresponding JSX attribute node or undefined
+* @param initialScope (Optional) The initial scope to use for variable resolution
 */
 function getJsxAttribute(context, node, initialScope) {
 	const scope = initialScope ?? context.sourceCode.getScope(node);
 	const attributes = node.openingElement.attributes;
 	/**
-	* Find a JSX attribute by name, considering both direct attributes and spread attributes.
-	* @param name The name of the attribute to find
-	* @returns The JSX attribute node if found, otherwise undefined
+	* Finds the last occurrence of a specific attribute
+	* @param name The attribute name to search for
 	*/
 	return (name) => {
 		return attributes.findLast((attr) => {
@@ -285,8 +284,19 @@ function getJsxAttribute(context, node, initialScope) {
 
 //#endregion
 //#region src/jsx/jsx-attribute-value.ts
+/**
+* Resolves the static value of a JSX attribute or spread attribute
+*
+* @param context - The ESLint rule context
+* @param attribute - The JSX attribute node to resolve
+* @returns An object containing the value kind, the node (if applicable), and a `toStatic` helper
+*/
 function resolveJsxAttributeValue(context, attribute) {
 	const initialScope = context.sourceCode.getScope(attribute);
+	/**
+	* Handles standard JSX attributes (e.g., prop="value", prop={value}, prop)
+	* @param node The JSX attribute node
+	*/
 	function handleJsxAttribute(node) {
 		if (node.value == null) return {
 			kind: "boolean",
@@ -331,6 +341,10 @@ function resolveJsxAttributeValue(context, attribute) {
 			};
 		}
 	}
+	/**
+	* Handles JSX spread attributes (e.g., {...props})
+	* @param node The JSX spread attribute node
+	*/
 	function handleJsxSpreadAttribute(node) {
 		return {
 			kind: "spreadProps",
@@ -358,9 +372,9 @@ const JsxEmit = {
 	ReactJSXDev: 5
 };
 /**
-* Get JsxConfig from the rule context by reading compiler options.
-* @param context The RuleContext.
-* @returns JsxConfig derived from compiler options.
+* Get JsxConfig from the rule context by reading compiler options
+* @param context The RuleContext
+* @returns JsxConfig derived from compiler options
 */
 function getJsxConfigFromContext(context) {
 	const options = context.sourceCode.parserServices?.program?.getCompilerOptions() ?? {};
@@ -373,9 +387,9 @@ function getJsxConfigFromContext(context) {
 }
 const cache = /* @__PURE__ */ new WeakMap();
 /**
-* Get JsxConfig from pragma comments (annotations) in the source code.
-* @param context The RuleContext.
-* @returns JsxConfig derived from pragma comments.
+* Get JsxConfig from pragma comments (annotations) in the source code
+* @param context The RuleContext
+* @returns JsxConfig derived from pragma comments
 */
 function getJsxConfigFromAnnotation(context) {
 	return getOrElseUpdate(cache, context.sourceCode, () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint-react/core",
-  "version": "2.3.13-next.3",
+  "version": "2.3.13-next.4",
   "description": "ESLint React's ESLint utility module for static analysis of React core APIs and patterns.",
   "homepage": "https://github.com/Rel1cx/eslint-react",
   "bugs": {
@@ -35,10 +35,10 @@
     "@typescript-eslint/utils": "^8.48.1",
     "birecord": "^0.1.1",
     "ts-pattern": "^5.9.0",
-    "@eslint-react/ast": "2.3.13-next.3",
-    "@eslint-react/eff": "2.3.13-next.3",
-    "@eslint-react/shared": "2.3.13-next.3",
-    "@eslint-react/var": "2.3.13-next.3"
+    "@eslint-react/ast": "2.3.13-next.4",
+    "@eslint-react/shared": "2.3.13-next.4",
+    "@eslint-react/eff": "2.3.13-next.4",
+    "@eslint-react/var": "2.3.13-next.4"
   },
   "peerDependencies": {
     "eslint": "^8.57.0 || ^9.0.0",