Improve autoconversion for containers

Author: nyamsprod

docs/basic-usage.md

@@ -35,6 +35,7 @@ $permissions['geolocation'][-1]->value();      // returns the last value of the
 $permissions['camera']->value();               // returns '*' the sole value attached to the 'camera' feature
 isset($permissions['yolo']);                   // returns false this permission does not exust
 $permissions->isEmpty();                       // returns false the dictionary contains some permissions
+echo $permissions;                             // returns 'picture-in-picture=(), geolocation=(self "https://example.com/"), camera=*'
 ```
 
 > [!WARNING]

docs/containers.md

@@ -236,8 +236,8 @@ echo $field->removeByKeys('expire', 'httponly', 'max-age')->toHttpValue(); // re
 
 ### Automatic conversion
 
-Learning new types may be a daunting tasks so for ease of usage, for all containers, the following automatic
-conversion are applied on the member argument of each modifying methods.
+Learning new types may be a daunting tasks so for ease of usage, all datatype can be represented using an array as list.
+The automatic conversion are applied on the member argument of each modifying methods>
 
 If the submitted type is:
 

src/InnerList.php

@@ -29,7 +29,9 @@
  * @see https://www.rfc-editor.org/rfc/rfc9651.html#section-3.1.1
  *
  * @phpstan-import-type SfType from StructuredFieldProvider
+ * @phpstan-import-type SfTypeInput from StructuredFieldProvider
  * @phpstan-import-type SfItemInput from StructuredFieldProvider
+ * @phpstan-import-type SfItemPair from StructuredFieldProvider
  * @phpstan-import-type SfInnerListPair from StructuredFieldProvider
  * @phpstan-import-type SfParameterInput from StructuredFieldProvider
  *
@@ -45,7 +47,7 @@ final class InnerList implements ArrayAccess, Countable, IteratorAggregate
     private readonly Parameters $parameters;
 
     /**
-     * @param iterable<SfItemInput> $members
+     * @param iterable<SfItemInput|SfItemPair> $members
      */
     private function __construct(iterable $members, ?Parameters $parameters = null)
     {
@@ -54,7 +56,7 @@ private function __construct(iterable $members, ?Parameters $parameters = null)
     }
 
     /**
-     * @param SfItemInput $member
+     * @param SfItemInput|SfItemPair $member
      */
     private function filterMember(mixed $member): Item
     {
@@ -141,9 +143,11 @@ public static function fromPair(array $pair): self
 
     /**
      * Returns a new instance.
+     *
+     * @param StructuredFieldProvider|Item|SfTypeInput|SfItemPair ...$members
      */
     public static function new(
-        StructuredFieldProvider|OuterList|Dictionary|InnerList|Parameters|Item|Token|Bytes|DisplayString|DateTimeInterface|string|int|float|bool ...$members
+        StructuredFieldProvider|Item|Token|Bytes|DisplayString|DateTimeInterface|array|string|int|float|bool ...$members
     ): self {
         return new self($members);
     }

src/Item.php

@@ -114,6 +114,7 @@ public static function tryFromPair(array $pair): ?self
      */
     public static function fromPair(array $pair): self
     {
+        ;
         if ([] === $pair || !array_is_list($pair) || 2 < count($pair)) {
             throw new SyntaxError('The pair must be represented by an non-empty array as a list containing exactly 1 or 2 members.');
         }
@@ -141,7 +142,7 @@ public static function fromPair(array $pair): self
     /**
      * Returns a new bare instance from value.
      *
-     * @param SfItemInput|array{0:SfItemInput, 1:Parameters|iterable<array{0:string, 1:SfItemInput}>} $value
+     * @param SfItemInput|SfItemPair $value
      *
      * @throws SyntaxError If the value is not valid.
      */

src/OuterList.php

@@ -141,11 +141,11 @@ public static function fromPairs(StructuredFieldProvider|iterable $pairs): self
     }
 
     /**
-     * @param SfMemberInput ...$members
+     * @param StructuredFieldProvider|SfInnerListPair|SfItemPair|SfMemberInput ...$members
      */
     public static function new(iterable|StructuredFieldProvider|InnerList|Item|Token|Bytes|DisplayString|DateTimeInterface|string|int|float|bool ...$members): self
     {
-        return new self(...$members);
+        return self::fromPairs($members); /* @phpstan-ignore-line*/
     }
 
     public static function fromRfc9651(Stringable|string $httpValue): self