bug #6998 Improve deprecation message about return type (VincentLanglet)

This PR was merged into the 4.x branch.

Discussion
----------

Improve deprecation message about return type

Seems like the ``@return` TEntity` gives a weird deprecation message `@javiereguiluz`, cf issue
#6995

So I updated the phpdoc to
```
`@return` object

`@phpstan`-return TEntity
```

Also, I saw some ``@psalm`-`. Annotation.

Since you're using phpstan for SA and not psalm ;
I would recommend to use ``@phpstan`` everywhere so I updated those tag.

Closes #6995 I think

Commits
-------

5ac430e Improve return type

Author: javiereguiluz

src/Config/Crud.php

@@ -56,7 +56,7 @@ public static function new(): self
     /**
      * @param TranslatableInterface|string|callable $label The callable signature is: fn ($entityInstance, $pageName): string
      *
-     * @psalm-param mixed $label
+     * @phpstan-param mixed $label
      */
     public function setEntityLabelInSingular($label): self
     {
@@ -80,7 +80,7 @@ public function setEntityLabelInSingular($label): self
     /**
      * @param TranslatableInterface|string|callable $label The callable signature is: fn ($entityInstance, $pageName): string
      *
-     * @psalm-param mixed $label
+     * @phpstan-param mixed $label
      */
     public function setEntityLabelInPlural($label): self
     {
@@ -104,7 +104,7 @@ public function setEntityLabelInPlural($label): self
     /**
      * @param TranslatableInterface|string|callable $title The callable signature is: fn ($entityInstance): string
      *
-     * @psalm-param mixed $title
+     * @phpstan-param mixed $title
      */
     public function setPageTitle(string $pageName, $title): self
     {

src/Contracts/Controller/CrudControllerInterface.php

@@ -43,7 +43,7 @@ public function configureFilters(Filters $filters): Filters;
     /**
      * @return FieldInterface[]|string[]
      *
-     * @psalm-return iterable<FieldInterface|string>
+     * @phpstan-return iterable<FieldInterface|string>
      */
     public function configureFields(string $pageName): iterable;
 
@@ -74,7 +74,9 @@ public function createIndexQueryBuilder(SearchDto $searchDto, EntityDto $entityD
     /**
      * @param class-string<TEntity> $entityFqcn
      *
-     * @return TEntity
+     * @return object
+     *
+     * @phpstan-return TEntity
      */
     public function createEntity(string $entityFqcn);
 

src/Contracts/Controller/DashboardControllerInterface.php

@@ -26,7 +26,7 @@ public function configureAssets(): Assets;
     /**
      * @return MenuItemInterface[]
      *
-     * @psalm-return iterable<MenuItemInterface>
+     * @phpstan-return iterable<MenuItemInterface>
      */
     public function configureMenuItems(): iterable;
 

src/Contracts/Event/EntityLifecycleEventInterface.php

@@ -10,7 +10,9 @@
 interface EntityLifecycleEventInterface
 {
     /**
-     * @return TEntity
+     * @return object
+     *
+     * @phpstan-return TEntity
      */
     public function getEntityInstance();
 }

src/Dto/EntityDto.php

@@ -99,7 +99,9 @@ public function toString(): string
     }
 
     /**
-     * @return TEntity|null
+     * @return object|null
+     *
+     * @phpstan-return TEntity|null
      */
     public function getInstance()/* : ?object */
     {