SupportedOption

25class SupportedOption extends AbstractDataTransferObject26{27    public const KEY_NAME = 'name';28    public const KEY_SUPPORTED_VALUES = 'supportedValues';29    /**30     * @var OptionEnum The option name.31     */32    protected OptionEnum $name;33    /**34     * @var list<mixed>|null The supported values for this option.35     */36    protected ?array $supportedValues;37    /**38     * Constructor.39     *40     * @since 0.1.041     *42     * @param OptionEnum $name The option name.43     * @param list<mixed>|null $supportedValues The supported values for this option, or null if any value is supported.44     *45     * @throws InvalidArgumentException If supportedValues is not null and not a list.46     */47    public function __construct(OptionEnum $name, ?array $supportedValues = null)48    {49        if ($supportedValues !== null && !array_is_list($supportedValues)) {50            throw new InvalidArgumentException('Supported values must be a list array.');51        }52        $this->name = $name;53        $this->supportedValues = $supportedValues;54    }55    /**56     * Gets the option name.57     *58     * @since 0.1.059     *60     * @return OptionEnum The option name.61     */62    public function getName(): OptionEnum63    {64        return $this->name;65    }66    /**67     * Checks if a value is supported for this option.68     *69     * @since 0.1.070     *71     * @param mixed $value The value to check.72     * @return bool True if the value is supported, false otherwise.73     */74    public function isSupportedValue($value): bool75    {76        // If supportedValues is null, any value is supported77        if ($this->supportedValues === null) {78            return \true;79        }80        // If the value is an array, consider it a set (i.e. order doesn't matter).81        if (is_array($value)) {82            $normalizedValue = self::normalizeArrayForComparison($value);83            foreach ($this->supportedValues as $supportedValue) {84                if (!is_array($supportedValue)) {85                    continue;86                }87                $normalizedSupported = self::normalizeArrayForComparison($supportedValue);88                if ($normalizedValue === $normalizedSupported) {89                    return \true;90                }91            }92            return \false;93        }94        $normalizedValue = self::normalizeValue($value);95        foreach ($this->supportedValues as $supportedValue) {96            if (self::normalizeValue($supportedValue) === $normalizedValue) {97                return \true;98            }99        }100        return \false;101    }102    /**103     * Normalizes an AbstractEnum instance to its string value.104     *