<?php
// SharpConfig.php
// Created: 2023-10-20
// Updated: 2023-10-20

namespace Syokuhou;

use InvalidArgumentException;
use Index\IO\FileStream;
use Index\IO\Stream;

/**
 * Provides a configuration in SharpChat format.
 */
class SharpConfig implements IConfig {
    use ImmutableConfigTrait, GetValueInfoTrait, GetValuesTrait;

    /**
     * @param array<string, SharpConfigValueInfo> $values
     */
    public function __construct(private array $values) {}

    public function getSeparator(): string {
        return ':';
    }

    public function scopeTo(string ...$prefix): IConfig {
        return new ScopedConfig($this, $prefix);
    }

    public function hasValues(string|array $names): bool {
        if(is_string($names))
            return array_key_exists($names, $this->values);

        foreach($names as $name)
            if(!array_key_exists($name, $this->values))
                return false;

        return true;
    }

    public function getAllValueInfos(int $range = 0, int $offset = 0): array {
        if($range === 0)
            return array_values($this->values);

        if($range < 0)
            throw new InvalidArgumentException('$range must be a positive integer.');
        if($offset < 0)
            throw new InvalidArgumentException('$offset must be greater than zero if a range is specified.');

        return array_slice($this->values, $offset, $range);
    }

    public function getValueInfos(string|array $names): array {
        if(is_string($names))
            return array_key_exists($names, $this->values) ? [$this->values[$names]] : [];

        $infos = [];

        foreach($names as $name)
            if(array_key_exists($name, $this->values))
                $infos[] = $this->values[$name];

        return $infos;
    }

    /**
     * Creates an instance of SharpConfig from an array of lines.
     *
     * @param string[] $lines Config lines.
     * @return SharpConfig
     */
    public static function fromLines(array $lines): self {
        $values = [];

        foreach($lines as $line) {
            $line = trim($line);
            if($line === '' || $line[0] === '#' || $line[0] === ';')
                continue;

            $info = new SharpConfigValueInfo(...explode(' ', $line, 2));
            $values[$info->getName()] = $info;
        }

        return new SharpConfig($values);
    }

    /**
     * Creates an instance of SharpConfig from a string.
     *
     * @param string $lines Config lines.
     * @param non-empty-string $newLine Line separator character.
     * @return SharpConfig
     */
    public static function fromString(string $lines, string $newLine = "\n"): self {
        return self::fromLines(explode($newLine, $lines));
    }

    /**
     * Creates an instance of SharpConfig from a file.
     *
     * @param string $path Config file path.
     * @throws InvalidArgumentException If $path does not exist.
     * @return SharpConfig
     */
    public static function fromFile(string $path): self {
        if(!is_file($path))
            throw new InvalidArgumentException('$path does not exist.');

        return self::fromStream(FileStream::openRead($path));
    }

    /**
     * Creates an instance of SharpConfig from a readable stream.
     *
     * @param Stream $stream Config file stream.
     * @throws InvalidArgumentException If $stream is not readable.
     * @return SharpConfig
     */
    public static function fromStream(Stream $stream): self {
        if(!$stream->canRead())
            throw new InvalidArgumentException('$stream must be readable.');

        $values = [];
        while(($line = $stream->readLine()) !== null) {
            $line = trim($line);
            if($line === '' || $line[0] === '#' || $line[0] === ';')
                continue;

            $info = new SharpConfigValueInfo(...explode(' ', $line, 2));
            $values[$info->getName()] = $info;
        }

        return new SharpConfig($values);
    }
}