UkrainianVocative 1.1.0

UkrainianVocative

Бібліотека .NET для перетворення імен українською мовою у кличний відмінок.

Можливості

• Перетворення імен українською мовою у кличний відмінок
• Підтримка російських написань (автоматичне перетворення на українські відповідники)
• Обробка латинських транслітерацій зі зворотною транслітерацією
• Регістронезалежний пошук
• Обробка різних варіантів апострофів
• ~1600 імен українською із кличними формами, у тому числі вірменські, грузинські, тюркські, арабські та західноєвропейські імена
• ~520 російсько-українських відповідностей імен

Встановлення

dotnet add package UkrainianVocative

Використання

using UkrainianVocative;

// Конвертер за замовчуванням (українські, російські та транслітеровані імена)
var converter = VocativeConverter.Default;

// Імена українською мовою
converter.ToVocative("Андрій");    // "Андрію"
converter.ToVocative("Натусик");   // "Натусику"
converter.ToVocative("Дженніфер"); // "Дженніфер"
converter.ToVocative("Ванесса");   // "Ванессо"

// Російські написання (автоматично конвертуються)
converter.ToVocative("Снежана");   // "Сніжано"
converter.ToVocative("Вячеслав");  // "В'ячеславе"

// Латинські транслітерації
converter.ToVocative("Yevhenii");   // "Євгенію"
converter.ToVocative("Sviatoslav"); // "Святославе"
converter.ToVocative("Svetlana");   // "Світлано" (через Светлана → Світлана)

// Не знайдені імена повертаються без змін
converter.ToVocative("Йода");      // "Йода"

// Перевірка наявності кличної форми
converter.HasVocativeForm("Олег"); // true

Налаштування

// За замовчуванням: українською, російською та транслітом
var defaultConverter = VocativeConverter.Default;

// Тільки українською, без підтримки російської чи трансліту
var ukrainianOnly = VocativeConverter.UkrainianOnly;

// Власна конфігурація
var custom = new VocativeConverter(
    convertRussian: true,
    convertTransliterated: false
);

Як це працює

1. Прямий пошук: перевірка наявності імені в українському словнику кличних форм
2. Російське відображення: пошук російсько-українського відповідника
3. Зворотна транслітерація: генерація можливих кириличних варіантів з латиниці та перевірка кожного у словниках

Зворотний транслітератор обробляє типові неоднозначності:

• i → і, и, й, ь
• y → и, й, ь
• ia → я, ія, ья
• kh → х
• zh → ж
• sh → ш
• та інші...

Ліцензія

MIT License

Внески

Внески вітаються! Створюйте issues або pull requests на GitHub.