WoWTranslate_UK (Ukrainian Localization)

# WoWTranslate_UK — v1.1.0 (квітень 2026)

## 🎯 Головне
- **Повний перехід на DeepL.** Попередня версія поєднувала кілька безкоштовних
  машинних перекладачів; цього разу вся база (680 000+ рядків) пройшла через
  професійний DeepL API — ~$600 витрачено, щоб позбутися ляпів на зразок
  "Ерєдран" замість "Ередар" та покалічених токенів форматування.
- **Відмінювання за відмінками.** Нова система `ns.Inflect()` + 5000 авто-
  згенерованих + 300+ ручних відмінків. Тепер "Поговоріть з Капітаном
  Гарріком", а не "з Капітан Гаррік".
- **Подвійна структура аддона.** Основна частина (WoWTranslate_UK, ~30 MB —
  UI, фракції, зони, досягнення) вантажиться миттєво на старті гри. Масивна
  частина (WoWTranslate_UK_Bulk, ~120 MB — предмети, закляття, квести, NPC)
  вантажиться ЛІНИВО через 3с після логіну або при першому тултіпі/квестлозі.
  Менше лагів на старті.

## 🔧 Під капотом
- Захист WoW-токенів (`%s`, `$n`, `|cff...`, `{name}`, атласи/іконки) під час
  перекладу — форматований текст більше не ламається.
- Рантайм-кеш (8K записів) на гарячих хуках `SetText` / `SetFormattedText`.
- Шрифти Montserrat (Regular/Bold/SemiBold) зі шляхо-залежним підбором
  (Morpheus → Bold, Skurri → SemiBold, FrizQT → Regular).
- Pre-compiled диспетч ~130 regex-правил за першим словом — О(1) замість
  лінійного сканування на кожне невлучання.
- Проксі-пайплайн для перекладу: `curl_cffi` + `chrome131` імперсонація,
  двоярусний пул (unknown/proven) з автоматичним скиданням мертвих проксі.

## 🐛 Виправлено
- Дублікати ключів у таблицях відмінків (Архімаг, Капітан, Tallstrider,
  Highlord, Ward) — Lua тихо залишав лише останній.
- Плутанина однина/множина ("Hippogryphs" → тепер "Гіпогрифи", не "Гіпогриф").
- `hasCyrillic` розширена на U+0500–U+052F.
- Відмінки "Учень": було "Унем/Уня/Уню" (такого слова немає), стало
  "Учнем/Учня/Учневі".
- Транслітерація імен: 60 послідовних `gsub` → 3 із табличним lookup
  (~20× менше алокацій у GC).
- `QuestTranslator`: паттерни пре-ескейпляться один раз; `safeRegions`/
  `safeChildren` більше не алокують closure щоразу (важливо на розкритому
  QuestLog).

## ⚠️ Міграція / сумісність
- **Мінімальний TOC: 12.0.5.** Якщо ти на 12.0.1 або Classic — лишайся на
  попередній версії (2.0.0) до оновлення клієнта.
- Структура збережених змінних зберігається: `WoWTranslate_UK_Untranslated`
  працює так само — збирає непокладені рядки для подальшого аналізу.
- Попередні `WoWTranslate_UK_DebugLog` більше не використовується — можна
  видалити з WTF вручну, якщо хочеш.

## 📦 Розміри
- Main addon: ~30 MB (постійно в пам'яті після логіну)
- Bulk addon: ~120 MB (LoadOnDemand)
- Архів: 46 MB .zip