norse-blue/php-string-extensions-inflections

<?php

declare(strict_types=1);

namespace NorseBlue\StringExtensions\Inflections\Extensions;

use Doctrine\Inflector\InflectorFactory;
use Doctrine\Inflector\Language;
use NorseBlue\ExtensibleObjects\Contracts\ExtensionMethod;
use NorseBlue\ScalarObjects\Types\StringType;
use function NorseBlue\ScalarObjects\Functions\string;

final class StringSingularExtension extends StringType implements ExtensionMethod
{
    /**
     * @return callable(): StringType
     */
    public function __invoke(): callable
    {
        /**
         * Get the singular form of a word.
         *
         * @return \NorseBlue\ScalarObjects\Types\StringType
         */
        return function (string $language = Language::ENGLISH): StringType {
            return string(InflectorFactory::createForLanguage($language)->build()->singularize($this->value));
        };
    }
}