Adding merge method to Dictionary and Parameters

Author: nyamsprod

CHANGELOG.md

@@ -21,6 +21,8 @@ All Notable changes to `bakame/http-strucured-fields` will be documented in this
 - `Parameters::valueByKey`
 - `Parameters::valueByIndex`
 - Added a validation mechanism to facilitate `Item` and `Parameters` validation against field definition.
+- `Dictionary::mergeParametersByPairs`, `Dictionary::mergeParametersByAssociative`
+- `Parameters::mergeParametersByPairs`, `Parameters::mergeParametersByAssociative`
 
 ### Fixed
 

src/ParameterAccess.php

@@ -231,4 +231,30 @@ public function filterParameters(callable $callback): static
     {
         return $this->withParameters($this->parameters()->filter($callback));
     }
+
+    /**
+     * Merges multiple instances using iterable pairs.
+     *
+     * This method MUST retain the state of the current instance, and return
+     * an instance that contains the specified changes.
+     *
+     * @param StructuredFieldProvider|Parameters|Dictionary|iterable<array{0:string, 1:SfItemInput}> ...$others
+     */
+    public function mergeParametersByPairs(...$others): static
+    {
+        return $this->withParameters($this->parameters()->mergePairs(...$others));
+    }
+
+    /**
+     * Merges multiple instances using iterable associative.
+     *
+     * This method MUST retain the state of the current instance, and return
+     * an instance that contains the specified changes.
+     *
+     * @param StructuredFieldProvider|Dictionary|Parameters|iterable<string, SfItemInput> ...$others
+     */
+    public function mergeParametersByAssociative(...$others): static
+    {
+        return $this->withParameters($this->parameters()->mergeAssociative(...$others));
+    }
 }