[PHPDoc] Aligned PHPDoc after applying return type Rector

Author: alongosz

src/lib/FieldType/Author/Type.php

@@ -21,6 +21,8 @@
  *
  * Field type representing a list of authors, consisting of author name, and
  * author email.
+ *
+ * @phpstan-type TAuthorHash list<array{id: int, name: string, email:string}>
  */
 class Type extends FieldType implements TranslationContainerInterface
 {
@@ -123,9 +125,9 @@ protected function getSortInfo(BaseValue $value)
     }
 
     /**
-     * Converts an $hash to the Value defined by the field type.
+     * Converts a $hash to the Value defined by the field type.
      *
-     * @param mixed $hash
+     * @phpstan-param TAuthorHash $hash
      *
      * @return \Ibexa\Core\FieldType\Author\Value $value
      */
@@ -146,7 +148,7 @@ static function ($author) {
      *
      * @param \Ibexa\Core\FieldType\Author\Value $value
      *
-     * @return mixed
+     * @phpstan-return TAuthorHash
      */
     public function toHash(SPIValue $value): array
     {

src/lib/FieldType/Url/UrlStorage.php

@@ -36,15 +36,6 @@ public function __construct(StorageGatewayInterface $gateway, LoggerInterface $l
         $this->logger = $logger;
     }
 
-    /**
-     * @see \Ibexa\Contracts\Core\FieldType\FieldStorage
-     *
-     * @param \Ibexa\Contracts\Core\Persistence\Content\VersionInfo $versionInfo
-     * @param \Ibexa\Contracts\Core\Persistence\Content\Field $field
-     * @param array $context
-     *
-     * @return bool|mixed
-     */
     public function storeFieldData(VersionInfo $versionInfo, Field $field, array $context): bool
     {
         $url = $field->value->externalData;

src/lib/FieldType/Url/UrlStorage/Gateway/DoctrineStorage.php

@@ -99,7 +99,7 @@ public function getUrlIdMap(array $urls)
      *
      * @param string $url The URL to insert in the database
      *
-     * @return string
+     * @throws \Doctrine\DBAL\Exception
      */
     public function insertUrl($url): int
     {

src/lib/Limitation/LocationLimitationType.php

@@ -224,12 +224,6 @@ public function getCriterion(APILimitationValue $value, APIUserReference $curren
         return new Criterion\LocationId($value->limitationValues);
     }
 
-    /**
-     * Returns info on valid $limitationValues.
-     *
-     * @return mixed[]|int In case of array, a hash with key as valid limitations value and value as human readable name
-     *                     of that option, in case of int on of VALUE_SCHEMA_ constants.
-     */
     public function valueSchema(): int
     {
         return self::VALUE_SCHEMA_LOCATION_ID;

src/lib/Limitation/SubtreeLimitationType.php

@@ -258,12 +258,6 @@ public function getCriterion(APILimitationValue $value, APIUserReference $curren
         return new PermissionSubtree($value->limitationValues);
     }
 
-    /**
-     * Returns info on valid $limitationValues.
-     *
-     * @return mixed[]|int In case of array, a hash with key as valid limitations value and value as human readable name
-     *                     of that option, in case of int on of VALUE_SCHEMA_ constants.
-     */
     public function valueSchema(): int
     {
         return self::VALUE_SCHEMA_LOCATION_PATH;

src/lib/Persistence/Legacy/Content/FieldValue/Converter/AuthorConverter.php

@@ -33,10 +33,8 @@ public static function create()
     }
 
     /**
-     * Converts data from $value to $storageFieldValue.
-     *
-     * @param \Ibexa\Contracts\Core\Persistence\Content\FieldValue $value
-     * @param \Ibexa\Core\Persistence\Legacy\Content\StorageFieldValue $storageFieldValue
+     * @throws \DOMException
+     * @throws \Ibexa\Contracts\Core\Repository\Exceptions\InvalidArgumentException
      */
     public function toStorageValue(FieldValue $value, StorageFieldValue $storageFieldValue)
     {

src/lib/Persistence/Legacy/Content/FieldValue/Converter/NullConverter.php

@@ -86,8 +86,6 @@ public function toFieldDefinition(StorageFieldDefinition $storageDef, FieldDefin
      * Returns the name of the index column the datatype uses, which is either
      * "sort_key_int" or "sort_key_string". This column is then used for
      * filtering and sorting for this type.
-     *
-     * @return string
      */
     public function getIndexColumn(): bool
     {

src/lib/Search/Common/FieldValueMapper/PriceMapper.php

@@ -23,10 +23,6 @@ public function canMap(Field $field): bool
 
     /**
      * Map field value to a proper search engine representation.
-     *
-     * @param \Ibexa\Contracts\Core\Search\Field $field
-     *
-     * @return mixed
      */
     public function map(Field $field): float
     {