Improve some PHPdocs based on existing Symfony stubs in PHPstan and Psalm

Author: mdeboer

Extension/ExtensionInterface.php

@@ -23,6 +23,8 @@ interface ExtensionInterface
     /**
      * Loads a specific configuration.
      *
+     * @param array<array<mixed>> $configs
+     *
      * @throws \InvalidArgumentException When provided tag is not defined in this extension
      */
     public function load(array $configs, ContainerBuilder $container);

ParameterBag/ContainerBagInterface.php

@@ -29,6 +29,12 @@ public function all(): array;
     /**
      * Replaces parameter placeholders (%name%) by their values.
      *
+     * @template TValue of array<array|scalar>|scalar
+     *
+     * @param TValue $value
+     *
+     * @psalm-return (TValue is scalar ? array|scalar : array<array|scalar>)
+     *
      * @throws ParameterNotFoundException if a placeholder references a parameter that does not exist
      */
     public function resolveValue(mixed $value);

ParameterBag/ParameterBag.php

@@ -148,7 +148,12 @@ public function resolve()
     /**
      * Replaces parameter placeholders (%name%) by their values.
      *
-     * @param array $resolving An array of keys that are being resolved (used internally to detect circular references)
+     * @template TValue of array<array|scalar>|scalar
+     *
+     * @param TValue $value
+     * @param array  $resolving An array of keys that are being resolved (used internally to detect circular references)
+     *
+     * @return (TValue is scalar ? array|scalar : array<array|scalar>)
      *
      * @throws ParameterNotFoundException          if a placeholder references a parameter that does not exist
      * @throws ParameterCircularReferenceException if a circular reference if detected