Deprecate legacy hook interfaces (#5898)

Refs vimeo/psalm#4700

psalm.xml.dist

@@ -55,9 +55,16 @@
         <DeprecatedClass>
             <errorLevel type="suppress">
                 <referencedClass name="PackageVersions\Versions"/>
+                <referencedClass name="Psalm\Plugin\Hook\*" />
             </errorLevel>
         </DeprecatedClass>
 
+        <DeprecatedInterface>
+            <errorLevel type="suppress">
+                <referencedClass name="Psalm\Plugin\Hook\*" />
+            </errorLevel>
+        </DeprecatedInterface>
+
         <UnusedParam>
             <errorLevel type="suppress">
                 <directory name="examples"/>

src/Psalm/Plugin/Hook/AfterAnalysisInterface.php

@@ -5,6 +5,7 @@ use Psalm\Internal\Analyzer\IssueData;
 use Psalm\Codebase;
 use Psalm\SourceControl\SourceControlInfo;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterClassLikeAnalysisInterface.php

@@ -7,6 +7,7 @@ use Psalm\FileManipulation;
 use Psalm\StatementsSource;
 use Psalm\Storage\ClassLikeStorage;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterClassLikeAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterClassLikeExistenceCheckInterface.php

@@ -6,6 +6,7 @@ use Psalm\CodeLocation;
 use Psalm\FileManipulation;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterClassLikeExistenceCheckInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterClassLikeVisitInterface.php

@@ -7,6 +7,7 @@ use Psalm\FileManipulation;
 use Psalm\FileSource;
 use Psalm\Storage\ClassLikeStorage;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterClassLikeVisitInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterCodebasePopulatedInterface.php

@@ -3,6 +3,7 @@ namespace Psalm\Plugin\Hook;
 
 use Psalm\Codebase;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterCodebasePopulatedInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterEveryFunctionCallAnalysisInterface.php

@@ -6,6 +6,7 @@ use Psalm\Codebase;
 use Psalm\Context;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterEveryFunctionCallAnalysisInterface
 {
     public static function afterEveryFunctionCallAnalysis(

src/Psalm/Plugin/Hook/AfterExpressionAnalysisInterface.php

@@ -7,6 +7,7 @@ use Psalm\Context;
 use Psalm\FileManipulation;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterExpressionAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterFileAnalysisInterface.php

@@ -6,6 +6,7 @@ use Psalm\Context;
 use Psalm\StatementsSource;
 use Psalm\Storage\FileStorage;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterFileAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterFunctionCallAnalysisInterface.php

@@ -8,6 +8,7 @@ use Psalm\FileManipulation;
 use Psalm\StatementsSource;
 use Psalm\Type\Union;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterFunctionCallAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterFunctionLikeAnalysisInterface.php

@@ -7,6 +7,7 @@ use Psalm\FileManipulation;
 use Psalm\StatementsSource;
 use Psalm\Storage\FunctionLikeStorage;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterFunctionLikeAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterMethodCallAnalysisInterface.php

@@ -10,6 +10,7 @@ use Psalm\FileManipulation;
 use Psalm\StatementsSource;
 use Psalm\Type\Union;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterMethodCallAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/AfterStatementAnalysisInterface.php

@@ -7,6 +7,7 @@ use Psalm\Context;
 use Psalm\FileManipulation;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface AfterStatementAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/BeforeFileAnalysisInterface.php

@@ -6,6 +6,7 @@ use Psalm\Context;
 use Psalm\StatementsSource;
 use Psalm\Storage\FileStorage;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface BeforeFileAnalysisInterface
 {
     /**

src/Psalm/Plugin/Hook/FunctionExistenceProviderInterface.php

@@ -3,6 +3,7 @@ namespace Psalm\Plugin\Hook;
 
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface FunctionExistenceProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/FunctionParamsProviderInterface.php

@@ -6,6 +6,7 @@ use Psalm\CodeLocation;
 use Psalm\Context;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface FunctionParamsProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/FunctionReturnTypeProviderInterface.php

@@ -7,6 +7,7 @@ use Psalm\Context;
 use Psalm\StatementsSource;
 use Psalm\Type;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface FunctionReturnTypeProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/MethodExistenceProviderInterface.php

@@ -4,6 +4,7 @@ namespace Psalm\Plugin\Hook;
 use Psalm\CodeLocation;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface MethodExistenceProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/MethodParamsProviderInterface.php

@@ -6,6 +6,7 @@ use Psalm\CodeLocation;
 use Psalm\Context;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface MethodParamsProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/MethodReturnTypeProviderInterface.php

@@ -7,6 +7,7 @@ use Psalm\Context;
 use Psalm\StatementsSource;
 use Psalm\Type;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface MethodReturnTypeProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/MethodVisibilityProviderInterface.php

@@ -5,6 +5,7 @@ use Psalm\CodeLocation;
 use Psalm\Context;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface MethodVisibilityProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/PropertyExistenceProviderInterface.php

@@ -5,6 +5,7 @@ use Psalm\CodeLocation;
 use Psalm\Context;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface PropertyExistenceProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/PropertyTypeProviderInterface.php

@@ -5,6 +5,7 @@ use Psalm\Context;
 use Psalm\StatementsSource;
 use Psalm\Type;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface PropertyTypeProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/PropertyVisibilityProviderInterface.php

@@ -5,6 +5,7 @@ use Psalm\CodeLocation;
 use Psalm\Context;
 use Psalm\StatementsSource;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface PropertyVisibilityProviderInterface
 {
     /**

src/Psalm/Plugin/Hook/StringInterpreterInterface.php

@@ -3,6 +3,7 @@ namespace Psalm\Plugin\Hook;
 
 use Psalm\Type;
 
+/** @deprecated going to be removed in Psalm 5 */
 interface StringInterpreterInterface
 {
     /**