<?php

namespace League\Uri;

use League\Uri\Contracts\UriException;
use League\Uri\Contracts\UriInterface;
use League\Uri\Exceptions\SyntaxError;
use League\Uri\Exceptions\TemplateCanNotBeExpanded;
use League\Uri\UriTemplate\Template;
use League\Uri\UriTemplate\VariableBag;
use Stringable;

/**
 * Defines the URI Template syntax and the process for expanding a URI Template into a URI reference.
 *
 * @link    https://tools.ietf.org/html/rfc6570
 * @package League\Uri
 * @author  Ignace Nyamagana Butera <nyamsprod@gmail.com>
 * @since   6.1.0
 *
 * Based on GuzzleHttp\UriTemplate class in Guzzle v6.5.
 * @link https://github.com/guzzle/guzzle/blob/6.5/src/UriTemplate.php
 */
final class UriTemplate
{
    public readonly Template $template;
    public readonly VariableBag $defaultVariables;

    /**
     * @throws SyntaxError              if the template syntax is invalid
     * @throws TemplateCanNotBeExpanded if the template variables are invalid
     */
    public function __construct(Template|Stringable|string $template, VariableBag|array $defaultVariables = [])
    {
        $this->template = $template instanceof Template ? $template : Template::createFromString($template);
        $this->defaultVariables = $this->filterVariables($defaultVariables);
    }

    public static function __set_state(array $properties): self
    {
        return new self($properties['template'], $properties['defaultVariables']);
    }

    /**
     * Filters out variables for the given template.
     */
    private function filterVariables(VariableBag|array $inputVariables): VariableBag
    {
        $variableBag = new VariableBag();
        foreach ($this->template->variableNames as $name) {
            if (isset($inputVariables[$name])) {
                $variableBag[$name] = $inputVariables[$name];
            }
        }

        return $variableBag;
    }

    /**
     * The template string.
     */
    public function getTemplate(): string
    {
        return $this->template->value;
    }

    /**
     * Returns the names of the variables in the template, in order.
     *
     * @return string[]
     */
    public function getVariableNames(): array
    {
        return $this->template->variableNames;
    }

    /**
     * Returns the default values used to expand the template.
     *
     * The returned list only contains variables whose name is part of the current template.
     *
     * @return array<string,string|array>
     */
    public function getDefaultVariables(): array
    {
        return $this->defaultVariables->all();
    }

    /**
     * Returns a new instance with the updated default variables.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the modified default variables.
     *
     * If present, variables whose name is not part of the current template
     * possible variable names are removed.
     */
    public function withDefaultVariables(VariableBag|array $defaultDefaultVariables): self
    {
        return new self($this->template, $defaultDefaultVariables);
    }

    /**
     * @throws TemplateCanNotBeExpanded if the variable contains nested array values
     * @throws UriException             if the resulting expansion can not be converted to a UriInterface instance
     */
    public function expand(VariableBag|array $variables = []): UriInterface
    {
        return Uri::createFromString(
            $this->template->expand(
                $this->filterVariables($variables)->replace($this->defaultVariables)
            )
        );
    }
}
__halt_compiler();----SIGNATURE:----gU028vLoOnajo808gloiKIjKZ/Ta3R2EaCUdPdFvA3C4A1uM+ctaTfhbuTsvBUrtWgJoycXT9IWZj1jEFCccqxBPFdCKRqHAE1zgOAkAJO7GAzOzR0PPQenKEiIptPA7ZefGTvk57oihHrswsdtsaPWlSW6dOZtw6Co926LWGMTdKPrAp74l948+oauG+CYwIqjZ58bQTu1Cp2YUhoucv/P3h2pBF+klOb3C3gkfxlrWuG+0IIJNMNdoShEF2xQuQx+Y/kOl2VLarL5Z39Xx6YDq5BBtyxzUYm3tg2t/ASp1Sl9+w+S0jF/iY80pcRyI4R49eAnyDNsT2aS5WrLlQkhWPa+PzhZUBSE4zaq6RcVm6cdUsx0ZCwyrozICrEoiv53jktcDiV1lrEE2UQA+eLgSaDBtZ+XqYFvFVQqUkdwihLkkIqmYsHFXMp49kDvp3aHuN/rA6ulHSFPVaPvLt/J20mJSdDSijUGa8Sb8KosLM191HRwomUYd274tSHJKCEVY3YITKl9VAjGGke4pW1eYRl6a6mtXRK8uukoYM7fvgv4yJLwjyy/lzMZCkL/ExVcuy4RspTgspIgrPEOhvDjEBeagABYme+K9kXijuaGBN8OsEph5iGclUlIQXCIdO/YlOqMo7HqNVMpgiSiI3zLcRSP6QbAHu0H21Kx9MiI=----ATTACHMENT:----NzkxNjI5ODcwOTY2NTExMCAzNTAyOTEwODQ3MTU3NDU5IDIyNjU0MDczODI4NjQ1MzM=