ResolvedDomain should handle domain with root label

Author: nyamsprod

README.md

@@ -228,7 +228,7 @@ supported type to avoid unexpected results. By default, if the input is not a
 `Pdp\Suffix` instance, the resulting public suffix will be labelled as
 being unknown. For more information go to the [Public Suffix section](#public-suffix)
 
-> [!TIP]
+> [!NOTE]
 > Since version `6.4` Domain resolution is also adapted so that absolute domain
 can effectively be resolved. Prior to version `6.4` an exception was thrown.
 

src/DomainName.php

@@ -14,10 +14,6 @@
  * @see https://tools.ietf.org/html/rfc5890
  *
  * @extends IteratorAggregate<string>
- *
- * @method bool isAbsolute() tells whether the domain is absolute or not.
- * @method self withRootLabel() returns an instance with its Root label. (see https://tools.ietf.org/html/rfc3986#section-3.2.2)
- * @method self withoutRootLabel() returns an instance without its Root label. (see https://tools.ietf.org/html/rfc3986#section-3.2.2)
  */
 interface DomainName extends Host, IteratorAggregate
 {

src/Host.php

@@ -11,6 +11,10 @@
  * @see https://tools.ietf.org/html/rfc1034#section-3.5
  * @see https://tools.ietf.org/html/rfc1123#section-2.1
  * @see https://tools.ietf.org/html/rfc5890
+ *
+ * @method bool isAbsolute() tells whether the domain is absolute or not.
+ * @method static withRootLabel() returns an instance with its Root label. (see https://tools.ietf.org/html/rfc3986#section-3.2.2)
+ * @method static withoutRootLabel() returns an instance without its Root label. (see https://tools.ietf.org/html/rfc3986#section-3.2.2)
  */
 interface Host extends Countable, JsonSerializable
 {

src/ResolvedDomain.php

@@ -190,6 +190,21 @@ public function toUnicode(): self
         return new self($this->domain->toUnicode(), $this->suffix->toUnicode());
     }
 
+    public function isAbsolute(): bool
+    {
+        return $this->domain->isAbsolute();
+    }
+
+    public function withoutRootLabel(): self
+    {
+        return new self($this->domain->withoutRootLabel(), $this->suffix);
+    }
+
+    public function withRootLabel(): self
+    {
+        return new self($this->domain->withRootLabel(), $this->suffix);
+    }
+
     /**
      * @throws CannotProcessHost
      */

src/ResolvedDomainTest.php

@@ -628,4 +628,19 @@ public function testSuffixCanHandleIpLikeValue(): void
             ResolvedDomain::fromICANN('cloudflare-dns.com.1.1.1.1', 4)->toString()
         );
     }
+
+    public function testWithAndWithoutRootLabelResult(): void
+    {
+        $withoutRootLabelResult = ResolvedDomain::fromICANN('cloudflare-dns.com', 1);
+        $withRootLabelResult = $withoutRootLabelResult->withRootLabel();
+
+        self::assertTrue($withRootLabelResult->isAbsolute());
+        self::assertFalse($withoutRootLabelResult->isAbsolute());
+        self::assertEquals($withoutRootLabelResult, $withRootLabelResult->withoutRootLabel());
+        self::assertSame($withoutRootLabelResult->suffix()->value(), $withRootLabelResult->suffix()->value());
+        self::assertSame($withoutRootLabelResult->subDomain()->value(), $withRootLabelResult->subDomain()->value());
+        self::assertSame($withoutRootLabelResult->registrableDomain()->value(), $withRootLabelResult->registrableDomain()->value());
+        self::assertSame($withoutRootLabelResult->secondLevelDomain()->value(), $withRootLabelResult->secondLevelDomain()->value());
+        self::assertNotSame($withoutRootLabelResult->domain()->value(), $withRootLabelResult->domain()->value());
+    }
 }