[deprecation] Deprecate AddInterfaceByTraitRector

[TomasVotruba]

Pairing a trait with an interface is specific to a single project or package. In practice the mapping needs extra conditions - only for classes in a certain namespace, only when the trait is used directly, only when a matching method exists - none of which a plain trait => interface map can express. A custom rule is a better fit.

The rule is not part of any set - neither in rector-src config/set/, nor in rector-symfony, rector-doctrine, rector-phpunit, rector-laravel or drupal-rector.

What the rule did:

$rectorConfig->ruleWithConfiguration(AddInterfaceByTraitRector::class, [
    'SomeTrait' => 'SomeInterface',
]);

-class SomeClass
+class SomeClass implements SomeInterface
 {
     use SomeTrait;
 }

The class carried an @api used in rector-doctrine note, but rector-doctrine has no reference to it anymore, so the tag was stale and is dropped.

Follows the same shape as the recently deprecated rules - DeprecatedInterface, refactor() throws, tests removed.