eventespresso / event-espresso-core

vendor/phpdocumentor/reflection-docblock/src/DocBlock/DescriptionFactory.php

Indentation +105 added lines, -105 removed lines

@@ -47,59 +47,59 @@ 
  */
 class DescriptionFactory
 {
-    /** @var TagFactory */
-    private $tagFactory;
-
-    /**
-     * Initializes this factory with the means to construct (inline) tags.
-     */
-    public function __construct(TagFactory $tagFactory)
-    {
-        $this->tagFactory = $tagFactory;
-    }
-
-    /**
-     * Returns the parsed text of this description.
-     */
-    public function create(string $contents, ?TypeContext $context = null): Description
-    {
-        $tokens   = $this->lex($contents);
-        $count    = count($tokens);
-        $tagCount = 0;
-        $tags     = [];
-
-        for ($i = 1; $i < $count; $i += 2) {
-            $tags[]     = $this->tagFactory->create($tokens[$i], $context);
-            $tokens[$i] = '%' . ++$tagCount . '$s';
-        }
-
-        //In order to allow "literal" inline tags, the otherwise invalid
-        //sequence "{@}" is changed to "@", and "{}" is changed to "}".
-        //"%" is escaped to "%%" because of vsprintf.
-        //See unit tests for examples.
-        for ($i = 0; $i < $count; $i += 2) {
-            $tokens[$i] = str_replace(['{@}', '{}', '%'], ['@', '}', '%%'], $tokens[$i]);
-        }
-
-        return new Description(implode('', $tokens), $tags);
-    }
-
-    /**
-     * Strips the contents from superfluous whitespace and splits the description into a series of tokens.
-     *
-     * @return string[] A series of tokens of which the description text is composed.
-     */
-    private function lex(string $contents): array
-    {
-        $contents = $this->removeSuperfluousStartingWhitespace($contents);
-
-        // performance optimalization; if there is no inline tag, don't bother splitting it up.
-        if (strpos($contents, '{@') === false) {
-            return [$contents];
-        }
-
-        return Utils::pregSplit(
-            '/\{
+	/** @var TagFactory */
+	private $tagFactory;
+
+	/**
+	 * Initializes this factory with the means to construct (inline) tags.
+	 */
+	public function __construct(TagFactory $tagFactory)
+	{
+		$this->tagFactory = $tagFactory;
+	}
+
+	/**
+	 * Returns the parsed text of this description.
+	 */
+	public function create(string $contents, ?TypeContext $context = null): Description
+	{
+		$tokens   = $this->lex($contents);
+		$count    = count($tokens);
+		$tagCount = 0;
+		$tags     = [];
+
+		for ($i = 1; $i < $count; $i += 2) {
+			$tags[]     = $this->tagFactory->create($tokens[$i], $context);
+			$tokens[$i] = '%' . ++$tagCount . '$s';
+		}
+
+		//In order to allow "literal" inline tags, the otherwise invalid
+		//sequence "{@}" is changed to "@", and "{}" is changed to "}".
+		//"%" is escaped to "%%" because of vsprintf.
+		//See unit tests for examples.
+		for ($i = 0; $i < $count; $i += 2) {
+			$tokens[$i] = str_replace(['{@}', '{}', '%'], ['@', '}', '%%'], $tokens[$i]);
+		}
+
+		return new Description(implode('', $tokens), $tags);
+	}
+
+	/**
+	 * Strips the contents from superfluous whitespace and splits the description into a series of tokens.
+	 *
+	 * @return string[] A series of tokens of which the description text is composed.
+	 */
+	private function lex(string $contents): array
+	{
+		$contents = $this->removeSuperfluousStartingWhitespace($contents);
+
+		// performance optimalization; if there is no inline tag, don't bother splitting it up.
+		if (strpos($contents, '{@') === false) {
+			return [$contents];
+		}
+
+		return Utils::pregSplit(
+			'/\{
                 # "{@}" is not a valid inline tag. This ensures that we do not treat it as one, but treat it literally.
                 (?!@\})
                 # We want to capture the whole tag line, but without the inline tag delimiters.
@@ -123,56 +123,56 @@ 
                        # nested inline tags.
                 )
             \}/Sux',
-            $contents,
-            0,
-            PREG_SPLIT_DELIM_CAPTURE
-        );
-    }
-
-    /**
-     * Removes the superfluous from a multi-line description.
-     *
-     * When a description has more than one line then it can happen that the second and subsequent lines have an
-     * additional indentation. This is commonly in use with tags like this:
-     *
-     *     {@}since 1.1.0 This is an example
-     *         description where we have an
-     *         indentation in the second and
-     *         subsequent lines.
-     *
-     * If we do not normalize the indentation then we have superfluous whitespace on the second and subsequent
-     * lines and this may cause rendering issues when, for example, using a Markdown converter.
-     */
-    private function removeSuperfluousStartingWhitespace(string $contents): string
-    {
-        $lines = Utils::pregSplit("/\r\n?|\n/", $contents);
-
-        // if there is only one line then we don't have lines with superfluous whitespace and
-        // can use the contents as-is
-        if (count($lines) <= 1) {
-            return $contents;
-        }
-
-        // determine how many whitespace characters need to be stripped
-        $startingSpaceCount = 9999999;
-        for ($i = 1, $iMax = count($lines); $i < $iMax; ++$i) {
-            // lines with a no length do not count as they are not indented at all
-            if (trim($lines[$i]) === '') {
-                continue;
-            }
-
-            // determine the number of prefixing spaces by checking the difference in line length before and after
-            // an ltrim
-            $startingSpaceCount = min($startingSpaceCount, strlen($lines[$i]) - strlen(ltrim($lines[$i])));
-        }
-
-        // strip the number of spaces from each line
-        if ($startingSpaceCount > 0) {
-            for ($i = 1, $iMax = count($lines); $i < $iMax; ++$i) {
-                $lines[$i] = substr($lines[$i], $startingSpaceCount);
-            }
-        }
-
-        return implode("\n", $lines);
-    }
+			$contents,
+			0,
+			PREG_SPLIT_DELIM_CAPTURE
+		);
+	}
+
+	/**
+	 * Removes the superfluous from a multi-line description.
+	 *
+	 * When a description has more than one line then it can happen that the second and subsequent lines have an
+	 * additional indentation. This is commonly in use with tags like this:
+	 *
+	 *     {@}since 1.1.0 This is an example
+	 *         description where we have an
+	 *         indentation in the second and
+	 *         subsequent lines.
+	 *
+	 * If we do not normalize the indentation then we have superfluous whitespace on the second and subsequent
+	 * lines and this may cause rendering issues when, for example, using a Markdown converter.
+	 */
+	private function removeSuperfluousStartingWhitespace(string $contents): string
+	{
+		$lines = Utils::pregSplit("/\r\n?|\n/", $contents);
+
+		// if there is only one line then we don't have lines with superfluous whitespace and
+		// can use the contents as-is
+		if (count($lines) <= 1) {
+			return $contents;
+		}
+
+		// determine how many whitespace characters need to be stripped
+		$startingSpaceCount = 9999999;
+		for ($i = 1, $iMax = count($lines); $i < $iMax; ++$i) {
+			// lines with a no length do not count as they are not indented at all
+			if (trim($lines[$i]) === '') {
+				continue;
+			}
+
+			// determine the number of prefixing spaces by checking the difference in line length before and after
+			// an ltrim
+			$startingSpaceCount = min($startingSpaceCount, strlen($lines[$i]) - strlen(ltrim($lines[$i])));
+		}
+
+		// strip the number of spaces from each line
+		if ($startingSpaceCount > 0) {
+			for ($i = 1, $iMax = count($lines); $i < $iMax; ++$i) {
+				$lines[$i] = substr($lines[$i], $startingSpaceCount);
+			}
+		}
+
+		return implode("\n", $lines);
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -70,7 +70,7 @@
 
         for ($i = 1; $i < $count; $i += 2) {
             $tags[]     = $this->tagFactory->create($tokens[$i], $context);
-            $tokens[$i] = '%' . ++$tagCount . '$s';
+            $tokens[$i] = '%'.++$tagCount.'$s';
         }
 
         //In order to allow "literal" inline tags, the otherwise invalid

vendor/phpdocumentor/reflection-docblock/src/DocBlock/Description.php

Indentation +52 added lines, -52 removed lines

@@ -52,64 +52,64 @@
  */
 class Description
 {
-    /** @var string */
-    private $bodyTemplate;
+	/** @var string */
+	private $bodyTemplate;
 
-    /** @var Tag[] */
-    private $tags;
+	/** @var Tag[] */
+	private $tags;
 
-    /**
-     * Initializes a Description with its body (template) and a listing of the tags used in the body template.
-     *
-     * @param Tag[] $tags
-     */
-    public function __construct(string $bodyTemplate, array $tags = [])
-    {
-        $this->bodyTemplate = $bodyTemplate;
-        $this->tags         = $tags;
-    }
+	/**
+	 * Initializes a Description with its body (template) and a listing of the tags used in the body template.
+	 *
+	 * @param Tag[] $tags
+	 */
+	public function __construct(string $bodyTemplate, array $tags = [])
+	{
+		$this->bodyTemplate = $bodyTemplate;
+		$this->tags         = $tags;
+	}
 
-    /**
-     * Returns the body template.
-     */
-    public function getBodyTemplate(): string
-    {
-        return $this->bodyTemplate;
-    }
+	/**
+	 * Returns the body template.
+	 */
+	public function getBodyTemplate(): string
+	{
+		return $this->bodyTemplate;
+	}
 
-    /**
-     * Returns the tags for this DocBlock.
-     *
-     * @return Tag[]
-     */
-    public function getTags(): array
-    {
-        return $this->tags;
-    }
+	/**
+	 * Returns the tags for this DocBlock.
+	 *
+	 * @return Tag[]
+	 */
+	public function getTags(): array
+	{
+		return $this->tags;
+	}
 
-    /**
-     * Renders this description as a string where the provided formatter will format the tags in the expected string
-     * format.
-     */
-    public function render(?Formatter $formatter = null): string
-    {
-        if ($formatter === null) {
-            $formatter = new PassthroughFormatter();
-        }
+	/**
+	 * Renders this description as a string where the provided formatter will format the tags in the expected string
+	 * format.
+	 */
+	public function render(?Formatter $formatter = null): string
+	{
+		if ($formatter === null) {
+			$formatter = new PassthroughFormatter();
+		}
 
-        $tags = [];
-        foreach ($this->tags as $tag) {
-            $tags[] = '{' . $formatter->format($tag) . '}';
-        }
+		$tags = [];
+		foreach ($this->tags as $tag) {
+			$tags[] = '{' . $formatter->format($tag) . '}';
+		}
 
-        return vsprintf($this->bodyTemplate, $tags);
-    }
+		return vsprintf($this->bodyTemplate, $tags);
+	}
 
-    /**
-     * Returns a plain string representation of this description.
-     */
-    public function __toString(): string
-    {
-        return $this->render();
-    }
+	/**
+	 * Returns a plain string representation of this description.
+	 */
+	public function __toString(): string
+	{
+		return $this->render();
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -99,7 +99,7 @@
 
         $tags = [];
         foreach ($this->tags as $tag) {
-            $tags[] = '{' . $formatter->format($tag) . '}';
+            $tags[] = '{'.$formatter->format($tag).'}';
         }
 
         return vsprintf($this->bodyTemplate, $tags);

vendor/phpdocumentor/reflection-docblock/src/DocBlock/StandardTagFactory.php

Indentation +277 added lines, -277 removed lines

@@ -68,281 +68,281 @@
  */
 final class StandardTagFactory implements TagFactory
 {
-    /** PCRE regular expression matching a tag name. */
-    public const REGEX_TAGNAME = '[\w\-\_\\\\:]+';
-
-    /**
-     * @var array<class-string<Tag>> An array with a tag as a key, and an
-     *                               FQCN to a class that handles it as an array value.
-     */
-    private $tagHandlerMappings = [
-        'author' => Author::class,
-        'covers' => Covers::class,
-        'deprecated' => Deprecated::class,
-        // 'example'        => '\phpDocumentor\Reflection\DocBlock\Tags\Example',
-        'link' => LinkTag::class,
-        'method' => Method::class,
-        'param' => Param::class,
-        'property-read' => PropertyRead::class,
-        'property' => Property::class,
-        'property-write' => PropertyWrite::class,
-        'return' => Return_::class,
-        'see' => SeeTag::class,
-        'since' => Since::class,
-        'source' => Source::class,
-        'throw' => Throws::class,
-        'throws' => Throws::class,
-        'uses' => Uses::class,
-        'var' => Var_::class,
-        'version' => Version::class,
-    ];
-
-    /**
-     * @var array<class-string<Tag>> An array with a anotation s a key, and an
-     *      FQCN to a class that handles it as an array value.
-     */
-    private $annotationMappings = [];
-
-    /**
-     * @var ReflectionParameter[][] a lazy-loading cache containing parameters
-     *      for each tagHandler that has been used.
-     */
-    private $tagHandlerParameterCache = [];
-
-    /** @var FqsenResolver */
-    private $fqsenResolver;
-
-    /**
-     * @var mixed[] an array representing a simple Service Locator where we can store parameters and
-     *     services that can be inserted into the Factory Methods of Tag Handlers.
-     */
-    private $serviceLocator = [];
-
-    /**
-     * Initialize this tag factory with the means to resolve an FQSEN and optionally a list of tag handlers.
-     *
-     * If no tag handlers are provided than the default list in the {@see self::$tagHandlerMappings} property
-     * is used.
-     *
-     * @see self::registerTagHandler() to add a new tag handler to the existing default list.
-     *
-     * @param array<class-string<Tag>> $tagHandlers
-     */
-    public function __construct(FqsenResolver $fqsenResolver, ?array $tagHandlers = null)
-    {
-        $this->fqsenResolver = $fqsenResolver;
-        if ($tagHandlers !== null) {
-            $this->tagHandlerMappings = $tagHandlers;
-        }
-
-        $this->addService($fqsenResolver, FqsenResolver::class);
-    }
-
-    public function create(string $tagLine, ?TypeContext $context = null): Tag
-    {
-        if (!$context) {
-            $context = new TypeContext('');
-        }
-
-        [$tagName, $tagBody] = $this->extractTagParts($tagLine);
-
-        return $this->createTag(trim($tagBody), $tagName, $context);
-    }
-
-    /**
-     * @param mixed $value
-     */
-    public function addParameter(string $name, $value): void
-    {
-        $this->serviceLocator[$name] = $value;
-    }
-
-    public function addService(object $service, ?string $alias = null): void
-    {
-        $this->serviceLocator[$alias ?: get_class($service)] = $service;
-    }
-
-    public function registerTagHandler(string $tagName, string $handler): void
-    {
-        Assert::stringNotEmpty($tagName);
-        Assert::classExists($handler);
-        Assert::implementsInterface($handler, Tag::class);
-
-        if (strpos($tagName, '\\') && $tagName[0] !== '\\') {
-            throw new InvalidArgumentException(
-                'A namespaced tag must have a leading backslash as it must be fully qualified'
-            );
-        }
-
-        $this->tagHandlerMappings[$tagName] = $handler;
-    }
-
-    /**
-     * Extracts all components for a tag.
-     *
-     * @return string[]
-     */
-    private function extractTagParts(string $tagLine): array
-    {
-        $matches = [];
-        if (!preg_match('/^@(' . self::REGEX_TAGNAME . ')((?:[\s\(\{])\s*([^\s].*)|$)/us', $tagLine, $matches)) {
-            throw new InvalidArgumentException(
-                'The tag "' . $tagLine . '" does not seem to be wellformed, please check it for errors'
-            );
-        }
-
-        if (count($matches) < 3) {
-            $matches[] = '';
-        }
-
-        return array_slice($matches, 1);
-    }
-
-    /**
-     * Creates a new tag object with the given name and body or returns null if the tag name was recognized but the
-     * body was invalid.
-     */
-    private function createTag(string $body, string $name, TypeContext $context): Tag
-    {
-        $handlerClassName = $this->findHandlerClassName($name, $context);
-        $arguments        = $this->getArgumentsForParametersFromWiring(
-            $this->fetchParametersForHandlerFactoryMethod($handlerClassName),
-            $this->getServiceLocatorWithDynamicParameters($context, $name, $body)
-        );
-
-        try {
-            $callable = [$handlerClassName, 'create'];
-            Assert::isCallable($callable);
-            /** @phpstan-var callable(string): ?Tag $callable */
-            $tag = call_user_func_array($callable, $arguments);
-
-            return $tag ?? InvalidTag::create($body, $name);
-        } catch (InvalidArgumentException $e) {
-            return InvalidTag::create($body, $name)->withError($e);
-        }
-    }
-
-    /**
-     * Determines the Fully Qualified Class Name of the Factory or Tag (containing a Factory Method `create`).
-     *
-     * @return class-string<Tag>
-     */
-    private function findHandlerClassName(string $tagName, TypeContext $context): string
-    {
-        $handlerClassName = Generic::class;
-        if (isset($this->tagHandlerMappings[$tagName])) {
-            $handlerClassName = $this->tagHandlerMappings[$tagName];
-        } elseif ($this->isAnnotation($tagName)) {
-            // TODO: Annotation support is planned for a later stage and as such is disabled for now
-            $tagName = (string) $this->fqsenResolver->resolve($tagName, $context);
-            if (isset($this->annotationMappings[$tagName])) {
-                $handlerClassName = $this->annotationMappings[$tagName];
-            }
-        }
-
-        return $handlerClassName;
-    }
-
-    /**
-     * Retrieves the arguments that need to be passed to the Factory Method with the given Parameters.
-     *
-     * @param ReflectionParameter[] $parameters
-     * @param mixed[]               $locator
-     *
-     * @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(array $parameters, array $locator): array
-    {
-        $arguments = [];
-        foreach ($parameters as $parameter) {
-            $type     = $parameter->getType();
-            $typeHint = null;
-            if ($type instanceof ReflectionNamedType) {
-                $typeHint = $type->getName();
-                if ($typeHint === 'self') {
-                    $declaringClass = $parameter->getDeclaringClass();
-                    if ($declaringClass !== null) {
-                        $typeHint = $declaringClass->getName();
-                    }
-                }
-            }
-
-            if (isset($locator[$typeHint])) {
-                $arguments[] = $locator[$typeHint];
-                continue;
-            }
-
-            $parameterName = $parameter->getName();
-            if (isset($locator[$parameterName])) {
-                $arguments[] = $locator[$parameterName];
-                continue;
-            }
-
-            $arguments[] = null;
-        }
-
-        return $arguments;
-    }
-
-    /**
-     * Retrieves a series of ReflectionParameter objects for the static 'create' method of the given
-     * tag handler class name.
-     *
-     * @param class-string $handlerClassName
-     *
-     * @return ReflectionParameter[]
-     */
-    private function fetchParametersForHandlerFactoryMethod(string $handlerClassName): array
-    {
-        if (!isset($this->tagHandlerParameterCache[$handlerClassName])) {
-            $methodReflection                                  = new ReflectionMethod($handlerClassName, 'create');
-            $this->tagHandlerParameterCache[$handlerClassName] = $methodReflection->getParameters();
-        }
-
-        return $this->tagHandlerParameterCache[$handlerClassName];
-    }
-
-    /**
-     * Returns a copy of this class' Service Locator with added dynamic parameters,
-     * such as the tag's name, body and Context.
-     *
-     * @param TypeContext $context The Context (namespace and aliasses) that may be
-     *  passed and is used to resolve FQSENs.
-     * @param string      $tagName The name of the tag that may be
-     *  passed onto the factory method of the Tag class.
-     * @param string      $tagBody The body of the tag that may be
-     *  passed onto the factory method of the Tag class.
-     *
-     * @return mixed[]
-     */
-    private function getServiceLocatorWithDynamicParameters(
-        TypeContext $context,
-        string $tagName,
-        string $tagBody
-    ): array {
-        return array_merge(
-            $this->serviceLocator,
-            [
-                'name' => $tagName,
-                'body' => $tagBody,
-                TypeContext::class => $context,
-            ]
-        );
-    }
-
-    /**
-     * Returns whether the given tag belongs to an annotation.
-     *
-     * @todo this method should be populated once we implement Annotation notation support.
-     */
-    private function isAnnotation(string $tagContent): bool
-    {
-        // 1. Contains a namespace separator
-        // 2. Contains parenthesis
-        // 3. Is present in a list of known annotations (make the algorithm smart by first checking is the last part
-        //    of the annotation class name matches the found tag name
-
-        return false;
-    }
+	/** PCRE regular expression matching a tag name. */
+	public const REGEX_TAGNAME = '[\w\-\_\\\\:]+';
+
+	/**
+	 * @var array<class-string<Tag>> An array with a tag as a key, and an
+	 *                               FQCN to a class that handles it as an array value.
+	 */
+	private $tagHandlerMappings = [
+		'author' => Author::class,
+		'covers' => Covers::class,
+		'deprecated' => Deprecated::class,
+		// 'example'        => '\phpDocumentor\Reflection\DocBlock\Tags\Example',
+		'link' => LinkTag::class,
+		'method' => Method::class,
+		'param' => Param::class,
+		'property-read' => PropertyRead::class,
+		'property' => Property::class,
+		'property-write' => PropertyWrite::class,
+		'return' => Return_::class,
+		'see' => SeeTag::class,
+		'since' => Since::class,
+		'source' => Source::class,
+		'throw' => Throws::class,
+		'throws' => Throws::class,
+		'uses' => Uses::class,
+		'var' => Var_::class,
+		'version' => Version::class,
+	];
+
+	/**
+	 * @var array<class-string<Tag>> An array with a anotation s a key, and an
+	 *      FQCN to a class that handles it as an array value.
+	 */
+	private $annotationMappings = [];
+
+	/**
+	 * @var ReflectionParameter[][] a lazy-loading cache containing parameters
+	 *      for each tagHandler that has been used.
+	 */
+	private $tagHandlerParameterCache = [];
+
+	/** @var FqsenResolver */
+	private $fqsenResolver;
+
+	/**
+	 * @var mixed[] an array representing a simple Service Locator where we can store parameters and
+	 *     services that can be inserted into the Factory Methods of Tag Handlers.
+	 */
+	private $serviceLocator = [];
+
+	/**
+	 * Initialize this tag factory with the means to resolve an FQSEN and optionally a list of tag handlers.
+	 *
+	 * If no tag handlers are provided than the default list in the {@see self::$tagHandlerMappings} property
+	 * is used.
+	 *
+	 * @see self::registerTagHandler() to add a new tag handler to the existing default list.
+	 *
+	 * @param array<class-string<Tag>> $tagHandlers
+	 */
+	public function __construct(FqsenResolver $fqsenResolver, ?array $tagHandlers = null)
+	{
+		$this->fqsenResolver = $fqsenResolver;
+		if ($tagHandlers !== null) {
+			$this->tagHandlerMappings = $tagHandlers;
+		}
+
+		$this->addService($fqsenResolver, FqsenResolver::class);
+	}
+
+	public function create(string $tagLine, ?TypeContext $context = null): Tag
+	{
+		if (!$context) {
+			$context = new TypeContext('');
+		}
+
+		[$tagName, $tagBody] = $this->extractTagParts($tagLine);
+
+		return $this->createTag(trim($tagBody), $tagName, $context);
+	}
+
+	/**
+	 * @param mixed $value
+	 */
+	public function addParameter(string $name, $value): void
+	{
+		$this->serviceLocator[$name] = $value;
+	}
+
+	public function addService(object $service, ?string $alias = null): void
+	{
+		$this->serviceLocator[$alias ?: get_class($service)] = $service;
+	}
+
+	public function registerTagHandler(string $tagName, string $handler): void
+	{
+		Assert::stringNotEmpty($tagName);
+		Assert::classExists($handler);
+		Assert::implementsInterface($handler, Tag::class);
+
+		if (strpos($tagName, '\\') && $tagName[0] !== '\\') {
+			throw new InvalidArgumentException(
+				'A namespaced tag must have a leading backslash as it must be fully qualified'
+			);
+		}
+
+		$this->tagHandlerMappings[$tagName] = $handler;
+	}
+
+	/**
+	 * Extracts all components for a tag.
+	 *
+	 * @return string[]
+	 */
+	private function extractTagParts(string $tagLine): array
+	{
+		$matches = [];
+		if (!preg_match('/^@(' . self::REGEX_TAGNAME . ')((?:[\s\(\{])\s*([^\s].*)|$)/us', $tagLine, $matches)) {
+			throw new InvalidArgumentException(
+				'The tag "' . $tagLine . '" does not seem to be wellformed, please check it for errors'
+			);
+		}
+
+		if (count($matches) < 3) {
+			$matches[] = '';
+		}
+
+		return array_slice($matches, 1);
+	}
+
+	/**
+	 * Creates a new tag object with the given name and body or returns null if the tag name was recognized but the
+	 * body was invalid.
+	 */
+	private function createTag(string $body, string $name, TypeContext $context): Tag
+	{
+		$handlerClassName = $this->findHandlerClassName($name, $context);
+		$arguments        = $this->getArgumentsForParametersFromWiring(
+			$this->fetchParametersForHandlerFactoryMethod($handlerClassName),
+			$this->getServiceLocatorWithDynamicParameters($context, $name, $body)
+		);
+
+		try {
+			$callable = [$handlerClassName, 'create'];
+			Assert::isCallable($callable);
+			/** @phpstan-var callable(string): ?Tag $callable */
+			$tag = call_user_func_array($callable, $arguments);
+
+			return $tag ?? InvalidTag::create($body, $name);
+		} catch (InvalidArgumentException $e) {
+			return InvalidTag::create($body, $name)->withError($e);
+		}
+	}
+
+	/**
+	 * Determines the Fully Qualified Class Name of the Factory or Tag (containing a Factory Method `create`).
+	 *
+	 * @return class-string<Tag>
+	 */
+	private function findHandlerClassName(string $tagName, TypeContext $context): string
+	{
+		$handlerClassName = Generic::class;
+		if (isset($this->tagHandlerMappings[$tagName])) {
+			$handlerClassName = $this->tagHandlerMappings[$tagName];
+		} elseif ($this->isAnnotation($tagName)) {
+			// TODO: Annotation support is planned for a later stage and as such is disabled for now
+			$tagName = (string) $this->fqsenResolver->resolve($tagName, $context);
+			if (isset($this->annotationMappings[$tagName])) {
+				$handlerClassName = $this->annotationMappings[$tagName];
+			}
+		}
+
+		return $handlerClassName;
+	}
+
+	/**
+	 * Retrieves the arguments that need to be passed to the Factory Method with the given Parameters.
+	 *
+	 * @param ReflectionParameter[] $parameters
+	 * @param mixed[]               $locator
+	 *
+	 * @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(array $parameters, array $locator): array
+	{
+		$arguments = [];
+		foreach ($parameters as $parameter) {
+			$type     = $parameter->getType();
+			$typeHint = null;
+			if ($type instanceof ReflectionNamedType) {
+				$typeHint = $type->getName();
+				if ($typeHint === 'self') {
+					$declaringClass = $parameter->getDeclaringClass();
+					if ($declaringClass !== null) {
+						$typeHint = $declaringClass->getName();
+					}
+				}
+			}
+
+			if (isset($locator[$typeHint])) {
+				$arguments[] = $locator[$typeHint];
+				continue;
+			}
+
+			$parameterName = $parameter->getName();
+			if (isset($locator[$parameterName])) {
+				$arguments[] = $locator[$parameterName];
+				continue;
+			}
+
+			$arguments[] = null;
+		}
+
+		return $arguments;
+	}
+
+	/**
+	 * Retrieves a series of ReflectionParameter objects for the static 'create' method of the given
+	 * tag handler class name.
+	 *
+	 * @param class-string $handlerClassName
+	 *
+	 * @return ReflectionParameter[]
+	 */
+	private function fetchParametersForHandlerFactoryMethod(string $handlerClassName): array
+	{
+		if (!isset($this->tagHandlerParameterCache[$handlerClassName])) {
+			$methodReflection                                  = new ReflectionMethod($handlerClassName, 'create');
+			$this->tagHandlerParameterCache[$handlerClassName] = $methodReflection->getParameters();
+		}
+
+		return $this->tagHandlerParameterCache[$handlerClassName];
+	}
+
+	/**
+	 * Returns a copy of this class' Service Locator with added dynamic parameters,
+	 * such as the tag's name, body and Context.
+	 *
+	 * @param TypeContext $context The Context (namespace and aliasses) that may be
+	 *  passed and is used to resolve FQSENs.
+	 * @param string      $tagName The name of the tag that may be
+	 *  passed onto the factory method of the Tag class.
+	 * @param string      $tagBody The body of the tag that may be
+	 *  passed onto the factory method of the Tag class.
+	 *
+	 * @return mixed[]
+	 */
+	private function getServiceLocatorWithDynamicParameters(
+		TypeContext $context,
+		string $tagName,
+		string $tagBody
+	): array {
+		return array_merge(
+			$this->serviceLocator,
+			[
+				'name' => $tagName,
+				'body' => $tagBody,
+				TypeContext::class => $context,
+			]
+		);
+	}
+
+	/**
+	 * Returns whether the given tag belongs to an annotation.
+	 *
+	 * @todo this method should be populated once we implement Annotation notation support.
+	 */
+	private function isAnnotation(string $tagContent): bool
+	{
+		// 1. Contains a namespace separator
+		// 2. Contains parenthesis
+		// 3. Is present in a list of known annotations (make the algorithm smart by first checking is the last part
+		//    of the annotation class name matches the found tag name
+
+		return false;
+	}
 }

Spacing +4 added lines, -4 removed lines

@@ -140,7 +140,7 @@ 
 
     public function create(string $tagLine, ?TypeContext $context = null): Tag
     {
-        if (!$context) {
+        if ( ! $context) {
             $context = new TypeContext('');
         }
 
@@ -185,9 +185,9 @@ 
     private function extractTagParts(string $tagLine): array
     {
         $matches = [];
-        if (!preg_match('/^@(' . self::REGEX_TAGNAME . ')((?:[\s\(\{])\s*([^\s].*)|$)/us', $tagLine, $matches)) {
+        if ( ! preg_match('/^@('.self::REGEX_TAGNAME.')((?:[\s\(\{])\s*([^\s].*)|$)/us', $tagLine, $matches)) {
             throw new InvalidArgumentException(
-                'The tag "' . $tagLine . '" does not seem to be wellformed, please check it for errors'
+                'The tag "'.$tagLine.'" does not seem to be wellformed, please check it for errors'
             );
         }
 
@@ -295,7 +295,7 @@ 
      */
     private function fetchParametersForHandlerFactoryMethod(string $handlerClassName): array
     {
-        if (!isset($this->tagHandlerParameterCache[$handlerClassName])) {
+        if ( ! isset($this->tagHandlerParameterCache[$handlerClassName])) {
             $methodReflection                                  = new ReflectionMethod($handlerClassName, 'create');
             $this->tagHandlerParameterCache[$handlerClassName] = $methodReflection->getParameters();
         }

vendor/phpdocumentor/reflection-docblock/src/DocBlock/Serializer.php

Indentation +126 added lines, -126 removed lines

@@ -28,130 +28,130 @@
  */
 class Serializer
 {
-    /** @var string The string to indent the comment with. */
-    protected $indentString = ' ';
-
-    /** @var int The number of times the indent string is repeated. */
-    protected $indent = 0;
-
-    /** @var bool Whether to indent the first line with the given indent amount and string. */
-    protected $isFirstLineIndented = true;
-
-    /** @var int|null The max length of a line. */
-    protected $lineLength;
-
-    /** @var Formatter A custom tag formatter. */
-    protected $tagFormatter;
-    /** @var string */
-    private $lineEnding;
-
-    /**
-     * Create a Serializer instance.
-     *
-     * @param int       $indent          The number of times the indent string is repeated.
-     * @param string    $indentString    The string to indent the comment with.
-     * @param bool      $indentFirstLine Whether to indent the first line.
-     * @param int|null  $lineLength      The max length of a line or NULL to disable line wrapping.
-     * @param Formatter $tagFormatter    A custom tag formatter, defaults to PassthroughFormatter.
-     * @param string    $lineEnding      Line ending used in the output, by default \n is used.
-     */
-    public function __construct(
-        int $indent = 0,
-        string $indentString = ' ',
-        bool $indentFirstLine = true,
-        ?int $lineLength = null,
-        ?Formatter $tagFormatter = null,
-        string $lineEnding = "\n"
-    ) {
-        $this->indent              = $indent;
-        $this->indentString        = $indentString;
-        $this->isFirstLineIndented = $indentFirstLine;
-        $this->lineLength          = $lineLength;
-        $this->tagFormatter        = $tagFormatter ?: new PassthroughFormatter();
-        $this->lineEnding = $lineEnding;
-    }
-
-    /**
-     * Generate a DocBlock comment.
-     *
-     * @param DocBlock $docblock The DocBlock to serialize.
-     *
-     * @return string The serialized doc block.
-     */
-    public function getDocComment(DocBlock $docblock): string
-    {
-        $indent      = str_repeat($this->indentString, $this->indent);
-        $firstIndent = $this->isFirstLineIndented ? $indent : '';
-        // 3 === strlen(' * ')
-        $wrapLength = $this->lineLength ? $this->lineLength - strlen($indent) - 3 : null;
-
-        $text = $this->removeTrailingSpaces(
-            $indent,
-            $this->addAsterisksForEachLine(
-                $indent,
-                $this->getSummaryAndDescriptionTextBlock($docblock, $wrapLength)
-            )
-        );
-
-        $comment = $firstIndent . "/**\n";
-        if ($text) {
-            $comment .= $indent . ' * ' . $text . "\n";
-            $comment .= $indent . " *\n";
-        }
-
-        $comment = $this->addTagBlock($docblock, $wrapLength, $indent, $comment);
-
-        return str_replace("\n", $this->lineEnding, $comment . $indent . ' */');
-    }
-
-    private function removeTrailingSpaces(string $indent, string $text): string
-    {
-        return str_replace(
-            sprintf("\n%s * \n", $indent),
-            sprintf("\n%s *\n", $indent),
-            $text
-        );
-    }
-
-    private function addAsterisksForEachLine(string $indent, string $text): string
-    {
-        return str_replace(
-            "\n",
-            sprintf("\n%s * ", $indent),
-            $text
-        );
-    }
-
-    private function getSummaryAndDescriptionTextBlock(DocBlock $docblock, ?int $wrapLength): string
-    {
-        $text = $docblock->getSummary() . ((string) $docblock->getDescription() ? "\n\n" . $docblock->getDescription()
-                : '');
-        if ($wrapLength !== null) {
-            $text = wordwrap($text, $wrapLength);
-
-            return $text;
-        }
-
-        return $text;
-    }
-
-    private function addTagBlock(DocBlock $docblock, ?int $wrapLength, string $indent, string $comment): string
-    {
-        foreach ($docblock->getTags() as $tag) {
-            $tagText = $this->tagFormatter->format($tag);
-            if ($wrapLength !== null) {
-                $tagText = wordwrap($tagText, $wrapLength);
-            }
-
-            $tagText = str_replace(
-                "\n",
-                sprintf("\n%s * ", $indent),
-                $tagText
-            );
-
-            $comment .= sprintf("%s * %s\n", $indent, $tagText);
-        }
-
-        return $comment;
-    }
+	/** @var string The string to indent the comment with. */
+	protected $indentString = ' ';
+
+	/** @var int The number of times the indent string is repeated. */
+	protected $indent = 0;
+
+	/** @var bool Whether to indent the first line with the given indent amount and string. */
+	protected $isFirstLineIndented = true;
+
+	/** @var int|null The max length of a line. */
+	protected $lineLength;
+
+	/** @var Formatter A custom tag formatter. */
+	protected $tagFormatter;
+	/** @var string */
+	private $lineEnding;
+
+	/**
+	 * Create a Serializer instance.
+	 *
+	 * @param int       $indent          The number of times the indent string is repeated.
+	 * @param string    $indentString    The string to indent the comment with.
+	 * @param bool      $indentFirstLine Whether to indent the first line.
+	 * @param int|null  $lineLength      The max length of a line or NULL to disable line wrapping.
+	 * @param Formatter $tagFormatter    A custom tag formatter, defaults to PassthroughFormatter.
+	 * @param string    $lineEnding      Line ending used in the output, by default \n is used.
+	 */
+	public function __construct(
+		int $indent = 0,
+		string $indentString = ' ',
+		bool $indentFirstLine = true,
+		?int $lineLength = null,
+		?Formatter $tagFormatter = null,
+		string $lineEnding = "\n"
+	) {
+		$this->indent              = $indent;
+		$this->indentString        = $indentString;
+		$this->isFirstLineIndented = $indentFirstLine;
+		$this->lineLength          = $lineLength;
+		$this->tagFormatter        = $tagFormatter ?: new PassthroughFormatter();
+		$this->lineEnding = $lineEnding;
+	}
+
+	/**
+	 * Generate a DocBlock comment.
+	 *
+	 * @param DocBlock $docblock The DocBlock to serialize.
+	 *
+	 * @return string The serialized doc block.
+	 */
+	public function getDocComment(DocBlock $docblock): string
+	{
+		$indent      = str_repeat($this->indentString, $this->indent);
+		$firstIndent = $this->isFirstLineIndented ? $indent : '';
+		// 3 === strlen(' * ')
+		$wrapLength = $this->lineLength ? $this->lineLength - strlen($indent) - 3 : null;
+
+		$text = $this->removeTrailingSpaces(
+			$indent,
+			$this->addAsterisksForEachLine(
+				$indent,
+				$this->getSummaryAndDescriptionTextBlock($docblock, $wrapLength)
+			)
+		);
+
+		$comment = $firstIndent . "/**\n";
+		if ($text) {
+			$comment .= $indent . ' * ' . $text . "\n";
+			$comment .= $indent . " *\n";
+		}
+
+		$comment = $this->addTagBlock($docblock, $wrapLength, $indent, $comment);
+
+		return str_replace("\n", $this->lineEnding, $comment . $indent . ' */');
+	}
+
+	private function removeTrailingSpaces(string $indent, string $text): string
+	{
+		return str_replace(
+			sprintf("\n%s * \n", $indent),
+			sprintf("\n%s *\n", $indent),
+			$text
+		);
+	}
+
+	private function addAsterisksForEachLine(string $indent, string $text): string
+	{
+		return str_replace(
+			"\n",
+			sprintf("\n%s * ", $indent),
+			$text
+		);
+	}
+
+	private function getSummaryAndDescriptionTextBlock(DocBlock $docblock, ?int $wrapLength): string
+	{
+		$text = $docblock->getSummary() . ((string) $docblock->getDescription() ? "\n\n" . $docblock->getDescription()
+				: '');
+		if ($wrapLength !== null) {
+			$text = wordwrap($text, $wrapLength);
+
+			return $text;
+		}
+
+		return $text;
+	}
+
+	private function addTagBlock(DocBlock $docblock, ?int $wrapLength, string $indent, string $comment): string
+	{
+		foreach ($docblock->getTags() as $tag) {
+			$tagText = $this->tagFormatter->format($tag);
+			if ($wrapLength !== null) {
+				$tagText = wordwrap($tagText, $wrapLength);
+			}
+
+			$tagText = str_replace(
+				"\n",
+				sprintf("\n%s * ", $indent),
+				$tagText
+			);
+
+			$comment .= sprintf("%s * %s\n", $indent, $tagText);
+		}
+
+		return $comment;
+	}
 }

Spacing +5 added lines, -5 removed lines

@@ -93,15 +93,15 @@ 
             )
         );
 
-        $comment = $firstIndent . "/**\n";
+        $comment = $firstIndent."/**\n";
         if ($text) {
-            $comment .= $indent . ' * ' . $text . "\n";
-            $comment .= $indent . " *\n";
+            $comment .= $indent.' * '.$text."\n";
+            $comment .= $indent." *\n";
         }
 
         $comment = $this->addTagBlock($docblock, $wrapLength, $indent, $comment);
 
-        return str_replace("\n", $this->lineEnding, $comment . $indent . ' */');
+        return str_replace("\n", $this->lineEnding, $comment.$indent.' */');
     }
 
     private function removeTrailingSpaces(string $indent, string $text): string
@@ -124,7 +124,7 @@ 
 
     private function getSummaryAndDescriptionTextBlock(DocBlock $docblock, ?int $wrapLength): string
     {
-        $text = $docblock->getSummary() . ((string) $docblock->getDescription() ? "\n\n" . $docblock->getDescription()
+        $text = $docblock->getSummary().((string) $docblock->getDescription() ? "\n\n".$docblock->getDescription()
                 : '');
         if ($wrapLength !== null) {
             $text = wordwrap($text, $wrapLength);

vendor/phpdocumentor/reflection-docblock/src/DocBlock/Tags/Generic.php

Indentation +52 added lines, -52 removed lines

@@ -27,63 +27,63 @@
  */
 final class Generic extends BaseTag implements Factory\StaticMethod
 {
-    /**
-     * Parses a tag and populates the member variables.
-     *
-     * @param string      $name        Name of the tag.
-     * @param Description $description The contents of the given tag.
-     */
-    public function __construct(string $name, ?Description $description = null)
-    {
-        $this->validateTagName($name);
+	/**
+	 * Parses a tag and populates the member variables.
+	 *
+	 * @param string      $name        Name of the tag.
+	 * @param Description $description The contents of the given tag.
+	 */
+	public function __construct(string $name, ?Description $description = null)
+	{
+		$this->validateTagName($name);
 
-        $this->name        = $name;
-        $this->description = $description;
-    }
+		$this->name        = $name;
+		$this->description = $description;
+	}
 
-    /**
-     * Creates a new tag that represents any unknown tag type.
-     *
-     * @return static
-     */
-    public static function create(
-        string $body,
-        string $name = '',
-        ?DescriptionFactory $descriptionFactory = null,
-        ?TypeContext $context = null
-    ): self {
-        Assert::stringNotEmpty($name);
-        Assert::notNull($descriptionFactory);
+	/**
+	 * Creates a new tag that represents any unknown tag type.
+	 *
+	 * @return static
+	 */
+	public static function create(
+		string $body,
+		string $name = '',
+		?DescriptionFactory $descriptionFactory = null,
+		?TypeContext $context = null
+	): self {
+		Assert::stringNotEmpty($name);
+		Assert::notNull($descriptionFactory);
 
-        $description = $body !== '' ? $descriptionFactory->create($body, $context) : null;
+		$description = $body !== '' ? $descriptionFactory->create($body, $context) : null;
 
-        return new static($name, $description);
-    }
+		return new static($name, $description);
+	}
 
-    /**
-     * Returns the tag as a serialized string
-     */
-    public function __toString(): string
-    {
-        if ($this->description) {
-            $description = $this->description->render();
-        } else {
-            $description = '';
-        }
+	/**
+	 * Returns the tag as a serialized string
+	 */
+	public function __toString(): string
+	{
+		if ($this->description) {
+			$description = $this->description->render();
+		} else {
+			$description = '';
+		}
 
-        return $description;
-    }
+		return $description;
+	}
 
-    /**
-     * Validates if the tag name matches the expected format, otherwise throws an exception.
-     */
-    private function validateTagName(string $name): void
-    {
-        if (!preg_match('/^' . StandardTagFactory::REGEX_TAGNAME . '$/u', $name)) {
-            throw new InvalidArgumentException(
-                'The tag name "' . $name . '" is not wellformed. Tags may only consist of letters, underscores, '
-                . 'hyphens and backslashes.'
-            );
-        }
-    }
+	/**
+	 * Validates if the tag name matches the expected format, otherwise throws an exception.
+	 */
+	private function validateTagName(string $name): void
+	{
+		if (!preg_match('/^' . StandardTagFactory::REGEX_TAGNAME . '$/u', $name)) {
+			throw new InvalidArgumentException(
+				'The tag name "' . $name . '" is not wellformed. Tags may only consist of letters, underscores, '
+				. 'hyphens and backslashes.'
+			);
+		}
+	}
 }

Spacing +2 added lines, -2 removed lines

@@ -79,9 +79,9 @@
      */
     private function validateTagName(string $name): void
     {
-        if (!preg_match('/^' . StandardTagFactory::REGEX_TAGNAME . '$/u', $name)) {
+        if ( ! preg_match('/^'.StandardTagFactory::REGEX_TAGNAME.'$/u', $name)) {
             throw new InvalidArgumentException(
-                'The tag name "' . $name . '" is not wellformed. Tags may only consist of letters, underscores, '
+                'The tag name "'.$name.'" is not wellformed. Tags may only consist of letters, underscores, '
                 . 'hyphens and backslashes.'
             );
         }

vendor/phpdocumentor/reflection-docblock/src/DocBlock/Tags/Author.php

Indentation +73 added lines, -73 removed lines

@@ -26,77 +26,77 @@
  */
 final class Author extends BaseTag implements Factory\StaticMethod
 {
-    /** @var string register that this is the author tag. */
-    protected $name = 'author';
-
-    /** @var string The name of the author */
-    private $authorName;
-
-    /** @var string The email of the author */
-    private $authorEmail;
-
-    /**
-     * Initializes this tag with the author name and e-mail.
-     */
-    public function __construct(string $authorName, string $authorEmail)
-    {
-        if ($authorEmail && !filter_var($authorEmail, FILTER_VALIDATE_EMAIL)) {
-            throw new InvalidArgumentException('The author tag does not have a valid e-mail address');
-        }
-
-        $this->authorName  = $authorName;
-        $this->authorEmail = $authorEmail;
-    }
-
-    /**
-     * Gets the author's name.
-     *
-     * @return string The author's name.
-     */
-    public function getAuthorName(): string
-    {
-        return $this->authorName;
-    }
-
-    /**
-     * Returns the author's email.
-     *
-     * @return string The author's email.
-     */
-    public function getEmail(): string
-    {
-        return $this->authorEmail;
-    }
-
-    /**
-     * Returns this tag in string form.
-     */
-    public function __toString(): string
-    {
-        if ($this->authorEmail) {
-            $authorEmail = '<' . $this->authorEmail . '>';
-        } else {
-            $authorEmail = '';
-        }
-
-        $authorName = $this->authorName;
-
-        return $authorName . ($authorEmail !== '' ? ($authorName !== '' ? ' ' : '') . $authorEmail : '');
-    }
-
-    /**
-     * Attempts to create a new Author object based on the tag body.
-     */
-    public static function create(string $body): ?self
-    {
-        $splitTagContent = preg_match('/^([^\<]*)(?:\<([^\>]*)\>)?$/u', $body, $matches);
-        if (!$splitTagContent) {
-            return null;
-        }
-
-        $authorName = trim($matches[1]);
-        $email      = isset($matches[2]) ? trim($matches[2]) : '';
-
-        return new static($authorName, $email);
-    }
+	/** @var string register that this is the author tag. */
+	protected $name = 'author';
+
+	/** @var string The name of the author */
+	private $authorName;
+
+	/** @var string The email of the author */
+	private $authorEmail;
+
+	/**
+	 * Initializes this tag with the author name and e-mail.
+	 */
+	public function __construct(string $authorName, string $authorEmail)
+	{
+		if ($authorEmail && !filter_var($authorEmail, FILTER_VALIDATE_EMAIL)) {
+			throw new InvalidArgumentException('The author tag does not have a valid e-mail address');
+		}
+
+		$this->authorName  = $authorName;
+		$this->authorEmail = $authorEmail;
+	}
+
+	/**
+	 * Gets the author's name.
+	 *
+	 * @return string The author's name.
+	 */
+	public function getAuthorName(): string
+	{
+		return $this->authorName;
+	}
+
+	/**
+	 * Returns the author's email.
+	 *
+	 * @return string The author's email.
+	 */
+	public function getEmail(): string
+	{
+		return $this->authorEmail;
+	}
+
+	/**
+	 * Returns this tag in string form.
+	 */
+	public function __toString(): string
+	{
+		if ($this->authorEmail) {
+			$authorEmail = '<' . $this->authorEmail . '>';
+		} else {
+			$authorEmail = '';
+		}
+
+		$authorName = $this->authorName;
+
+		return $authorName . ($authorEmail !== '' ? ($authorName !== '' ? ' ' : '') . $authorEmail : '');
+	}
+
+	/**
+	 * Attempts to create a new Author object based on the tag body.
+	 */
+	public static function create(string $body): ?self
+	{
+		$splitTagContent = preg_match('/^([^\<]*)(?:\<([^\>]*)\>)?$/u', $body, $matches);
+		if (!$splitTagContent) {
+			return null;
+		}
+
+		$authorName = trim($matches[1]);
+		$email      = isset($matches[2]) ? trim($matches[2]) : '';
+
+		return new static($authorName, $email);
+	}
 }

Spacing +4 added lines, -4 removed lines

@@ -40,7 +40,7 @@ 
      */
     public function __construct(string $authorName, string $authorEmail)
     {
-        if ($authorEmail && !filter_var($authorEmail, FILTER_VALIDATE_EMAIL)) {
+        if ($authorEmail && ! filter_var($authorEmail, FILTER_VALIDATE_EMAIL)) {
             throw new InvalidArgumentException('The author tag does not have a valid e-mail address');
         }
 
@@ -74,14 +74,14 @@ 
     public function __toString(): string
     {
         if ($this->authorEmail) {
-            $authorEmail = '<' . $this->authorEmail . '>';
+            $authorEmail = '<'.$this->authorEmail.'>';
         } else {
             $authorEmail = '';
         }
 
         $authorName = $this->authorName;
 
-        return $authorName . ($authorEmail !== '' ? ($authorName !== '' ? ' ' : '') . $authorEmail : '');
+        return $authorName.($authorEmail !== '' ? ($authorName !== '' ? ' ' : '').$authorEmail : '');
     }
 
     /**
@@ -90,7 +90,7 @@ 
     public static function create(string $body): ?self
     {
         $splitTagContent = preg_match('/^([^\<]*)(?:\<([^\>]*)\>)?$/u', $body, $matches);
-        if (!$splitTagContent) {
+        if ( ! $splitTagContent) {
             return null;
         }
 

vendor/phpdocumentor/reflection-docblock/src/DocBlock/Tags/TagWithType.php

Indentation +34 added lines, -34 removed lines

@@ -22,45 +22,45 @@
 
 abstract class TagWithType extends BaseTag
 {
-    /** @var ?Type */
-    protected $type;
+	/** @var ?Type */
+	protected $type;
 
-    /**
-     * Returns the type section of the variable.
-     */
-    public function getType(): ?Type
-    {
-        return $this->type;
-    }
+	/**
+	 * Returns the type section of the variable.
+	 */
+	public function getType(): ?Type
+	{
+		return $this->type;
+	}
 
-    /**
-     * @return string[]
-     */
-    protected static function extractTypeFromBody(string $body): array
-    {
-        $type         = '';
-        $nestingLevel = 0;
-        for ($i = 0, $iMax = strlen($body); $i < $iMax; $i++) {
-            $character = $body[$i];
+	/**
+	 * @return string[]
+	 */
+	protected static function extractTypeFromBody(string $body): array
+	{
+		$type         = '';
+		$nestingLevel = 0;
+		for ($i = 0, $iMax = strlen($body); $i < $iMax; $i++) {
+			$character = $body[$i];
 
-            if ($nestingLevel === 0 && trim($character) === '') {
-                break;
-            }
+			if ($nestingLevel === 0 && trim($character) === '') {
+				break;
+			}
 
-            $type .= $character;
-            if (in_array($character, ['<', '(', '[', '{'])) {
-                $nestingLevel++;
-                continue;
-            }
+			$type .= $character;
+			if (in_array($character, ['<', '(', '[', '{'])) {
+				$nestingLevel++;
+				continue;
+			}
 
-            if (in_array($character, ['>', ')', ']', '}'])) {
-                $nestingLevel--;
-                continue;
-            }
-        }
+			if (in_array($character, ['>', ')', ']', '}'])) {
+				$nestingLevel--;
+				continue;
+			}
+		}
 
-        $description = trim(substr($body, strlen($type)));
+		$description = trim(substr($body, strlen($type)));
 
-        return [$type, $description];
-    }
+		return [$type, $description];
+	}
 }

vendor/phpdocumentor/reflection-docblock/src/DocBlock/Tags/Reference/Url.php

Indentation +11 added lines, -11 removed lines

@@ -20,17 +20,17 @@
  */
 final class Url implements Reference
 {
-    /** @var string */
-    private $uri;
+	/** @var string */
+	private $uri;
 
-    public function __construct(string $uri)
-    {
-        Assert::stringNotEmpty($uri);
-        $this->uri = $uri;
-    }
+	public function __construct(string $uri)
+	{
+		Assert::stringNotEmpty($uri);
+		$this->uri = $uri;
+	}
 
-    public function __toString(): string
-    {
-        return $this->uri;
-    }
+	public function __toString(): string
+	{
+		return $this->uri;
+	}
 }

vendor/phpdocumentor/reflection-docblock/src/DocBlock/Tags/Reference/Fqsen.php

Indentation +13 added lines, -13 removed lines

@@ -20,19 +20,19 @@
  */
 final class Fqsen implements Reference
 {
-    /** @var RealFqsen */
-    private $fqsen;
+	/** @var RealFqsen */
+	private $fqsen;
 
-    public function __construct(RealFqsen $fqsen)
-    {
-        $this->fqsen = $fqsen;
-    }
+	public function __construct(RealFqsen $fqsen)
+	{
+		$this->fqsen = $fqsen;
+	}
 
-    /**
-     * @return string string representation of the referenced fqsen
-     */
-    public function __toString(): string
-    {
-        return (string) $this->fqsen;
-    }
+	/**
+	 * @return string string representation of the referenced fqsen
+	 */
+	public function __toString(): string
+	{
+		return (string) $this->fqsen;
+	}
 }