<?php

/*
 * This file is part of Chevere.
 *
 * (c) Rodolfo Berrios <rodolfo@chevere.org>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace Chevere\Parameter;

use Chevere\Parameter\Interfaces\ArgumentsStringInterface;
use Chevere\Parameter\Traits\ArgumentsTrait;
use Chevere\Parameter\Traits\ExceptionErrorMessageTrait;
use InvalidArgumentException;
use OutOfBoundsException;
use TypeError;
use function Chevere\Message\message;

final class ArgumentsString implements ArgumentsStringInterface
{
    use ExceptionErrorMessageTrait;

    /**
     * @template-use ArgumentsTrait<string>
     */
    use ArgumentsTrait;

    /**
     * @return array<int|string, string>
     */
    public function toArrayFill(string $fill): array
    {
        $filler = array_fill_keys($this->null, $fill);

        return array_merge($filler, $this->arguments);
    }

    /**
     * @throws OutOfBoundsException
     * @throws TypeError
     * @throws InvalidArgumentException
     */
    public function withPut(string $name, string $value): ArgumentsStringInterface
    {
        $new = clone $this;
        $new->assertSetArgument($name, $value);
        $new->arguments[$name] = $value;

        return $new;
    }

    public function get(string $name): ?string
    {
        if (! $this->has($name)) {
            return null;
        }
        if (! array_key_exists($name, $this->arguments)) {
            $name = array_search($name, $this->parameters()->keys(), true);
        }

        return $this->arguments[$name] ?? null;
    }

    public function required(string $name): string
    {
        if ($this->parameters()->optionalKeys()->contains($name)) {
            throw new InvalidArgumentException(
                (string) message(
                    'Argument `%name%` is optional',
                    name: $name
                )
            );
        }

        return $this->arguments[$name];
    }

    public function optional(string $name): ?string
    {
        if ($this->parameters()->has($name)
            && ! $this->parameters()->optionalKeys()->contains($name)
        ) {
            throw new InvalidArgumentException(
                (string) message(
                    'Argument `%name%` is required',
                    name: $name
                )
            );
        }

        if ($this->has($name)) {
            return $this->arguments[$name];
        }

        return null;
    }
}