@intlayer/docs 8.9.8 → 8.10.0-canary.0

package/docs/uk/benchmark/svelte.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
-title: Найкраще i18n рішення для Svelte у 2026 році — Звіт про бенчмарк
+updatedAt: 2026-05-18
+title: Найкраще i18n рішення для Svelte у 2026 році - Звіт про бенчмарк
 description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Svelte, такі як svelte-i18n, Paraglide та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
 keywords:
   - benchmark
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Додати порівняння зірок GitHub"
   - version: 8.7.12
     date: 2026-01-06
     changes: "Ініціалізація бенчмарку"
 ---
 
-# Бібліотеки i18n для Svelte — Звіт про бенчмарк 2026
+# Бібліотеки i18n для Svelte - Звіт про бенчмарк 2026
 
 Ця сторінка є звітом про бенчмарк рішень i18n на Svelte.
 
@@ -97,7 +100,7 @@ style="border:none;"
 - `svelte-i18n` (v4.0.1)
 - `@inlang/paraglide-js` (v2.17.0)
 
-Фреймворк — `Svelte` з багатомовним додатком із **10 сторінок** і **10 мов**.
+Фреймворк - `Svelte` з багатомовним додатком із **10 сторінок** і **10 мов**.
 
 Ми порівняли **чотири стратегії завантаження**:
 
@@ -113,13 +116,19 @@ style="border:none;"
 - **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
 - **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
 
+## Зірки на GitHub
+
+Зірки на GitHub є потужним індикатором популярності проекту, довіри спільноти та довгострокової актуальності. Хоча вони не є прямим показником технічної якості, вони відображають, скільки розробників вважають проект корисним, стежать за його розвитком і, ймовірно, впровадять його. Для оцінки цінності проекту зірки допомагають порівняти інтерес до альтернатив і дають уявлення про зростання екосистеми.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=kaisermann%2Fsvelte-i18n%2Copral%2paraglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#kaisermann/svelte-i18n&opral/paraglide-js&aymericzip/intlayer)
+
 ## Результати детально
 
-### 1 — Рішення, яких слід уникати
+### 1 - Рішення, яких слід уникати
 
 > В екосистемі Svelte немає очевидних рішень, яких слід уникати.
 
-### 2 — Прийнятні рішення
+### 2 - Прийнятні рішення
 
 **(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
 
@@ -129,13 +138,13 @@ style="border:none;"
 Особисто я не прихильник того, щоб перегенерувати файли JS перед кожним пушем, що створює постійний ризик конфліктів при злитті через PR. Інструмент також здається більш зосередженим на Vite, ніж на Next.js.
 Нарешті, у порівнянні з іншими рішеннями, Paraglide не використовує стор (наприклад, Svelte store) для отримання поточної локалі для рендерингу контенту. Для кожного розібраного вузла він запитуватиме локаль з localStorage / cookie тощо. Це призводить до виконання непотрібної логіки, яка впливає на реактивність компонентів.
 
-> Примітка щодо paraglide: рішення впорскує код у вашу кодову базу для імпорту; як результат, метрика 'lib size' у звіті бенчмарку становить майже 0. Генерація коду — це добре, тому що використана функція включатиме лише необхідну логіку (префікс скрізь проти відсутності префікса, кукі проти сховища тощо). Для порівняння, Intlayer виконує цю фільтрацію за допомогою впорскування змінних оточення під час збірки, щоб змусити бандлер виконувати tree-shaking контенту залежно від логіки. Завдяки цьому paraglide та intlayer стають у 6–10 разів легшими рішеннями, ніж i18next або next-intl.
+> Примітка щодо paraglide: рішення впорскує код у вашу кодову базу для імпорту; як результат, метрика 'lib size' у звіті бенчмарку становить майже 0. Генерація коду - це добре, тому що використана функція включатиме лише необхідну логіку (префікс скрізь проти відсутності префікса, кукі проти сховища тощо). Для порівняння, Intlayer виконує цю фільтрацію за допомогою впорскування змінних оточення під час збірки, щоб змусити бандлер виконувати tree-shaking контенту залежно від логіки. Завдяки цьому paraglide та intlayer стають у 6–10 разів легшими рішеннями, ніж i18next або next-intl.
 
 **(svelte-i18n)** (`svelte-i18n@3.4.0`):
 
 Це рішення задовольняє всі потреби i18n у проєкті Svelte. Але як і у випадку з i18next або іншими великими i18n рішеннями, воно трохи важке (~15.9kb, що приблизно в 7 разів більше за `svelte-intlayer`).
 
-### 3 — Рекомендації
+### 3 - Рекомендації
 
 **(Intlayer)** (`svelte-intlayer@8.7.12`):
 

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`.
 
 #### Встановлення