eslint-plugin-traceability 1.29.0 → 1.29.1

package/CHANGELOG.md

@@ -1,9 +1,9 @@
-# [1.29.0](https://github.com/voder-ai/eslint-plugin-traceability/compare/v1.28.0...v1.29.0) (2026-01-12)
+## [1.29.1](https://github.com/voder-ai/eslint-plugin-traceability/compare/v1.29.0...v1.29.1) (2026-01-12)
 
 
-### Features
+### Bug Fixes
 
-* **rules:** exclude anonymous arrow callbacks, require named arrows ([373ac23](https://github.com/voder-ai/eslint-plugin-traceability/commit/373ac23f620cb6d0ad3056526f329c9f1dcb0e13))
+* **rules:** clarify anonymous arrow exclusion logic and add inline docs ([efd6f4a](https://github.com/voder-ai/eslint-plugin-traceability/commit/efd6f4a6101936ac42321d4fb31f156ce2f12a9d))
 
 # Changelog
 

package/lib/rules/helpers/require-story-helpers.js

@@ -159,15 +159,17 @@ function requiresOwnFunctionAnnotation(node, options) {
     if ((0, require_story_node_utils_1.isNestedFunction)(node) && (0, require_story_node_utils_1.isEffectivelyAnonymousFunction)(node)) {
         return false;
     }
-    // Anonymous arrow functions used as common utility callbacks (map, filter, setTimeout, etc.)
-    // are excluded by default, UNLESS excludeTestCallbacks is explicitly false.
+    // Anonymous arrow functions are excluded by default when used as:
+    // - Callbacks to common utility methods (map, filter, setTimeout, Promise.then, etc.)
+    // - Callbacks to recognized test framework functions (when excludeTestCallbacks is true)
+    // Anonymous arrows passed to custom functions are checked unless nested and inheriting.
     // Named arrow functions require annotations like other function declarations.
     if ((0, require_story_node_utils_1.isAnonymousArrowFunction)(node)) {
-        // When excludeTestCallbacks is false, check ALL functions
+        // When excludeTestCallbacks is false, check ALL functions (including anonymous arrows)
         if (options?.excludeTestCallbacks === false) {
             return true;
         }
-        // Special case: Vitest's bench callbacks should always be checked
+        // Special case: Vitest's bench callbacks should always be checked, even if anonymous
         if (node.parent?.type === "CallExpression" &&
             node.parent.callee?.type === "Identifier" &&
             node.parent.callee.name === "bench") {
@@ -177,7 +179,8 @@ function requiresOwnFunctionAnnotation(node, options) {
         if (isCommonUtilityCallback(node)) {
             return false; // Exclude common utility callbacks
         }
-        // Other anonymous arrows (like callbacks to user functions) should be checked
+        // Other anonymous arrows (like callbacks to custom functions) should be checked
+        // unless they are nested and can inherit from their parent
         return true;
     }
     return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-traceability",
-  "version": "1.29.0",
+  "version": "1.29.1",
   "description": "A customizable ESLint plugin that enforces traceability annotations in your code, ensuring each implementation is linked to its requirement or test case.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",