Tests/ScopeSettingWithNamespaceOperatorTest: use named data sets

With non-named data sets, when a test fails, PHPUnit will display the number of the test which failed.

With tests which have a _lot_ of data sets, this makes it _interesting_ (and time-consuming) to debug those, as one now has to figure out which of the data sets in the data provider corresponds to that number.

Using named data sets makes debugging failing tests more straight forward as PHPUnit will display the data set name instead of the number.
Using named data sets also documents what exactly each data set is testing.

Aside from adding the data set name, this commit also adds the parameter name for each item in the data set, this time in an effort to make it more straight forward to update and add tests as it will be more obvious what each key in the data set signifies.

Include making the data type in the docblock more specific.
Includes fixing the test description in the file docblock.

Author: jrfnl

tests/Core/Tokenizer/ScopeSettingWithNamespaceOperatorTest.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * Tests the adding of the "bracket_opener/closer" keys to use group tokens.
+ * Tests the scope opener/closers are set correctly when the namespace keyword is used as an operator.
  *
  * @author    Juliette Reinders Folmer <[email protected]>
  * @copyright 2020 Squiz Pty Ltd (ABN 77 084 670 600)
@@ -18,10 +18,10 @@ final class ScopeSettingWithNamespaceOperatorTest extends AbstractMethodUnitTest
     /**
      * Test that the scope opener/closers are set correctly when the namespace keyword is encountered as an operator.
      *
-     * @param string       $testMarker The comment which prefaces the target tokens in the test file.
-     * @param int|string[] $tokenTypes The token type to search for.
-     * @param int|string[] $open       Optional. The token type for the scope opener.
-     * @param int|string[] $close      Optional. The token type for the scope closer.
+     * @param string            $testMarker The comment which prefaces the target tokens in the test file.
+     * @param array<int|string> $tokenTypes The token type to search for.
+     * @param array<int|string> $open       Optional. The token type for the scope opener.
+     * @param array<int|string> $close      Optional. The token type for the scope closer.
      *
      * @dataProvider dataScopeSetting
      * @covers       PHP_CodeSniffer\Tokenizers\Tokenizer::recurseScopeMap
@@ -59,36 +59,36 @@ public function testScopeSetting($testMarker, $tokenTypes, $open=T_OPEN_CURLY_BR
      *
      * @see testScopeSetting()
      *
-     * @return array
+     * @return array<string, array<string, string|array<int|string>>>
      */
     public static function dataScopeSetting()
     {
         return [
-            [
-                '/* testClassExtends */',
-                [T_CLASS],
+            'class which extends namespace relative name'           => [
+                'testMarker' => '/* testClassExtends */',
+                'tokenTypes' => [T_CLASS],
             ],
-            [
-                '/* testClassImplements */',
-                [T_ANON_CLASS],
+            'class which implements namespace relative name'        => [
+                'testMarker' => '/* testClassImplements */',
+                'tokenTypes' => [T_ANON_CLASS],
             ],
-            [
-                '/* testInterfaceExtends */',
-                [T_INTERFACE],
+            'interface which extend namespace relative name'        => [
+                'testMarker' => '/* testInterfaceExtends */',
+                'tokenTypes' => [T_INTERFACE],
             ],
-            [
-                '/* testFunctionReturnType */',
-                [T_FUNCTION],
+            'namespace relative name in function return type'       => [
+                'testMarker' => '/* testFunctionReturnType */',
+                'tokenTypes' => [T_FUNCTION],
             ],
-            [
-                '/* testClosureReturnType */',
-                [T_CLOSURE],
+            'namespace relative name in closure return type'        => [
+                'testMarker' => '/* testClosureReturnType */',
+                'tokenTypes' => [T_CLOSURE],
             ],
-            [
-                '/* testArrowFunctionReturnType */',
-                [T_FN],
-                [T_FN_ARROW],
-                [T_SEMICOLON],
+            'namespace relative name in arrow function return type' => [
+                'testMarker' => '/* testArrowFunctionReturnType */',
+                'tokenTypes' => [T_FN],
+                'open'       => [T_FN_ARROW],
+                'close'      => [T_SEMICOLON],
             ],
         ];