Enhance type annotations for Injector::invoke()

src/Injector.php

@@ -42,7 +42,7 @@
      * Enable memoization of class reflections for improved performance when resolving the same objects multiple times.
      * Note: Enabling this feature may increase memory usage.
      */
     public function withCacheReflections(bool $cacheReflections = true): self
     {
         $new = clone $this;
         $new->cacheReflections = $cacheReflections;
@@ -69,7 +69,9 @@
      * This will pass the string `'Hello World!'` as the first argument, and a formatter instance created
      * by the DI container as the second argument.
      *
-     * @param callable $callable callable to be invoked.
+     * @template TReturn
+     *
+     * @param callable(): TReturn $callable callable to be invoked.
      * @param array $arguments The array of the function arguments.
      * This can be either a list of arguments, or an associative array where keys are argument names.
      *
@@ -78,6 +80,9 @@
      * @throws ReflectionException
      *
      * @return mixed The callable return value.
+     *
+     * @psalm-param callable(...): TReturn $callable
+     * @psalm-return TReturn
      */
     public function invoke(callable $callable, array $arguments = [])
     {
@@ -236,7 +241,7 @@
             throw $error;
         }
 
         if ($isVariadic) {
             return true;
         }
         return null;
@@ -336,7 +341,7 @@
     private function getClassReflection(string $class): ReflectionClass
     {
         if ($this->cacheReflections) {
             return $this->reflectionsCache[$class] ??= new ReflectionClass($class);
         }
 
         return new ReflectionClass($class);

src/InvalidArgumentException.php

@@ -7,5 +7,5 @@
 final class InvalidArgumentException extends ArgumentException
 {
     protected const EXCEPTION_MESSAGE = 'Invalid argument "%s" when calling "%s"%s. Non-interface argument should be'
-    . ' named explicitly when passed.';
+        . ' named explicitly when passed.';
 }

src/MissingInternalArgumentException.php

@@ -7,5 +7,5 @@
 final class MissingInternalArgumentException extends ArgumentException
 {
     protected const EXCEPTION_MESSAGE = 'Can not determine default value of parameter "%s" when calling "%s"%s because'
-    . ' it is PHP internal. Please specify argument explicitly.';
+        . ' it is PHP internal. Please specify argument explicitly.';
 }