Add more types/type-hints (#1313)

src/Analysers/ComposerAutoloaderScanner.php

@@ -17,7 +17,11 @@
 class ComposerAutoloaderScanner
 {
     /**
-     * Collect all classes/interfaces/traits known by autoloaders.
+     * Collect all classes/interfaces/traits known by composer.
+     *
+     * @param array<string> $namespaces
+     *
+     * @return array<string>
      */
     public function scan(array $namespaces): array
     {

src/Analysers/DocBlockParser.php

@@ -7,6 +7,7 @@
 namespace OpenApi\Analysers;
 
 use Doctrine\Common\Annotations\DocParser;
+use OpenApi\Annotations\AbstractAnnotation;
 use OpenApi\Context;
 use OpenApi\Generator;
 
@@ -20,6 +21,9 @@ class DocBlockParser
      */
     protected $docParser;
 
+    /**
+     * @param array<string, class-string> $aliases
+     */
     public function __construct(array $aliases = [])
     {
         $docParser = new DocParser();
@@ -28,6 +32,9 @@ public function __construct(array $aliases = [])
         $this->docParser = $docParser;
     }
 
+    /**
+     * @param array<string, class-string> $aliases
+     */
     public function setAliases(array $aliases): void
     {
         $this->docParser->setImports($aliases);
@@ -39,7 +46,7 @@ public function setAliases(array $aliases): void
      * @param string  $comment a T_DOC_COMMENT
      * @param Context $context
      *
-     * @return array Annotations
+     * @return array<AbstractAnnotation>
      */
     public function fromComment(string $comment, Context $context): array
     {

src/Analysers/ReflectionAnalyser.php

@@ -27,6 +27,9 @@ class ReflectionAnalyser implements AnalyserInterface
     /** @var Generator|null */
     protected $generator;
 
+    /**
+     * @param array<AnnotationFactoryInterface> $annotationFactories
+     */
     public function __construct(array $annotationFactories = [])
     {
         $this->annotationFactories = $annotationFactories;

src/Analysers/TokenScanner.php

@@ -215,6 +215,9 @@ protected function nextToken(array &$tokens)
         return $token;
     }
 
+    /**
+     * @return array<string>
+     */
     protected function resolveFQN(array $names, string $namespace, array $uses): array
     {
         $resolve = function ($name) use ($namespace, $uses) {

src/Annotations/Attachable.php

@@ -64,7 +64,7 @@ class Attachable extends AbstractAnnotation
      * Container to allow custom annotations that are limited to a subset of potential parent
      * annotation classes.
      *
-     * @return array List of valid parent annotation classes. If `null`` the default nesting rules apply.
+     * @return array<class-string>|null List of valid parent annotation classes. If `null`, the default nesting rules apply.
      */
     public function allowedParents(): ?array
     {

src/Generator.php

@@ -129,6 +129,9 @@ public static function isDefault($value): bool
         return $value === Generator::UNDEFINED;
     }
 
+    /**
+     * @return array<string>
+     */
     public function getAliases(): array
     {
         return $this->aliases;
@@ -148,6 +151,9 @@ public function setAliases(array $aliases): Generator
         return $this;
     }
 
+    /**
+     * @return array<string>|null
+     */
     public function getNamespaces(): ?array
     {
         return $this->namespaces;