@intlayer/docs 8.9.7 → 8.10.0-canary.0

package/docs/uk/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: Найкраще i18n рішення для TanStack Start у 2026 році - Звіт бенчмарку
 description: Порівняйте бібліотеки інтернаціоналізації для TanStack Start, такі як react-i18next, use-intl та Intlayer. Детальний звіт про продуктивність за розміром бандла, витоком та реактивністю.
 keywords:
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Додати порівняння зірок GitHub"
   - version: 8.7.5
     date: 2026-01-06
     changes: "Ініціалізація бенчмарку"
 ---
 
-# Бібліотеки i18n для TanStack Start — Звіт бенчмарку 2026
+# Бібліотеки i18n для TanStack Start - Звіт бенчмарку 2026
 
 Ця сторінка є звітом бенчмарку i18n рішень на TanStack Start.
 
@@ -105,7 +108,7 @@ history:
 - `gt-react` (vlatest)
 - `lingo.dev` (v0.133.9)
 
-Фреймворк — `TanStack Start` з багатомовним додатком на **10 сторінок** та **10 мов**.
+Фреймворк - `TanStack Start` з багатомовним додатком на **10 сторінок** та **10 мов**.
 
 Ми порівняли **чотири стратегії завантаження**:
 
@@ -121,9 +124,15 @@ history:
 - **Scoped static**: Зберігає код структурованим (логічний поділ) без складних мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _розділення коду_ (code splitting) та продуктивності. Мінімізує обсяг пам'яті, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+## Зірки на GitHub
+
+Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=formatjs%2Fformatjs%2Ci18next%2Freact-i18next%2Clingui%2Fjs-lingui%2Camannn%2Fnext-intl%2Copral%2paraglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#formatjs/formatjs&i18next/react-i18next&lingui/js-lingui&amannn/next-intl&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
+
 ## Детальні результати
 
-### 1 — Рішення, яких слід уникати
+### 1 - Рішення, яких слід уникати
 
 Деяких рішень, таких як `gt-react` або `lingo.dev`, явно варто триматися подалі. Вони поєднують прив'язку до вендора із засміченням вашої кодової бази. Гірше того: попри багато годин спроб їх впровадження, я так і не зміг забезпечити їх коректну роботу на TanStack Start (аналогічно до `gt-next` на Next.js).
 
@@ -145,19 +154,19 @@ history:
 - Під час збірки він повністю стирав згенеровані JSON-файли при додаванні нового контенту. У результаті лише кілька ключів могли знищити сотні наявних.
 - Я стикнувся з проблемами реактивності бібліотеки в TanStack Start: при зміні локалі довелося примусово перерендерити провайдер, щоб це запрацювало.
 
-### 2 — Експериментальні рішення
+### 2 - Експериментальні рішення
 
 **(Wuchale)** (`wuchale@0.22.11`):
 
 Ідея `Wuchale` цікава, але поки що не є життєздатним рішенням. Я зіткнувся з проблемами реактивності бібліотеки і був змушений примусово перерендерити провайдер, щоб додаток запрацював на TanStack Start. Документація також досить нечітка, що ускладнює освоєння.
 
-### 3 — Прийнятні рішення
+### 3 - Прийнятні рішення
 
 **(Paraglide)** (`@inlang/paraglide-js@2.15.1`):
 
 `Paraglide` пропонує інноваційний, добре продуманий підхід. Проте в цьому тесті рекламований компанією tree-shaking не спрацював ні для моєї реалізації на Next.js, ні для TanStack Start. Робочий процес і DX також складніші за інші варіанти. Особисто я не прихильник необхідності регенерувати JS-файли перед кожним пушем, що створює постійний ризик конфліктів під час злиття для розробників через PR.
 
-> Примітка щодо paraglide: це рішення впорскує код у вашу кодову базу для імпорту; як наслідок, метрика 'lib size' у звіті бенчмарку становить майже 0. Генерація коду — це добре, оскільки використовувана функція включатиме лише необхідну логіку (префікс усюди проти відсутності префікса, куки проти сховища тощо). Для порівняння, Intlayer виконує це фільтрування за допомогою впорскування змінних оточення в збірку, щоб змусити бандлер виконати tree-shake контенту залежно від логіки. Завдяки цьому paraglide та intlayer врешті-решт стають у 6–10 разів легшими рішеннями, ніж i18next або next-intl.
+> Примітка щодо paraglide: це рішення впорскує код у вашу кодову базу для імпорту; як наслідок, метрика 'lib size' у звіті бенчмарку становить майже 0. Генерація коду - це добре, оскільки використовувана функція включатиме лише необхідну логіку (префікс усюди проти відсутності префікса, куки проти сховища тощо). Для порівняння, Intlayer виконує це фільтрування за допомогою впорскування змінних оточення в збірку, щоб змусити бандлер виконати tree-shake контенту залежно від логіки. Завдяки цьому paraglide та intlayer врешті-решт стають у 6–10 разів легшими рішеннями, ніж i18next або next-intl.
 
 **(Tolgee)** (`@tolgee/react@7.0.0`):
 
@@ -167,17 +176,17 @@ history:
 
 **(use-intl)** (`use-intl@4.9.1`):
 
-`use-intl` — це зараз наймодніша частина "intl" в екосистемі React (та ж родина, що й `next-intl`), яку часто просувають ШІ-агенти, але на мій погляд — помилково в контексті продуктивності. Почати роботу досить просто. На практиці ж процес оптимізації та обмеження витоків є досить складним. Аналогічно, поєднання динамічного завантаження + просторів імен + типів TypeScript сильно сповільнює розробку.
+`use-intl` - це зараз наймодніша частина "intl" в екосистемі React (та ж родина, що й `next-intl`), яку часто просувають ШІ-агенти, але на мій погляд - помилково в контексті продуктивності. Почати роботу досить просто. На практиці ж процес оптимізації та обмеження витоків є досить складним. Аналогічно, поєднання динамічного завантаження + просторів імен + типів TypeScript сильно сповільнює розробку.
 
 У TanStack Start ви уникаєте специфічних пасток Next.js (`setRequestLocale`, статичний рендеринг), але основна проблема та ж сама: без суворої дисципліни бандл швидко перевантажується повідомленнями, а підтримка просторів імен для кожного маршруту стає виснажливою.
 
 **(react-i18next)** (`react-i18next@17.0.2`):
 
-`react-i18next` — це, мабуть, найпопулярніший варіант, оскільки він був одним із перших, хто задовольнив потреби i18n у JS-додатках. Він також має великий набір плагінів від спільноти для конкретних проблем.
+`react-i18next` - це, мабуть, найпопулярніший варіант, оскільки він був одним із перших, хто задовольнив потреби i18n у JS-додатках. Він також має великий набір плагінів від спільноти для конкретних проблем.
 
 Проте він має ті ж недоліки, що й стеки на базі `t('a.b.c')`: оптимізація можлива, але забирає багато часу, а великі проекти ризикують скотитися до поганих практик (простори імен + динамічне завантаження + типи).
 
-Формати повідомлень також відрізняються: `use-intl` використовує ICU MessageFormat, тоді як `i18next` має власний формат — це ускладнює інструментарій або міграцію, якщо ви їх змішуєте.
+Формати повідомлень також відрізняються: `use-intl` використовує ICU MessageFormat, тоді як `i18next` має власний формат - це ускладнює інструментарій або міграцію, якщо ви їх змішуєте.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
 
@@ -185,9 +194,9 @@ history:
 
 **(react-intl)** (`react-intl@10.1.1`):
 
-`react-intl` — це продуктивна реалізація від команди Format.js. DX залишається багатослівним: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` додає складності, додаткової роботи JavaScript та прив'язує глобальний екземпляр i18n до багатьох вузлів у React-дереві.
+`react-intl` - це продуктивна реалізація від команди Format.js. DX залишається багатослівним: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` додає складності, додаткової роботи JavaScript та прив'язує глобальний екземпляр i18n до багатьох вузлів у React-дереві.
 
-### 4 — Рекомендації
+### 4 - Рекомендації
 
 Цей бенчмарк TanStack Start не має прямого еквівалента `next-translate` (Next.js плагін + `getStaticProps`). Командам, які справді хочуть API у стилі `t()` зі зрілою екосистемою, `react-i18next` та `use-intl` залишаються "розумним" вибором, але будьте готові витратити багато часу на оптимізацію для уникнення витоків.
 

package/docs/uk/benchmark/vue.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
-title: Найкраще i18n рішення для Vue у 2026 році — Звіт про бенчмарк
+updatedAt: 2026-05-18
+title: Найкраще i18n рішення для Vue у 2026 році - Звіт про бенчмарк
 description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Vue, такі як vue-i18n, fluent-vue та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
 keywords:
   - benchmark
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Додати порівняння зірок GitHub"
   - version: 8.7.12
     date: 2026-01-06
     changes: "Ініціалізація бенчмарку"
 ---
 
-# Бібліотеки i18n для Vue — Звіт про бенчмарк 2026
+# Бібліотеки i18n для Vue - Звіт про бенчмарк 2026
 
 Ця сторінка є звітом про бенчмарк рішень i18n на Vue.
 
@@ -97,7 +100,7 @@ style="border:none;"
 - `vue-i18n` (v11.4.0)
 - `fluent-vue` (v3.8.2)
 
-Фреймворк — `Vue` з багатомовним додатком із **10 сторінок** і **10 мов**.
+Фреймворк - `Vue` з багатомовним додатком із **10 сторінок** і **10 мов**.
 
 Ми порівняли **чотири стратегії завантаження**:
 
@@ -117,17 +120,17 @@ style="border:none;"
 
 Я запустив той самий багатомовний додаток у реальному браузері для кожного стека, а потім записав, що насправді пройшло мережею і скільки часу це зайняло. Розміри вказані **після звичайного веб-стиснення**, оскільки це ближче до того, що люди насправді завантажують, ніж необроблена кількість рядків вихідного коду.
 
-- **Розмір бібліотеки інтернаціоналізації**: Після бандлінгу, tree-shaking та мініфікації розмір бібліотеки i18n — це розмір коду провайдерів + composables у порожньому компоненті. Він не включає завантаження файлів перекладу. Це відповідає на питання, наскільки "дорогою" є бібліотека до того, як ваш контент з'явиться в кадрі.
+- **Розмір бібліотеки інтернаціоналізації**: Після бандлінгу, tree-shaking та мініфікації розмір бібліотеки i18n - це розмір коду провайдерів + composables у порожньому компоненті. Він не включає завантаження файлів перекладу. Це відповідає на питання, наскільки "дорогою" є бібліотека до того, як ваш контент з'явиться в кадрі.
 
-- **JavaScript на сторінку**: Для кожного маршруту бенчмарку, скільки скриптів завантажує браузер для цього відвідування, усереднено за сторінками в наборі (і за локалями). Важкі сторінки — це повільні сторінки.
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку, скільки скриптів завантажує браузер для цього відвідування, усереднено за сторінками в наборі (і за локалями). Важкі сторінки - це повільні сторінки.
 
 - **Витік з інших локалей (Leakage)**: Це контент тієї ж сторінки, але іншою мовою, який помилково завантажується на сторінці, що перевіряється. Цей контент є непотрібним і його слід уникати (наприклад: контент сторінки `/fr/about` у бандлі сторінки `/en/about`).
 
 - **Витік з інших маршрутів**: Та ж ідея для **інших екранів** у додатку: чи додається їхній текст, коли ви відкрили лише одну сторінку (наприклад: контент сторінки `/en/about` у бандлі сторінки `/en/contact`). Високий бал вказує на слабкий поділ або занадто широкі бандли.
 
-- **Середній розмір бандла компонента**: Загальні елементи інтерфейсу вимірюються **по одному**, замість того щоб ховатися всередині одного гігантського числа додатка. Це показує, чи інтернаціоналізація непомітно роздуває повсякденні компоненти. Наприклад, якщо ваш компонент перерендерюється, він завантажуватиме всі ці дані з пам'яті. Прикріплення гігантського JSON до будь-якого компонента — це як підключення великого сховища невикористовуваних даних, що сповільнить продуктивність ваших компонентів.
+- **Середній розмір бандла компонента**: Загальні елементи інтерфейсу вимірюються **по одному**, замість того щоб ховатися всередині одного гігантського числа додатка. Це показує, чи інтернаціоналізація непомітно роздуває повсякденні компоненти. Наприклад, якщо ваш компонент перерендерюється, він завантажуватиме всі ці дані з пам'яті. Прикріплення гігантського JSON до будь-якого компонента - це як підключення великого сховища невикористовуваних даних, що сповільнить продуктивність ваших компонентів.
 
-- **Швидкість реакції на зміну мови**: Я змінюю мову за допомогою власного контролера додатка і вимірюю час, поки сторінка чітко не зміниться — те, що помітить відвідувач.
+- **Швидкість реакції на зміну мови**: Я змінюю мову за допомогою власного контролера додатка і вимірюю час, поки сторінка чітко не зміниться - те, що помітить відвідувач.
 
 - **Робота рендерингу після зміни мови**: Більш точне спостереження: скільки зусиль доклав інтерфейс для перемальовування для нової мови після початку зміни. Корисно, коли "відчутний" час і витрати фреймворку розходяться.
 
@@ -135,13 +138,19 @@ style="border:none;"
 
 - **Час гідратації (Hydration)**: Час, який клієнт витрачає на перетворення серверного HTML на інтерактивний інтерфейс. Тире в таблицях означає, що ця реалізація не надала надійного показника гідратації в цьому бенчмарку.
 
+## Зірки на GitHub
+
+Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&aymericzip/intlayer)
+
 ## Результати детально
 
-### 1 — Рішення, яких слід уникати
+### 1 - Рішення, яких слід уникати
 
 > В екосистемі Vue немає очевидних рішень, яких слід уникати.
 
-### 2 — Прийнятні рішення
+### 2 - Прийнятні рішення
 
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
@@ -153,7 +162,7 @@ style="border:none;"
 
 - **fluent-vue** пропонує спробу інновації через формат .ftl. Організація повідомлень чудова, легше почати роботу. Але на практиці відсутність безпеки типів підвищує ризик помилок і налагодження може швидко стати трудомістким. Більше того, це рішення завантажує повідомлення за допомогою плагіна vite, який змушує завантажувати весь контент усіма мовами на кожну сторінку. Крім того, це надзвичайно важке рішення (~92.7kb, що приблизно в 34 рази більше за `vue-intlayer`).
 
-### 3 — Рекомендації
+### 3 - Рекомендації
 
 **(Intlayer)** (`vue-intlayer@8.7.12`):
 

package/docs/uk/bundle_optimization.md

@@ -35,7 +35,7 @@ history:
 
 ## Сканування бандла
 
-Аналіз бандла — це перший крок до виявлення "важких" JSON-файлів та можливостей розділення коду. Ці інструменти генерують візуальну деревоподібну карту (treemap) скомпільованого коду вашого застосунку, дозволяючи вам точно побачити, які бібліотеки займають найбільше місця.
+Аналіз бандла - це перший крок до виявлення "важких" JSON-файлів та можливостей розділення коду. Ці інструменти генерують візуальну деревоподібну карту (treemap) скомпільованого коду вашого застосунку, дозволяючи вам точно побачити, які бібліотеки займають найбільше місця.
 
 <Tabs>
  <Tab value="vite">

package/docs/uk/cli/index.md

@@ -121,51 +121,51 @@ Intlayer приймає кілька форматів файлів конфіг
 
 ### Автентифікація
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/login.md)** — Автентифікація в Intlayer CMS та отримання облікових даних доступу
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/login.md)** - Автентифікація в Intlayer CMS та отримання облікових даних доступу
 
 ### Основні команди
 
-- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/build.md)** — Створення словників з ваших файлів оголошення контенту
-- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/watch.md)** — Відстеження змін та автоматична перезбірка словників
-- **[Create Standalone Bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/standalone.md)** — Створення автономної JavaScript-збірки, що містить Intlayer та вказані пакети
-- **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/version.md)** — Перевірка встановленої версії Intlayer CLI
-- **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/list_projects.md)** — Перегляд списку всіх проєктів Intlayer у директорії або git-репозиторії
+- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/build.md)** - Створення словників з ваших файлів оголошення контенту
+- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/watch.md)** - Відстеження змін та автоматична перезбірка словників
+- **[Create Standalone Bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/standalone.md)** - Створення автономної JavaScript-збірки, що містить Intlayer та вказані пакети
+- **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/version.md)** - Перевірка встановленої версії Intlayer CLI
+- **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/list_projects.md)** - Перегляд списку всіх проєктів Intlayer у директорії або git-репозиторії
 
 ### Керування словниками
 
-- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/push.md)** — Відправка словників у Редактор Intlayer та CMS
-- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/pull.md)** — Завантаження словників з Редактора Intlayer та CMS
-- **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/fill.md)** — Заповнення, аудит та переклад словників за допомогою AI
-- **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/test.md)** — Тестування та виявлення відсутніх перекладів
-- **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/list.md)** — Вивід списку всіх файлів оголошення контенту у вашому проєкті
+- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/push.md)** - Відправка словників у Редактор Intlayer та CMS
+- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/pull.md)** - Завантаження словників з Редактора Intlayer та CMS
+- **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/fill.md)** - Заповнення, аудит та переклад словників за допомогою AI
+- **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/test.md)** - Тестування та виявлення відсутніх перекладів
+- **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/list.md)** - Вивід списку всіх файлів оголошення контенту у вашому проєкті
 
 ### Керування компонентами
 
-- **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md)** — Вилучення рядків з компонентів у файл .content поруч із компонентом
+- **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md)** - Вилучення рядків з компонентів у файл .content поруч із компонентом
 
 ### Конфігурація
 
-- **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/init.md)** — Налаштування Intlayer у вашому проєкті з автоматичною конфігурацією
-- **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/configuration.md)** — Отримання вашої конфігурації Intlayer та її відправка в CMS
+- **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/init.md)** - Налаштування Intlayer у вашому проєкті з автоматичною конфігурацією
+- **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/configuration.md)** - Отримання вашої конфігурації Intlayer та її відправка в CMS
 
 ### Керування документацією
 
-- **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-translate.md)** — Автоматичний переклад файлів документації за допомогою AI
-- **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-review.md)** — Рецензування файлів документації на предмет якості та послідовності
+- **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-translate.md)** - Автоматичний переклад файлів документації за допомогою AI
+- **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/doc-review.md)** - Рецензування файлів документації на предмет якості та послідовності
 
 ### Редактор та Live Sync
 
-- **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/editor.md)** — Використання команд Редактора Intlayer
-- **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/live.md)** — Використання Live Sync для застосування змін контенту з CMS у реальному часі
+- **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/editor.md)** - Використання команд Редактора Intlayer
+- **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/live.md)** - Використання Live Sync для застосування змін контенту з CMS у реальному часі
 
 ### CI/CD та автоматизація
 
-- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/ci.md)** — Виконання команд Intlayer з автоматично підставленими обліковими даними для CI/CD-пайплайнів
+- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/ci.md)** - Виконання команд Intlayer з автоматично підставленими обліковими даними для CI/CD-пайплайнів
 
 ### Інструменти розробки
 
-- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/sdk.md)** — Використання Intlayer CLI SDK у вашому власному коді
-- **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/debug.md)** — Налагодження та вирішення проблем з Intlayer CLI
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/sdk.md)** - Використання Intlayer CLI SDK у вашому власному коді
+- **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/debug.md)** - Налагодження та вирішення проблем з Intlayer CLI
 
 ## Використовуйте команди Intlayer у вашому файлі `package.json`
 

package/docs/uk/cli/init.md

@@ -48,19 +48,19 @@ bun x intlayer init
 
 ## Аргументи (Arguments):
 
-- `--project-root [projectRoot]` — Опціонально. Вкажіть кореневу директорію проєкту. Якщо не вказано, команда шукатиме корінь проєкту, починаючи з поточної робочої директорії.
-- `--no-gitignore` — Опціонально. Пропускає автоматичне оновлення файлу `.gitignore`. Якщо цей прапорець встановлено, `.intlayer` не буде додано до `.gitignore`.
+- `--project-root [projectRoot]` - Опціонально. Вкажіть кореневу директорію проєкту. Якщо не вказано, команда шукатиме корінь проєкту, починаючи з поточної робочої директорії.
+- `--no-gitignore` - Опціонально. Пропускає автоматичне оновлення файлу `.gitignore`. Якщо цей прапорець встановлено, `.intlayer` не буде додано до `.gitignore`.
 
 ## Що вона робить:
 
 Команда `init` виконує наступні завдання з налаштування:
 
-1. **Перевірка структури проєкту** — Переконується, що ви перебуваєте в коректній директорії проєкту з файлом `package.json`.
-2. **Оновлення `.gitignore`** — Додає `.intlayer` до вашого файлу `.gitignore`, щоб виключити згенеровані файли з системи контролю версій (можна пропустити за допомогою `--no-gitignore`).
-3. **Конфігурація TypeScript** — Оновлює будь-які файли `tsconfig.json`, щоб включити визначення типів Intlayer (`.intlayer/**/*.ts`).
-4. **Створення файлу конфігурації** — Генерує `intlayer.config.ts` (для проєктів на TypeScript) або `intlayer.config.mjs` (для проєктів на JavaScript) з налаштуваннями за замовчуванням.
-5. **Оновлення конфігурації Vite** — Якщо виявлено файл конфігурації Vite, додає імпорт для плагіна `vite-intlayer`.
-6. **Оновлення конфігурації Next.js** — Якщо виявлено файл конфігурації Next.js, додає імпорт для плагіна `next-intlayer`.
+1. **Перевірка структури проєкту** - Переконується, що ви перебуваєте в коректній директорії проєкту з файлом `package.json`.
+2. **Оновлення `.gitignore`** - Додає `.intlayer` до вашого файлу `.gitignore`, щоб виключити згенеровані файли з системи контролю версій (можна пропустити за допомогою `--no-gitignore`).
+3. **Конфігурація TypeScript** - Оновлює будь-які файли `tsconfig.json`, щоб включити визначення типів Intlayer (`.intlayer/**/*.ts`).
+4. **Створення файлу конфігурації** - Генерує `intlayer.config.ts` (для проєктів на TypeScript) або `intlayer.config.mjs` (для проєктів на JavaScript) з налаштуваннями за замовчуванням.
+5. **Оновлення конфігурації Vite** - Якщо виявлено файл конфігурації Vite, додає імпорт для плагіна `vite-intlayer`.
+6. **Оновлення конфігурації Next.js** - Якщо виявлено файл конфігурації Next.js, додає імпорт для плагіна `next-intlayer`.
 
 ## Приклади:
 
@@ -138,7 +138,7 @@ Checking Intlayer configuration...
 
 ## Примітки:
 
-- Команда є ідемпотентною — ви можете безпечно запускати її кілька разів. Вже налаштовані кроки будуть пропущені.
+- Команда є ідемпотентною - ви можете безпечно запускати її кілька разів. Вже налаштовані кроки будуть пропущені.
 - Якщо файл конфігурації вже існує, він не буде перезаписаний.
 - Конфігурації TypeScript без масиву `include` (наприклад, конфігурації у стилі solution з посиланнями) пропускаються.
 - Команда зупиниться з помилкою, якщо в корені проєкту не буде знайдено `package.json`.

package/docs/uk/cli/standalone.md

@@ -47,20 +47,20 @@ bun x intlayer standalone --packages [пакети...] [опції]
 
 ## Опції
 
-- `-o, --outfile [outfile]` — Опціонально. Ім'я вихідного файлу. За замовчуванням: `intlayer-bundle.js`.
-- `--packages [пакети...]` — Обов'язково. Список пакетів для включення у збірку (наприклад, `intlayer`, `vanilla-intlayer`).
-- `--version [version]` — Опціонально. Версія пакетів для збірки. Якщо не вказано, за замовчуванням використовується версія Intlayer CLI.
-- `--minify` — Опціонально. Чи потрібно мініфікувати вихідні дані. За замовчуванням: `true`.
-- `--platform [platform]` — Опціонально. Цільова платформа для збірки (наприклад, `browser`, `node`). За замовчуванням: `browser`.
-- `--format [format]` — Опціонально. Формат вихідних даних збірки (наприклад, `esm`, `cjs`, `iife`). За замовчуванням: `esm`.
+- `-o, --outfile [outfile]` - Опціонально. Ім'я вихідного файлу. За замовчуванням: `intlayer-bundle.js`.
+- `--packages [пакети...]` - Обов'язково. Список пакетів для включення у збірку (наприклад, `intlayer`, `vanilla-intlayer`).
+- `--version [version]` - Опціонально. Версія пакетів для збірки. Якщо не вказано, за замовчуванням використовується версія Intlayer CLI.
+- `--minify` - Опціонально. Чи потрібно мініфікувати вихідні дані. За замовчуванням: `true`.
+- `--platform [platform]` - Опціонально. Цільова платформа для збірки (наприклад, `browser`, `node`). За замовчуванням: `browser`.
+- `--format [format]` - Опціонально. Формат вихідних даних збірки (наприклад, `esm`, `cjs`, `iife`). За замовчуванням: `esm`.
 
 ## Загальні опції
 
-- `--env-file [envFile]` — Файл середовища.
-- `-e, --env [env]` — Середовище.
-- `--base-dir [baseDir]` — Базова директорія.
-- `--no-cache` — Вимкнути кеш.
-- `--verbose` — Детальний вивід.
+- `--env-file [envFile]` - Файл середовища.
+- `-e, --env [env]` - Середовище.
+- `--base-dir [baseDir]` - Базова директорія.
+- `--no-cache` - Вимкнути кеш.
+- `--verbose` - Детальний вивід.
 
 ## Приклади:
 
@@ -122,11 +122,11 @@ bun x intlayer standalone --packages intlayer --format iife
 
 ## Що вона робить:
 
-1. **Створює тимчасове середовище** — Налаштовує тимчасову директорію для керування залежностями.
-2. **Встановлює пакети** — Використовує `npm` або `bun` (якщо є), щоб встановити запитані пакети та їхні залежності.
-3. **Генерує точку входу** — Створює тимчасовий файл точки входу, який експортує всі запитані пакети та робить їх доступними як глобальні змінні при запуску в браузері.
-4. **Збирає за допомогою esbuild** — Використовує esbuild для об'єднання всього в один файл, застосовує мініфікацію та форматування згідно із запитом.
-5. **Генерує файл** — Записує результуючу збірку за вказаним вихідним шляхом.
+1. **Створює тимчасове середовище** - Налаштовує тимчасову директорію для керування залежностями.
+2. **Встановлює пакети** - Використовує `npm` або `bun` (якщо є), щоб встановити запитані пакети та їхні залежності.
+3. **Генерує точку входу** - Створює тимчасовий файл точки входу, який експортує всі запитані пакети та робить їх доступними як глобальні змінні при запуску в браузері.
+4. **Збирає за допомогою esbuild** - Використовує esbuild для об'єднання всього в один файл, застосовує мініфікацію та форматування згідно із запитом.
+5. **Генерує файл** - Записує результуючу збірку за вказаним вихідним шляхом.
 
 ## Глобальні змінні
 

package/docs/uk/compiler.md

@@ -35,7 +35,7 @@ history:
 
 ## Що таке Intlayer Compiler?
 
-**Intlayer Compiler** — це потужний інструмент, розроблений для автоматизації процесу інтернаціоналізації (i18n) у ваших додатках. Він сканує ваш вихідний код (JSX, TSX, Vue, Svelte) на наявність декларацій контенту, витягує їх і автоматично генерує необхідні файли словників. Це дозволяє зберігати контент поруч із компонентами, тоді як Intlayer займається керуванням та синхронізацією ваших словників.
+**Intlayer Compiler** - це потужний інструмент, розроблений для автоматизації процесу інтернаціоналізації (i18n) у ваших додатках. Він сканує ваш вихідний код (JSX, TSX, Vue, Svelte) на наявність декларацій контенту, витягує їх і автоматично генерує необхідні файли словників. Це дозволяє зберігати контент поруч із компонентами, тоді як Intlayer займається керуванням та синхронізацією ваших словників.
 
 ## Чому використовувати Intlayer Compiler?
 
@@ -50,7 +50,7 @@ history:
 
 Хоча компілятор пропонує чудовий досвід «just works», він також вносить певні компроміси, про які варто знати:
 
-- **Евристична неоднозначність**: Компілятор має вгадувати, що є контентом для користувача, а що — логікою додатка (наприклад, `className="active"`, коди статусів, ID продуктів). У складних кодових базах це може призводити до хибних спрацьовувань або пропущених рядків, що вимагатиме ручних анотацій та винятків.
+- **Евристична неоднозначність**: Компілятор має вгадувати, що є контентом для користувача, а що - логікою додатка (наприклад, `className="active"`, коди статусів, ID продуктів). У складних кодових базах це може призводити до хибних спрацьовувань або пропущених рядків, що вимагатиме ручних анотацій та винятків.
 - **Тільки статична екстракція**: Екстракція на основі компілятора покладається на статичний аналіз. Рядки, які існують лише під час виконання (коди помилок API, поля CMS тощо), не можуть бути виявлені або перекладені лише компілятором, тому вам усе одно знадобиться додаткова стратегія i18n під час виконання.
 
 Для глибшого архітектурного порівняння див. статтю в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md).
@@ -64,7 +64,7 @@ history:
 
 ### Vite
 
-Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор — через плагін `vite-intlayer`.
+Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор - через плагін `vite-intlayer`.
 
 #### Встановлення
 

package/docs/uk/configuration.md

@@ -606,7 +606,7 @@ export default config;
 | ----------------- | --------------------------------------------------------------------------------------------- | ---------- | ------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `locales`         | Список підтримуваних локалей у додатку.                                                       | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                                                                        |
 | `requiredLocales` | Список обов'язкових локалей у додатку.                                                        | `string[]` | `[]`                | `[]`                 | • Якщо порожній, усі локалі обов'язкові в режимі `strict`.<br/>• Переконайтеся, що обов'язкові локалі також визначені в полі `locales`.                                                                                                                                                                                |
-| `strictMode`      | Забезпечує суворе впровадження інтернаціоналізованого контенту за допомогою TypeScript.       | `string`   | `'inclusive'`       |                      | • Якщо `"strict"`: Обов'язкове визначення кожної оголошеної локалі для функції `t` — помилка в разі відсутності або неоголошеної локалі.<br/>• Якщо `"inclusive"`: Попередження для відсутніх локалей, але дозволяє використання існуючих неоголошених локалей.<br/>• Якщо `"loose"`: Приймає будь-яку існуючу локаль. |
+| `strictMode`      | Забезпечує суворе впровадження інтернаціоналізованого контенту за допомогою TypeScript.       | `string`   | `'inclusive'`       |                      | • Якщо `"strict"`: Обов'язкове визначення кожної оголошеної локалі для функції `t` - помилка в разі відсутності або неоголошеної локалі.<br/>• Якщо `"inclusive"`: Попередження для відсутніх локалей, але дозволяє використання існуючих неоголошених локалей.<br/>• Якщо `"loose"`: Приймає будь-яку існуючу локаль. |
 | `defaultLocale`   | Локаль за замовчуванням, яка використовується як резервна, якщо запитувана локаль недоступна. | `string`   | `Locales.ENGLISH`   | `'en'`               | Використовується для визначення локалі, якщо її не вказано в URL, файлах cookie або заголовку.                                                                                                                                                                                                                         |
 
 ---
@@ -640,9 +640,9 @@ export default config;
 | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `mode`     | Режим структури URL для керування локаллю.                                                                                                                                                                      | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) або `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard` . `'no-prefix'`: локаль керується іншим способом. `'search-params'`: `/dashboard?locale=fr` | Не впливає на керування файлами cookie або локальне сховище.                                                                                                                                                                                                                                     |
 | `storage`  | Конфігурація для зберігання локалі на клієнті.                                                                                                                                                                  | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                             | Див. таблицю параметрів зберігання нижче.                                                                                                                                                                                                                                                        |
-| `basePath` | Базовий шлях для URL додатка.                                                                                                                                                                                   | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                    | Якщо ваш додаток знаходиться за адресою `https://example.com/my-app`, basePath — `'/my-app'`, що вказує на URL `https://example.com/my-app/en` .                                                                                                                                                 |
+| `basePath` | Базовий шлях для URL додатка.                                                                                                                                                                                   | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                    | Якщо ваш додаток знаходиться за адресою `https://example.com/my-app`, basePath - `'/my-app'`, що вказує на URL `https://example.com/my-app/en` .                                                                                                                                                 |
 | `rewrite`  | Власні правила перенаправлення URL для зміни стандартного режиму маршрутизації для певних шляхів. Підтримує динамічні параметри `[param]`.                                                                      | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | Див. приклад нижче                                                                                                                                                                             | • Правила перенаправлення мають вищий пріоритет, ніж `mode`.<br/>• Працює з Next.js та Vite.<br/>• `getLocalizedUrl()` автоматично застосовує відповідні правила.<br/>• Див. [Власні перенаправлення URL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
-| `domains`  | Відображає локалі на імена хостів доменів для маршрутизації на основі доменів. Якщо встановлено, URL для цієї локалі використовують цей домен як базу (абсолютний URL), і префікс локалі не додається до шляху. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                    | • Протокол за замовчуванням — `https://`, якщо він не вказаний у імені хоста.<br/>• Сам домен ідентифікує локаль, тому префікс `/zh/` не додається.<br/>• `getLocalizedUrl('/', 'zh')` повертає `https://intlayer.zh/`.                                                                          |
+| `domains`  | Відображає локалі на імена хостів доменів для маршрутизації на основі доменів. Якщо встановлено, URL для цієї локалі використовують цей домен як базу (абсолютний URL), і префікс локалі не додається до шляху. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                    | • Протокол за замовчуванням - `https://`, якщо він не вказаний у імені хоста.<br/>• Сам домен ідентифікує локаль, тому префікс `/zh/` не додається.<br/>• `getLocalizedUrl('/', 'zh')` повертає `https://intlayer.zh/`.                                                                          |
 
 **Приклад `rewrite`**:
 
@@ -670,10 +670,10 @@ routing: {
 
 | Значення           | Примітки                                                                                                                                                                                                       | Опис                                                                      |
 | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
-| `'cookie'`         | • Забезпечте належну згоду користувача відповідно до GDPR.<br/>• Можна налаштувати через `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).                     | Зберігає локаль у файлі cookie — доступно і на клієнті, і на сервері.     |
-| `'localStorage'`   | • Термін дії не закінчується, поки не буде видалено явно.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`). | Зберігає локаль у браузері без терміну дії — лише клієнтська частина.     |
-| `'sessionStorage'` | • Видаляється при закритті вкладки/вікна браузера.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).      | Зберігає локаль на час сесії сторінки — лише клієнтська частина.          |
-| `'header'`         | • Корисно для викликів API.<br/>• Клієнтська частина не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                 | Зберігає або передає локаль через HTTP-заголовки — лише серверна частина. |
+| `'cookie'`         | • Забезпечте належну згоду користувача відповідно до GDPR.<br/>• Можна налаштувати через `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).                     | Зберігає локаль у файлі cookie - доступно і на клієнті, і на сервері.     |
+| `'localStorage'`   | • Термін дії не закінчується, поки не буде видалено явно.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`). | Зберігає локаль у браузері без терміну дії - лише клієнтська частина.     |
+| `'sessionStorage'` | • Видаляється при закритті вкладки/вікна браузера.<br/>• Intlayer Proxy не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).      | Зберігає локаль на час сесії сторінки - лише клієнтська частина.          |
+| `'header'`         | • Корисно для викликів API.<br/>• Клієнтська частина не має доступу до нього.<br/>• Можна налаштувати через `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                 | Зберігає або передає локаль через HTTP-заголовки - лише серверна частина. |
 
 #### Атрибути Cookie (Cookies Attributes)
 
@@ -861,7 +861,7 @@ export default config;
 | `location`                  | Вказує на місце зберігання файлів словників та спосіб їх синхронізації з CMS.                                                                  | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`        | `'hybrid'`                                                                                  | • `'local'`: Тільки локальне керування.<br/>• `'remote'`: Тільки віддалене керування (CMS).<br/>• `'hybrid'`: І локальне, і віддалене керування.<br/>• `'plugin'` або власні рядки: Керування через плагін або власне джерело.                                                                                                                                                                                      |
 | `importMode`                | Керує способом імпорту словників.                                                                                                              | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`       | `'dynamic'`                                                                                 | • `'static'`: Статичний імпорт.<br/>• `'dynamic'`: Динамічний імпорт через Suspense.<br/>• `'fetch'`: Отримання через Live Sync API; резервний варіант `'dynamic'` у разі помилки.<br/>• Потрібні плагіни `@intlayer/babel` та `@intlayer/swc`.<br/>• Ключі мають бути оголошені статично.<br/>• Ігнорується, якщо `optimize` вимкнено.<br/>• Не впливає на `getIntlayer`, `getDictionary` тощо.                    |
 | `priority`                  | Пріоритет словника. При вирішенні конфліктів між словниками вище значення має перевагу перед нижчим.                                           | `number`                                                                                                        | `undefined`      | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| `live`                      | ЗАСТАРІЛО — використовуйте `importMode: 'fetch'`. Раніше вказувало, чи слід отримувати контент словника динамічно через Live Sync API.         | `boolean`                                                                                                       | `undefined`      |                                                                                             | Перейменовано на `importMode: 'fetch'` у v8.0.0.                                                                                                                                                                                                                                                                                                                                                                    |
+| `live`                      | ЗАСТАРІЛО - використовуйте `importMode: 'fetch'`. Раніше вказувало, чи слід отримувати контент словника динамічно через Live Sync API.         | `boolean`                                                                                                       | `undefined`      |                                                                                             | Перейменовано на `importMode: 'fetch'` у v8.0.0.                                                                                                                                                                                                                                                                                                                                                                    |
 | `schema`                    | Генерується автоматично Intlayer для валідації JSON-схеми.                                                                                     | `'https://intlayer.org/schema.json'`                                                                            | Генерується      |                                                                                             | Не редагуйте вручну.                                                                                                                                                                                                                                                                                                                                                                                                |
 | `title`                     | Допомагає ідентифікувати словники в редакторі та CMS.                                                                                          | `string`                                                                                                        | `undefined`      | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                     |
 | `tags`                      | Класифікує словники та надає контекст або інструкції для редактора та AI.                                                                      | `string[]`                                                                                                      | `undefined`      | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                     |