Tests/ArrayKeywordTest: use named data within data sets

This commit adds the parameter name for each item in the data set 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.

Includes minor array normalization.
Includes making the data type in the docblock more specific.

Author: jrfnl

tests/Core/Tokenizer/ArrayKeywordTest.php

@@ -49,19 +49,27 @@ public function testArrayKeyword($testMarker, $testContent='array')
      *
      * @see testArrayKeyword()
      *
-     * @return array
+     * @return array<string, array<string, string>>
      */
     public static function dataArrayKeyword()
     {
         return [
-            'empty array'                           => ['/* testEmptyArray */'],
-            'array with space before parenthesis'   => ['/* testArrayWithSpace */'],
+            'empty array'                           => [
+                'testMarker' => '/* testEmptyArray */',
+            ],
+            'array with space before parenthesis'   => [
+                'testMarker' => '/* testArrayWithSpace */',
+            ],
             'array with comment before parenthesis' => [
-                '/* testArrayWithComment */',
-                'Array',
+                'testMarker'  => '/* testArrayWithComment */',
+                'testContent' => 'Array',
+            ],
+            'nested: outer array'                   => [
+                'testMarker' => '/* testNestingArray */',
+            ],
+            'nested: inner array'                   => [
+                'testMarker' => '/* testNestedArray */',
             ],
-            'nested: outer array'                   => ['/* testNestingArray */'],
-            'nested: inner array'                   => ['/* testNestedArray */'],
         ];
 
     }//end dataArrayKeyword()
@@ -101,17 +109,21 @@ public function testArrayType($testMarker, $testContent='array')
      *
      * @see testArrayType()
      *
-     * @return array
+     * @return array<string, array<string, string>>
      */
     public static function dataArrayType()
     {
         return [
             'closure return type'        => [
-                '/* testClosureReturnType */',
-                'Array',
+                'testMarker'  => '/* testClosureReturnType */',
+                'testContent' => 'Array',
+            ],
+            'function param type'        => [
+                'testMarker' => '/* testFunctionDeclarationParamType */',
+            ],
+            'function union return type' => [
+                'testMarker' => '/* testFunctionDeclarationReturnType */',
             ],
-            'function param type'        => ['/* testFunctionDeclarationParamType */'],
-            'function union return type' => ['/* testFunctionDeclarationReturnType */'],
         ];
 
     }//end dataArrayType()
@@ -152,16 +164,18 @@ public function testNotArrayKeyword($testMarker, $testContent='array')
      *
      * @see testNotArrayKeyword()
      *
-     * @return array
+     * @return array<string, array<string, string>>
      */
     public static function dataNotArrayKeyword()
     {
         return [
             'class-constant-name' => [
-                '/* testClassConst */',
-                'ARRAY',
+                'testMarker'  => '/* testClassConst */',
+                'testContent' => 'ARRAY',
+            ],
+            'class-method-name'   => [
+                'testMarker' => '/* testClassMethod */',
             ],
-            'class-method-name'   => ['/* testClassMethod */'],
         ];
 
     }//end dataNotArrayKeyword()