Merge pull request #5630 from paulbalandan/routes-docblocks

Rename docblocks in Routes utilities classes

Author: kenjis

system/Commands/Utilities/Routes/AutoRouteCollector.php

@@ -35,7 +35,8 @@ public function __construct(string $namespace, string $defaultController, string
     }
 
     /**
-     * @return list<list<string>>
+     * @return array<int, array<int, string>>
+     * @phpstan-return list<list<string>>
      */
     public function get(): array
     {

system/Commands/Utilities/Routes/ControllerFinder.php

@@ -36,7 +36,8 @@ public function __construct(string $namespace)
     }
 
     /**
-     * @return class-string[]
+     * @return string[]
+     * @phpstan-return class-string[]
      */
     public function find(): array
     {
@@ -62,7 +63,7 @@ public function find(): array
                 $classnameOrEmpty = $this->locator->getClassname($file);
 
                 if ($classnameOrEmpty !== '') {
-                    /** @var class-string $classname */
+                    /** @phpstan-var class-string $classname */
                     $classname = $classnameOrEmpty;
 
                     $classes[] = $classname;

system/Commands/Utilities/Routes/ControllerMethodReader.php

@@ -33,9 +33,10 @@ public function __construct(string $namespace)
     }
 
     /**
-     * @param class-string $class
+     * @phpstan-param class-string $class
      *
-     * @return list<array{route: string, handler: string}>
+     * @return array<int, array{route: string, handler: string}>
+     * @phpstan-return list<array{route: string, handler: string}>
      */
     public function read(string $class, string $defaultController = 'Home', string $defaultMethod = 'index'): array
     {
@@ -125,7 +126,7 @@ private function hasRemap(ReflectionClass $class): bool
     }
 
     /**
-     * @param class-string $classname
+     * @phpstan-param class-string $classname
      *
      * @return string URI path part from the folder(s) and controller
      */