eslint-plugin-traceability 1.23.0 → 1.24.0

package/lib/tests/utils/annotation-checker.test.d.ts

@@ -1,24 +0,0 @@
-type AnnotationCheckerTestConfig = {
-    rule: any;
-    valid: Array<{
-        name: string;
-        code: string;
-        [key: string]: any;
-    }>;
-    invalid: Array<{
-        name: string;
-        code: string;
-        errors: any[];
-        [key: string]: any;
-    }>;
-};
-/**
- * Shared helper for running tests that exercise the annotation-checker logic
- * for TypeScript constructs.
- *
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-TYPESCRIPT-SUPPORT - Support TypeScript-specific function syntax
- * @req REQ-TEST-UTILS-TS-LANG - Shared TS RuleTester language options helper
- */
-export declare function runAnnotationCheckerTests(ruleName: string, config: AnnotationCheckerTestConfig): void;
-export {};

package/lib/tests/utils/annotation-checker.test.js

@@ -1,84 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAnnotationCheckerTests = runAnnotationCheckerTests;
-/**
- * Tests for: docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-TYPESCRIPT-SUPPORT - Support TypeScript-specific function syntax
- * @req REQ-TEST-UTILS-TS-LANG - Shared TS RuleTester language options helper
- * @supports docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md REQ-TYPESCRIPT-SUPPORT REQ-TEST-UTILS-TS-LANG
- */
-const eslint_1 = require("eslint");
-const annotation_checker_1 = require("../../src/utils/annotation-checker");
-const ts_language_options_1 = require("./ts-language-options");
-const ruleTester = new eslint_1.RuleTester();
-/**
- * Shared helper for running tests that exercise the annotation-checker logic
- * for TypeScript constructs.
- *
- * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
- * @req REQ-TYPESCRIPT-SUPPORT - Support TypeScript-specific function syntax
- * @req REQ-TEST-UTILS-TS-LANG - Shared TS RuleTester language options helper
- */
-function runAnnotationCheckerTests(ruleName, config) {
-    const { rule, valid, invalid } = config;
-    ruleTester.run(ruleName, rule, {
-        valid: valid.map(ts_language_options_1.withTsLanguageOptions),
-        invalid: invalid.map(ts_language_options_1.withTsLanguageOptions),
-    });
-}
-const rule = {
-    meta: {
-        type: "problem",
-        fixable: "code",
-        docs: {
-            description: "Test helper for checking @req annotation",
-            recommended: "error",
-        },
-        messages: { missingReq: "Missing @req annotation" },
-        schema: [],
-    },
-    create(context) {
-        return {
-            /**
-             * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
-             * @req REQ-TYPESCRIPT-SUPPORT - Support TypeScript-specific function syntax
-             */
-            TSDeclareFunction: (node) => (0, annotation_checker_1.checkReqAnnotation)(context, node),
-            /**
-             * @story docs/stories/003.0-DEV-FUNCTION-ANNOTATIONS.story.md
-             * @req REQ-TYPESCRIPT-SUPPORT - Support TypeScript-specific function syntax
-             */
-            TSMethodSignature: (node) => (0, annotation_checker_1.checkReqAnnotation)(context, node),
-        };
-    },
-};
-describe("annotation-checker helper (Story 003.0-DEV-FUNCTION-ANNOTATIONS)", () => {
-    runAnnotationCheckerTests("annotation-checker", {
-        rule,
-        valid: [
-            {
-                name: "[REQ-TYPESCRIPT-SUPPORT] valid TSDeclareFunction with @req",
-                code: `/** @req REQ-TEST */\ndeclare function foo(): void;`,
-            },
-            {
-                name: "[REQ-TYPESCRIPT-SUPPORT] valid TSMethodSignature with @req",
-                code: `interface I { /** @req REQ-TEST */ method(): void; }`,
-            },
-        ],
-        invalid: [
-            {
-                name: "[REQ-TYPESCRIPT-SUPPORT] missing @req on TSDeclareFunction",
-                code: `declare function foo(): void;`,
-                output: `/** @req <REQ-ID> */\ndeclare function foo(): void;`,
-                errors: [{ messageId: "missingReq" }],
-            },
-            {
-                name: "[REQ-TYPESCRIPT-SUPPORT] missing @req on TSMethodSignature",
-                code: `interface I { method(): void; }`,
-                output: `interface I { /** @req <REQ-ID> */\nmethod(): void; }`,
-                errors: [{ messageId: "missingReq" }],
-            },
-        ],
-    });
-});

package/lib/tests/utils/annotation-scope-analyzer.test.d.ts

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

package/lib/tests/utils/annotation-scope-analyzer.test.js

@@ -1,211 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const annotation_scope_analyzer_1 = require("../../src/utils/annotation-scope-analyzer");
-describe("annotation-scope-analyzer helpers (Story 027.0-DEV-REDUNDANT-ANNOTATION-DETECTION)", () => {
-    it("[REQ-DUPLICATION-DETECTION] builds stable story/req keys", () => {
-        const key = (0, annotation_scope_analyzer_1.toStoryReqKey)("docs/stories/001.story.md", "REQ-ONE");
-        expect(key).toBe("docs/stories/001.story.md|REQ-ONE");
-    });
-    it("[REQ-DUPLICATION-DETECTION] normalizes missing story or requirement to empty segments", () => {
-        const noStory = (0, annotation_scope_analyzer_1.toStoryReqKey)(null, "REQ-ONE");
-        const noReq = (0, annotation_scope_analyzer_1.toStoryReqKey)("docs/stories/001.story.md", undefined);
-        expect(noStory).toBe("|REQ-ONE");
-        expect(noReq).toBe("docs/stories/001.story.md|");
-    });
-    it("[REQ-DUPLICATION-DETECTION] extracts pairs from @story/@req sequences", () => {
-        const text = `// @story docs/stories/001.story.md\n// @req REQ-ONE`;
-        const pairs = (0, annotation_scope_analyzer_1.extractStoryReqPairsFromText)(text);
-        expect(Array.from(pairs)).toEqual([
-            "docs/stories/001.story.md|REQ-ONE",
-        ]);
-    });
-    it("[REQ-DUPLICATION-DETECTION] returns empty set when text has no annotations", () => {
-        const pairs = (0, annotation_scope_analyzer_1.extractStoryReqPairsFromText)("");
-        expect(pairs.size).toBe(0);
-    });
-    it("[REQ-SCOPE-ANALYSIS] extracts pairs from @supports lines", () => {
-        const text = `// @supports docs/stories/002.story.md REQ-A REQ-B OTHER`;
-        const pairs = (0, annotation_scope_analyzer_1.extractStoryReqPairsFromText)(text);
-        expect(pairs.has("docs/stories/002.story.md|REQ-A")).toBe(true);
-        expect(pairs.has("docs/stories/002.story.md|REQ-B")).toBe(true);
-    });
-    it("[REQ-DUPLICATION-DETECTION] aggregates pairs across comments", () => {
-        const comments = [
-            { value: "// @story docs/stories/001.story.md\n// @req REQ-ONE" },
-            { value: "// @supports docs/stories/002.story.md REQ-TWO" },
-        ];
-        const pairs = (0, annotation_scope_analyzer_1.extractStoryReqPairsFromComments)(comments);
-        expect(pairs.size).toBe(2);
-    });
-    it("[REQ-DUPLICATION-DETECTION] returns empty set for empty comments list", () => {
-        const pairs = (0, annotation_scope_analyzer_1.extractStoryReqPairsFromComments)([]);
-        expect(pairs.size).toBe(0);
-    });
-    it("[REQ-DUPLICATION-DETECTION] determines full coverage correctly", () => {
-        const parent = new Set([
-            "story|REQ-ONE",
-            "story|REQ-TWO",
-        ]);
-        const childCovered = new Set(["story|REQ-ONE"]);
-        const childNotCovered = new Set(["story|REQ-THREE"]);
-        expect((0, annotation_scope_analyzer_1.arePairsFullyCovered)(childCovered, parent)).toBe(true);
-        expect((0, annotation_scope_analyzer_1.arePairsFullyCovered)(childNotCovered, parent)).toBe(false);
-    });
-    it("[REQ-DUPLICATION-DETECTION] treats empty child or parent as not covered", () => {
-        const nonEmpty = new Set(["story|REQ-ONE"]);
-        expect((0, annotation_scope_analyzer_1.arePairsFullyCovered)(new Set(), nonEmpty)).toBe(false);
-        expect((0, annotation_scope_analyzer_1.arePairsFullyCovered)(nonEmpty, new Set())).toBe(false);
-    });
-    it("[REQ-STATEMENT-SIGNIFICANCE] respects alwaysCovered and strictness levels", () => {
-        const base = {
-            strictness: "moderate",
-            allowEmphasisDuplication: false,
-            maxScopeDepth: 3,
-            alwaysCovered: ["ReturnStatement"],
-        };
-        const branchTypes = ["IfStatement"];
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({ type: "ReturnStatement" }, base, branchTypes)).toBe(true);
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({ type: "ExpressionStatement" }, base, branchTypes)).toBe(true);
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({ type: "IfStatement" }, base, branchTypes)).toBe(false);
-    });
-    it("[REQ-CONFIGURABLE-STRICTNESS] treats permissive mode as only honoring alwaysCovered list", () => {
-        const options = {
-            strictness: "permissive",
-            allowEmphasisDuplication: false,
-            maxScopeDepth: 3,
-            alwaysCovered: ["ReturnStatement"],
-        };
-        const branchTypes = ["IfStatement"];
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({ type: "ReturnStatement" }, options, branchTypes)).toBe(true);
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({ type: "ExpressionStatement" }, options, branchTypes)).toBe(false);
-    });
-    it("[REQ-CONFIGURABLE-STRICTNESS] treats strict mode as allowing any non-branch statement", () => {
-        const options = {
-            strictness: "strict",
-            allowEmphasisDuplication: false,
-            maxScopeDepth: 3,
-            alwaysCovered: [],
-        };
-        const branchTypes = ["IfStatement"];
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({ type: "ExpressionStatement" }, options, branchTypes)).toBe(true);
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({ type: "IfStatement" }, options, branchTypes)).toBe(false);
-    });
-    it("[REQ-STATEMENT-SIGNIFICANCE] returns false for null or non-node values", () => {
-        const options = {
-            strictness: "moderate",
-            allowEmphasisDuplication: false,
-            maxScopeDepth: 3,
-            alwaysCovered: [],
-        };
-        const branchTypes = [];
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)(null, options, branchTypes)).toBe(false);
-        expect((0, annotation_scope_analyzer_1.isStatementEligibleForRedundancy)({}, options, branchTypes)).toBe(false);
-    });
-    it("[REQ-SAFE-REMOVAL] computes removal range for full-line comment", () => {
-        const source = `const x = 1;\n// @story docs/stories/001.story.md\nconst y = 2;\n`;
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const start = source.indexOf("// @story");
-        const end = start + "// @story docs/stories/001.story.md".length;
-        const comment = { range: [start, end] };
-        const [removalStart, removalEnd] = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        const removed = source.slice(0, removalStart) + source.slice(removalEnd);
-        expect(removed).toBe("const x = 1;\nconst y = 2;\n");
-    });
-    it("[REQ-SAFE-REMOVAL] computes removal range for full-line comment with Windows newlines", () => {
-        const source = "const x = 1;\r\n// @story docs/stories/001.story.md\r\nconst y = 2;\r\n";
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const start = source.indexOf("// @story");
-        const end = start + "// @story docs/stories/001.story.md".length;
-        const comment = { range: [start, end] };
-        const [removalStart, removalEnd] = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        const removed = source.slice(0, removalStart) + source.slice(removalEnd);
-        expect(removed).toBe("const x = 1;\r\nconst y = 2;\r\n");
-    });
-    it("[REQ-SAFE-REMOVAL] computes removal range for full-line comment with standalone CR newline", () => {
-        const source = "const x = 1;\r// @story docs/stories/001.story.md\rconst y = 2;\r";
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const start = source.indexOf("// @story");
-        const end = start + "// @story docs/stories/001.story.md".length;
-        const comment = { range: [start, end] };
-        const [removalStart, removalEnd] = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        const removed = source.slice(0, removalStart) + source.slice(removalEnd);
-        expect(removed).toBe("const x = 1;\rconst y = 2;\r");
-    });
-    it("[REQ-SAFE-REMOVAL] computes removal range for inline comment", () => {
-        const source = "const x = 1; // @story docs/stories/001.story.md\nconst y = 2;\n";
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const start = source.indexOf("// @story");
-        const end = start + "// @story docs/stories/001.story.md".length;
-        const comment = { range: [start, end] };
-        const [removalStart, removalEnd] = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        const removed = source.slice(0, removalStart) + source.slice(removalEnd);
-        expect(removed).toBe("const x = 1; \nconst y = 2;\n");
-    });
-    it("[REQ-SAFE-REMOVAL] consumes trailing spaces and tabs following a full-line comment", () => {
-        const source = "const x = 1;\n// @story docs/stories/001.story.md   	  \nconst y = 2;\n";
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const start = source.indexOf("// @story");
-        const end = start + "// @story docs/stories/001.story.md".length;
-        const comment = { range: [start, end] };
-        const [removalStart, removalEnd] = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        const removed = source.slice(0, removalStart) + source.slice(removalEnd);
-        expect(removed).toBe("const x = 1;\nconst y = 2;\n");
-    });
-    it("[REQ-SAFE-REMOVAL] handles full-line comment at end of file without trailing newline", () => {
-        const source = "const x = 1;\n// @story docs/stories/001.story.md";
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const start = source.indexOf("// @story");
-        const end = start + "// @story docs/stories/001.story.md".length;
-        const comment = { range: [start, end] };
-        const [removalStart, removalEnd] = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        const removed = source.slice(0, removalStart) + source.slice(removalEnd);
-        expect(removed).toBe("const x = 1;\n");
-        expect(removalEnd).toBe(source.length);
-    });
-    it("[REQ-SAFE-REMOVAL] returns [0, 0] for comments with invalid range length (EXPECTS EXPECTED_RANGE_LENGTH usage)", () => {
-        const source = "const x = 1;";
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const comment = { range: [0] };
-        const range = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        expect(range).toEqual([0, 0]);
-    });
-    it("[REQ-SAFE-REMOVAL] returns [0, 0] when comment range is not an array", () => {
-        const source = "const x = 1;";
-        const sourceCode = {
-            getText() {
-                return source;
-            },
-        };
-        const comment = { range: null };
-        const range = (0, annotation_scope_analyzer_1.getCommentRemovalRange)(comment, sourceCode);
-        expect(range).toEqual([0, 0]);
-    });
-});

package/lib/tests/utils/branch-annotation-catch-insert-position.test.d.ts

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

package/lib/tests/utils/branch-annotation-catch-insert-position.test.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable traceability/valid-annotation-format */
-/**
- * Unit tests for CatchClause insert position calculation.
- * @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md
- * @story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md
- * @supports docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md REQ-PRETTIER-AUTOFIX
- */
-const branch_annotation_helpers_1 = require("../../src/utils/branch-annotation-helpers");
-describe("CatchClause insert position (Story 025.0-DEV-CATCH-ANNOTATION-POSITION)", () => {
-    it("[REQ-PRETTIER-AUTOFIX] inserts annotations at the first statement inside the catch body", () => {
-        const lines = [
-            "try {",
-            "  doSomething();",
-            "}",
-            "catch (error) {",
-            "  handleError(error);",
-            "}",
-        ];
-        const fixer = {
-            insertTextBeforeRange: jest.fn((r, t) => ({ r, t })),
-        };
-        const context = {
-            getSourceCode() {
-                return {
-                    lines,
-                    getCommentsBefore() {
-                        return [];
-                    },
-                    getIndexFromLoc({ line, column }) {
-                        // simple line/column to index mapping for the test: assume each line ends with "\n"
-                        const prefix = lines.slice(0, line - 1).join("\n");
-                        return prefix.length + (line > 1 ? 1 : 0) + column;
-                    },
-                };
-            },
-            report({ fix }) {
-                // immediately invoke the fixer to exercise the insert position
-                if (typeof fix === "function") {
-                    fix(fixer);
-                }
-            },
-        };
-        const node = {
-            type: "CatchClause",
-            loc: { start: { line: 4 } },
-            body: {
-                type: "BlockStatement",
-                loc: { start: { line: 4 } },
-                body: [
-                    {
-                        type: "ExpressionStatement",
-                        loc: { start: { line: 5 } },
-                    },
-                ],
-            },
-        };
-        const storyFixCountRef = { count: 0 };
-        (0, branch_annotation_helpers_1.reportMissingAnnotations)(context, node, storyFixCountRef);
-        expect(fixer.insertTextBeforeRange).toHaveBeenCalledTimes(1);
-        const [range, text] = fixer.insertTextBeforeRange.mock.calls[0];
-        // ensure we are inserting before the first statement in the catch body (line 5)
-        const expectedIndex = context.getSourceCode().getIndexFromLoc({ line: 5, column: 0 });
-        expect(range).toEqual([expectedIndex, expectedIndex]);
-        // and that the inserted text is prefixed with the inner indentation from line 5
-        expect(text.startsWith("  ")).toBe(true);
-    });
-});

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

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

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

@@ -1,115 +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 = [], commentsInside = [] } = options;
-    return {
-        lines,
-        getCommentsBefore() {
-            return commentsBefore;
-        },
-        getCommentsInside(node) {
-            // exercise the code path that passes node.body into getCommentsInside
-            if (node && node.type === "BlockStatement") {
-                return commentsInside;
-            }
-            return [];
-        },
-    };
-}
-describe("gatherBranchCommentText CatchClause behavior (Story 025.0-DEV-CATCH-ANNOTATION-POSITION)", () => {
-    it("[REQ-DUAL-POSITION-DETECTION] prefers before-catch annotations when present", () => {
-        const sourceCode = createMockSourceCode({
-            commentsBefore: [
-                { value: "@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md" },
-                { value: "@req REQ-BRANCH-DETECTION" },
-            ],
-            commentsInside: [
-                { value: "@story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md" },
-            ],
-        });
-        const node = {
-            type: "CatchClause",
-            loc: { start: { line: 5 } },
-            body: { type: "BlockStatement" },
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node);
-        expect(text).toContain("@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md");
-        expect(text).toContain("@req REQ-BRANCH-DETECTION");
-    });
-    it("[REQ-FALLBACK-LOGIC] falls back to inside-catch annotations when before-catch is missing", () => {
-        const sourceCode = createMockSourceCode({
-            commentsBefore: [],
-            commentsInside: [
-                { value: "@story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md" },
-                { value: "@req REQ-CATCH-PATH" },
-            ],
-        });
-        const node = {
-            type: "CatchClause",
-            loc: { start: { line: 10 } },
-            body: { type: "BlockStatement" },
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node);
-        expect(text).toContain("@story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md");
-        expect(text).toContain("@req REQ-CATCH-PATH");
-    });
-    it("[REQ-FALLBACK-LOGIC] returns before-catch text when getCommentsInside is not available", () => {
-        const lines = [
-            "try {",
-            "  doSomething();",
-            "}",
-            "catch (error) {",
-            "  // body",
-            "}",
-        ];
-        const sourceCode = {
-            lines,
-            getCommentsBefore() {
-                return [
-                    { value: "@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md" },
-                    { value: "@req REQ-BRANCH-DETECTION" },
-                ];
-            },
-            // intentionally omit getCommentsInside so that the CatchClause path
-            // falls back to the before-catch comments.
-        };
-        const node = {
-            type: "CatchClause",
-            loc: { start: { line: 4 } },
-            body: { type: "BlockStatement" },
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node);
-        expect(text).toContain("@story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md");
-        expect(text).toContain("@req REQ-BRANCH-DETECTION");
-    });
-    it("[REQ-FALLBACK-LOGIC] collects inside-catch comments using line-based fallback when getCommentsInside is unavailable", () => {
-        const lines = [
-            "try {",
-            "  doSomething();",
-            "} catch (error) {",
-            "  // @story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md",
-            "  // @req REQ-CATCH-LINE-FALLBACK",
-            "  handleError(error);",
-            "}",
-        ];
-        const sourceCode = {
-            lines,
-            getCommentsBefore() {
-                return [];
-            },
-        };
-        const node = {
-            type: "CatchClause",
-            loc: { start: { line: 3 } },
-            body: {
-                type: "BlockStatement",
-                loc: { start: { line: 3 }, end: { line: 7 } },
-                body: [],
-            },
-        };
-        const text = (0, branch_annotation_helpers_1.gatherBranchCommentText)(sourceCode, node);
-        expect(text).toContain("@story docs/stories/025.0-DEV-CATCH-ANNOTATION-POSITION.story.md");
-        expect(text).toContain("@req REQ-CATCH-LINE-FALLBACK");
-    });
-});

package/lib/tests/utils/branch-annotation-else-if-insert-position.test.d.ts

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

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

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/* eslint-disable traceability/valid-annotation-format */
-/**
- * Unit tests for else-if insert position calculation.
- * @story docs/stories/004.0-DEV-BRANCH-ANNOTATIONS.story.md
- * @story docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md
- * @supports docs/stories/026.0-DEV-ELSE-IF-ANNOTATION-POSITION.story.md REQ-PRETTIER-AUTOFIX-ELSE-IF
- */
-const branch_annotation_helpers_1 = require("../../src/utils/branch-annotation-helpers");
-describe("Else-if insert position (Story 026.0-DEV-ELSE-IF-ANNOTATION-POSITION)", () => {
-    it("[REQ-PRETTIER-AUTOFIX-ELSE-IF] inserts annotations before the else-if line in Prettier-compatible default 'before' mode", () => {
-        const lines = [
-            "if (a) {",
-            "  doA();",
-            "}",
-            "else if (b) {",
-            "  doB();",
-            "}",
-        ];
-        const fixer = {
-            insertTextBeforeRange: jest.fn((r, t) => ({
-                r,
-                t,
-            })),
-        };
-        const context = {
-            options: [{ annotationPlacement: "before" }],
-            getSourceCode() {
-                return {
-                    lines,
-                    getCommentsBefore() {
-                        return [];
-                    },
-                    getIndexFromLoc({ line, column }) {
-                        // simple line/column to index mapping for the test: assume each line ends with "\n"
-                        const prefix = lines.slice(0, line - 1).join("\n");
-                        return prefix.length + (line > 1 ? 1 : 0) + column;
-                    },
-                };
-            },
-            report({ fix }) {
-                // immediately invoke the fixer to exercise the insert position
-                if (typeof fix === "function") {
-                    fix(fixer);
-                }
-            },
-        };
-        const node = {
-            type: "IfStatement",
-            loc: { start: { line: 4 } },
-            test: { loc: { end: { line: 4 } } },
-            consequent: {
-                type: "BlockStatement",
-                loc: { start: { line: 4 } },
-                body: [
-                    {
-                        type: "ExpressionStatement",
-                        loc: { start: { line: 5 } },
-                    },
-                ],
-            },
-        };
-        const parent = {
-            type: "IfStatement",
-            alternate: node,
-        };
-        node.parent = parent;
-        const storyFixCountRef = { count: 0 };
-        (0, branch_annotation_helpers_1.reportMissingAnnotations)(context, node, storyFixCountRef);
-        expect(fixer.insertTextBeforeRange).toHaveBeenCalledTimes(1);
-        const [range, text] = fixer.insertTextBeforeRange.mock
-            .calls[0];
-        // ensure we are inserting before the else-if line (line 4) when placement is 'before'
-        const expectedIndex = context
-            .getSourceCode()
-            .getIndexFromLoc({ line: 4, column: 0 });
-        expect(range).toEqual([expectedIndex, expectedIndex]);
-        // and that the inserted text is prefixed with the base indentation from line 4
-        expect(text.startsWith("")).toBe(true);
-    });
-});

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

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