refactor: add PHPStan generic type annotations to Extractors and Detectors

      Added PHPDoc template annotations to improve type safety and PHPStan compatibility across all adapter classes. This change removes the need for inline @var annotations by properly declaring generic type
      relationships between Extractors and Detectors.

Author: sasezaki

src/Adapters/Archive/Detectors/AuthorName.php

@@ -3,14 +3,15 @@
 
 namespace Embed\Adapters\Archive\Detectors;
 
-use Embed\Adapters\Archive\Extractor;
 use Embed\Detectors\AuthorName as Detector;
 
+/**
+ * @extends Detector<\Embed\Adapters\Archive\Extractor>
+ */
 class AuthorName extends Detector
 {
     public function detect(): ?string
     {
-        /** @var Extractor $extractor */
         $extractor = $this->extractor;
         $api = $extractor->getApi();
 

src/Adapters/Archive/Detectors/Code.php

@@ -8,6 +8,9 @@
 use function Embed\html;
 use function Embed\matchPath;
 
+/**
+ * @extends Detector<\Embed\Adapters\Archive\Extractor>
+ */
 class Code extends Detector
 {
     public function detect(): ?EmbedCode

src/Adapters/Archive/Detectors/Description.php

@@ -3,14 +3,15 @@
 
 namespace Embed\Adapters\Archive\Detectors;
 
-use Embed\Adapters\Archive\Extractor;
 use Embed\Detectors\Description as Detector;
 
+/**
+ * @extends Detector<\Embed\Adapters\Archive\Extractor>
+ */
 class Description extends Detector
 {
     public function detect(): ?string
     {
-        /** @var Extractor $extractor */
         $extractor = $this->extractor;
         $api = $extractor->getApi();
 

src/Adapters/Archive/Detectors/ProviderName.php

@@ -5,6 +5,9 @@
 
 use Embed\Detectors\ProviderName as Detector;
 
+/**
+ * @extends Detector<\Embed\Adapters\Archive\Extractor>
+ */
 class ProviderName extends Detector
 {
     public function detect(): string

src/Adapters/Archive/Detectors/PublishedTime.php

@@ -4,14 +4,15 @@
 namespace Embed\Adapters\Archive\Detectors;
 
 use DateTime;
-use Embed\Adapters\Archive\Extractor;
 use Embed\Detectors\PublishedTime as Detector;
 
+/**
+ * @extends Detector<\Embed\Adapters\Archive\Extractor>
+ */
 class PublishedTime extends Detector
 {
     public function detect(): ?DateTime
     {
-        /** @var Extractor $extractor */
         $extractor = $this->extractor;
         $api = $extractor->getApi();
 

src/Adapters/Archive/Detectors/Title.php

@@ -3,14 +3,15 @@
 
 namespace Embed\Adapters\Archive\Detectors;
 
-use Embed\Adapters\Archive\Extractor;
 use Embed\Detectors\Title as Detector;
 
+/**
+ * @extends Detector<\Embed\Adapters\Archive\Extractor>
+ */
 class Title extends Detector
 {
     public function detect(): ?string
     {
-        /** @var Extractor $extractor */
         $extractor = $this->extractor;
         $api = $extractor->getApi();
 

src/Adapters/Archive/Extractor.php

@@ -9,6 +9,9 @@
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\UriInterface;
 
+/**
+ * @template-extends Base<\Embed\Detectors\Detector<self>>
+ */
 class Extractor extends Base
 {
     private Api $api;
@@ -28,9 +31,6 @@ public function getApi(): Api
         return $this->api;
     }
 
-    /**
-     * @return array<string, \Embed\Detectors\Detector>
-     */
     public function createCustomDetectors(): array
     {
         return [

src/Adapters/Bandcamp/Detectors/ProviderName.php

@@ -5,6 +5,9 @@
 
 use Embed\Detectors\ProviderName as Detector;
 
+/**
+ * @extends Detector<\Embed\Adapters\Bandcamp\Extractor>
+ */
 class ProviderName extends Detector
 {
     public function detect(): string

src/Adapters/Bandcamp/Extractor.php

@@ -5,11 +5,11 @@
 
 use Embed\Extractor as Base;
 
+/**
+ * @template-extends Base<\Embed\Detectors\Detector<self>>
+ */
 class Extractor extends Base
 {
-    /**
-     * @return array<string, \Embed\Detectors\Detector>
-     */
     public function createCustomDetectors(): array
     {
         return [

src/Adapters/CadenaSer/Detectors/Code.php

@@ -9,6 +9,9 @@
 use function Embed\html;
 use function Embed\matchPath;
 
+/**
+ * @extends Detector<\Embed\Adapters\CadenaSer\Extractor>
+ */
 class Code extends Detector
 {
     public function detect(): ?EmbedCode