Improve type casting

Author: nyamsprod

src/DomainTest.php

@@ -6,8 +6,6 @@
 
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\TestCase;
-use stdClass;
-use TypeError;
 
 final class DomainTest extends TestCase
 {
@@ -290,12 +288,6 @@ public static function withLabelWorksProvider(): iterable
         ];
     }
 
-    public function testWithLabelFailsWithTypeError(): void
-    {
-        $this->expectException(TypeError::class);
-        Domain::fromIDNA2008('example.com')->withLabel(1, new stdClass()); /* @phpstan-ignore-line */
-    }
-
     public function testWithLabelFailsWithInvalidKey(): void
     {
         $this->expectException(SyntaxError::class);

src/ResolvedDomainTest.php

@@ -6,9 +6,6 @@
 
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\TestCase;
-use TypeError;
-
-use function date_create;
 
 final class ResolvedDomainTest extends TestCase
 {
@@ -301,13 +298,6 @@ public function testItCanThrowsDuringSubDomainChangesIfTheSubDomainIsTheEmptyStr
         ResolvedDomain::fromICANN('www.example.com', 1)->withSubDomain('');
     }
 
-    public function testItCanThrowsDuringSubDomainChangesIfTheSubDomainIsNotStringable(): void
-    {
-        $this->expectException(TypeError::class);
-
-        ResolvedDomain::fromICANN('www.example.com', 1)->withSubDomain(date_create()); /* @phpstan-ignore-line */
-    }
-
     #[DataProvider('withPublicSuffixWorksProvider')]
     public function testItCanChangeItsSuffix(
         ResolvedDomain $domain,

src/Rules.php

@@ -152,10 +152,7 @@ public static function __set_state(array $properties): self
         return new self($properties['rules']);
     }
 
-    /**
-     * @param int|DomainNameProvider|Host|string|Stringable|null $host a type that supports instantiating a Domain from.
-     */
-    public function resolve($host): ResolvedDomainName
+    public function resolve(DomainNameProvider|Host|Stringable|string|int|null $host): ResolvedDomainName
     {
         try {
             return $this->getCookieDomain($host);
@@ -166,10 +163,7 @@ public function resolve($host): ResolvedDomainName
         }
     }
 
-    /**
-     * @param int|DomainNameProvider|Host|string|Stringable|null $host the domain value
-     */
-    public function getCookieDomain($host): ResolvedDomainName
+    public function getCookieDomain(DomainNameProvider|Host|Stringable|string|int|null $host): ResolvedDomainName
     {
         $domain = $this->validateDomain($host);
         [$suffixLength, $section] = $this->resolveSuffix($domain->withoutRootLabel(), self::UNKNOWN_DOMAINS);
@@ -181,10 +175,7 @@ public function getCookieDomain($host): ResolvedDomainName
         };
     }
 
-    /**
-     * @param int|DomainNameProvider|Host|string|Stringable|null $host a type that supports instantiating a Domain from.
-     */
-    public function getICANNDomain($host): ResolvedDomainName
+    public function getICANNDomain(DomainNameProvider|Host|Stringable|string|int|null $host): ResolvedDomainName
     {
         $domain = $this->validateDomain($host);
         [$suffixLength, $section] = $this->resolveSuffix($domain, self::ICANN_DOMAINS);
@@ -195,10 +186,7 @@ public function getICANNDomain($host): ResolvedDomainName
         return ResolvedDomain::fromICANN($domain, $suffixLength);
     }
 
-    /**
-     * @param int|DomainNameProvider|Host|string|Stringable|null $host a type that supports instantiating a Domain from.
-     */
-    public function getPrivateDomain($host): ResolvedDomainName
+    public function getPrivateDomain(DomainNameProvider|Host|Stringable|string|int|null $host): ResolvedDomainName
     {
         $domain = $this->validateDomain($host);
         [$suffixLength, $section] = $this->resolveSuffix($domain, self::PRIVATE_DOMAINS);
@@ -215,7 +203,7 @@ public function getPrivateDomain($host): ResolvedDomainName
      * @throws SyntaxError If the domain is invalid
      * @throws UnableToResolveDomain If the domain can not be resolved
      */
-    private function validateDomain(int|DomainNameProvider|Host|string|Stringable|null $domain): DomainName
+    private function validateDomain(DomainNameProvider|Host|Stringable|string|int|null $domain): DomainName
     {
         if ($domain instanceof DomainNameProvider) {
             $domain = $domain->domain();

src/RulesTest.php

@@ -6,7 +6,6 @@
 
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\TestCase;
-use TypeError;
 
 use function array_fill;
 use function dirname;
@@ -67,13 +66,6 @@ public function testNullWillReturnNullDomain(): void
         self::assertFalse($domain->suffix()->isKnown());
     }
 
-    public function testThrowsTypeErrorOnWrongInput(): void
-    {
-        $this->expectException(TypeError::class);
-
-        self::$rules->resolve(date_create());  /* @phpstan-ignore-line */
-    }
-
     public function testIsSuffixValidFalse(): void
     {
         $domain = self::$rules->resolve('www.example.faketld');

src/TopLevelDomains.php

@@ -164,10 +164,7 @@ public function getIterator(): Iterator
         yield from array_keys($this->records);
     }
 
-    /**
-     * @param int|DomainNameProvider|Host|string|Stringable|null $host a type that supports instantiating a Domain from.
-     */
-    public function resolve($host): ResolvedDomainName
+    public function resolve(DomainNameProvider|Host|Stringable|string|int|null $host): ResolvedDomainName
     {
         try {
             $domain = $this->validateDomain($host);
@@ -188,7 +185,7 @@ public function resolve($host): ResolvedDomainName
      * @throws SyntaxError If the domain is invalid
      * @throws UnableToResolveDomain If the domain can not be resolved
      */
-    private function validateDomain(int|DomainNameProvider|Host|string|Stringable|null $domain): DomainName
+    private function validateDomain(DomainNameProvider|Host|Stringable|string|int|null $domain): DomainName
     {
         if ($domain instanceof DomainNameProvider) {
             $domain = $domain->domain();