Fix PHPStorm "Undefined Class" inspection failures

Is there no PHPCS or Coder sniff for this?

Also is this a dupe of your own issue? :) #3226198: [PP-1] Undefined namespaces in PHP DocBlocks

It's a pity that the coding standards say

Immediately after an @tag (@param, @return, @var, etc.), class and interface names must always include the fully-qualified namespace.

(even though I can't google that, I only see that referred in #3250534: @param tags not using a fully-qualified class names are not reported)

That's limiting readibility IMHO. Other packages use the use statements to import the FQCNs, and their PHPDoc only refer to the class name. PHPStan fully supports that.

So something like this

--- a/composer/Plugin/VendorHardening/Config.php
+++ b/composer/Plugin/VendorHardening/Config.php
@@ -84,7 +84,7 @@ class Config {
   /**
    * The root package.
    *
-   * @var Composer\Package\RootPackageInterface
+   * @var \Composer\Package\RootPackageInterface
    */
   protected $rootPackage;
 

would become something like this

--- a/composer/Plugin/VendorHardening/Config.php
+++ b/composer/Plugin/VendorHardening/Config.php
@@ -84,7 +84,7 @@ class Config {
   /**
    * The root package.
    *
-   * @var Composer\Package\RootPackageInterface
+   * @var RootPackageInterface
    */
   protected $rootPackage;
 

that is, BTW, also what would happen once the property will be typehinted instead of annotated.