Improve Interfaces documentation

Author: nyamsprod

CHANGELOG.md

@@ -24,7 +24,6 @@ All Notable changes to `League\Uri\Interfaces` will be documented in this file
 - `UriString::containsValidRfc3987Characters`
 - `UriString::isValidScheme`
 - `UriString::isValidHost`
-- `UriString::buildUserInfo`
 - `FeatureDetection::supportsDom`
 - `Encoder::decodeNecessary`
 - `Encoder::decodePath`
@@ -47,7 +46,7 @@ All Notable changes to `League\Uri\Interfaces` will be documented in this file
 ### Fixed
 
 - `UriString::parse` will fail if the URI contains whitespace.
-- `UriString::buildUri` allows the `$path` argument to be `null`.
+- `UriString::buildUri` allows all arguments to be `null` including the `path`.
 - `UriString::buildAuthority` allows the `$user` argument to be `null` and still generate a user info component.
 
 ### Deprecated

Encoder.php

@@ -287,7 +287,7 @@ public static function decodeQuery(Stringable|string|null $path): ?string
     }
 
     /**
-     * Normalize query component.
+     * Normalize the query component.
      *
      * The value returned MUST be percent-encoded, but MUST NOT double-encode
      * any characters. To determine what characters to encode, please refer to
@@ -317,7 +317,7 @@ public static function decodeFragment(Stringable|string|null $path): ?string
     }
 
     /**
-     * Normalize fragment component.
+     * Normalize the fragment component.
      *
      * The value returned MUST be percent-encoded, but MUST NOT double-encode
      * any characters. To determine what characters to encode, please refer to
@@ -329,7 +329,7 @@ public static function normalizeFragment(Stringable|string|null $fragment): ?str
     }
 
     /**
-     * Normalize host component.
+     * Normalize the host component.
      *
      * @see https://www.rfc-editor.org/rfc/rfc3986.html#section-3.2.2
      *

UriString.php

@@ -218,20 +218,20 @@ public static function build(array $components): string
     }
 
     /**
-     * Generate a URI string representation based on RFC3986 algorithm.
+     * Generates a URI string representation based on RFC3986 algorithm.
      *
-     * valid URI component MUST be provided without their URI delimiters
+     * Valid URI component MUST be provided without their URI delimiters
      * but properly encoded.
      *
      * @link https://tools.ietf.org/html/rfc3986#section-5.3
      * @link https://tools.ietf.org/html/rfc3986#section-7.5§
      */
     public static function buildUri(
-        ?string $scheme,
-        ?string $authority,
-        ?string $path,
-        ?string $query,
-        ?string $fragment,
+        ?string $scheme = null,
+        ?string $authority = null,
+        ?string $path = null,
+        ?string $query = null,
+        ?string $fragment = null,
     ): string {
         self::validateComponents($scheme, $authority, $path);
         $uri = '';
@@ -284,25 +284,6 @@ public static function buildAuthority(array $components): ?string
         return $authority;
     }
 
-    /**
-     * Generate a URI UserInfo representation from the URI parsed representation.
-     *
-     * @param InputComponentMap $components
-     */
-    public static function buildUserInfo(array $components): ?string
-    {
-        if (!isset($components['user'])) {
-            return null;
-        }
-
-        $userInfo = $components['user'];
-        if (! isset($components['pass'])) {
-            return $userInfo;
-        }
-
-        return $userInfo.':'.$components['pass'];
-    }
-
     /**
      * Parses and normalizes the URI following RFC3986 destructive and non-destructive constraints.
      *