Add return phpstan doc to getFeedback

Author: franmomu

src/Feedback.php

@@ -17,7 +17,10 @@ class Feedback
     /**
      * @param int $score
      * @param MatchInterface[] $sequence
-     * @return array
+     * @return array{
+     *      warning: string,
+     *      suggestions: string[]
+     * }
      */
     public function getFeedback(int $score, array $sequence): array
     {

src/Matchers/BaseMatch.php

@@ -48,8 +48,10 @@ public function __construct(string $password, int $begin, int $end, string $toke
      *
      * @param  bool $isSoleMatch
      *   Whether this is the only match in the password
-     * @return array
-     *   Associative array with warning (string) and suggestions (array of strings)
+     * @return array{
+     *      warning: string,
+     *      suggestions: string[]
+     * } Associative array with warning (string) and suggestions (array of strings)
      */
     #[ArrayShape(['warning' => 'string', 'suggestions' => 'string[]'])]
     abstract public function getFeedback(bool $isSoleMatch): array;

src/Matchers/DictionaryMatch.php

@@ -115,7 +115,7 @@ public function getFeedbackWarning(bool $isSoleMatch): string
     {
         switch ($this->dictionaryName) {
             case 'user_inputs':
-                return 'This is easy to guess based on the other inputs';
+                return 'This is similar to, or incorporates parts of, other input';
             case 'passwords':
                 if ($isSoleMatch && !$this->l33t && !$this->reversed) {
                     if ($this->rank <= 10) {

test/FeedbackTest.php

@@ -115,7 +115,7 @@ public function testFeedbackFromUserInput()
         ]);
         $feedback = $this->feedback->getFeedback(0, [$match]);
 
-        $this->assertEquals('This is easy to guess based on the other inputs', $feedback['warning'], 'no warning for user input');
-        $this->assertNotEmpty($feedback['suggestions'], 'no suggestions for user intpu');
+        $this->assertEquals('This is similar to, or incorporates parts of, other input', $feedback['warning'], 'no warning for user input');
+        $this->assertNotEmpty($feedback['suggestions'], 'no suggestions for user input');
     }
 }