[dx] add withTypeCoverageDocblockLevel()fs

Author: TomasVotruba

config/set/type-declaration-docblocks.php

@@ -8,5 +8,5 @@
  * @experimental * 2025-09, experimental hidden set for type declaration in docblocks
  */
 return static function (RectorConfig $rectorConfig): void {
-    $rectorConfig->rules(\Rector\Config\Level\TypeDeclarationDocblockLevel::RULES);
+    $rectorConfig->rules(\Rector\Config\Level\TypeDeclarationDocblocksLevel::RULES);
 };

…g/Level/TypeDeclarationDocblockLevel.php …/Level/TypeDeclarationDocblocksLevel.phpsrc/Config/Level/TypeDeclarationDocblockLevel.php renamed to src/Config/Level/TypeDeclarationDocblocksLevel.php src/Config/Level/TypeDeclarationDocblockLevel.php renamed to src/Config/Level/TypeDeclarationDocblocksLevel.php

@@ -20,7 +20,7 @@
 use Rector\TypeDeclarationDocblocks\Rector\ClassMethod\DocblockGetterReturnArrayFromPropertyDocblockVarRector;
 use Rector\TypeDeclarationDocblocks\Rector\ClassMethod\DocblockReturnArrayFromDirectArrayInstanceRector;
 
-final class TypeDeclarationDocblockLevel
+final class TypeDeclarationDocblocksLevel
 {
     /**
      * @var array<class-string<RectorInterface>>

src/Configuration/RectorConfigBuilder.php

@@ -11,6 +11,7 @@
 use Rector\Config\Level\CodeQualityLevel;
 use Rector\Config\Level\CodingStyleLevel;
 use Rector\Config\Level\DeadCodeLevel;
+use Rector\Config\Level\TypeDeclarationDocblocksLevel;
 use Rector\Config\Level\TypeDeclarationLevel;
 use Rector\Config\RectorConfig;
 use Rector\Config\RegisteredService;
@@ -742,6 +743,7 @@ public function withPreparedSets(
         bool $codeQuality = false,
         bool $codingStyle = false,
         bool $typeDeclarations = false,
+        bool $typeDeclarationDocblocks = false,
         bool $privatization = false,
         bool $naming = false,
         bool $instanceOf = false,
@@ -761,6 +763,7 @@ public function withPreparedSets(
             SetList::CODE_QUALITY => $codeQuality,
             SetList::CODING_STYLE => $codingStyle,
             SetList::TYPE_DECLARATION => $typeDeclarations,
+            SetList::TYPE_DECLARATION_DOCBLOCKS => $typeDeclarationDocblocks,
             SetList::PRIVATIZATION => $privatization,
             SetList::NAMING => $naming,
             SetList::INSTANCEOF => $instanceOf,
@@ -1019,6 +1022,33 @@ public function withTypeCoverageLevel(int $level): self
         return $this;
     }
 
+    /**
+     * Raise your type coverage docblock from the safest type rules
+     * to more affecting ones, one level at a time
+     */
+    public function withTypeCoverageDocblockLevel(int $level): self
+    {
+        Assert::natural($level);
+
+        $levelRules = LevelRulesResolver::resolve($level, TypeDeclarationDocblocksLevel::RULES, __METHOD__);
+
+        // too high
+        $levelRulesCount = count($levelRules);
+        if ($levelRulesCount + self::MAX_LEVEL_GAP < $level) {
+            $this->levelOverflows[] = new LevelOverflow(
+                __METHOD__,
+                $level,
+                $levelRulesCount,
+                'TypeDeclarationDocblocksLevel',
+                'TYPE_DECLARATION_DOCBLOCKS'
+            );
+        }
+
+        $this->rules = array_merge($this->rules, $levelRules);
+
+        return $this;
+    }
+
     /**
      * Raise your dead-code coverage from the safest rules
      * to more affecting ones, one level at a time