Merge pull request #30 from gsteel/minor-type-docs-improvement

Improve type inference for DefaultParamsTrait

Author: gsteel

psalm-baseline.xml

@@ -8,24 +8,4 @@
       <code>render</code>
     </PossiblyUnusedMethod>
   </file>
-  <file src="test/ArrayParametersTraitTest.php">
-    <PossiblyUnusedMethod>
-      <code>nonNullScalarParameters</code>
-    </PossiblyUnusedMethod>
-  </file>
-  <file src="test/ExceptionTest.php">
-    <PossiblyUnusedMethod>
-      <code>exception</code>
-    </PossiblyUnusedMethod>
-  </file>
-  <file src="test/TemplatePathAssertionsTrait.php">
-    <PossiblyUnusedMethod>
-      <code>assertEqualTemplatePath</code>
-    </PossiblyUnusedMethod>
-  </file>
-  <file src="test/TestAsset/ViewModel.php">
-    <PossiblyUnusedMethod>
-      <code>getVariables</code>
-    </PossiblyUnusedMethod>
-  </file>
 </files>

psalm.xml

@@ -18,17 +18,16 @@
     </projectFiles>
 
     <issueHandlers>
-        <InternalMethod>
+        <UnusedClass>
             <errorLevel type="suppress">
-                <referencedMethod name="PHPUnit\Framework\MockObject\Builder\InvocationMocker::method"/>
+                <directory name="test/StaticAnalysis" />
             </errorLevel>
+        </UnusedClass>
+        <PossiblyUnusedMethod>
             <errorLevel type="suppress">
-                <referencedMethod name="PHPUnit\Framework\MockObject\Builder\InvocationMocker::willReturn"/>
+                <directory name="test" />
             </errorLevel>
-            <errorLevel type="suppress">
-                <referencedMethod name="PHPUnit\Framework\MockObject\Builder\InvocationMocker::with"/>
-            </errorLevel>
-        </InternalMethod>
+        </PossiblyUnusedMethod>
     </issueHandlers>
 
     <plugins>

src/DefaultParamsTrait.php

@@ -52,6 +52,10 @@ public function addDefaultParam(string $templateName, string $param, mixed $valu
 
     /**
      * Returns merged global, template-specific and given params
+     *
+     * @template TKey of array-key
+     * @param array<TKey, mixed> $params
+     * @return array<TKey, mixed>
      */
     private function mergeParams(string $template, array $params): array
     {

test/DefaultParamsTraitTest.php

@@ -68,7 +68,7 @@ public function testMergingParamsWithDefaultParamArray(): void
                     3 => ['id' => 3],
                     4 => ['id' => 4],
                 ],
-            ])
+            ]),
         );
         $params = $this->defaultParams->mergeParameters('template', $params);
 

test/StaticAnalysis/DefaultParameters.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MezzioTest\Template\StaticAnalysis;
+
+use Mezzio\Template\DefaultParamsTrait;
+
+final class DefaultParameters
+{
+    use DefaultParamsTrait;
+
+    /**
+     * @param array<string, mixed> $params
+     * @return array<string, mixed>
+     */
+    public function mergePreservesKeyType(array $params): array
+    {
+        return $this->mergeParams('whatever', $params);
+    }
+}