eslint-plugin-traceability 1.23.0 → 1.24.0

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

@@ -1,264 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-ANNOTATION-REQUIRED - Verify require-req-annotation rule enforces @req on functions
- * @story docs/stories/007.0-DEV-ERROR-REPORTING.story.md
- * @req REQ-ERROR-SPECIFIC - Verify enhanced, specific error messaging behavior
- *
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-TYPESCRIPT-SUPPORT - Verify TypeScript declarations are checked via shared annotation checker helper
- *
- * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
- * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Verify @supports is accepted as satisfying requirement annotations
- */
-const eslint_1 = require("eslint");
-const require_req_annotation_1 = __importDefault(require("../../src/rules/require-req-annotation"));
-const ts_language_options_1 = require("../utils/ts-language-options");
-const annotation_checker_test_1 = require("../utils/annotation-checker.test");
-const ruleTester = new eslint_1.RuleTester({
-    languageOptions: {
-        parserOptions: { ecmaVersion: 2022, sourceType: "module" },
-    },
-});
-/**
- * Build a standard missingReq error object for a given function name.
- *
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-ANNOTATION-REQUIRED - Standardize missingReq error shape in tests
- */
-function missingReq(functionName) {
-    return {
-        messageId: "missingReq",
-        data: { name: functionName, functionName },
-    };
-}
-/**
- * @trace Story 003.0-DEV-FUNCTION-ANNOTATIONS / REQ-TYPESCRIPT-SUPPORT
- * Exercise the require-req-annotation rule's behavior on TSDeclareFunction and
- * TSMethodSignature via the shared runAnnotationCheckerTests helper.
- *
- * The helper delegates to the real rule's TypeScript-specific visitors
- * without changing its behavior; it provides the common TS parser
- * configuration and assertion plumbing.
- */
-(0, annotation_checker_test_1.runAnnotationCheckerTests)("require-req-annotation", {
-    rule: require_req_annotation_1.default,
-    valid: [
-        {
-            name: "[REQ-TYPESCRIPT-SUPPORT] valid with @req annotation on TSDeclareFunction",
-            code: `/**\n * @req REQ-EXAMPLE\n */\ndeclare function foo(): void;`,
-        },
-        {
-            name: "[REQ-TYPESCRIPT-SUPPORT] valid with @req annotation on TSMethodSignature",
-            code: `interface I {\n  /**\n   * @req REQ-EXAMPLE\n   */\n  method(): void;\n}`,
-        },
-    ],
-    invalid: [
-        {
-            name: "[REQ-TYPESCRIPT-SUPPORT] missing @req on TSDeclareFunction",
-            code: `declare function baz(): void;`,
-            errors: [missingReq("baz")],
-        },
-        {
-            name: "[REQ-TYPESCRIPT-SUPPORT] missing @req on TSMethodSignature",
-            code: `interface I { method(): void; }`,
-            errors: [missingReq("method")],
-        },
-    ],
-});
-describe("Require Req Annotation Rule (Story 003.0-DEV-FUNCTION-ANNOTATIONS)", () => {
-    ruleTester.run("require-req-annotation", require_req_annotation_1.default, {
-        valid: [
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] valid with only @req annotation",
-                code: `/**\n * @req REQ-EXAMPLE\n */\nfunction foo() {}`,
-            },
-            {
-                name: "[REQ-REQUIRE-ACCEPTS-IMPLEMENTS] valid with only @implements annotation",
-                code: `/**\n * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction implOnly() {}`,
-            },
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] valid with @story and @req annotations",
-                code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n * @req REQ-EXAMPLE\n */\nfunction bar() {}`,
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] valid FunctionExpression with @req annotation",
-                code: `const fn = /**\n * @req REQ-EXAMPLE\n */\nfunction() {};`,
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] valid MethodDefinition with @req annotation",
-                code: `class C {\n  /**\n   * @req REQ-EXAMPLE\n   */\n  m() {}\n}`,
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] valid ArrowFunctionExpression with @req annotation",
-                code: `/** @req REQ-EXAMPLE */\nconst arrow = () => {};`,
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] valid exported ArrowFunctionExpression with @req annotation",
-                code: `/** @req REQ-EXAMPLE */\nexport const arrow = () => {};`,
-            },
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-TYPESCRIPT-SUPPORT][REQ-FUNCTION-DETECTION][Story 003.0] valid TS FunctionExpression in variable declarator with @req",
-                code: `const fn = /**\n * @req REQ-EXAMPLE\n */\nfunction () {};`,
-            }),
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-TYPESCRIPT-SUPPORT][REQ-FUNCTION-DETECTION][Story 003.0] valid exported TS FunctionExpression in variable declarator with @req",
-                code: `export const fn = /**\n * @req REQ-EXAMPLE\n */\nfunction () {};`,
-            }),
-            {
-                name: "[REQ-CONFIGURABLE-SCOPE][Story 003.0] FunctionExpression ignored when scope only includes FunctionDeclaration",
-                code: `const fn = function () {};`,
-                options: [{ scope: ["FunctionDeclaration"] }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported function ignored when exportPriority is 'exported'",
-                code: `function nonExported() {}`,
-                options: [{ exportPriority: "exported" }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported function required when exportPriority is 'exported'",
-                code: `/** @req REQ-EXAMPLE */\nexport function exportedFn() {}`,
-                options: [{ exportPriority: "exported" }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported function ignored when exportPriority is 'non-exported'",
-                code: `export function exportedFn() {}`,
-                options: [{ exportPriority: "non-exported" }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported function required when exportPriority is 'non-exported'",
-                code: `/** @req REQ-EXAMPLE */\nfunction nonExported() {}`,
-                options: [{ exportPriority: "non-exported" }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported method ignored when exportPriority is 'non-exported'",
-                code: `export class C {\n  m() {}\n}`,
-                options: [{ exportPriority: "non-exported" }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported method required when exportPriority is 'non-exported'",
-                code: `class C {\n  /** @req REQ-EXAMPLE */\n  m() {}\n}`,
-                options: [{ exportPriority: "non-exported" }],
-            },
-            {
-                name: "[REQ-INSIDE-BRACE-PLACEMENT][REQ-ALL-BLOCK-TYPES] function-level @supports requirement inside body is valid when annotationPlacement is 'inside'",
-                code: `function withInsideReq() {\n  // @supports docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md REQ-FN-INSIDE\n  return 1;\n}`,
-                options: [{ annotationPlacement: "inside" }],
-            },
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-INSIDE-BRACE-PLACEMENT][REQ-ALL-BLOCK-TYPES] method-level @req inside body is valid when annotationPlacement is 'inside'",
-                code: `class C {\n  method() {\n    // @req REQ-METHOD-INSIDE\n    return 1;\n  }\n}`,
-                options: [{ annotationPlacement: "inside" }],
-            }),
-            {
-                name: "[REQ-INSIDE-BRACE-PLACEMENT] before-function @req remains valid when annotationPlacement is 'inside' (REQ-REQ-PLACEMENT-BC)",
-                code: `/**\n * @req REQ-BEFORE-FN\n */\nfunction beforeReqOnly() {\n  return 1;\n}`,
-                options: [{ annotationPlacement: "inside" }],
-            },
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-INSIDE-BRACE-PLACEMENT] before-method @req remains valid when annotationPlacement is 'inside' (REQ-REQ-PLACEMENT-BC)",
-                code: `class C {\n  /**\n   * @req REQ-BEFORE-METHOD\n   */\n  method() {\n    return 1;\n  }\n}`,
-                options: [{ annotationPlacement: "inside" }],
-            }),
-        ],
-        invalid: [
-            {
-                name: "[REQ-ANNOTATION-REQUIRED][REQ-REQUIRE-ACCEPTS-IMPLEMENTS] missing @req on function without JSDoc remains invalid under multi-story support",
-                code: `function baz() {}`,
-                errors: [missingReq("baz")],
-            },
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] missing @req on function with only @story annotation",
-                code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction qux() {}`,
-                errors: [missingReq("qux")],
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on FunctionExpression assigned to variable",
-                code: `const fn = function () {};`,
-                errors: [missingReq("fn")],
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on anonymous FunctionExpression (no variable name)",
-                code: `(function () {})();`,
-                errors: [missingReq("(anonymous)")],
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on MethodDefinition in class",
-                code: `class C {\n  m() {}\n}`,
-                errors: [missingReq("m")],
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on MethodDefinition in object literal",
-                code: `const o = { m() {} };`,
-                errors: [missingReq("m")],
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on ArrowFunctionExpression",
-                code: `const arrow = () => {};`,
-                errors: [missingReq("arrow")],
-            },
-            {
-                name: "[REQ-FUNCTION-DETECTION][Story 003.0] missing @req on exported ArrowFunctionExpression",
-                code: `export const arrow = () => {};`,
-                errors: [missingReq("arrow")],
-            },
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-TYPESCRIPT-SUPPORT][REQ-FUNCTION-DETECTION][Story 003.0] missing @req on TS FunctionExpression in variable declarator",
-                code: `const fn = function () {};`,
-                errors: [missingReq("fn")],
-            }),
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-TYPESCRIPT-SUPPORT][REQ-FUNCTION-DETECTION][Story 003.0] missing @req on exported TS FunctionExpression in variable declarator",
-                code: `export const fn = function () {};`,
-                errors: [missingReq("fn")],
-            }),
-            {
-                name: "[REQ-CONFIGURABLE-SCOPE][Story 003.0] FunctionDeclaration still reported when scope only includes FunctionDeclaration",
-                code: `function scoped() {}`,
-                options: [{ scope: ["FunctionDeclaration"] }],
-                errors: [missingReq("scoped")],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported function reported when exportPriority is 'exported'",
-                code: `export function exportedFn() {}`,
-                options: [{ exportPriority: "exported" }],
-                errors: [missingReq("exportedFn")],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported function reported when exportPriority is 'non-exported'",
-                code: `function nonExported() {}`,
-                options: [{ exportPriority: "non-exported" }],
-                errors: [missingReq("nonExported")],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported method reported when exportPriority is 'exported'",
-                code: `export class C {\n  m() {}\n}`,
-                errors: [missingReq("m")],
-                options: [{ exportPriority: "exported" }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported method reported when exportPriority is 'non-exported'",
-                code: `class C {\n  m() {}\n}`,
-                errors: [missingReq("m")],
-                options: [{ exportPriority: "non-exported" }],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] exported FunctionExpression reported when exportPriority is 'exported'",
-                code: `export const fn = function () {};`,
-                options: [{ exportPriority: "exported" }],
-                errors: [missingReq("fn")],
-            },
-            {
-                name: "[REQ-EXPORT-PRIORITY][Story 003.0] non-exported FunctionExpression reported when exportPriority is 'non-exported'",
-                code: `const fn = function () {};`,
-                options: [{ exportPriority: "non-exported" }],
-                errors: [missingReq("fn")],
-            },
-        ],
-    });
-});

package/lib/tests/rules/require-story-annotation.test.d.ts

@@ -1 +0,0 @@
-export {};

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

@@ -1,376 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @story docs/stories/010.2-DEV-MULTI-STORY-SUPPORT.story.md
- * @req REQ-ANNOTATION-REQUIRED - Verify require-story-annotation rule enforces @story annotation on functions
- * @req REQ-REQUIRE-ACCEPTS-IMPLEMENTS - Verify @supports annotation is accepted as satisfying story requirements
- */
-const eslint_1 = require("eslint");
-const require_story_annotation_1 = __importDefault(require("../../src/rules/require-story-annotation"));
-const ts_language_options_1 = require("../utils/ts-language-options");
-const ruleTester = new eslint_1.RuleTester({
-    languageOptions: ts_language_options_1.tsRuleTesterLanguageOptions,
-});
-describe("Require Story Annotation Rule (Story 003.0-DEV-FUNCTION-ANNOTATIONS)" /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */ /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */, () => {
-    ruleTester.run("require-story-annotation", require_story_annotation_1.default, {
-        valid: [
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] valid with JSDoc @story annotation",
-                code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction foo() {}`,
-            },
-            {
-                name: "[REQ-REQUIRE-ACCEPTS-IMPLEMENTS] valid with only @implements annotation",
-                code: `/**\n * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-ANNOTATION-REQUIRED\n */\nfunction implOnly() {}`,
-            },
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] valid with line comment @story annotation",
-                code: `// @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
-function foo() {}`,
-            },
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] valid on function expression with annotation",
-                code: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nconst fnExpr = function() {};`,
-            },
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] valid on arrow function with annotation",
-                code: `// @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
-const arrowFn = () => {};`,
-            },
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-ANNOTATION-REQUIRED] valid on class method with annotation",
-                code: `class A {\n  /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\n  method() {}\n}`,
-            }),
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-FUNCTION-DETECTION] valid with annotation on TS declare function",
-                code: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */
-declare function tsDecl(): void;`,
-            }),
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-FUNCTION-DETECTION] valid with annotation on TS method signature",
-                code: `interface C {
-  /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */
-  method(): void;
-}`,
-            }),
-            {
-                name: "[REQ-ARROW-FUNCTION-EXCLUDED] anonymous arrow callback in higher-order function is allowed without annotation",
-                code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction mapValues(items) {\n  return items.map(() => {\n    return 1;\n  });\n}`,
-            },
-            {
-                name: "[REQ-NESTED-FUNCTION-INHERITANCE] anonymous inner function inherits outer annotation",
-                code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction outer() {\n  const inner = function() {\n    return 1;\n  };\n  return inner();\n}`,
-            },
-            {
-                name: "[REQ-TEST-CALLBACK-EXCLUSION][Story 003.0] default exclusion of Jest-style anonymous test callbacks",
-                code: `/**
- * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-TEST-CALLBACK-EXCLUSION
- */
-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', () => {});
-});`,
-            },
-            {
-                name: "[REQ-TEST-CALLBACK-EXCLUSION][Story 003.0] additionalTestHelperNames excludes configured helper callbacks when excludeTestCallbacks=true",
-                code: `withTestCase("does something", () => {});`,
-                options: [{ additionalTestHelperNames: ["withTestCase"] }],
-            },
-            {
-                name: "[REQ-INSIDE-BRACE-PLACEMENT][REQ-ALL-BLOCK-TYPES] function-level @supports annotation inside body is valid when annotationPlacement is 'inside'",
-                code: `function insideAnnotated() {\n  // @supports docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md REQ-INSIDE-FN\n  return 1;\n}`,
-                options: [{ annotationPlacement: "inside" }],
-            },
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-INSIDE-BRACE-PLACEMENT][REQ-ALL-BLOCK-TYPES] function-level @story annotation inside body is valid when annotationPlacement is 'inside' (TS)",
-                code: `function insideAnnotatedTs() {\n  // @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md\n  return 1;\n}`,
-                options: [{ annotationPlacement: "inside" }],
-            }),
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-INSIDE-BRACE-PLACEMENT] before-method @story remains valid when annotationPlacement is 'inside' (placement BC)",
-                code: `class C {\n  /** @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md */\n  method() {\n    return 1;\n  }\n}`,
-                options: [{ annotationPlacement: "inside" }],
-            }),
-        ],
-        invalid: [
-            {
-                // Backward compatibility: plain unannotated functions remain invalid under multi-story support
-                name: "[REQ-ANNOTATION-REQUIRED][BACKCOMPAT] missing @story annotation on function with no @supports",
-                code: `function bar() {}`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nfunction bar() {}`,
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'bar' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nfunction bar() {}`,
-                            },
-                        ],
-                    },
-                ],
-            },
-            {
-                name: "[REQ-ANNOTATION-REQUIRED] missing @story on function expression",
-                code: `const fnExpr = function() {};`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nconst fnExpr = function() {};`,
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'fnExpr' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nconst fnExpr = function() {};`,
-                            },
-                        ],
-                    },
-                ],
-            },
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-ANNOTATION-REQUIRED] missing @story on class method",
-                code: `class C {\n  method() {}\n}`,
-                output: `class C {\n  /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\n  method() {}\n}`,
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        data: { name: "method", functionName: "method" },
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'method' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `class C {\n  /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\n  method() {}\n}`,
-                            },
-                        ],
-                    },
-                ],
-            }),
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-ANNOTATION-REQUIRED] missing @story on TS declare function",
-                code: `declare function tsDecl(): void;`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\ndeclare function tsDecl(): void;`,
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'tsDecl' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\ndeclare function tsDecl(): void;`,
-                            },
-                        ],
-                    },
-                ],
-            }),
-            (0, ts_language_options_1.withTsLanguageOptions)({
-                name: "[REQ-ANNOTATION-REQUIRED] missing @story on TS method signature",
-                code: `interface D {\n  method(): void;\n}`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\ninterface D {\n  method(): void;\n}`,
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'method' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\ninterface D {\n  method(): void;\n}`,
-                            },
-                        ],
-                    },
-                ],
-            }),
-            {
-                name: "[REQ-ARROW-FUNCTION-EXCLUDED] named arrow function must be annotated",
-                code: `const handler = () => {};`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nconst handler = () => {};`,
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'handler' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nconst handler = () => {};`,
-                            },
-                        ],
-                    },
-                ],
-            },
-            {
-                name: "[REQ-NESTED-FUNCTION-INHERITANCE] named inner function inside annotated outer must still be annotated",
-                code: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction outer() {\n  function innerNamed() {\n    return 1;\n  }\n  return innerNamed();\n}`,
-                output: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction outer() {\n  /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nfunction innerNamed() {\n    return 1;\n  }\n  return innerNamed();\n}`,
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'innerNamed' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/**\n * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\n */\nfunction outer() {\n  /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nfunction innerNamed() {\n    return 1;\n  }\n  return innerNamed();\n}`,
-                            },
-                        ],
-                    },
-                ],
-            },
-            {
-                name: "[REQ-TEST-CALLBACK-EXCLUSION][Story 003.0] bench callback still reported even when included in additionalTestHelperNames",
-                code: `bench("bench case", () => {});`,
-                options: [{ additionalTestHelperNames: ["bench"], autoFix: false }],
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function '(anonymous)' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `bench("bench case", /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\n() => {});`,
-                            },
-                        ],
-                    },
-                ],
-            },
-            {
-                name: "[REQ-BEFORE-BRACE-ERROR][REQ-INSIDE-BRACE-PLACEMENT] before-function annotation is ignored when annotationPlacement is 'inside'",
-                code: `// @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md\nfunction beforeOnly() {\n  return 1;\n}`,
-                options: [{ annotationPlacement: "inside", autoFix: false }],
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: 1, // satisfy TypeScript's SuggestionOutput[] typing while asserting suggestion count
-                    },
-                ],
-            },
-        ],
-    });
-    ruleTester.run("require-story-annotation with exportPriority option", require_story_annotation_1.default, {
-        valid: [
-            {
-                name: "[exportPriority] unexported function without @story should be valid",
-                code: `function local() {}`,
-                options: [{ exportPriority: "exported" }],
-            },
-            {
-                name: "[exportPriority] exported with annotation",
-                code: `// @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md\nexport function exportedAnnotated() {}`,
-                options: [{ exportPriority: "exported" }],
-            },
-        ],
-        invalid: [
-            {
-                name: "[exportPriority] exported function missing @story annotation",
-                code: `export function exportedMissing() {}`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nexport function exportedMissing() {}`,
-                options: [{ exportPriority: "exported" }],
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'exportedMissing' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nexport function exportedMissing() {}`,
-                            },
-                        ],
-                    },
-                ],
-            },
-            {
-                name: "[exportPriority][REQ-ARROW-FUNCTION-EXCLUDED] exported named arrow function must be annotated",
-                code: `export const arrowExported = () => {};`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nexport const arrowExported = () => {};`,
-                options: [{ exportPriority: "exported" }],
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'arrowExported' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nexport const arrowExported = () => {};`,
-                            },
-                        ],
-                    },
-                ],
-            },
-        ],
-    });
-    ruleTester.run("require-story-annotation with scope option", require_story_annotation_1.default, {
-        valid: [
-            {
-                name: "[scope] arrow function ignored when scope is FunctionDeclaration",
-                code: `const arrow = () => {};`,
-                options: [{ scope: ["FunctionDeclaration"] }],
-            },
-        ],
-        invalid: [
-            {
-                name: "[scope] function declaration missing annotation when scope is FunctionDeclaration",
-                code: `function onlyDecl() {}`,
-                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nfunction onlyDecl() {}`,
-                options: [{ scope: ["FunctionDeclaration"] }],
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function 'onlyDecl' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `/** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\nfunction onlyDecl() {}`,
-                            },
-                        ],
-                    },
-                ],
-            },
-        ],
-    });
-    ruleTester.run("require-story-annotation with excludeTestCallbacks option", require_story_annotation_1.default, {
-        valid: [
-            {
-                name: "[REQ-TEST-CALLBACK-EXCLUSION][Story 003.0] non-test arrow function annotated when excludeTestCallbacks=false",
-                code: `/**
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- */
-const handler = () => {};`,
-                options: [{ excludeTestCallbacks: false }],
-            },
-        ],
-        invalid: [
-            {
-                name: "[REQ-TEST-CALLBACK-EXCLUSION][Story 003.0] Jest-style it() callback requires annotation when excludeTestCallbacks=false",
-                code: `it('does something', () => {});`,
-                options: [{ excludeTestCallbacks: false, autoFix: false }],
-                errors: [
-                    {
-                        messageId: "missingStory",
-                        suggestions: [
-                            {
-                                desc: `Add traceability annotation for function '(anonymous)' using @supports (preferred) or @story (legacy), for example: /** @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */`,
-                                output: `it('does something', /** @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md */\n() => {});`,
-                            },
-                        ],
-                    },
-                ],
-            },
-        ],
-    });
-});

package/lib/tests/rules/require-story-core-edgecases.test.d.ts

@@ -1 +0,0 @@
-export {};

package/lib/tests/rules/require-story-core-edgecases.test.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Edge-case tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-AUTOFIX - Cover additional branch cases in require-story-core (addStoryFixer/reportMissing)
- * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-AUTOFIX
- */
-const require_story_core_1 = require("../../src/rules/helpers/require-story-core");
-const require_story_core_test_helpers_1 = require("../utils/require-story-core-test-helpers");
-describe("Require Story Core - edge cases (Story 003.0)", () => {
-    test("createAddStoryFix covers primary branch combinations via shared helper (edge cases)", () => {
-        (0, require_story_core_test_helpers_1.exerciseCreateAddStoryFixBranches)(require_story_core_1.createAddStoryFix);
-    });
-});