use Hierone\Component\Recap\Translator;
use Hierone\Component\Recap\Catalog\ArrayCatalog;
use Hierone\Component\Recap\Formatter\SimpleMessageFormatter;

// Set up the translator
$catalog = new ArrayCatalog();
$formatter = new SimpleMessageFormatter();
$translator = new Translator($catalog, $formatter, 'en');

// Add translations
$catalog->addTranslations([
    'welcome' => 'Welcome to our application!',
    'user.greeting' => 'Hello, :name!',
    'items.zero' => 'no items',
    'items.one' => 'one item', 
    'items.other' => ':count items'
], 'en');

// Use translations
echo $translator->trans('welcome');
echo $translator->trans('user.greeting', ['name' => 'John']);
echo $translator->transChoice('items', 0); // "no items"
echo $translator->transChoice('items', 1); // "one item"
echo $translator->transChoice('items', 5, ['count' => 5]); // "5 items"

use Hierone\Component\Recap\Loader\JsonLoader;

$loader = new JsonLoader();
$translations = $loader->load('/path/to/translations.json', 'en');
$catalog->addTranslations($translations, 'en');

use Hierone\Component\Recap\Loader\PhpArrayLoader;

$loader = new PhpArrayLoader();
$translations = $loader->load('/path/to/translations.php', 'en');
$catalog->addTranslations($translations, 'en');

// Automatic pluralization based on locale
$translator->setLocale('ru'); // Russian
echo $translator->transChoice('books', 2); // Uses Russian plural rules

echo $translator->transWithContext('navigation', 'home'); // navigation.home

$translator->setFallbackLocale('en'); // Fall back to English if key not found

use Hierone\Component\Recap\Formatter\MessageFormatterInterface;

class CustomFormatter implements MessageFormatterInterface 
{
    public function format(string $message, array $parameters, string $locale): string
    {
        // Custom formatting logic
    }
}

$translator = new Translator($catalog, new CustomFormatter());