<?php

namespace App\Contracts;

interface CatalogProductRanker
{
    /**
     * Rank product candidates for a catalog roundup.
     *
     * @param  list<array<string, mixed>>  $candidates
     * @return list<array<string, mixed>>
     */
    public function rank(
        array $candidates,
        string $category = '',
        string $subcategory = '',
        ?string $notes = null,
    ): array;
}