Improve coercion

Author: nyamsprod

components/Modifier.php

@@ -45,7 +45,6 @@
 use Psr\Http\Message\UriInterface as Psr7UriInterface;
 use SensitiveParameter;
 use Stringable;
-use Traversable;
 use Uri\Rfc3986\Uri as Rfc3986Uri;
 use Uri\WhatWg\Url as WhatWgUrl;
 use ValueError;

interfaces/FeatureDetection.php

@@ -44,7 +44,6 @@ public static function supportsIdn(): void
         $isSupported = $isSupported ?? (function_exists('\idn_to_ascii') && defined('\INTL_IDNA_VARIANT_UTS46'));
 
         $isSupported || throw new MissingFeature('Support for IDN host requires the `intl` extension for best performance or run "composer require symfony/polyfill-intl-idn" to install a polyfill.');
-
     }
 
     public static function supportsIPv4Conversion(): void

interfaces/StringCoercionMode.php

@@ -14,12 +14,19 @@
 namespace League\Uri;
 
 use BackedEnum;
+use DateTimeInterface;
+use IntlDateFormatter;
+use League\Uri\Contracts\FragmentDirective;
 use League\Uri\Contracts\UriComponentInterface;
+use League\Uri\Contracts\UriInterface;
 use Stringable;
 use TypeError;
+use Uri\Rfc3986\Uri as Rfc3986Uri;
+use Uri\WhatWg\Url as WhatWgUrl;
 
 use function array_is_list;
 use function array_map;
+use function extension_loaded;
 use function get_debug_type;
 use function implode;
 use function is_array;
@@ -65,6 +72,7 @@ enum StringCoercionMode
      * - Backed Enum: converted to their backing value and then stringify see int and string
      * - Array as list are flatten into a string list using the "," character as separator
      * - Associative array, Unit Enum, any object without stringification semantics is coerced to "[object Object]".
+     * - DateTimeInterface object are stringify following EcmaScript `Date.prototype.toString()` semantics
      */
     case Ecmascript;
 
@@ -75,6 +83,8 @@ public function isCoercible(mixed $value): bool
         return self::Ecmascript === $this
             ? !is_resource($value)
             : match (true) {
+                $value instanceof Rfc3986Uri,
+                $value instanceof WhatWgUrl,
                 $value instanceof BackedEnum,
                 $value instanceof Stringable,
                 is_scalar($value),
@@ -86,8 +96,12 @@ public function isCoercible(mixed $value): bool
     public function coerce(mixed $value): ?string
     {
         $value = match (true) {
+            $value instanceof UriComponentInterface,
+            $value instanceof FragmentDirective => $value->value(),
+            $value instanceof UriInterface,
+            $value instanceof WhatWgUrl => $value->toAsciiString(),
+            $value instanceof Rfc3986Uri => $value->toString(),
             $value instanceof BackedEnum => $value->value,
-            $value instanceof UriComponentInterface => $value->value(),
             $value instanceof Stringable => (string) $value,
             default => $value,
         };

interfaces/StringCoercionModeTest.php

@@ -13,6 +13,7 @@
 
 namespace League\Uri;
 
+use League\Uri\Components\FragmentDirectives\TextDirective;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\TestCase;
 use stdClass;
@@ -50,6 +51,9 @@ public function __toString(): string
                     return 'ok';
                 }
             }, 'ok'],
+
+            [new \Uri\Rfc3986\Uri('https://example.com'), 'https://example.com'],
+            [new TextDirective('start', 'end'), 'start,end'],
         ];
     }
 
@@ -94,6 +98,9 @@ public function __toString(): string
             }, 'ok'],
             [fn () => 42, '[object Object]'],
             [TestUnitEnum::One, '[object Object]'],
+
+            [new \Uri\WhatWg\Url('https://0:0@0:0/0?0#0'), 'https://0:0@0.0.0.0:0/0?0#0'],
+            [new TextDirective('start', 'end'), 'start,end'],
         ];
     }