Add @template typehints for make / instance / app to improve type hints (#41557)

- This enables resolving type of instance that container resolves without any IDE plugins.
- Helps phpstan / psalm / other tools

Author: pionl

src/Illuminate/Container/Container.php

@@ -461,9 +461,10 @@ public function extend($abstract, Closure $closure)
     /**
      * Register an existing instance as shared in the container.
      *
+     * @template T
      * @param  string  $abstract
-     * @param  mixed  $instance
-     * @return mixed
+     * @param  T  $instance
+     * @return T
      */
     public function instance($abstract, $instance)
     {
@@ -683,9 +684,10 @@ public function makeWith($abstract, array $parameters = [])
     /**
      * Resolve the given type from the container.
      *
-     * @param  string|callable  $abstract
+     * @template T
+     * @param  class-string<T>  $abstract
      * @param  array  $parameters
-     * @return mixed
+     * @return T|mixed
      *
      * @throws \Illuminate\Contracts\Container\BindingResolutionException
      */

src/Illuminate/Contracts/Container/Container.php

@@ -113,9 +113,10 @@ public function extend($abstract, Closure $closure);
     /**
      * Register an existing instance as shared in the container.
      *
+     * @template T
      * @param  string  $abstract
-     * @param  mixed  $instance
-     * @return mixed
+     * @param  T  $instance
+     * @return T
      */
     public function instance($abstract, $instance);
 
@@ -155,9 +156,10 @@ public function flush();
     /**
      * Resolve the given type from the container.
      *
-     * @param  string  $abstract
+     * @template T
+     * @param  class-string<T>  $abstract
      * @param  array  $parameters
-     * @return mixed
+     * @return T|mixed
      *
      * @throws \Illuminate\Contracts\Container\BindingResolutionException
      */

src/Illuminate/Foundation/Application.php

@@ -829,9 +829,10 @@ public function registerDeferredProvider($provider, $service = null)
     /**
      * Resolve the given type from the container.
      *
-     * @param  string  $abstract
+     * @template T
+     * @param  class-string<T>  $abstract
      * @param  array  $parameters
-     * @return mixed
+     * @return T|mixed
      */
     public function make($abstract, array $parameters = [])
     {

src/Illuminate/Foundation/helpers.php

@@ -106,9 +106,10 @@ function action($name, $parameters = [], $absolute = true)
     /**
      * Get the available container instance.
      *
-     * @param  string|null  $abstract
+     * @template T
+     * @param  class-string<T>|mixed  $abstract
      * @param  array  $parameters
-     * @return mixed|\Illuminate\Contracts\Foundation\Application
+     * @return mixed|T|\Illuminate\Contracts\Foundation\Application
      */
     function app($abstract = null, array $parameters = [])
     {