eslint-plugin-traceability 1.23.0 → 1.24.0

package/lib/tests/utils/branch-annotation-else-if-position.test.js

@@ -1,145 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const branch_annotation_helpers_1 = require("../../src/utils/branch-annotation-helpers");
-function createMockSourceCode(options) {
-    const { lines = [], commentsBefore = [] } = options;
-    return {
-        lines,
-        getCommentsBefore() {
-            return commentsBefore;
-        },
-    };
-}
-describe("gatherBranchCommentText else-if behavior (Story 026.0-DEV-ELSE-IF-ANNOTATION-POSITION)", () => {
-    it("[REQ-DUAL-POSITION-DETECTION-ELSE-IF] detects annotations placed before the else-if keyword", () => {
-        const sourceCode = createMockSourceCode({
-            commentsBefore: [
-                {
-                    value: "@story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md",
-                },
-                { value: "@req REQ-DUAL-POSITION-DETECTION-ELSE-IF" },
-            ],
-            // lines are unused in this case because we short-circuit on before-text annotations.
-            lines: [],
-        });
-        const node = {
-            type: "IfStatement",
-            loc: { start: { line: 10 } },
-        };
-        const parent = {
-            type: "IfStatement",
-            alternate: node,
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node, parent);
-        expect(text).toContain("@story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md");
-        expect(text).toContain("@req REQ-DUAL-POSITION-DETECTION-ELSE-IF");
-    });
-    it("[REQ-FALLBACK-LOGIC-ELSE-IF] falls back to annotations between condition and body when before-else-if comments lack annotations", () => {
-        const lines = [
-            "if (a) {",
-            "  doA();",
-            "} else if (b && c) {",
-            "  // @story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md",
-            "  // @req REQ-FALLBACK-LOGIC-ELSE-IF",
-            "  doB();",
-            "}",
-        ];
-        const sourceCode = createMockSourceCode({
-            commentsBefore: [{ value: "// some unrelated comment" }],
-            lines,
-        });
-        const node = {
-            type: "IfStatement",
-            loc: { start: { line: 3 } },
-            test: { loc: { end: { line: 3 } } },
-            consequent: {
-                type: "BlockStatement",
-                loc: { start: { line: 6 } },
-            },
-        };
-        const parent = {
-            type: "IfStatement",
-            alternate: node,
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node, parent);
-        expect(text).toContain("@story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md");
-        expect(text).toContain("@req REQ-FALLBACK-LOGIC-ELSE-IF");
-    });
-    it("[REQ-POSITION-PRIORITY-ELSE-IF] prefers before-else-if annotations when both positions are present", () => {
-        const lines = [
-            "if (a) {",
-            "  doA();",
-            "} else if (b) {",
-            "  // @story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md",
-            "  // @req REQ-POSITION-PRIORITY-ELSE-IF-BETWEEN",
-            "  doB();",
-            "}",
-        ];
-        const sourceCode = createMockSourceCode({
-            commentsBefore: [
-                {
-                    value: "@story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md",
-                },
-                { value: "@req REQ-POSITION-PRIORITY-ELSE-IF" },
-            ],
-            lines,
-        });
-        const node = {
-            type: "IfStatement",
-            loc: { start: { line: 3 } },
-            test: { loc: { end: { line: 3 } } },
-            consequent: {
-                type: "BlockStatement",
-                loc: { start: { line: 6 } },
-            },
-        };
-        const parent = {
-            type: "IfStatement",
-            alternate: node,
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node, parent);
-        // The helper should use the before-else-if annotations and not need to
-        // fall back to between-condition-and-body comments.
-        expect(text).toContain("@story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md");
-        expect(text).toContain("@req REQ-POSITION-PRIORITY-ELSE-IF");
-        expect(text).not.toContain("REQ-POSITION-PRIORITY-ELSE-IF-BETWEEN");
-    });
-    it("[REQ-SINGLE-LINE-ELSE-IF-SUPPORT] detects annotations on single-line else-if without braces when placed before the else-if keyword", () => {
-        const lines = [
-            "let suggestion;",
-            "// @story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md",
-            "// @req REQ-SINGLE-LINE-ELSE-IF-SUPPORT",
-            "if (arg === \"--json\") suggestion = \"--format=json\";",
-            "// @story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md",
-            "// @req REQ-SINGLE-LINE-ELSE-IF-SUPPORT",
-            "else if (arg.startsWith(\"--format\")) suggestion = \"--format\";",
-        ];
-        const sourceCode = createMockSourceCode({
-            commentsBefore: [
-                {
-                    value: "@story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md",
-                },
-                { value: "@req REQ-SINGLE-LINE-ELSE-IF-SUPPORT" },
-            ],
-            lines,
-        });
-        const node = {
-            type: "IfStatement",
-            loc: { start: { line: 7 } },
-            test: { loc: { end: { line: 7 } } },
-            consequent: {
-                // single-line consequent without BlockStatement braces in the real-world source;
-                // for this helper-level test we only care that loc values exist and are consistent.
-                type: "ExpressionStatement",
-                loc: { start: { line: 7 } },
-            },
-        };
-        const parent = {
-            type: "IfStatement",
-            alternate: node,
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node, parent);
-        expect(text).toContain("@story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md");
-        expect(text).toContain("@req REQ-SINGLE-LINE-ELSE-IF-SUPPORT");
-    });
-});

package/lib/tests/utils/branch-annotation-helpers.test.d.ts

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

package/lib/tests/utils/branch-annotation-helpers.test.js

@@ -1,462 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable traceability/valid-annotation-format */
-/**
- * Unit tests for branch annotation helpers
- * Tests for: docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md
- * @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md
- * @req REQ-CONFIGURABLE-SCOPE - Allow configuration of branch types for annotation enforcement
- * @supports docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md REQ-CONFIGURABLE-SCOPE
- */
-const branch_annotation_helpers_1 = require("../../src/utils/branch-annotation-helpers");
-describe("validateBranchTypes helper (Story 004.0-DEV-BRANCH-ANNOTATIONS)", () => {
-    let context;
-    beforeEach(() => {
-        context = { options: [], report: jest.fn() };
-    });
-    it("should return default branch types when no options provided", () => {
-        const result = (0, branch_annotation_helpers_1.validateBranchTypes)(context);
-        expect(Array.isArray(result)).toBe(true);
-        expect(result).toEqual(branch_annotation_helpers_1.DEFAULT_BRANCH_TYPES);
-    });
-    it("should return custom branch types when valid options provided", () => {
-        context.options = [{ branchTypes: ["IfStatement", "ForStatement"] }];
-        const result = (0, branch_annotation_helpers_1.validateBranchTypes)(context);
-        expect(Array.isArray(result)).toBe(true);
-        expect(result).toEqual(["IfStatement", "ForStatement"]);
-    });
-    it("should return listener when invalid branch types provided and report errors", () => {
-        const invalid = ["UnknownType", "Foo"];
-        context.options = [{ branchTypes: invalid }];
-        // Invoke helper
-        const result = (0, branch_annotation_helpers_1.validateBranchTypes)(context);
-        // Should return a listener object
-        expect(typeof result).toBe("object");
-        expect(result).toHaveProperty("Program");
-        // Call the Program listener
-        const fakeNode = {};
-        result.Program(fakeNode);
-        // report should be called for each invalid type
-        expect(context.report).toHaveBeenCalledTimes(invalid.length);
-        invalid.forEach((t) => {
-            expect(context.report).toHaveBeenCalledWith(expect.objectContaining({
-                node: fakeNode,
-                message: expect.stringContaining(`Value "${t}" should be equal to one of the allowed values:`),
-            }));
-        });
-    });
-    it("should gather SwitchCase comment text via gatherBranchCommentText (Story 004.0-DEV-BRANCH-ANNOTATIONS)", () => {
-        const sourceCode = {
-            lines: [],
-            getCommentsBefore: jest.fn().mockReturnValue([
-                { value: "@story first part" },
-                { value: "@req REQ-FIRST" },
-            ]),
-            getText: jest.fn(),
-        };
-        // SwitchCase-like node with loc.start.line corresponding to "case 1:" line (line 3)
-        const switchCaseNode = {
-            type: "SwitchCase",
-            loc: {
-                start: { line: 3, column: 0 },
-                end: { line: 3, column: 7 },
-            },
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, switchCaseNode);
-        expect(text).toBe("@story first part @req REQ-FIRST");
-    });
-    it("should gather comment text for CatchClause and loop nodes via gatherBranchCommentText (Story 004.0-DEV-BRANCH-ANNOTATIONS)", () => {
-        // CatchClause: comments come from getCommentsBefore when beforeText already contains @story
-        const catchComments = [
-            { type: "Line", value: "@story catch branch story" },
-            { type: "Line", value: "additional info" },
-        ];
-        const sourceCodeCatch = {
-            getCommentsBefore: jest.fn().mockReturnValue(catchComments),
-            getText: jest.fn().mockReturnValue("@story existing beforeText"),
-            lines: [],
-        };
-        const catchNode = {
-            type: "CatchClause",
-            loc: {
-                start: { line: 10, column: 0 },
-                end: { line: 12, column: 1 },
-            },
-        };
-        const catchText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCodeCatch, catchNode);
-        expect(sourceCodeCatch.getCommentsBefore).toHaveBeenCalledWith(catchNode);
-        expect(catchText).toContain("@story catch branch story");
-        expect(catchText).toContain("additional info");
-        // Loop node: ForStatement currently uses beforeComments.map(extractCommentValue).join(" ")
-        const loopComments = [
-            { type: "Line", value: "@story loop branch story" },
-            { type: "Block", value: "loop details" },
-        ];
-        const sourceCodeLoop = {
-            getCommentsBefore: jest.fn().mockReturnValue(loopComments),
-            getText: jest.fn().mockReturnValue("@story loop beforeText"),
-            lines: [],
-        };
-        const forNode = {
-            type: "ForStatement",
-            loc: {
-                start: { line: 20, column: 0 },
-                end: { line: 25, column: 1 },
-            },
-        };
-        const loopText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCodeLoop, forNode);
-        expect(sourceCodeLoop.getCommentsBefore).toHaveBeenCalledWith(forNode);
-        expect(loopText).toBe("@story loop branch story loop details");
-    });
-    it("[REQ-INSIDE-BRACE-PLACEMENT][REQ-PLACEMENT-CONFIG] uses inside-loop comments when annotationPlacement is 'inside' and ignores before-loop annotations", () => {
-        const sourceCode = {
-            lines: [
-                "// @story before-loop should be ignored in inside mode",
-                "for (const item of items) {",
-                "  // @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md",
-                "  // @req REQ-LOOP-INSIDE",
-                "  process(item);",
-                "}",
-            ],
-            getCommentsBefore: jest
-                .fn()
-                .mockReturnValue([
-                { value: "@story before-loop should be ignored in inside mode" },
-            ]),
-        };
-        const loopNode = {
-            type: "ForOfStatement",
-            loc: {
-                start: { line: 2, column: 0 },
-                end: { line: 5, column: 1 },
-            },
-            body: {
-                type: "BlockStatement",
-                loc: {
-                    start: { line: 2, column: 27 },
-                    end: { line: 5, column: 1 },
-                },
-            },
-        };
-        const parent = {
-            type: "BlockStatement",
-            body: [loopNode],
-        };
-        const insideText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, loopNode, parent, "inside");
-        expect(insideText).toContain("@story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md");
-        expect(insideText).toContain("@req REQ-LOOP-INSIDE");
-        expect(insideText).not.toContain("before-loop should be ignored");
-    });
-    it("[REQ-INSIDE-BRACE-PLACEMENT][REQ-PLACEMENT-CONFIG] uses inside-catch comments when annotationPlacement is 'inside' and ignores before-catch annotations", () => {
-        const sourceCode = {
-            lines: [
-                "// @story before-catch should be ignored in inside mode",
-                "try {",
-                "  doSomething();",
-                "}",
-                "catch (error) {",
-                "  // @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md",
-                "  // @req REQ-CATCH-INSIDE",
-                "  handleError(error);",
-                "}",
-            ],
-            getCommentsBefore: jest
-                .fn()
-                .mockReturnValue([
-                { value: "@story before-catch should be ignored in inside mode" },
-            ]),
-        };
-        const catchNode = {
-            type: "CatchClause",
-            loc: {
-                start: { line: 5, column: 0 },
-                end: { line: 8, column: 1 },
-            },
-            body: {
-                type: "BlockStatement",
-                loc: {
-                    start: { line: 5, column: 14 },
-                    end: { line: 8, column: 1 },
-                },
-            },
-        };
-        const parent = {
-            type: "TryStatement",
-            handler: catchNode,
-        };
-        const insideText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, catchNode, parent, "inside");
-        expect(insideText).toContain("@story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md");
-        expect(insideText).toContain("@req REQ-CATCH-INSIDE");
-        expect(insideText).not.toContain("before-catch should be ignored");
-    });
-    it("[REQ-INSIDE-BRACE-PLACEMENT][REQ-PLACEMENT-CONFIG] uses inside-switch comments when annotationPlacement is 'inside' and ignores before-case annotations", () => {
-        const sourceCode = {
-            lines: [
-                "// @story before-switch should be ignored in inside mode",
-                "switch (value) {",
-                "  case 'a': {",
-                "    // @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md",
-                "    // @req REQ-SWITCH-INSIDE",
-                "    doSomething();",
-                "  }",
-                "}",
-            ],
-            getCommentsBefore: jest
-                .fn()
-                .mockReturnValue([
-                { value: "@story before-switch should be ignored in inside mode" },
-            ]),
-        };
-        const switchCaseNode = {
-            type: "SwitchCase",
-            loc: {
-                start: { line: 3, column: 2 },
-                end: { line: 7, column: 4 },
-            },
-            consequent: [
-                {
-                    type: "BlockStatement",
-                    loc: {
-                        start: { line: 3, column: 16 },
-                        end: { line: 7, column: 4 },
-                    },
-                },
-            ],
-        };
-        const parent = {
-            type: "SwitchStatement",
-            discriminant: { type: "Identifier", name: "value" },
-            cases: [switchCaseNode],
-        };
-        const insideText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, switchCaseNode, parent, "inside");
-        expect(insideText).toContain("@story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md");
-        expect(insideText).toContain("@req REQ-SWITCH-INSIDE");
-        expect(insideText).not.toContain("before-switch should be ignored");
-    });
-});
-/**
- * Tests for annotationPlacement wiring at helper level
- * @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md
- * @supports docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md REQ-PLACEMENT-CONFIG
- * @supports docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md REQ-DEFAULT-BACKWARD-COMPAT
- */
-describe("gatherBranchCommentText annotationPlacement wiring (Story 028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION)", () => {
-    it("[REQ-PLACEMENT-CONFIG][REQ-DEFAULT-BACKWARD-COMPAT] honors configured placement for simple if-statements", () => {
-        const sourceCode = {
-            lines: [
-                "function demo() {",
-                "  if (condition) {",
-                "    // @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md",
-                "    // @req REQ-INSIDE",
-                "    doSomething();",
-                "  }",
-                "}",
-            ],
-            getCommentsBefore: jest
-                .fn()
-                .mockReturnValue([
-                { value: "@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md" },
-                { value: "@req REQ-BEFORE" },
-            ]),
-        };
-        const ifNode = {
-            type: "IfStatement",
-            loc: {
-                start: { line: 2, column: 2 },
-                end: { line: 5, column: 3 },
-            },
-            consequent: {
-                type: "BlockStatement",
-                loc: {
-                    start: { line: 2, column: 18 },
-                    end: { line: 5, column: 3 },
-                },
-            },
-        };
-        const parent = {
-            type: "BlockStatement",
-            body: [ifNode],
-        };
-        const beforeText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, ifNode, parent, "before");
-        expect(beforeText).toContain("@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md");
-        expect(beforeText).toContain("@req REQ-BEFORE");
-        const insideText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, ifNode, parent, "inside");
-        expect(insideText).toContain("@story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md");
-        expect(insideText).toContain("@req REQ-INSIDE");
-        expect(insideText).not.toContain("@req REQ-BEFORE");
-    });
-    it("[REQ-PLACEMENT-CONFIG][REQ-DEFAULT-BACKWARD-COMPAT] honors Story 028.0 inside-placement semantics for else-if branches while preserving Story 026.0 before-else behavior", () => {
-        const sourceCode = {
-            lines: [
-                "function demoElseIf(x) {", // 1
-                "  if (x === 1) {", // 2
-                "    // @story inside-if", // 3
-                "    doOne();", // 4
-                "  }", // 5
-                "  // @story docs/stories/026.0-DEV-BRANCH-ANNOTATIONS-ELSE-BRANCHES.story.md", // 6 (before else-if)
-                "  // @req REQ-BEFORE-ELSE", // 7
-                "  else if (x === 2) {", // 8
-                "    // @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md", // 9 (inside else-if)
-                "    // @req REQ-ELSE-IF-INSIDE", // 10
-                "    doTwo();", // 11
-                "  }", // 12
-                "}", // 13
-            ],
-            getCommentsBefore: jest.fn().mockImplementation((node) => {
-                // Simulate ESLint getCommentsBefore only returning comments that are truly
-                // "before" the node they are querying.
-                // Our chain has:
-                // - before-if comments not used in this test
-                // - line 6-7 as before-else-if comments
-                if (node && node.loc && node.loc.start && node.loc.start.line === 2) {
-                    // before the initial if (not used in assertions here)
-                    return [
-                        { value: "@story BEFORE-IF" },
-                        { value: "@req REQ-BEFORE-IF" },
-                    ];
-                }
-                if (node && node.loc && node.loc.start && node.loc.start.line === 8) {
-                    // before the else-if branch (Story 026.0 semantics)
-                    return [
-                        {
-                            value: "@story docs/stories/026.0-DEV-BRANCH-ANNOTATIONS-ELSE-BRANCHES.story.md",
-                        },
-                        { value: "@req REQ-BEFORE-ELSE" },
-                    ];
-                }
-                return [];
-            }),
-        };
-        const elseIfNode = {
-            type: "IfStatement",
-            loc: {
-                start: { line: 8, column: 2 },
-                end: { line: 12, column: 3 },
-            },
-            consequent: {
-                type: "BlockStatement",
-                loc: {
-                    start: { line: 8, column: 22 },
-                    end: { line: 12, column: 3 },
-                },
-            },
-        };
-        const parent = {
-            type: "IfStatement",
-            alternate: elseIfNode,
-        };
-        const beforeText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, elseIfNode, parent, "before");
-        expect(beforeText).toContain("@story docs/stories/026.0-DEV-BRANCH-ANNOTATIONS-ELSE-BRANCHES.story.md");
-        expect(beforeText).toContain("@req REQ-BEFORE-ELSE");
-        const insideText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, elseIfNode, parent, "inside");
-        expect(insideText).toBe("");
-        expect(insideText).not.toContain("REQ-BEFORE-ELSE");
-        expect(insideText).not.toContain("docs/stories/026.0-DEV-BRANCH-ANNOTATIONS-ELSE-BRANCHES.story.md");
-    });
-    it("[REQ-PLACEMENT-CONFIG][REQ-DEFAULT-BACKWARD-COMPAT] honors configured placement for TryStatement branches in try/finally patterns", () => {
-        const sourceCode = {
-            lines: [
-                "function demoTry() {", // 1
-                "  // @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md", // 2 (before try)
-                "  // @req REQ-BEFORE-TRY", // 3
-                "  try {", // 4
-                "    // @story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md", // 5 (inside try)
-                "    // @req REQ-TRY-INSIDE", // 6
-                "    doWork();", // 7
-                "  } finally {", // 8
-                "    cleanup();", // 9
-                "  }", // 10
-                "}", // 11
-            ],
-            getCommentsBefore: jest.fn().mockImplementation((node) => {
-                if (node && node.loc && node.loc.start && node.loc.start.line === 4) {
-                    return [
-                        {
-                            value: "@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md",
-                        },
-                        { value: "@req REQ-BEFORE-TRY" },
-                    ];
-                }
-                return [];
-            }),
-        };
-        const tryNode = {
-            type: "TryStatement",
-            loc: {
-                start: { line: 4, column: 2 },
-                end: { line: 9, column: 3 },
-            },
-            block: {
-                type: "BlockStatement",
-                loc: {
-                    start: { line: 4, column: 8 },
-                    end: { line: 7, column: 3 },
-                },
-            },
-            handler: null,
-            finalizer: {
-                type: "BlockStatement",
-                loc: {
-                    start: { line: 8, column: 12 },
-                    end: { line: 9, column: 3 },
-                },
-            },
-        };
-        const parent = {
-            type: "BlockStatement",
-            body: [tryNode],
-        };
-        const beforeText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, tryNode, parent, "before");
-        expect(beforeText).toContain("@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md");
-        expect(beforeText).toContain("@req REQ-BEFORE-TRY");
-        expect(beforeText).not.toContain("REQ-TRY-INSIDE");
-        const insideText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, tryNode, parent, "inside");
-        expect(insideText).toContain("@story docs/stories/028.0-DEV-ANNOTATION-PLACEMENT-STANDARDIZATION.story.md");
-        expect(insideText).toContain("@req REQ-TRY-INSIDE");
-        expect(insideText).not.toContain("REQ-BEFORE-TRY");
-    });
-    it("[REQ-PLACEMENT-CONFIG][REQ-DEFAULT-BACKWARD-COMPAT] honors before-case annotations for SwitchCase in default placement mode", () => {
-        const sourceCode = {
-            lines: [
-                "// @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md",
-                "// @req REQ-SWITCH-BEFORE",
-                "switch (value) {",
-                "  case 'a':",
-                "    doSomething();",
-                "}",
-            ],
-            getCommentsBefore: jest
-                .fn()
-                .mockReturnValue([
-                {
-                    value: "@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md",
-                },
-                { value: "@req REQ-SWITCH-BEFORE" },
-            ]),
-        };
-        const switchCaseNode = {
-            type: "SwitchCase",
-            loc: {
-                start: { line: 4, column: 2 },
-                end: { line: 5, column: 18 },
-            },
-            consequent: [
-                {
-                    type: "ExpressionStatement",
-                    loc: {
-                        start: { line: 5, column: 4 },
-                        end: { line: 5, column: 18 },
-                    },
-                },
-            ],
-        };
-        const parent = {
-            type: "SwitchStatement",
-            discriminant: { type: "Identifier", name: "value" },
-            cases: [switchCaseNode],
-        };
-        const beforeText = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, switchCaseNode, parent, "before");
-        expect(beforeText).toContain("@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md");
-        expect(beforeText).toContain("@req REQ-SWITCH-BEFORE");
-    });
-});

package/lib/tests/utils/fsTestHelpers.d.ts

@@ -1,7 +0,0 @@
-/**
- * Shared filesystem mocking utilities for rule tests.
- *
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-TEST-UTILS-FS - Provide helpers to reduce duplication in fs-related tests
- */
-export declare function mockFsForExistingFile(fs: typeof import("fs"), filePath: string): void;

package/lib/tests/utils/fsTestHelpers.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockFsForExistingFile = mockFsForExistingFile;
-/**
- * Shared filesystem mocking utilities for rule tests.
- *
- * @story docs/stories/006.0-DEV-FILE-VALIDATION.story.md
- * @req REQ-TEST-UTILS-FS - Provide helpers to reduce duplication in fs-related tests
- */
-function mockFsForExistingFile(fs, filePath) {
-    jest.spyOn(fs, "existsSync").mockImplementation((...args) => {
-        const p = args[0];
-        return p === filePath;
-    });
-    jest.spyOn(fs, "statSync").mockImplementation((...args) => {
-        const p = args[0];
-        if (p === filePath) {
-            return {
-                isFile: () => true,
-            };
-        }
-        const err = new Error("ENOENT");
-        err.code = "ENOENT";
-        throw err;
-    });
-}

package/lib/tests/utils/ioTestHelpers.d.ts

@@ -1,7 +0,0 @@
-/**
- * Shared IO helper tests for require-story-io behavior.
- *
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-TEST-UTILS-IO - Provide reusable helpers for IO-related edge case tests
- */
-export declare function runFallbackTextBeforeHasStoryDetectsStoryTest(storyAnnotationOrFallbackFn?: string | ((_source: any, _node: any) => boolean), maybeFallbackFn?: (_source: any, _node: any) => boolean): void;

package/lib/tests/utils/ioTestHelpers.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runFallbackTextBeforeHasStoryDetectsStoryTest = runFallbackTextBeforeHasStoryDetectsStoryTest;
-/**
- * Shared IO helper tests for require-story-io behavior.
- *
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-TEST-UTILS-IO - Provide reusable helpers for IO-related edge case tests
- */
-function runFallbackTextBeforeHasStoryDetectsStoryTest(storyAnnotationOrFallbackFn = "@story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md", maybeFallbackFn) {
-    const isFirstArgFn = typeof storyAnnotationOrFallbackFn === "function";
-    const storyAnnotation = isFirstArgFn
-        ? "@story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md"
-        : storyAnnotationOrFallbackFn;
-    const fallbackFn = isFirstArgFn
-        ? storyAnnotationOrFallbackFn
-        : maybeFallbackFn;
-    const pre = `/* ${storyAnnotation} */\n`;
-    const rest = "function y() {}";
-    const full = pre + rest;
-    const fakeSource = { getText: () => full };
-    const node = { range: [full.indexOf("function"), full.length] };
-    expect(fallbackFn(fakeSource, node)).toBe(true);
-}