[Laravel] Improved version of Collection->map as a macro (you can add it at AppServiceProvider.php boot method)

Collection.loop.php

<?php
/*
 * Improved version of Collection->map method
 *
 * @param callable $callback
 *
 * @return Illuminate\Support\Collection
 */
Illuminate\Support\Collection::macro('loop', function(callable $callback){

    $items = [];

    $loop = (object) ['count' => count($this->items), 'index' => -1, 'iteration' => 0, 'remaining' => count($this->items)];

    foreach($this->items as $key => $item) {
        $loop->index++;
        $loop->iteration++;
        $loop->remaining--;
        $loop->first = $loop->index === 0;
        $loop->last = $loop->index === $loop->count - 1;
        $loop->even = ($loop->index + 1) % 2 === 0;
        $loop->odd = ! $loop->even;


        $items[$key] = $callback($item, $key, $loop);
    }

    return new static($items);
});

Example:

$array1 = collect(range(1, 100));

$array2 =  $array1->loop(function($item, $key, $loop){
    if($loop->first){
        return 'first';
    }

    if ($loop->last) {
        return 'last';
    }


    if ($loop->even) {
        return 'even';
    }
    
    if($loop->odd){
        return 'odd';
    }
    
    return $item++;
});