eslint-plugin-traceability 1.16.0 → 1.16.1

package/CHANGELOG.md

@@ -1,9 +1,9 @@
-# [1.16.0](https://github.com/voder-ai/eslint-plugin-traceability/compare/v1.15.0...v1.16.0) (2025-12-09)
+## [1.16.1](https://github.com/voder-ai/eslint-plugin-traceability/compare/v1.16.0...v1.16.1) (2025-12-09)
 
 
-### Features
+### Bug Fixes
 
-* add excludeTestCallbacks option for test framework callbacks ([108510d](https://github.com/voder-ai/eslint-plugin-traceability/commit/108510d361f45c9ff75118ee266970dcbabd3fb8))
+* broaden test callback exclusion coverage for function annotations ([8078745](https://github.com/voder-ai/eslint-plugin-traceability/commit/80787455dcba39724158f378fce54ae78a75b59b))
 
 # Changelog
 

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

@@ -29,15 +29,30 @@ Object.defineProperty(exports, "STORY_PATH", { enumerable: true, get: function (
  * @req REQ-TEST-CALLBACK-EXCLUSION
  */
 const TEST_FUNCTION_NAMES = new Set([
+    // Core test/describe-style functions (Jest, Mocha, Vitest share many of these)
     "it",
     "test",
     "describe",
+    "suite",
+    // Focused variants
     "fit",
-    "xit",
     "ftest",
-    "xtest",
     "fdescribe",
+    "fsuite",
+    // Skipped variants
+    "xit",
+    "xtest",
     "xdescribe",
+    "xsuite",
+    // Additional common aliases
+    "context",
+    "specify",
+    "before",
+    "after",
+    "beforeEach",
+    "afterEach",
+    "beforeAll",
+    "afterAll",
 ]);
 const TEST_FUNCTION_CONCURRENT_PROP = "concurrent";
 /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */
@@ -113,7 +128,10 @@ function isEffectivelyAnonymousFunction(node) {
  * framework function (Jest, Mocha, Vitest, etc).
  *
  * Supports:
- * - it(), test(), describe(), fit(), xit(), ftest(), xtest(), fdescribe(), xdescribe()
+ * - it(), test(), describe(), suite(), context(), specify()
+ * - lifecycle hooks: before(), after(), beforeEach(), afterEach(), beforeAll(), afterAll()
+ * - focused variants: fit(), ftest(), fdescribe(), fsuite()
+ * - skipped variants and helpers: xit(), xtest(), xdescribe(), xsuite()
  * - their .concurrent variants (e.g., it.concurrent(), test.concurrent())
  *
  * @req REQ-TEST-CALLBACK-EXCLUSION

package/lib/tests/rules/require-story-annotation.test.js

@@ -72,6 +72,32 @@ declare function tsDecl(): void;`,
  */
 describe('Feature X', () => {
   it('does something', () => {});
+});
+
+// Mocha-style suite/context/specify examples
+suite('Mocha suite', () => {
+  beforeEach(() => {});
+  afterEach(() => {});
+  before(() => {});
+  after(() => {});
+
+  test('Mocha test', () => {});
+  specify('Mocha specify', () => {});
+  context('Mocha context', () => {
+    it('nested it', () => {});
+  });
+});
+
+// Vitest-style APIs including hooks and bench
+describe('Vitest suite', () => {
+  beforeEach(() => {});
+  afterEach(() => {});
+  beforeAll(() => {});
+  afterAll(() => {});
+
+  it('Vitest it', () => {});
+  test('Vitest test', () => {});
+  bench('Vitest bench', () => {});
 });`,
             },
         ],

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

@@ -192,6 +192,94 @@ describe("Require Story Helpers (Story 003.0)", () => {
         const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
         expect(result).toBeFalsy();
     });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as beforeEach callback is excluded by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "beforeEach" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeFalsy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as afterEach callback is excluded by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "afterEach" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeFalsy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as beforeAll callback is excluded by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "beforeAll" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeFalsy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as afterAll callback is excluded by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "afterAll" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeFalsy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as suite callback is excluded by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "suite" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeFalsy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as context callback is excluded by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "context" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeFalsy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as specify callback is excluded by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "specify" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeFalsy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] Arrow function used as bench callback is checked by default", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "bench" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE);
+        expect(result).toBeTruthy();
+    });
     /**
      * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
      * @req REQ-TEST-CALLBACK-EXCLUSION - Verify arrow function test callbacks are checked when exclusion is disabled
@@ -209,4 +297,108 @@ describe("Require Story Helpers (Story 003.0)", () => {
         });
         expect(result).toBeTruthy();
     });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] beforeEach arrow function callback is checked when excludeTestCallbacks is false", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "beforeEach" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] afterEach arrow function callback is checked when excludeTestCallbacks is false", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "afterEach" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] beforeAll arrow function callback is checked when excludeTestCallbacks is false", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "beforeAll" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] afterAll arrow function callback is checked when excludeTestCallbacks is false", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "afterAll" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] suite arrow function callback is checked when excludeTestCallbacks is false", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "suite" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] context arrow function callback is checked when excludeTestCallbacks is false", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "context" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] specify arrow function callback is checked when excludeTestCallbacks is false", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "specify" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
+    test("[REQ-TEST-CALLBACK-EXCLUSION] bench arrow function callback is always checked (also when excludeTestCallbacks is false)", () => {
+        const node = {
+            type: "ArrowFunctionExpression",
+            parent: {
+                type: "CallExpression",
+                callee: { type: "Identifier", name: "bench" },
+            },
+        };
+        const result = (0, require_story_helpers_1.shouldProcessNode)(node, require_story_helpers_1.DEFAULT_SCOPE, "all", {
+            excludeTestCallbacks: false,
+        });
+        expect(result).toBeTruthy();
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-traceability",
-  "version": "1.16.0",
+  "version": "1.16.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/src/index.js",
   "types": "lib/src/index.d.ts",