Calculating the correct position in external tag parser errors

Author: Kirill Nesmeyanov

src/Parser/Tag/TagParser.php

@@ -5,6 +5,7 @@
 namespace TypeLang\PHPDoc\Parser\Tag;
 
 use TypeLang\PHPDoc\Exception\InvalidTagNameException;
+use TypeLang\PHPDoc\Exception\RuntimeExceptionInterface;
 use TypeLang\PHPDoc\FactoryInterface;
 use TypeLang\PHPDoc\Parser\Description\DescriptionParserInterface;
 use TypeLang\PHPDoc\Tag\Tag;
@@ -59,17 +60,25 @@ private function getTagName(string $content): string
     }
 
     /**
-     * @throws InvalidTagNameException
+     * @throws \Throwable
+     * @throws RuntimeExceptionInterface
      */
     public function parse(string $tag, DescriptionParserInterface $parser): Tag
     {
         $name = $this->getTagName($tag);
         /** @var non-empty-string $name */
         $name = \substr($name, 1);
 
-        $content = \substr($tag, \strlen($name) + 1);
-        $content = \ltrim($content);
+        $content = \substr($tag, $offset = \strlen($name) + 1);
+        $trimmed = \ltrim($content);
+
+        try {
+            return $this->tags->create($name, $trimmed, $parser);
+        } catch (RuntimeExceptionInterface $e) {
+            /** @var int<0, max> */
+            $offset += \strlen($content) - \strlen($trimmed);
 
-        return $this->tags->create($name, $content, $parser);
+            throw $e->withSource($tag, $offset);
+        }
     }
 }