Stratadox / ImmutableCollection

src/Appending.php

<?php

declare(strict_types=1);

namespace Stratadox\ImmutableCollection;

use function array_merge;
use Stratadox\Collection\Appendable;
use Stratadox\Collection\Collection;

/**
 * Behaviour to allow "appending" the immutable collection.
 *
 * Provides access to appending behaviour in the form of a method that
 * returns a modified copy of the original (immutable) collection.
 *
 * @package Stratadox\Collection
 * @author  Stratadox
 */
trait Appending
{
    /**
     * @see Appendable::add()
     * @param array ...$newItems
     * @return static
     */
    public function add(...$newItems)
    {
        return $this->newCopy(array_merge($this->items(), $newItems));

The expression return $this->newCopy(array_merge($this->items(), $newItems)) returns the type Stratadox\Collection\Collection which is incompatible with the documented return type Stratadox\ImmutableCollection\Appending.

    }

    /** @see Collection::items() */
    abstract public function items(): array;

    /**
     * @see ImmutableCollection::newCopy()
     * @param array $items
     * @return static
     */
    abstract protected function newCopy(array $items): Collection;
}