Narrow DOMDocument::createElement() return type and throw type for valid constant names

[janedbal]

Fixes phpstan/phpstan#13792

[phpstan-bot]

You've opened the pull request against the latest branch 2.2.x. PHPStan 2.2 is not going to be released for months. If your code is relevant on 2.1.x and you want it to be released sooner, please rebase your pull request and change its target to 2.1.x.

[staabm]

I am not sure whether this kind of optional runtime dependency is a good thing to have.
would it make sense to hard-code a list of valid elements instead?

[janedbal]

This logic was basically copied from SimpleXMLElementXpathMethodReturnTypeExtension, so I just followed that one.

[phpstan-bot]

This pull request has been marked as ready for review.

[VincentLanglet]

I'm sorry I wasn't clear.

I wanted to split the data file, but it can still be in this TestCase by writing a new test here

public function testBug13792(): void
	{
		$this->analyse([__DIR__ . '/data/bug-13792.php'], [
			[
				'Method Bug13792\Foo::dynamicName() throws checked exception DOMException but it\'s missing from the PHPDoc @throws tag.',
				20,
			],
			[
				'Method Bug13792\Foo::invalidConstantName() throws checked exception DOMException but it\'s missing from the PHPDoc @throws tag.',
				25,
			],
			[
				'Method Bug13792\Foo::unions() throws checked exception DOMException but it\'s missing from the PHPDoc @throws tag.',
				35,
			],
		]);
	}