Add new alias to UnaliasCollectionMethods (#305)

* add new alias to UnaliasCollectionMethods

* cs

---------

Co-authored-by: Geni Jaho <[email protected]>

Author: MrYamous

docs/rector_rules_overview.md

@@ -1457,8 +1457,12 @@ Use the base collection methods instead of their aliases.
  $collection = new Collection([0, 1, null, -1]);
 -$collection->average();
 -$collection->some(fn (?int $number): bool => is_null($number));
+-$collection->unlessEmpty(fn(Collection $collection) => $collection->push('Foo'));
+-$collection->unlessNotEmpty(fn(Collection $collection) => $collection->push('Foo'));
 +$collection->avg();
 +$collection->contains(fn (?int $number): bool => is_null($number));
++$collection->whenNotEmpty(fn(Collection $collection) => $collection->push('Foo'));
++$collection->whenEmpty(fn(Collection $collection) => $collection->push('Foo'));
 ```
 
 <br>

src/Rector/MethodCall/UnaliasCollectionMethodsRector.php

@@ -70,6 +70,10 @@ private function updateMethodCall(MethodCall $methodCall): ?MethodCall
             $replacement = 'contains';
         } elseif ($this->isName($name, 'average')) {
             $replacement = 'avg';
+        } elseif ($this->isName($name, 'unlessEmpty')) {
+            $replacement = 'whenNotEmpty';
+        } elseif ($this->isName($name, 'unlessNotEmpty')) {
+            $replacement = 'whenEmpty';
         } else {
             return null;
         }

stubs/Illuminate/Support/Enumerable.php

@@ -79,4 +79,26 @@ public function filter(?callable $callback = null);
      * @return static
      */
     public function reject($callback = true);
+
+    /**
+     * Apply the callback unless the collection is empty.
+     *
+     * @template TUnlessEmptyReturnType
+     *
+     * @param  callable($this): TUnlessEmptyReturnType  $callback
+     * @param  (callable($this): TUnlessEmptyReturnType)|null  $default
+     * @return $this|TUnlessEmptyReturnType
+     */
+    public function unlessEmpty();
+
+    /**
+     * Apply the callback unless the collection is not empty.
+     *
+     * @template TUnlessNotEmptyReturnType
+     *
+     * @param  callable($this): TUnlessNotEmptyReturnType  $callback
+     * @param  (callable($this): TUnlessNotEmptyReturnType)|null  $default
+     * @return $this|TUnlessNotEmptyReturnType
+     */
+    public function unlessNotEmpty();
 }

tests/Rector/MethodCall/UnaliasCollectionMethodsRector/Fixture/fixture.php.inc

@@ -7,6 +7,8 @@ use Illuminate\Support\Collection;
 $collection = new Collection([0, 1, null, -1]);
 $collection->average();
 $collection->some(fn (?int $number): bool => is_null($number));
+$collection->unlessEmpty(fn(Collection $collection) => $collection->push('Foo'));
+$collection->unlessNotEmpty(fn(Collection $collection) => $collection->push('Foo'));
 
 ?>
 -----
@@ -19,5 +21,7 @@ use Illuminate\Support\Collection;
 $collection = new Collection([0, 1, null, -1]);
 $collection->avg();
 $collection->contains(fn (?int $number): bool => is_null($number));
+$collection->whenNotEmpty(fn(Collection $collection) => $collection->push('Foo'));
+$collection->whenEmpty(fn(Collection $collection) => $collection->push('Foo'));
 
 ?>