[Transform] Deprecate StringToClassConstantRector as niche, never used and needs context

Author: TomasVotruba

phpstan.neon

@@ -237,7 +237,6 @@ parameters:
             paths:
                 - rules/Php81/Rector/FuncCall/NullToStrictStringFuncCallArgRector.php
                 - rules/Removing/Rector/Class_/RemoveTraitUseRector.php
-                - rules/Transform/Rector/String_/StringToClassConstantRector.php
 
         # lack of generic array in nikic/php-parser
         -

rules-tests/Transform/Rector/String_/StringToClassConstantRector/Fixture/fixture.php.inc

@@ -6,29 +6,19 @@
 
 use PhpParser\Node;
 use PhpParser\Node\Scalar\String_;
+use Rector\Configuration\Deprecation\Contract\DeprecatedInterface;
 use Rector\Contract\Rector\ConfigurableRectorInterface;
-use Rector\PhpParser\Node\Value\ValueResolver;
+use Rector\Exception\ShouldNotHappenException;
 use Rector\Rector\AbstractRector;
 use Rector\RuleDoc\CodeSample\ConfiguredCodeSample;
 use Rector\RuleDoc\RuleDefinition;
 use Rector\Transform\ValueObject\StringToClassConstant;
-use Webmozart\Assert\Assert;
 
 /**
- * @see \Rector\Tests\Transform\Rector\String_\StringToClassConstantRector\StringToClassConstantRectorTest
+ * @deprecated This rule is deprecated, as too niche, never used and needs project context. Write a custom rule for the exact project case instead.
  */
-final class StringToClassConstantRector extends AbstractRector implements ConfigurableRectorInterface
+final class StringToClassConstantRector extends AbstractRector implements ConfigurableRectorInterface, DeprecatedInterface
 {
-    /**
-     * @var StringToClassConstant[]
-     */
-    private array $stringsToClassConstants = [];
-
-    public function __construct(
-        private readonly ValueResolver $valueResolver
-    ) {
-    }
-
     public function getRuleDefinition(): RuleDefinition
     {
         return new RuleDefinition('Change strings to specific constants', [
@@ -71,27 +61,16 @@ public function getNodeTypes(): array
      */
     public function refactor(Node $node): ?Node
     {
-        foreach ($this->stringsToClassConstants as $stringToClassConstant) {
-            if (! $this->valueResolver->isValue($node, $stringToClassConstant->getString())) {
-                continue;
-            }
-
-            return $this->nodeFactory->createClassConstFetch(
-                $stringToClassConstant->getClass(),
-                $stringToClassConstant->getConstant()
-            );
-        }
-
-        return null;
+        throw new ShouldNotHappenException(sprintf(
+            '"%s" rule is deprecated, as too niche and part of no set; write a custom rule for the exact project case instead',
+            self::class
+        ));
     }
 
     /**
      * @param mixed[] $configuration
      */
     public function configure(array $configuration): void
     {
-        Assert::allIsAOf($configuration, StringToClassConstant::class);
-
-        $this->stringsToClassConstants = $configuration;
     }
 }

rules-tests/Transform/Rector/String_/StringToClassConstantRector/Fixture/skip_not_found_in_enum_case.php.inc

@@ -6,6 +6,9 @@
 
 use Rector\Validation\RectorAssert;
 
+/**
+ * @api used in deprecated StringToClassConstantRector configs
+ */
 final readonly class StringToClassConstant
 {
     public function __construct(