Clarify psalm types in Result (#668)

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## 1.3.0 under development
 
 - New #665: Add methods `addErrorWithFormatOnly()` and `addErrorWithoutPostProcessing()` to `Result` object (@vjik)
+- Enh #668: Clarify psalm types in `Result` (@vjik)
 
 ## 1.2.0 February 21, 2024
 

composer-require-checker.json

@@ -1,7 +1,10 @@
 {
     "symbol-whitelist": [
         "Yiisoft\\Yii\\Debug\\Collector\\CollectorTrait",
-        "Yiisoft\\Yii\\Debug\\Collector\\SummaryCollectorInterface"
+        "Yiisoft\\Yii\\Debug\\Collector\\SummaryCollectorInterface",
+        "JetBrains\\PhpStorm\\ArrayShape",
+        "JetBrains\\PhpStorm\\ExpectedValues",
+        "JetBrains\\PhpStorm\\Language"
     ],
     "php-core-extensions": [
         "Core",

src/Result.php

@@ -17,6 +17,7 @@ final class Result
 {
     /**
      * @var Error[] Validation errors.
+     * @psalm-var list<Error>
      */
     private array $errors = [];
 
@@ -51,6 +52,7 @@ public function isAttributeValid(string $attribute): bool
 
     /**
      * @return Error[] Validation errors.
+     * @psalm-return list<Error>
      */
     public function getErrors(): array
     {
@@ -61,6 +63,7 @@ public function getErrors(): array
      * Get errors messages as an array of strings.
      *
      * @return string[] Array messages as strings.
+     * @psalm-return list<string>
      */
     public function getErrorMessages(): array
     {
@@ -121,6 +124,8 @@ public function getErrorMessagesIndexedByAttribute(): array
      * @param string $attribute Attribute name.
      *
      * @return Error[] Array of error objects.
+     *
+     * @psalm-return list<Error>
      */
     public function getAttributeErrors(string $attribute): array
     {
@@ -139,6 +144,8 @@ public function getAttributeErrors(string $attribute): array
      * Get an array of error messages for the attribute specified.
      *
      * @return string[] Error messages.
+     *
+     * @psalm-return list<string>
      */
     public function getAttributeErrorMessages(string $attribute): array
     {
@@ -190,6 +197,8 @@ public function getAttributeErrorMessagesIndexedByPath(
      * Get common error messages that are not attached to any attribute.
      *
      * @return string[] Error messages.
+     *
+     * @psalm-return list<string>
      */
     public function getCommonErrorMessages(): array
     {