Fix @throws dependency line numbers to point to the tag, not the method

The startLine attribute was incorrectly set to the method's start line.
Now uses the docblock start line combined with the relative line of each
@throws tag (from ParserConfig lines=true) to compute the correct
absolute line in the file.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: fain182

src/Analyzer/Docblock.php

@@ -44,15 +44,21 @@ public function getReturnTagTypes(): array
         return array_filter($returnTypes);
     }
 
+    /**
+     * @return array<array{type: string, line: int}>
+     */
     public function getThrowTagsTypes(): array
     {
-        $throwTypes = array_map(
-            fn (ThrowsTagValueNode $throwTag) => $this->getType($throwTag->type),
-            $this->phpDocNode->getThrowsTagValues()
-        );
+        $throwTypes = [];
 
-        // remove null values
-        return array_filter($throwTypes);
+        foreach ($this->phpDocNode->getThrowsTagValues() as $throwTag) {
+            $type = $this->getType($throwTag->type);
+            if (null !== $type) {
+                $throwTypes[] = ['type' => $type, 'line' => $throwTag->getAttribute('startLine') ?? 0];
+            }
+        }
+
+        return $throwTypes;
     }
 
     public function getVarTagTypes(): array

src/Analyzer/DocblockTypesResolver.php

@@ -188,16 +188,18 @@ private function resolveThrowsValueType(Node $node, Docblock $docblock): void
             return;
         }
 
+        $docblockStartLine = $node->getDocComment() ? $node->getDocComment()->getStartLine() : $node->getStartLine();
+
         $throwsTypesResolved = [];
 
-        foreach ($throwValues as $throwValue) {
+        foreach ($throwValues as ['type' => $throwValue, 'line' => $relativeLine]) {
             if (str_starts_with($throwValue, '\\')) {
                 $name = new FullyQualified(substr($throwValue, 1));
             } else {
                 $name = $this->resolveName(new Name($throwValue), Stmt\Use_::TYPE_NORMAL);
             }
 
-            $name->setAttribute('startLine', $node->getStartLine());
+            $name->setAttribute('startLine', $docblockStartLine + $relativeLine - 1);
 
             $throwsTypesResolved[] = $name;
         }

tests/Unit/Analyzer/DocblockParserTest.php

@@ -114,9 +114,12 @@ public function test_it_should_extract_types_from_throws_tag(): void
 
         $varTags = $db->getThrowTagsTypes();
         self::assertCount(3, $varTags);
-        self::assertEquals('\Exception', $varTags[0]);
-        self::assertEquals('\Domain\Foo\FooException', $varTags[1]);
-        self::assertEquals('BarException', $varTags[2]);
+        self::assertEquals('\Exception', $varTags[0]['type']);
+        self::assertEquals('\Domain\Foo\FooException', $varTags[1]['type']);
+        self::assertEquals('BarException', $varTags[2]['type']);
+        self::assertEquals(2, $varTags[0]['line']);
+        self::assertEquals(3, $varTags[1]['line']);
+        self::assertEquals(4, $varTags[2]['line']);
     }
 
     public function test_it_should_extract_doctrine_like_annotations(): void

tests/Unit/Analyzer/DocblockTypesResolverTest.php

@@ -104,7 +104,9 @@ public function myMethod2(array $aParam, array $users): array
         self::assertEquals('Application\Model\Product', $dep[6]->getFQCN()->toString());
         self::assertEquals('Domain\Foo\MyOtherClass', $dep[7]->getFQCN()->toString());
         self::assertEquals('Domain\Foo\FooException', $dep[8]->getFQCN()->toString());
+        self::assertEquals(55, $dep[8]->getLine());
         self::assertEquals('Domain\Foo\BarException', $dep[9]->getFQCN()->toString());
+        self::assertEquals(56, $dep[9]->getLine());
         self::assertEquals('Application\Model\User', $dep[10]->getFQCN()->toString());
     }
 }