Improve docblocks

src/Paginations/AnyPagination.php

@@ -26,7 +26,7 @@ class AnyPagination extends Pagination
     ];
 
     /**
-     * Determine whether the configuration matches this pagination.
+     * Determine whether this pagination matches the configuration.
      */
     public function matches(): bool
     {

src/Sources/AnySource.php

@@ -5,22 +5,24 @@
 namespace Cerbero\LazyJsonPages\Sources;
 
 use Cerbero\LazyJsonPages\Exceptions\UnsupportedSourceException;
-use Generator;
 use Psr\Http\Message\RequestInterface;
 
+/**
+ * The aggregator of sources.
+ */
 class AnySource extends Source
 {
     /**
      * @var class-string<Source>[]
      */
     protected array $supportedSources = [
-        CustomSource::class,
+        // CustomSource::class,
         Endpoint::class,
-        LaravelClientRequest::class,
-        LaravelClientResponse::class,
-        LaravelRequest::class,
-        Psr7Request::class,
-        SymfonyRequest::class,
+        // LaravelClientRequest::class,
+        // LaravelClientResponse::class,
+        // LaravelRequest::class,
+        // Psr7Request::class,
+        // SymfonyRequest::class,
     ];
 
     /**
@@ -29,13 +31,16 @@ class AnySource extends Source
     protected ?Source $matchingSource;
 
     /**
-     * Determine whether the JSON source can be handled
+     * Determine whether this class can handle the source
      */
     public function matches(): bool
     {
         return true;
     }
 
+    /**
+     * Retrieve the HTTP request
+     */
     public function request(): RequestInterface
     {
         return $this->matchingSource()->request();
@@ -52,7 +57,9 @@ protected function matchingSource(): Source
             return $this->matchingSource;
         }
 
-        foreach ($this->sources() as $source) {
+        foreach ($this->supportedSources as $class) {
+            $source = new $class($this->source);
+
             if ($source->matches()) {
                 return $this->matchingSource = $source;
             }
@@ -62,17 +69,10 @@ protected function matchingSource(): Source
     }
 
     /**
-     * Retrieve all available sources
+     * Retrieve the HTTP response or part of it
      *
-     * @return Generator<int, Source>
+     * @return ($key is string ? mixed : \Cerbero\LazyJsonPages\ValueObjects\Response)
      */
-    protected function sources(): Generator
-    {
-        foreach ($this->supportedSources as $source) {
-            yield new $source($this->source);
-        }
-    }
-
     public function response(?string $key = null): mixed
     {
         return $this->matchingSource()->response($key);

src/Sources/Source.php

@@ -12,9 +12,20 @@ final public function __construct(
         protected readonly mixed $source,
     ) {}
 
+    /**
+     * Determine whether this class can handle the source
+     */
     abstract public function matches(): bool;
 
+    /**
+     * Retrieve the HTTP request
+     */
     abstract public function request(): RequestInterface;
 
+    /**
+     * Retrieve the HTTP response or part of it
+     *
+     * @return ($key is string ? mixed : \Cerbero\LazyJsonPages\ValueObjects\Response)
+     */
     abstract public function response(?string $key = null): mixed;
 }