add missing typehints and return types;

Author: ashnazg

src/DocBlock.php

@@ -133,7 +133,7 @@ public function isTemplateEnd(): bool
      *
      * @return Tag[]
      */
-    public function getTags()
+    public function getTags(): array
     {
         return $this->tags;
     }
@@ -146,7 +146,7 @@ public function getTags()
      *
      * @return Tag[]
      */
-    public function getTagsByName(string $name)
+    public function getTagsByName(string $name): array
     {
         $result = [];
 

src/DocBlock/Description.php

@@ -72,7 +72,7 @@ public function __construct(string $bodyTemplate, array $tags = [])
      *
      * @return Tag[]
      */
-    public function getTags()
+    public function getTags(): array
     {
         return $this->tags;
     }

src/DocBlock/DescriptionFactory.php

@@ -61,7 +61,7 @@ public function create(string $contents, ?TypeContext $context = null): Descript
      *
      * @return string[] A series of tokens of which the description text is composed.
      */
-    private function lex(string $contents)
+    private function lex(string $contents): array
     {
         $contents = $this->removeSuperfluousStartingWhitespace($contents);
 

src/DocBlock/StandardTagFactory.php

@@ -163,7 +163,7 @@ public function registerTagHandler(string $tagName, string $handler): void
      *
      * @return string[]
      */
-    private function extractTagParts(string $tagLine)
+    private function extractTagParts(string $tagLine): array
     {
         $matches = [];
         if (! preg_match('/^@(' . self::REGEX_TAGNAME . ')(?:\s*([^\s].*)|$)/us', $tagLine, $matches)) {
@@ -222,7 +222,7 @@ private function findHandlerClassName(string $tagName, TypeContext $context): st
      * @return mixed[] A series of values that can be passed to the Factory Method of the tag whose parameters
      *     is provided with this method.
      */
-    private function getArgumentsForParametersFromWiring($parameters, $locator)
+    private function getArgumentsForParametersFromWiring($parameters, $locator): array
     {
         $arguments = [];
         foreach ($parameters as $index => $parameter) {
@@ -251,7 +251,7 @@ private function getArgumentsForParametersFromWiring($parameters, $locator)
      *
      * @return \ReflectionParameter[]
      */
-    private function fetchParametersForHandlerFactoryMethod(string $handlerClassName)
+    private function fetchParametersForHandlerFactoryMethod(string $handlerClassName): array
     {
         if (! isset($this->tagHandlerParameterCache[$handlerClassName])) {
             $methodReflection = new \ReflectionMethod($handlerClassName, 'create');
@@ -271,7 +271,7 @@ private function fetchParametersForHandlerFactoryMethod(string $handlerClassName
      *
      * @return mixed[]
      */
-    private function getServiceLocatorWithDynamicParameters(TypeContext $context, string $tagName, string $tagBody)
+    private function getServiceLocatorWithDynamicParameters(TypeContext $context, string $tagName, string $tagBody): array
     {
         $locator = array_merge(
             $this->serviceLocator,

src/DocBlock/Tags/Example.php

@@ -81,7 +81,7 @@ public function getContent()
     /**
      * {@inheritdoc}
      */
-    public static function create(string $body)
+    public static function create(string $body): ?Tag
     {
         // File component: File path in quotes or File URI / Source information
         if (! preg_match('/^(?:\"([^\"]+)\"|(\S+))(?:\s+(.*))?$/sux', $body, $matches)) {

src/DocBlock/Tags/Method.php

@@ -92,12 +92,12 @@ public static function create(
                 )?
                 # Return type
                 (?:
-                    (   
+                    (
                         (?:[\w\|_\\\\]*\$this[\w\|_\\\\]*)
                         |
                         (?:
                             (?:[\w\|_\\\\]+)
-                            # array notation           
+                            # array notation
                             (?:\[\])*
                         )*
                     )
@@ -170,7 +170,7 @@ public function getMethodName(): string
     /**
      * @return string[]
      */
-    public function getArguments()
+    public function getArguments(): array
     {
         return $this->arguments;
     }
@@ -204,7 +204,7 @@ public function __toString(): string
             . ($this->description ? ' ' . $this->description->render() : ''));
     }
 
-    private function filterArguments($arguments)
+    private function filterArguments(array $arguments = []): array
     {
         foreach ($arguments as &$argument) {
             if (is_string($argument)) {
@@ -227,7 +227,7 @@ private function filterArguments($arguments)
         return $arguments;
     }
 
-    private static function stripRestArg($argument)
+    private static function stripRestArg(string $argument): string
     {
         if (strpos($argument, '...') === 0) {
             $argument = trim(substr($argument, 3));

src/DocBlock/Tags/Reference/Url.php

@@ -28,7 +28,7 @@ final class Url implements Reference
     /**
      * Url constructor.
      */
-    public function __construct($uri)
+    public function __construct(string $uri)
     {
         Assert::stringNotEmpty($uri);
         $this->uri = $uri;

src/DocBlockFactory.php

@@ -127,7 +127,7 @@ private function stripDocComment(string $comment): string
      *
      * @return string[] containing the template marker (if any), summary, description and a string containing the tags.
      */
-    private function splitDocBlock(string $comment)
+    private function splitDocBlock(string $comment): array
     {
         // Performance improvement cheat: if the first character is an @ then only tags are in this DocBlock. This
         // method does not split tags so we return this verbatim as the fourth result (tags). This saves us the
@@ -227,7 +227,7 @@ private function parseTagBlock(string $tags, Types\Context $context): array
     /**
      * @return string[]
      */
-    private function splitTagBlockIntoTagLines(string $tags)
+    private function splitTagBlockIntoTagLines(string $tags): array
     {
         $result = [];
         foreach (explode("\n", $tags) as $tag_line) {