[TASK] Make aliased class deprecation notices visible to tools (#1559)

Resolves #1553

Author: JakeQZ

src/Rule/Rule.php

@@ -9,9 +9,15 @@
 use function Safe\class_alias;
 
 if (!\class_exists(Rule::class, false) && !\interface_exists(Rule::class, false)) {
-    /**
-     * @deprecated in v9.2, will be removed in v10.0.  Use `Property\Declaration` instead, which is a direct
-     *             replacement.
-     */
     class_alias(Declaration::class, Rule::class);
+    // The test is expected to evaluate to false,
+    // but allows for the deprecation notice to be picked up by IDEs like PHPStorm.
+    // @phpstan-ignore-next-line booleanAnd.alwaysTrue
+    if (!\class_exists(Rule::class, false) && !\interface_exists(Rule::class, false)) {
+        /**
+         * @deprecated in v9.2, will be removed in v10.0.  Use `Property\Declaration` instead, which is a direct
+         *             replacement.
+         */
+        class Rule {}
+    }
 }

src/RuleSet/RuleContainer.php

@@ -7,8 +7,14 @@
 use function Safe\class_alias;
 
 if (!\class_exists(RuleContainer::class, false) && !\interface_exists(RuleContainer::class, false)) {
-    /**
-     * @deprecated in v9.2, will be removed in v10.0.  Use `DeclarationList` instead, which is a direct replacement.
-     */
     class_alias(DeclarationList::class, RuleContainer::class);
+    // The test is expected to evaluate to false,
+    // but allows for the deprecation notice to be picked up by IDEs like PHPStorm.
+    // @phpstan-ignore-next-line booleanAnd.alwaysTrue
+    if (!\class_exists(RuleContainer::class, false) && !\interface_exists(RuleContainer::class, false)) {
+        /**
+         * @deprecated in v9.2, will be removed in v10.0.  Use `DeclarationList` instead, which is a direct replacement.
+         */
+        interface RuleContainer {}
+    }
 }