What would this interface look like?

I've been asked to create a class that "implements this interface."

Not sure what that means or what that would look like.

What do you think?

<?php

namespace App\Data;

/**
 * An immutable collection of values with operators for manipulation or check.
 */
interface RangeFinderInterface extends \IteratorAggregate
{
    public function __construct(iterable $values = []);

    /**
     * Returns values that are between, and including, the passed values. [min, max]
     *
     * For the purpose of this code challenge, all non-numeric values should be dropped.
     *
     * @param int|float|string $min
     * @param int|float|string $max
     *
     * @return static
     */
    public function between($min, $max): self;

    public function after($min): self;

    public function before($max): self;

    /**
     * @param callable|null $by Accepts a single argument and returns a boolean `fn(mixed): bool`
     *
     * @return static
     */
    public function filter(?callable $by): self;

    /**
     * @param callable $by Accepts a single argument and returns a boolean `fn(mixed): bool`
     *
     * @return bool
     */
    public function some(callable $by): bool;

    /**
     * @param callable $by Accepts a single argument and returns a boolean `fn(mixed): bool`
     *
     * @return bool
     */
    public function every(callable $by): bool;

    /**
     * @return array
     */
    public function all(): array;
}

Select all Open in new window