Generics: Add support for generic type hints in comments

src/Standards/Squiz/Sniffs/Commenting/FunctionCommentSniff.php

@@ -435,6 +435,8 @@ protected function processParams(File $phpcsFile, $stackPtr, $commentStart)
                     $suggestedTypeHint = 'callable';
                 } else if (strpos($suggestedName, 'callback') !== false) {
                     $suggestedTypeHint = 'callable';
+                } else if (preg_match('/^([^<]+)<[^>]+>$/', $suggestedName, $matches) === 1) {
+                    $suggestedTypeHint = $matches[1];
                 } else if (in_array($suggestedName, Common::$allowedTypes, true) === false) {
                     $suggestedTypeHint = $suggestedName;
                 }

src/Standards/Squiz/Tests/Commenting/FunctionCommentUnitTest.inc

@@ -1047,6 +1047,18 @@ public function ignored() {
  * @throws Exception If any other error occurs. */
 function throwCommentOneLine() {}
 
+/**
+ * Using generic as a type hint should satisfy a specified object parameter type.
+ * @see https://phpstan.org/blog/generics-in-php-using-phpdocs
+ *
+ * @param Collection<int, string> $values An object with int, string pairs.
+ *
+ * @return void
+ */
+public function genericType(Collection $values) {
+
+}// end genericType()
+
 /**
  * When two adjacent pipe symbols are used (by mistake), the sniff should not throw a PHP Fatal error
  *

src/Standards/Squiz/Tests/Commenting/FunctionCommentUnitTest.inc.fixed

@@ -1047,6 +1047,18 @@ public function ignored() {
  * @throws Exception If any other error occurs. */
 function throwCommentOneLine() {}
 
+/**
+ * Using generic as a type hint should satisfy a specified object parameter type.
+ * @see https://phpstan.org/blog/generics-in-php-using-phpdocs
+ *
+ * @param Collection<int, string> $values An object with int, string pairs.
+ *
+ * @return void
+ */
+public function genericType(Collection $values) {
+
+}// end genericType()
+
 /**
  * When two adjacent pipe symbols are used (by mistake), the sniff should not throw a PHP Fatal error
  *