improved phpDoc and typehints

dg · dg · commit 0e53ed2440ab · 2022-03-09T21:53:15.000+01:00
diff --git a/src/PhpGenerator/Attribute.php b/src/PhpGenerator/Attribute.php
@@ -20,9 +20,12 @@ final class Attribute
 	use Nette\SmartObject;
 
 	private string $name;
+
+	/** @var mixed[] */
 	private array $args;
 
 
+	/** @param  mixed[]  $args */
 	public function __construct(string $name, array $args)
 	{
 		if (!Helpers::isNamespaceIdentifier($name)) {
@@ -40,6 +43,7 @@ public function getName(): string
 	}
 
 
+	/** @return mixed[] */
 	public function getArguments(): array
 	{
 		return $this->args;
diff --git a/src/PhpGenerator/ClassType.php b/src/PhpGenerator/ClassType.php
@@ -55,16 +55,16 @@ final class ClassType
 	/** @var TraitUse[] */
 	private array $traits = [];
 
-	/** @var Constant[] name => Constant */
+	/** @var array<string, Constant> */
 	private array $consts = [];
 
-	/** @var Property[] name => Property */
+	/** @var array<string, Property> */
 	private array $properties = [];
 
-	/** @var Method[] name => Method */
+	/** @var array<string, Method> */
 	private array $methods = [];
 
-	/** @var EnumCase[] name => EnumCase */
+	/** @var array<string, EnumCase> */
 	private array $cases = [];
 
 
@@ -401,7 +401,7 @@ public function getConstants(): array
 	}
 
 
-	public function addConstant(string $name, $value): Constant
+	public function addConstant(string $name, mixed $value): Constant
 	{
 		if (isset($this->consts[$name])) {
 			throw new Nette\InvalidStateException("Cannot add constant '$name', because it already exists.");
@@ -495,7 +495,7 @@ public function getProperty(string $name): Property
 	/**
 	 * @param  string  $name  without $
 	 */
-	public function addProperty(string $name, $value = null): Property
+	public function addProperty(string $name, mixed $value = null): Property
 	{
 		if (isset($this->properties[$name])) {
 			throw new Nette\InvalidStateException("Cannot add property '$name', because it already exists.");
@@ -603,6 +603,7 @@ public function validate(): void
 	}
 
 
+	/** @param  string[]  $names */
 	private function validateNames(array $names): void
 	{
 		foreach ($names as $name) {
diff --git a/src/PhpGenerator/Closure.php b/src/PhpGenerator/Closure.php
@@ -50,6 +50,7 @@ public function setUses(array $uses): static
 	}
 
 
+	/** @return Parameter[] */
 	public function getUses(): array
 	{
 		return $this->uses;
diff --git a/src/PhpGenerator/Constant.php b/src/PhpGenerator/Constant.php
@@ -27,7 +27,7 @@ final class Constant
 	private bool $final = false;
 
 
-	public function setValue($val): static
+	public function setValue(mixed $val): static
 	{
 		$this->value = $val;
 		return $this;
diff --git a/src/PhpGenerator/Dumper.php b/src/PhpGenerator/Dumper.php
@@ -27,13 +27,14 @@ final class Dumper
 	/**
 	 * Returns a PHP representation of a variable.
 	 */
-	public function dump($var, int $column = 0): string
+	public function dump(mixed $var, int $column = 0): string
 	{
 		return $this->dumpVar($var, [], 0, $column);
 	}
 
 
-	private function dumpVar(&$var, array $parents = [], int $level = 0, int $column = 0): string
+	/** @param  array<mixed[]|object>  $parents */
+	private function dumpVar(mixed &$var, array $parents = [], int $level = 0, int $column = 0): string
 	{
 		if ($var === null) {
 			return 'null';
@@ -95,6 +96,10 @@ private static function utf8Ord(string $c): int
 	}
 
 
+	/**
+	 * @param  mixed[]  $var
+	 * @param  array<mixed[]|object>  $parents
+	 */
 	private function dumpArray(array &$var, array $parents, int $level, int $column): string
 	{
 		if (empty($var)) {
@@ -130,7 +135,8 @@ private function dumpArray(array &$var, array $parents, int $level, int $column)
 	}
 
 
-	private function dumpObject($var, array $parents, int $level): string
+	/** @param  array<mixed[]|object>  $parents */
+	private function dumpObject(object $var, array $parents, int $level): string
 	{
 		if ($var instanceof \Serializable) {
 			return 'unserialize(' . $this->dumpString(serialize($var)) . ')';
@@ -200,7 +206,7 @@ private function dumpLiteral(Literal $var, int $level): string
 	/**
 	 * Generates PHP statement. Supports placeholders: ?  \?  $?  ->?  ::?  ...?  ...?:  ?*
 	 */
-	public function format(string $statement, ...$args): string
+	public function format(string $statement, mixed ...$args): string
 	{
 		$tokens = preg_split('#(\.\.\.\?:?|\$\?|->\?|::\?|\\\\\?|\?\*|\?(?!\w))#', $statement, -1, PREG_SPLIT_DELIM_CAPTURE);
 		$res = '';
@@ -239,6 +245,7 @@ public function format(string $statement, ...$args): string
 	}
 
 
+	/** @param  mixed[]  $var */
 	private function dumpArguments(array &$var, int $column, bool $named): string
 	{
 		$outInline = $outWrapped = '';
@@ -257,6 +264,7 @@ private function dumpArguments(array &$var, int $column, bool $named): string
 
 
 	/**
+	 * @param  mixed[]  $props
 	 * @internal
 	 */
 	public static function createObject(string $class, array $props): object
diff --git a/src/PhpGenerator/EnumCase.php b/src/PhpGenerator/EnumCase.php
@@ -32,7 +32,7 @@ public function setValue(string|int|null $val): static
 	}
 
 
-	public function getValue()
+	public function getValue(): string|int|null
 	{
 		return $this->value;
 	}
diff --git a/src/PhpGenerator/Extractor.php b/src/PhpGenerator/Extractor.php
@@ -25,6 +25,8 @@ final class Extractor
 	use Nette\SmartObject;
 
 	private string $code;
+
+	/** @var Node[] */
 	private array $statements;
 	private PhpParser\PrettyPrinterAbstract $printer;
 
@@ -58,6 +60,7 @@ private function parseCode(string $code): void
 	}
 
 
+	/** @return array<string, string> */
 	public function extractMethodBodies(string $className): array
 	{
 		$nodeFinder = new NodeFinder;
@@ -91,20 +94,24 @@ public function extractFunctionBody(string $name): ?string
 	}
 
 
-	/** @param  Node[]  $statements */
-	private function getReformattedContents(array $statements, int $level): string
+	/** @param  Node[]  $nodes */
+	private function getReformattedContents(array $nodes, int $level): string
 	{
-		$body = $this->getNodeContents(...$statements);
-		$body = $this->performReplacements($body, $this->prepareReplacements($statements));
+		$body = $this->getNodeContents(...$nodes);
+		$body = $this->performReplacements($body, $this->prepareReplacements($nodes));
 		return Helpers::unindent($body, $level);
 	}
 
 
-	private function prepareReplacements(array $statements): array
+	/**
+	 * @param  Node[]  $nodes
+	 * @return array<array{int, int, string}>
+	 */
+	private function prepareReplacements(array $nodes): array
 	{
-		$start = $statements[0]->getStartFilePos();
+		$start = $nodes[0]->getStartFilePos();
 		$replacements = [];
-		(new NodeFinder)->find($statements, function (Node $node) use (&$replacements, $start) {
+		(new NodeFinder)->find($nodes, function (Node $node) use (&$replacements, $start) {
 			if ($node instanceof Node\Name\FullyQualified) {
 				if ($node->getAttribute('originalName') instanceof Node\Name) {
 					$of = match (true) {
@@ -149,6 +156,7 @@ private function prepareReplacements(array $statements): array
 	}
 
 
+	/** @param  array<array{int, int, string}>  $replacements */
 	private function performReplacements(string $s, array $replacements): string
 	{
 		usort($replacements, fn($a, $b) => $b[0] <=> $a[0]);
diff --git a/src/PhpGenerator/Factory.php b/src/PhpGenerator/Factory.php
@@ -20,10 +20,14 @@ final class Factory
 {
 	use Nette\SmartObject;
 
+	/** @var string[][]  */
 	private array $bodyCache = [];
+
+	/** @var Extractor[]  */
 	private array $extractorCache = [];
 
 
+	/** @param  \ReflectionClass<object>  $from */
 	public function fromClassReflection(
 		\ReflectionClass $from,
 		bool $withBodies = false,
diff --git a/src/PhpGenerator/Helpers.php b/src/PhpGenerator/Helpers.php
@@ -49,15 +49,15 @@ final class Helpers
 
 
 	/** @deprecated  use (new Nette\PhpGenerator\Dumper)->dump() */
-	public static function dump($var): string
+	public static function dump(mixed $var): string
 	{
 		trigger_error(__METHOD__ . '() is deprecated, use (new Nette\PhpGenerator\Dumper)->dump().', E_USER_DEPRECATED);
 		return (new Dumper)->dump($var);
 	}
 
 
 	/** @deprecated  use (new Nette\PhpGenerator\Dumper)->format() */
-	public static function format(string $statement, ...$args): string
+	public static function format(string $statement, mixed ...$args): string
 	{
 		trigger_error(__METHOD__ . '() is deprecated, use (new Nette\PhpGenerator\Dumper)->format().', E_USER_DEPRECATED);
 		return (new Dumper)->format($statement, ...$args);
@@ -119,13 +119,13 @@ public static function unindent(string $s, int $level = 1): string
 	}
 
 
-	public static function isIdentifier($value): bool
+	public static function isIdentifier(mixed $value): bool
 	{
 		return is_string($value) && preg_match('#^' . self::PHP_IDENT . '$#D', $value);
 	}
 
 
-	public static function isNamespaceIdentifier($value, bool $allowLeadingSlash = false): bool
+	public static function isNamespaceIdentifier(mixed $value, bool $allowLeadingSlash = false): bool
 	{
 		$re = '#^' . ($allowLeadingSlash ? '\\\\?' : '') . self::PHP_IDENT . '(\\\\' . self::PHP_IDENT . ')*$#D';
 		return is_string($value) && preg_match($re, $value);
@@ -152,7 +152,10 @@ public static function tabsToSpaces(string $s, int $count = 4): string
 	}
 
 
-	/** @internal */
+	/**
+	 * @param  mixed[]  $props
+	 * @internal
+	 */
 	public static function createObject(string $class, array $props): object
 	{
 		return Dumper::createObject($class, $props);
diff --git a/src/PhpGenerator/Literal.php b/src/PhpGenerator/Literal.php
@@ -17,6 +17,7 @@ class Literal
 {
 	public function __construct(
 		private string $value,
+		/** @var ?mixed[] */
 		private ?array $args = null,
 	) {
 	}
diff --git a/src/PhpGenerator/Method.php b/src/PhpGenerator/Method.php
@@ -85,7 +85,7 @@ public function isAbstract(): bool
 	/**
 	 * @param  string  $name without $
 	 */
-	public function addPromotedParameter(string $name, $defaultValue = null): PromotedParameter
+	public function addPromotedParameter(string $name, mixed $defaultValue = null): PromotedParameter
 	{
 		$param = new PromotedParameter($name);
 		if (func_num_args() > 1) {
diff --git a/src/PhpGenerator/Printer.php b/src/PhpGenerator/Printer.php
@@ -349,6 +349,7 @@ private function printReturnType(Closure|GlobalFunction|Method $function): strin
 	}
 
 
+	/** @param  Attribute[]  $attrs */
 	private function printAttributes(array $attrs, bool $inline = false): string
 	{
 		if (!$attrs) {
@@ -383,7 +384,7 @@ protected function indent(string $s): string
 	}
 
 
-	protected function dump($var, int $column = 0): string
+	protected function dump(mixed $var, int $column = 0): string
 	{
 		$this->dumper->indentation = $this->indentation;
 		$this->dumper->wrapLength = $this->wrapLength;
@@ -393,6 +394,7 @@ protected function dump($var, int $column = 0): string
 	}
 
 
+	/** @param  string[]  $props */
 	private function joinProperties(array $props): string
 	{
 		return $this->linesBetweenProperties
diff --git a/src/PhpGenerator/TraitUse.php b/src/PhpGenerator/TraitUse.php
@@ -23,8 +23,8 @@ final class TraitUse
 	use Traits\NameAware;
 	use Traits\CommentAware;
 
+	/** @var string[] */
 	private array $resolutions = [];
-
 	private ?ClassType $parent;
 
 
@@ -46,12 +46,14 @@ public function addResolution(string $resolution): static
 	}
 
 
+	/** @return string[] */
 	public function getResolutions(): array
 	{
 		return $this->resolutions;
 	}
 
 
+	/** @param  mixed[]  $args */
 	public function __call(string $nm, array $args): mixed
 	{
 		if (!$this->parent) {
diff --git a/src/PhpGenerator/Traits/AttributeAware.php b/src/PhpGenerator/Traits/AttributeAware.php
@@ -21,6 +21,7 @@ trait AttributeAware
 	private array $attributes = [];
 
 
+	/** @param  mixed[]  $args */
 	public function addAttribute(string $name, array $args = []): static
 	{
 		$this->attributes[] = new Attribute($name, $args);
diff --git a/src/PhpGenerator/Traits/FunctionLike.php b/src/PhpGenerator/Traits/FunctionLike.php
@@ -30,6 +30,7 @@ trait FunctionLike
 	private bool $returnNullable = false;
 
 
+	/** @param  ?mixed[]  $args */
 	public function setBody(string $code, ?array $args = null): static
 	{
 		$this->body = $args === null
@@ -45,6 +46,7 @@ public function getBody(): string
 	}
 
 
+	/** @param  ?mixed[]  $args */
 	public function addBody(string $code, ?array $args = null): static
 	{
 		$this->body .= ($args === null ? $code : (new Dumper)->format($code, ...$args)) . "\n";
@@ -77,7 +79,7 @@ public function getParameters(): array
 	/**
 	 * @param  string  $name without $
 	 */
-	public function addParameter(string $name, $defaultValue = null): Parameter
+	public function addParameter(string $name, mixed $defaultValue = null): Parameter
 	{
 		$param = new Parameter($name);
 		if (func_num_args() > 1) {
diff --git a/src/PhpGenerator/Type.php b/src/PhpGenerator/Type.php
@@ -53,7 +53,7 @@ public static function intersection(string ...$types): string
 
 
 	/** @deprecated  use get_debug_type() */
-	public static function getType($value): ?string
+	public static function getType(mixed $value): ?string
 	{
 		trigger_error(__METHOD__ . '() is deprecated, use PHP function get_debug_type()', E_USER_DEPRECATED);
 		return is_resource($value) ? null : get_debug_type($value);

Original file line number	Diff line number	Diff line change
`@@ -20,9 +20,12 @@ final class Attribute`
`20`	`20`	`use Nette\SmartObject;`
`21`	`21`
`22`	`22`	`private string $name;`
	`23`	`+`
	`24`	`+ /** @var mixed[] */`
`23`	`25`	`private array $args;`
`24`	`26`
`25`	`27`
	`28`	`+ /** @param mixed[] $args */`
`26`	`29`	`public function __construct(string $name, array $args)`
`27`	`30`	`{`
`28`	`31`	`if (!Helpers::isNamespaceIdentifier($name)) {`
`@@ -40,6 +43,7 @@ public function getName(): string`
`40`	`43`	`}`
`41`	`44`
`42`	`45`
	`46`	`+ /** @return mixed[] */`
`43`	`47`	`public function getArguments(): array`
`44`	`48`	`{`
`45`	`49`	`return $this->args;`
Original file line number	Diff line number	Diff line change
`@@ -50,6 +50,7 @@ public function setUses(array $uses): static`
`50`	`50`	`}`
`51`	`51`
`52`	`52`
	`53`	`+ /** @return Parameter[] */`
`53`	`54`	`public function getUses(): array`
`54`	`55`	`{`
`55`	`56`	`return $this->uses;`
Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@ final class Constant`
`27`	`27`	`private bool $final = false;`
`28`	`28`
`29`	`29`
`30`		`- public function setValue($val): static`
	`30`	`+ public function setValue(mixed $val): static`
`31`	`31`	`{`
`32`	`32`	`$this->value = $val;`
`33`	`33`	`return $this;`
Original file line number	Diff line number	Diff line change
`@@ -27,13 +27,14 @@ final class Dumper`
`27`	`27`	`/**`
`28`	`28`	`* Returns a PHP representation of a variable.`
`29`	`29`	`*/`
`30`		`- public function dump($var, int $column = 0): string`
	`30`	`+ public function dump(mixed $var, int $column = 0): string`
`31`	`31`	`{`
`32`	`32`	`return $this->dumpVar($var, [], 0, $column);`
`33`	`33`	`}`
`34`	`34`
`35`	`35`
`36`		`- private function dumpVar(&$var, array $parents = [], int $level = 0, int $column = 0): string`
	`36`	`+ /** @param array<mixed[]\|object> $parents */`
	`37`	`+ private function dumpVar(mixed &$var, array $parents = [], int $level = 0, int $column = 0): string`
`37`	`38`	`{`
`38`	`39`	`if ($var === null) {`
`39`	`40`	`return 'null';`
`@@ -95,6 +96,10 @@ private static function utf8Ord(string $c): int`
`95`	`96`	`}`
`96`	`97`
`97`	`98`
	`99`	`+ /**`
	`100`	`+ * @param mixed[] $var`
	`101`	`+ * @param array<mixed[]\|object> $parents`
	`102`	`+ */`
`98`	`103`	`private function dumpArray(array &$var, array $parents, int $level, int $column): string`
`99`	`104`	`{`
`100`	`105`	`if (empty($var)) {`
`@@ -130,7 +135,8 @@ private function dumpArray(array &$var, array $parents, int $level, int $column)`
`130`	`135`	`}`
`131`	`136`
`132`	`137`
`133`		`- private function dumpObject($var, array $parents, int $level): string`
	`138`	`+ /** @param array<mixed[]\|object> $parents */`
	`139`	`+ private function dumpObject(object $var, array $parents, int $level): string`
`134`	`140`	`{`
`135`	`141`	`if ($var instanceof \Serializable) {`
`136`	`142`	`return 'unserialize(' . $this->dumpString(serialize($var)) . ')';`
`@@ -200,7 +206,7 @@ private function dumpLiteral(Literal $var, int $level): string`
`200`	`206`	`/**`
`201`	`207`	`* Generates PHP statement. Supports placeholders: ? \? $? ->? ::? ...? ...?: ?*`
`202`	`208`	`*/`
`203`		`- public function format(string $statement, ...$args): string`
	`209`	`+ public function format(string $statement, mixed ...$args): string`
`204`	`210`	`{`
`205`	`211`	`$tokens = preg_split('#(\.\.\.\?:?\|\$\?\|->\?\|::\?\|\\\\\?\|\?\*\|\?(?!\w))#', $statement, -1, PREG_SPLIT_DELIM_CAPTURE);`
`206`	`212`	`$res = '';`
`@@ -239,6 +245,7 @@ public function format(string $statement, ...$args): string`
`239`	`245`	`}`
`240`	`246`
`241`	`247`
	`248`	`+ /** @param mixed[] $var */`
`242`	`249`	`private function dumpArguments(array &$var, int $column, bool $named): string`
`243`	`250`	`{`
`244`	`251`	`$outInline = $outWrapped = '';`
`@@ -257,6 +264,7 @@ private function dumpArguments(array &$var, int $column, bool $named): string`
`257`	`264`
`258`	`265`
`259`	`266`	`/**`
	`267`	`+ * @param mixed[] $props`
`260`	`268`	`* @internal`
`261`	`269`	`*/`
`262`	`270`	`public static function createObject(string $class, array $props): object`
Original file line number	Diff line number	Diff line change
`@@ -32,7 +32,7 @@ public function setValue(string\|int\|null $val): static`
`32`	`32`	`}`
`33`	`33`
`34`	`34`
`35`		`- public function getValue()`
	`35`	`+ public function getValue(): string\|int\|null`
`36`	`36`	`{`
`37`	`37`	`return $this->value;`
`38`	`38`	`}`
Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,8 @@ final class Extractor`
`25`	`25`	`use Nette\SmartObject;`
`26`	`26`
`27`	`27`	`private string $code;`
	`28`	`+`
	`29`	`+ /** @var Node[] */`
`28`	`30`	`private array $statements;`
`29`	`31`	`private PhpParser\PrettyPrinterAbstract $printer;`
`30`	`32`
`@@ -58,6 +60,7 @@ private function parseCode(string $code): void`
`58`	`60`	`}`
`59`	`61`
`60`	`62`
	`63`	`+ /** @return array<string, string> */`
`61`	`64`	`public function extractMethodBodies(string $className): array`
`62`	`65`	`{`
`63`	`66`	`$nodeFinder = new NodeFinder;`
`@@ -91,20 +94,24 @@ public function extractFunctionBody(string $name): ?string`
`91`	`94`	`}`
`92`	`95`
`93`	`96`
`94`		`- /** @param Node[] $statements */`
`95`		`- private function getReformattedContents(array $statements, int $level): string`
	`97`	`+ /** @param Node[] $nodes */`
	`98`	`+ private function getReformattedContents(array $nodes, int $level): string`
`96`	`99`	`{`
`97`		`- $body = $this->getNodeContents(...$statements);`
`98`		`- $body = $this->performReplacements($body, $this->prepareReplacements($statements));`
	`100`	`+ $body = $this->getNodeContents(...$nodes);`
	`101`	`+ $body = $this->performReplacements($body, $this->prepareReplacements($nodes));`
`99`	`102`	`return Helpers::unindent($body, $level);`
`100`	`103`	`}`
`101`	`104`
`102`	`105`
`103`		`- private function prepareReplacements(array $statements): array`
	`106`	`+ /**`
	`107`	`+ * @param Node[] $nodes`
	`108`	`+ * @return array<array{int, int, string}>`
	`109`	`+ */`
	`110`	`+ private function prepareReplacements(array $nodes): array`
`104`	`111`	`{`
`105`		`- $start = $statements[0]->getStartFilePos();`
	`112`	`+ $start = $nodes[0]->getStartFilePos();`
`106`	`113`	`$replacements = [];`
`107`		`- (new NodeFinder)->find($statements, function (Node $node) use (&$replacements, $start) {`
	`114`	`+ (new NodeFinder)->find($nodes, function (Node $node) use (&$replacements, $start) {`
`108`	`115`	`if ($node instanceof Node\Name\FullyQualified) {`
`109`	`116`	`if ($node->getAttribute('originalName') instanceof Node\Name) {`
`110`	`117`	`$of = match (true) {`
`@@ -149,6 +156,7 @@ private function prepareReplacements(array $statements): array`
`149`	`156`	`}`
`150`	`157`
`151`	`158`
	`159`	`+ /** @param array<array{int, int, string}> $replacements */`
`152`	`160`	`private function performReplacements(string $s, array $replacements): string`
`153`	`161`	`{`
`154`	`162`	`usort($replacements, fn($a, $b) => $b[0] <=> $a[0]);`
Original file line number	Diff line number	Diff line change
`@@ -49,15 +49,15 @@ final class Helpers`
`49`	`49`
`50`	`50`
`51`	`51`	`/** @deprecated use (new Nette\PhpGenerator\Dumper)->dump() */`
`52`		`- public static function dump($var): string`
	`52`	`+ public static function dump(mixed $var): string`
`53`	`53`	`{`
`54`	`54`	`trigger_error(__METHOD__ . '() is deprecated, use (new Nette\PhpGenerator\Dumper)->dump().', E_USER_DEPRECATED);`
`55`	`55`	`return (new Dumper)->dump($var);`
`56`	`56`	`}`
`57`	`57`
`58`	`58`
`59`	`59`	`/** @deprecated use (new Nette\PhpGenerator\Dumper)->format() */`
`60`		`- public static function format(string $statement, ...$args): string`
	`60`	`+ public static function format(string $statement, mixed ...$args): string`
`61`	`61`	`{`
`62`	`62`	`trigger_error(__METHOD__ . '() is deprecated, use (new Nette\PhpGenerator\Dumper)->format().', E_USER_DEPRECATED);`
`63`	`63`	`return (new Dumper)->format($statement, ...$args);`
`@@ -119,13 +119,13 @@ public static function unindent(string $s, int $level = 1): string`
`119`	`119`	`}`
`120`	`120`
`121`	`121`
`122`		`- public static function isIdentifier($value): bool`
	`122`	`+ public static function isIdentifier(mixed $value): bool`
`123`	`123`	`{`
`124`	`124`	`return is_string($value) && preg_match('#^' . self::PHP_IDENT . '$#D', $value);`
`125`	`125`	`}`
`126`	`126`
`127`	`127`
`128`		`- public static function isNamespaceIdentifier($value, bool $allowLeadingSlash = false): bool`
	`128`	`+ public static function isNamespaceIdentifier(mixed $value, bool $allowLeadingSlash = false): bool`
`129`	`129`	`{`
`130`	`130`	`$re = '#^' . ($allowLeadingSlash ? '\\\\?' : '') . self::PHP_IDENT . '(\\\\' . self::PHP_IDENT . ')*$#D';`
`131`	`131`	`return is_string($value) && preg_match($re, $value);`
`@@ -152,7 +152,10 @@ public static function tabsToSpaces(string $s, int $count = 4): string`
`152`	`152`	`}`
`153`	`153`
`154`	`154`
`155`		`- /** @internal */`
	`155`	`+ /**`
	`156`	`+ * @param mixed[] $props`
	`157`	`+ * @internal`
	`158`	`+ */`
`156`	`159`	`public static function createObject(string $class, array $props): object`
`157`	`160`	`{`
`158`	`161`	`return Dumper::createObject($class, $props);`
Original file line number	Diff line number	Diff line change
`@@ -17,6 +17,7 @@ class Literal`
`17`	`17`	`{`
`18`	`18`	`public function __construct(`
`19`	`19`	`private string $value,`
	`20`	`+ /** @var ?mixed[] */`
`20`	`21`	`private ?array $args = null,`
`21`	`22`	`) {`
`22`	`23`	`}`