From 45978defa4169070fdf0dd23b406afa90086ec35 Mon Sep 17 00:00:00 2001
From: ErwannRousseau <erwann.rousseau@icloud.com>
Date: Sat, 18 Jul 2026 15:43:09 -0400
Subject: [PATCH 1/2] fix(phpstan): support Symfony config generics

---
 composer.json                                          |  2 +-
 phpstan-symfony-version.neon.php                       | 10 ++++++++++
 phpstan.neon.dist                                      |  3 +++
 phpstan/stubs/TreeBuilder.stub                         | 10 ++++++++++
 .../DependencyInjection/Configuration.php              |  3 +++
 5 files changed, 27 insertions(+), 1 deletion(-)
 create mode 100644 phpstan-symfony-version.neon.php
 create mode 100644 phpstan/stubs/TreeBuilder.stub

diff --git a/composer.json b/composer.json
index 28c0881e..cdfb9c02 100644
--- a/composer.json
+++ b/composer.json
@@ -35,7 +35,7 @@
         "phpspec/prophecy": "1.22.0",
         "phpstan/extension-installer": "1.4.3",
         "phpstan/phpstan": "2.1.27",
-        "phpstan/phpstan-symfony": "2.0.6",
+        "phpstan/phpstan-symfony": "2.0.20",
         "rector/rector": "2.1.7",
         "symfony/twig-bridge": "^5.4 || ^6.4 || ^7.0",
         "symfony/var-dumper": "^5.4 || ^6.4 || ^7.0",
diff --git a/phpstan-symfony-version.neon.php b/phpstan-symfony-version.neon.php
new file mode 100644
index 00000000..3a92c45f
--- /dev/null
+++ b/phpstan-symfony-version.neon.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+use Composer\InstalledVersions;
+use Composer\Semver\VersionParser;
+
+return InstalledVersions::satisfies(new VersionParser(), 'symfony/config', '<7.4')
+    ? ['parameters' => ['stubFiles' => [__DIR__.'/phpstan/stubs/TreeBuilder.stub']]]
+    : [];
diff --git a/phpstan.neon.dist b/phpstan.neon.dist
index 253e9e6c..e378c43d 100644
--- a/phpstan.neon.dist
+++ b/phpstan.neon.dist
@@ -1,3 +1,6 @@
+includes:
+    - phpstan-symfony-version.neon.php
+
 parameters:
     level: 8
     paths:
diff --git a/phpstan/stubs/TreeBuilder.stub b/phpstan/stubs/TreeBuilder.stub
new file mode 100644
index 00000000..b1d56123
--- /dev/null
+++ b/phpstan/stubs/TreeBuilder.stub
@@ -0,0 +1,10 @@
+<?php
+
+namespace Symfony\Component\Config\Definition\Builder;
+
+/**
+ * @template T of 'array'|'variable'|'scalar'|'string'|'boolean'|'integer'|'float'|'enum'
+ */
+class TreeBuilder
+{
+}
diff --git a/src/Knp/DictionaryBundle/DependencyInjection/Configuration.php b/src/Knp/DictionaryBundle/DependencyInjection/Configuration.php
index f3fd2125..09e4d3f0 100644
--- a/src/Knp/DictionaryBundle/DependencyInjection/Configuration.php
+++ b/src/Knp/DictionaryBundle/DependencyInjection/Configuration.php
@@ -14,6 +14,9 @@ final class Configuration implements ConfigurationInterface
      */
     private const CONFIG_NAME = 'knp_dictionary';
 
+    /**
+     * @return TreeBuilder<'array'>
+     */
     public function getConfigTreeBuilder(): TreeBuilder
     {
         $treeBuilder    = new TreeBuilder(self::CONFIG_NAME);

From 1d8c104148942747aaee7830f709faaf73b60910 Mon Sep 17 00:00:00 2001
From: ErwannRousseau <erwann.rousseau@icloud.com>
Date: Sat, 18 Jul 2026 15:53:52 -0400
Subject: [PATCH 2/2] chore(deps): declare Composer Semver

---
 composer.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/composer.json b/composer.json
index cdfb9c02..91ae3d6c 100644
--- a/composer.json
+++ b/composer.json
@@ -27,6 +27,7 @@
         "twig/twig": "^2.15.3 || ^3.4.3"
     },
     "require-dev": {
+        "composer/semver": "3.4.0",
         "fakerphp/faker": "1.24.1",
         "friends-of-phpspec/phpspec-code-coverage": "6.5.0",
         "friendsofphp/php-cs-fixer": "3.75.0",