Add mergeHidden and mergeVisible methods to Collection class with tests (#58110)

Author: mahmoudmohamedramadan

src/Illuminate/Database/Eloquent/Collection.php

@@ -580,6 +580,28 @@ public function makeVisible($attributes)
         return $this->each->makeVisible($attributes);
     }
 
+    /**
+     * Merge the given, typically visible, attributes hidden across the entire collection.
+     *
+     * @param  array<array-key, string>|string  $attributes
+     * @return $this
+     */
+    public function mergeHidden($attributes)
+    {
+        return $this->each->mergeHidden($attributes);
+    }
+
+    /**
+     * Merge the given, typically hidden, attributes visible across the entire collection.
+     *
+     * @param  array<array-key, string>|string  $attributes
+     * @return $this
+     */
+    public function mergeVisible($attributes)
+    {
+        return $this->each->mergeVisible($attributes);
+    }
+
     /**
      * Set the visible attributes across the entire collection.
      *

tests/Database/DatabaseEloquentCollectionTest.php

@@ -545,6 +545,22 @@ public function testMakeVisibleRemovesHiddenFromEntireCollection()
         $this->assertEquals([], $c[0]->getHidden());
     }
 
+    public function testMergeHiddenAddsHiddenOnEntireCollection()
+    {
+        $c = new Collection([new TestEloquentCollectionModel]);
+        $c = $c->mergeHidden(['merged']);
+
+        $this->assertEquals(['hidden', 'merged'], $c[0]->getHidden());
+    }
+
+    public function testMergeVisibleRemovesHiddenFromEntireCollection()
+    {
+        $c = new Collection([new TestEloquentCollectionModel]);
+        $c = $c->mergeVisible(['merged']);
+
+        $this->assertEquals(['visible', 'merged'], $c[0]->getVisible());
+    }
+
     public function testSetVisibleReplacesVisibleOnEntireCollection()
     {
         $c = new Collection([new TestEloquentCollectionModel]);