Fix #207: More secific Psalm type for OffsetPaginator::withCurrentPage()

src/Paginator/OffsetPaginator.php

@@ -94,6 +94,7 @@ public function __construct(ReadableDataInterface $dataReader)
 
     public function withToken(?PageToken $token): static
     {
+        /** @psalm-suppress ArgumentTypeCoercion */
         return $this->withCurrentPage($token === null ? 1 : (int)$token->value);
     }
 
@@ -112,13 +113,15 @@ public function withPageSize(int $pageSize): static
      * Get a new instance with the given current page number set.
      *
      * @param int $page Page number.
+     * @psalm-param positive-int $page
      *
      * @throws PaginatorException If the current page is incorrect.
      *
      * @return self New instance.
      */
     public function withCurrentPage(int $page): self
     {
+        /** @psalm-suppress DocblockTypeContradiction */
         if ($page < 1) {
             throw new PaginatorException('Current page should be at least 1.');
         }
@@ -152,9 +155,11 @@ public function getPageSize(): int
      * Get the current page number.
      *
      * @return int Current page number.
+     * @psalm-return positive-int
      */
     public function getCurrentPage(): int
     {
+        /** @var positive-int */
         return (int) $this->token->value;
     }
 
@@ -314,7 +319,7 @@ public function isPaginationRequired(): bool
     }
 
     /**
-     * @psalm-return non-negative-int
+     * @psalm-return positive-int
      */
     private function getInternalTotalPages(): int
     {