Resolver.php

<?php

declare(strict_types=1);

/**
 * Fast Forward Development Tools for PHP projects.
 *
 * This file is part of fast-forward/dev-tools project.
 *
 * @author   Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
 * @license  https://opensource.org/licenses/MIT MIT License
 *
 * @see      https://github.com/php-fast-forward/
 * @see      https://github.com/php-fast-forward/dev-tools
 * @see      https://github.com/php-fast-forward/dev-tools/issues
 * @see      https://php-fast-forward.github.io/dev-tools/
 * @see      https://datatracker.ietf.org/doc/html/rfc2119
 */

namespace FastForward\DevTools\License;

/**
 * Resolves license identifiers to their corresponding template filenames.
 *
 * This class maintains a mapping of supported open-source licenses to their
 * template files and provides methods to check support and resolve licenses.
 */
final class Resolver implements ResolverInterface
{
    private const array SUPPORTED_LICENSES = [
        'MIT' => 'mit.txt',
        'BSD-2-Clause' => 'bsd-2-clause.txt',
        'BSD-3-Clause' => 'bsd-3-clause.txt',
        'Apache-2.0' => 'apache-2.0.txt',
        'Apache-2' => 'apache-2.0.txt',
        'GPL-3.0-or-later' => 'gpl-3.0-or-later.txt',
        'GPL-3.0' => 'gpl-3.0-or-later.txt',
        'GPL-3+' => 'gpl-3.0-or-later.txt',
        'LGPL-3.0-or-later' => 'lgpl-3.0-or-later.txt',
        'LGPL-3.0' => 'lgpl-3.0-or-later.txt',
        'LGPL-3+' => 'lgpl-3.0-or-later.txt',
        'MPL-2.0' => 'mpl-2.0.txt',
        'ISC' => 'isc.txt',
        'Unlicense' => 'unlicense.txt',
    ];

    /**
     * Resolves a license identifier to its template filename.
     *
     * @param string|null $license The license identifier to resolve
     *
     * @return string|null The template filename if supported, or null if not
     */
    public function resolve(?string $license): ?string
    {
        $normalized = $this->normalize($license);

        if (null === $normalized) {
            return null;
        }

        if (! isset(self::SUPPORTED_LICENSES[$normalized])) {
            return null;
        }

        return self::SUPPORTED_LICENSES[$normalized];
    }

    /**
     * Normalizes the license identifier for comparison.
     *
     * @param string|null $license The license identifier to normalize
     *
     * @return string|null The normalized license string, or null when unavailable
     */
    private function normalize(?string $license): ?string
    {
        if (null === $license) {
            return null;
        }

        $license = trim($license);

        return '' === $license ? null : $license;
    }
}