@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/uk/benchmark/solid.md

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Найкраще i18n рішення для Solid у 2026 році — Звіт про бенчмарк
+description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Solid, такі як solid-primitives, solid-i18next та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - solid
+  - продуктивність
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - solid
+author: Aymeric PINEAU
+applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
+history:
+  - version: 8.7.12
+    date: 2026-01-06
+    changes: "Ініціалізація бенчмарку"
+---
+
+# Бібліотеки i18n для Solid — Звіт про бенчмарк 2026
+
+Ця сторінка є звітом про бенчмарк рішень i18n на Solid.
+
+## Зміст
+
+<Toc/>
+
+## Інтерактивний бенчмарк
+
+<I18nBenchmark framework="vite-solid" vertical/>
+
+## Посилання на результати:
+
+<iframe 
+  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md" 
+  width="100%" 
+  height="600px"
+  style="border:none;">
+</iframe>
+
+> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_solid.md
+
+Повний репозиторій бенчмарку можна знайти [тут](https://github.com/intlayer-org/benchmark-i18n/tree/main).
+
+## Вступ
+
+Рішення для інтернаціоналізації є одними з найважчих залежностей у додатку Solid. Основний ризик полягає у відправці непотрібного контенту: перекладів для інших сторінок та інших локалей у бандлі одного маршруту.
+
+З ростом вашого додатка ця проблема може швидко збільшити обсяг JavaScript, що надсилається клієнту, і сповільнити навігацію.
+
+На практиці, для найменш оптимізованих реалізацій, інтернаціоналізована сторінка може виявитися в кілька разів важчою, ніж версія без i18n.
+
+Інший вплив стосується досвіду розробника (DX): як ви оголошуєте контент, типи, організацію просторів імен, динамічне завантаження та реактивність при зміні локалі.
+
+## TL;DR
+
+- **Intlayer**: Рекомендований вибір для професійних додатків Solid, які потребують розширених функцій та оптимізації (v8.7.12).
+- **@solid-primitives/i18n**: Відмінна легка альтернатива для простих проєктів, хоча їй бракує розширених функцій, таких як lazy loading.
+- **solid-i18next**: Стандартний, але важкий варіант (~4.7 рази більше за Intlayer) з тими ж недоліками, що і React i18next.
+- **Paraglide**: Інноваційний підхід, але складний DX та проблеми з tree-shaking у деяких конфігураціях.
+
+## Протестуйте свій додаток
+
+Щоб швидко виявити проблеми з витоком i18n, я налаштував безкоштовний сканер, доступний [тут](https://intlayer.org/i18n-seo-scanner).
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Проблема
+
+Два важелі є важливими для обмеження вартості багатомовного додатка:
+
+- Розділіть контент за сторінками / просторами імен, щоб не завантажувати цілі словники, коли вони не потрібні.
+- Завантажуйте потрібну локаль динамічно, тільки коли це необхідно.
+
+Розуміння технічних обмежень цих підходів:
+
+**Динамічне завантаження**
+
+Без динамічного завантаження більшість рішень зберігають повідомлення в пам'яті з першого рендеру, що додає значне навантаження для додатків з багатьма маршрутами та локалями.
+
+З динамічним завантаженням ви приймаєте компроміс: менше початкового JS, але іноді додатковий запит при зміні мови.
+
+**Поділ контенту (Splitting)**
+
+Синтаксис, побудований навколо `t('a.b.c')`, дуже зручний, але часто заохочує зберігати великі JSON-об'єкти під час виконання. Ця модель ускладнює tree-shaking, якщо бібліотека не пропонує реальної стратегії поділу на сторінки.
+
+## Методологія дослідження
+
+Для цього бенчмарку ми порівняли наступні бібліотеки:
+
+- `Base App` (Без бібліотеки i18n)
+- `solid-intlayer` (v8.7.12)
+- `@solid-primitives/i18n` (v2.2.1)
+- `solid-i18next` (v17.0.2)
+- `@inlang/paraglide-js` (v2.17.0)
+
+Фреймворк — `Solid` з багатомовним додатком із **10 сторінок** і **10 мов**.
+
+Ми порівняли **чотири стратегії завантаження**:
+
+| Стратегія                  | Без просторів імен (глобально)                          | З просторами імен (scoped)                                                    |
+| :------------------------- | :------------------------------------------------------ | :---------------------------------------------------------------------------- |
+| **Статичне завантаження**  | **Static**: Все в пам'яті при запуску.                  | **Scoped static**: Розділено за просторами імен; все завантажено при запуску. |
+| **Динамічне завантаження** | **Dynamic**: Завантаження за запитом для кожної локалі. | **Scoped dynamic**: Детальне завантаження за простором імен та локаллю.       |
+
+## Підсумок стратегій
+
+- **Static**: Просто; немає затримки мережі після початкового завантаження. Мінус: великий розмір бандла.
+- **Dynamic**: Зменшує початкову вагу (lazy-loading). Ідеально, коли у вас багато локалей.
+- **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
+- **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
+
+## Результати детально
+
+### 1 — Рішення, яких слід уникати
+
+> В екосистемі Solid немає очевидних рішень, яких слід уникати.
+
+### 2 — Прийнятні рішення
+
+**(solid-i18next)** (`solid-i18next@17.0.2`):
+
+`solid-i18next`, ймовірно, є найпопулярнішим варіантом, оскільки він був одним із перших, хто задовольнив потреби i18n у JavaScript-додатках. Він також має широкий набір плагінів спільноти для конкретних проблем.
+
+Пакет важкий (~14.6kb, що приблизно в 4.7 рази більше за `solid-intlayer`).
+
+Тим не менш, він має ті ж основні недоліки, що і стеки, побудовані на `t('a.b.c')`: оптимізація можлива, але забирає багато часу, а великі проєкти ризикують поганими практиками (простори імен + динамічне завантаження + типи).
+
+**(@solid-primitives/i18n)** (`@solid-primitives/i18n@2.2.1`):
+
+Solid primitive надзвичайно легкий і ефективний. Я рекомендую це рішення для легких проєктів, але в ньому може швидко не вистачити функцій для професійних рішень, що включають управління кукі, перенаправлення проксі, форматери тощо.
+Йому також не вистачає lazy loading та скоупінгу просторів імен для оптимізації розміру сторінки.
+
+**(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
+
+`Paraglide` пропонує інноваційний, добре продуманий підхід. Незважаючи на це, у цьому бенчмарку деревоподібне шейкінг (tree-shaking), яке рекламує їхня компанія, не спрацювало для моєї реалізації. Робочий процес і DX також складніші за інші варіанти.
+Особисто я не прихильник того, щоб перегенерувати файли JS перед кожним пушем, що створює постійний ризик конфліктів при злитті через PR.
+Нарешті, у порівнянні з іншими рішеннями, Paraglide не використовує стор (наприклад, Solid signal) для отримання поточної локалі для рендерингу контенту. Для кожного розібраного вузла він запитуватиме локаль з localStorage / cookie тощо. Це призводить до виконання непотрібної логіки, яка впливає на реактивність компонентів.
+
+### 3 — Рекомендації
+
+**(Intlayer)** (`solid-intlayer@8.7.12`):
+
+Я не буду особисто оцінювати `solid-intlayer` заради об'єктивності, оскільки це моє власне рішення.
+
+### Особиста примітка
+
+Ця примітка є особистою і не впливає на результати бенчмарку. Тим не менш, у світі i18n часто можна побачити консенсус щодо патерну на кшталт `const t = useTranslation('xx')` + `<>{t('xx.xx')}</>` для перекладеного контенту.
+
+У додатках Solid впорскування функції як `JSX.Element`, на мій погляд, є антипатерном. Це також додає зайву складність та накладні витрати на виконання JavaScript (навіть якщо це ледь помітно).

package/docs/uk/benchmark/svelte.md

@@ -0,0 +1,148 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Найкраще i18n рішення для Svelte у 2026 році — Звіт про бенчмарк
+description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Svelte, такі як svelte-i18n, Paraglide та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - svelte
+  - продуктивність
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - svelte
+author: Aymeric PINEAU
+applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
+history:
+  - version: 8.7.12
+    date: 2026-01-06
+    changes: "Ініціалізація бенчмарку"
+---
+
+# Бібліотеки i18n для Svelte — Звіт про бенчмарк 2026
+
+Ця сторінка є звітом про бенчмарк рішень i18n на Svelte.
+
+## Зміст
+
+<Toc/>
+
+## Інтерактивний бенчмарк
+
+<I18nBenchmark framework="vite-svelte" vertical/>
+
+## Посилання на результати:
+
+<iframe 
+  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md" 
+  width="100%" 
+  height="600px"
+  style="border:none;">
+</iframe>
+
+> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md
+
+Повний репозиторій бенчмарку можна знайти [тут](https://github.com/intlayer-org/benchmark-i18n/tree/main).
+
+## Вступ
+
+Рішення для інтернаціоналізації є одними з найважчих залежностей у додатку Svelte. Основний ризик полягає у відправці непотрібного контенту: перекладів для інших сторінок та інших локалей у бандлі одного маршруту.
+
+З ростом вашого додатка ця проблема може швидко збільшити обсяг JavaScript, що надсилається клієнту, і сповільнити навігацію.
+
+На практиці, для найменш оптимізованих реалізацій, інтернаціоналізована сторінка може виявитися в кілька разів важчою, ніж версія без i18n.
+
+Інший вплив стосується досвіду розробника (DX): як ви оголошуєте контент, типи, організацію просторів імен, динамічне завантаження та реактивність при зміні локалі.
+
+## TL;DR
+
+- **Intlayer**: Найефективніший за продуктивністю вибір (v8.7.12) з найменшим слідом (footprint).
+- **Paraglide**: Сильний претендент для tree-shaking, але має складніший досвід розробника та накладні витрати на реактивність.
+- **svelte-i18n**: Комплексний та стандартний для Svelte, але несе значно більшу вагу бандла (~7 разів більше за Intlayer).
+
+## Протестуйте свій додаток
+
+Щоб швидко виявити проблеми з витоком i18n, я налаштував безкоштовний сканер, доступний [тут](https://intlayer.org/i18n-seo-scanner).
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Проблема
+
+Два важелі є важливими для обмеження вартості багатомовного додатка:
+
+- Розділіть контент за сторінками / просторами імен, щоб не завантажувати цілі словники, коли вони не потрібні.
+- Завантажуйте потрібну локаль динамічно, тільки коли це необхідно.
+
+Розуміння технічних обмежень цих підходів:
+
+**Динамічне завантаження**
+
+Без динамічного завантаження більшість рішень зберігають повідомлення в пам'яті з першого рендеру, що додає значне навантаження для додатків з багатьма маршрутами та локалями.
+
+З динамічним завантаженням ви приймаєте компроміс: менше початкового JS, але іноді додатковий запит при зміні мови.
+
+**Поділ контенту (Splitting)**
+
+Синтаксис, побудований навколо `t('a.b.c')`, дуже зручний, але часто заохочує зберігати великі JSON-об'єкти під час виконання. Ця модель ускладнює tree-shaking, якщо бібліотека не пропонує реальної стратегії поділу на сторінки.
+
+## Методологія дослідження
+
+Для цього бенчмарку ми порівняли наступні бібліотеки:
+
+- `Base App` (Без бібліотеки i18n)
+- `svelte-intlayer` (v8.7.12)
+- `svelte-i18n` (v4.0.1)
+- `@inlang/paraglide-js` (v2.17.0)
+
+Фреймворк — `Svelte` з багатомовним додатком із **10 сторінок** і **10 мов**.
+
+Ми порівняли **чотири стратегії завантаження**:
+
+| Стратегія                  | Без просторів імен (глобально)                          | З просторами імен (scoped)                                                    |
+| :------------------------- | :------------------------------------------------------ | :---------------------------------------------------------------------------- |
+| **Статичне завантаження**  | **Static**: Все в пам'яті при запуску.                  | **Scoped static**: Розділено за просторами імен; все завантажено при запуску. |
+| **Динамічне завантаження** | **Dynamic**: Завантаження за запитом для кожної локалі. | **Scoped dynamic**: Детальне завантаження за простором імен та локаллю.       |
+
+## Підсумок стратегій
+
+- **Static**: Просто; немає затримки мережі після початкового завантаження. Мінус: великий розмір бандла.
+- **Dynamic**: Зменшує початкову вагу (lazy-loading). Ідеально, коли у вас багато локалей.
+- **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
+- **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
+
+## Результати детально
+
+### 1 — Рішення, яких слід уникати
+
+> В екосистемі Svelte немає очевидних рішень, яких слід уникати.
+
+### 2 — Прийнятні рішення
+
+**(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
+
+`Paraglide` пропонує інноваційний, добре продуманий підхід. У контексті додатка Vite + Svelte деревоподібне шейкінг (tree-shaking), яке рекламує їхня компанія, працювало як очікувалося, і це чудово.
+Але у випадку React + TanStack Start tree-shaking не спрацював як очікувалося, те саме для Next.js. Тим не менш, використання Paraglide у проєкті Svelte та TanStack Start варто було б перевірити ще раз.
+Робочий процес і DX також складніші за інші варіанти.
+Особисто я не прихильник того, щоб перегенерувати файли JS перед кожним пушем, що створює постійний ризик конфліктів при злитті через PR. Інструмент також здається більш зосередженим на Vite, ніж на Next.js.
+Нарешті, у порівнянні з іншими рішеннями, Paraglide не використовує стор (наприклад, Svelte store) для отримання поточної локалі для рендерингу контенту. Для кожного розібраного вузла він запитуватиме локаль з localStorage / cookie тощо. Це призводить до виконання непотрібної логіки, яка впливає на реактивність компонентів.
+
+> Примітка щодо 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 — Рекомендації
+
+**(Intlayer)** (`svelte-intlayer@8.7.12`):
+
+Я не буду особисто оцінювати `svelte-intlayer` заради об'єктивності, оскільки це моє власне рішення.
+
+### Особиста примітка
+
+Ця примітка є особистою і не впливає на результати бенчмарку. Тим не менш, у світі i18n часто можна побачити консенсус щодо патерну на кшталт `const t = useTranslation('xx')` + `<>{t('xx.xx')}</>` для перекладеного контенту.
+
+У додатках Svelte впорскування функції як `Slot`, на мій погляд, є антипатерном. Це також додає зайву складність та накладні витрати на виконання JavaScript (навіть якщо це ледь помітно).

package/docs/uk/benchmark/tanstack.md

@@ -57,6 +57,13 @@ history:
 
 Інший вплив стосується досвіду розробника (DX): як ви оголошуєте контент, типи, організація просторів імен, динамічне завантаження та реактивність при зміні мови.
 
+## TL;DR
+
+- **Intlayer**: Забезпечує найкращу продуктивність і найменший розмір бандла (v8.7.12) для TanStack Start.
+- **react-i18next** та **use-intl**: Зрілі альтернативи з великими екосистемами, але значно важчі та складніші в оптимізації.
+- **Paraglide**: Інноваційна ідея tree-shaking, яка не працює на практиці. Складний DX та накладні витрати реактивності в TanStack Start.
+- **Уникайте**: **General Translation (GT)** та **Lingo.dev** через серйозні проблеми з продуктивністю, ліміти ШІ та прив'язку до вендора (vendor lock-in).
+
 ## Протестуйте свій додаток
 
 Щоб швидко виявити проблеми з витоком i18n, я налаштував безкоштовний сканер, доступний [тут](https://intlayer.org/i18n-seo-scanner).
@@ -87,12 +94,12 @@ history:
 Для цього бенчмарку ми порівняли наступні бібліотеки:
 
 - `Base App` (Без бібліотеки i18n)
-- `react-intlayer` (v8.7.5-canary.0)
+- `react-intlayer` (v8.7.12)
 - `react-i18next` (v17.0.2)
 - `use-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
 - `@inlang/paraglide-js` (v2.15.1)
-- `tolgee` (v7.0.0)
+- `@tolgee/react` (v7.0.0)
 - `react-intl` (v10.1.1)
 - `wuchale` (v0.22.11)
 - `gt-react` (vlatest)
@@ -150,7 +157,9 @@ history:
 
 `Paraglide` пропонує інноваційний, добре продуманий підхід. Проте в цьому тесті рекламований компанією tree-shaking не спрацював ні для моєї реалізації на Next.js, ні для TanStack Start. Робочий процес і DX також складніші за інші варіанти. Особисто я не прихильник необхідності регенерувати JS-файли перед кожним пушем, що створює постійний ризик конфліктів під час злиття для розробників через PR.
 
-**(Tolgee)** (`tolgee@7.0.0`):
+> Примітка щодо paraglide: це рішення впорскує код у вашу кодову базу для імпорту; як наслідок, метрика 'lib size' у звіті бенчмарку становить майже 0. Генерація коду — це добре, оскільки використовувана функція включатиме лише необхідну логіку (префікс усюди проти відсутності префікса, куки проти сховища тощо). Для порівняння, Intlayer виконує це фільтрування за допомогою впорскування змінних оточення в збірку, щоб змусити бандлер виконати tree-shake контенту залежно від логіки. Завдяки цьому paraglide та intlayer врешті-решт стають у 6–10 разів легшими рішеннями, ніж i18next або next-intl.
+
+**(Tolgee)** (`@tolgee/react@7.0.0`):
 
 `Tolgee` вирішує багато зі згаданих проблем. Проте почати роботу з ним здалося мені важче, ніж з іншими інструментами з подібними підходами. Він не забезпечує типізацію, що значно ускладнює виявлення відсутніх ключів під час компіляції. Мені довелося обертати Tolgee API своїми рішеннями, щоб додати перевірку відсутніх ключів.
 

package/docs/uk/benchmark/vue.md

@@ -0,0 +1,160 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Найкраще i18n рішення для Vue у 2026 році — Звіт про бенчмарк
+description: Порівняйте бібліотеки інтернаціоналізації (i18n) для Vue, такі як vue-i18n, fluent-vue та Intlayer. Детальний звіт про продуктивність щодо розміру бандла, витоків та реактивності.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - vue
+  - продуктивність
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - vue
+author: Aymeric PINEAU
+applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
+history:
+  - version: 8.7.12
+    date: 2026-01-06
+    changes: "Ініціалізація бенчмарку"
+---
+
+# Бібліотеки i18n для Vue — Звіт про бенчмарк 2026
+
+Ця сторінка є звітом про бенчмарк рішень i18n на Vue.
+
+## Зміст
+
+<Toc/>
+
+## Інтерактивний бенчмарк
+
+<I18nBenchmark framework="vite-vue" vertical/>
+
+## Посилання на результати:
+
+<iframe 
+  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md" 
+  width="100%" 
+  height="600px"
+  style="border:none;">
+</iframe>
+
+> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md
+
+Повний репозиторій бенчмарку можна знайти [тут](https://github.com/intlayer-org/benchmark-i18n/tree/main).
+
+## Вступ
+
+Рішення для інтернаціоналізації є одними з найважчих залежностей у додатку Vue. Основний ризик полягає у відправці непотрібного контенту: перекладів для інших сторінок та інших локалей у бандлі одного маршруту.
+
+З ростом вашого додатка ця проблема може швидко збільшити обсяг JavaScript, що надсилається клієнту, і сповільнити навігацію.
+
+На практиці, для найменш оптимізованих реалізацій, інтернаціоналізована сторінка може виявитися в кілька разів важчою, ніж версія без i18n.
+
+Інший вплив стосується досвіду розробника (DX): як ви оголошуєте контент, типи, організацію просторів імен, динамічне завантаження та реактивність при зміні локалі.
+
+## TL;DR
+
+- **Intlayer**: Найлегше рішення (v8.7.12) з нативним скоупінгом (scoping) та динамічним завантаженням.
+- **vue-i18n**: Галузевий стандарт з багатою екосистемою, але може стати значно важчим і важчим для оптимізації під code-splitting у великих додатках.
+- **fluent-vue**: Інноваційна організація повідомлень, але не вистачає безпеки типів (type-safety) і виявляється надзвичайно важким рішенням.
+
+## Протестуйте свій додаток
+
+Щоб швидко виявити проблеми з витоком i18n, я налаштував безкоштовний сканер, доступний [тут](https://intlayer.org/i18n-seo-scanner).
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Проблема
+
+Два важелі є важливими для обмеження вартості багатомовного додатка:
+
+- Розділіть контент за сторінками / просторами імен, щоб не завантажувати цілі словники, коли вони не потрібні.
+- Завантажуйте потрібну локаль динамічно, тільки коли це необхідно.
+
+Розуміння технічних обмежень цих підходів:
+
+**Динамічне завантаження**
+
+Без динамічного завантаження більшість рішень зберігають повідомлення в пам'яті з першого рендеру, що додає значне навантаження для додатків з багатьма маршрутами та локалями.
+
+З динамічним завантаженням ви приймаєте компроміс: менше початкового JS, але іноді додатковий запит при зміні мови.
+
+**Поділ контенту (Splitting)**
+
+Синтаксис, побудований навколо `const { t } = useI18n()` + `t('a.b.c')`, дуже зручний, але часто заохочує зберігати великі JSON-об'єкти під час виконання. Ця модель ускладнює tree-shaking, якщо бібліотека не пропонує реальної стратегії поділу на сторінки.
+
+## Методологія дослідження
+
+Для цього бенчмарку ми порівняли наступні бібліотеки:
+
+- `Base App` (Без бібліотеки i18n)
+- `vue-intlayer` (v8.7.12)
+- `vue-i18n` (v11.4.0)
+- `fluent-vue` (v3.8.2)
+
+Фреймворк — `Vue` з багатомовним додатком із **10 сторінок** і **10 мов**.
+
+Ми порівняли **чотири стратегії завантаження**:
+
+| Стратегія                  | Без просторів імен (глобально)                          | З просторами імен (scoped)                                                    |
+| :------------------------- | :------------------------------------------------------ | :---------------------------------------------------------------------------- |
+| **Статичне завантаження**  | **Static**: Все в пам'яті при запуску.                  | **Scoped static**: Розділено за просторами імен; все завантажено при запуску. |
+| **Динамічне завантаження** | **Dynamic**: Завантаження за запитом для кожної локалі. | **Scoped dynamic**: Детальне завантаження за простором імен та локаллю.       |
+
+## Підсумок стратегій
+
+- **Static**: Просто; немає затримки мережі після початкового завантаження. Мінус: великий розмір бандла.
+- **Dynamic**: Зменшує початкову вагу (lazy-loading). Ідеально, коли у вас багато локалей.
+- **Scoped static**: Зберігає код організованим (логічне розділення) без складних додаткових мережевих запитів.
+- **Scoped dynamic**: Найкращий підхід для _code splitting_ та продуктивності. Мінімізує пам'ять, завантажуючи лише те, що потрібно поточному перегляду та активній локалі.
+
+### Що я вимірював:
+
+Я запустив той самий багатомовний додаток у реальному браузері для кожного стека, а потім записав, що насправді пройшло мережею і скільки часу це зайняло. Розміри вказані **після звичайного веб-стиснення**, оскільки це ближче до того, що люди насправді завантажують, ніж необроблена кількість рядків вихідного коду.
+
+- **Розмір бібліотеки інтернаціоналізації**: Після бандлінгу, tree-shaking та мініфікації розмір бібліотеки i18n — це розмір коду провайдерів + composables у порожньому компоненті. Він не включає завантаження файлів перекладу. Це відповідає на питання, наскільки "дорогою" є бібліотека до того, як ваш контент з'явиться в кадрі.
+
+- **JavaScript на сторінку**: Для кожного маршруту бенчмарку, скільки скриптів завантажує браузер для цього відвідування, усереднено за сторінками в наборі (і за локалями). Важкі сторінки — це повільні сторінки.
+
+- **Витік з інших локалей (Leakage)**: Це контент тієї ж сторінки, але іншою мовою, який помилково завантажується на сторінці, що перевіряється. Цей контент є непотрібним і його слід уникати (наприклад: контент сторінки `/fr/about` у бандлі сторінки `/en/about`).
+
+- **Витік з інших маршрутів**: Та ж ідея для **інших екранів** у додатку: чи додається їхній текст, коли ви відкрили лише одну сторінку (наприклад: контент сторінки `/en/about` у бандлі сторінки `/en/contact`). Високий бал вказує на слабкий поділ або занадто широкі бандли.
+
+- **Середній розмір бандла компонента**: Загальні елементи інтерфейсу вимірюються **по одному**, замість того щоб ховатися всередині одного гігантського числа додатка. Це показує, чи інтернаціоналізація непомітно роздуває повсякденні компоненти. Наприклад, якщо ваш компонент перерендерюється, він завантажуватиме всі ці дані з пам'яті. Прикріплення гігантського JSON до будь-якого компонента — це як підключення великого сховища невикористовуваних даних, що сповільнить продуктивність ваших компонентів.
+
+- **Швидкість реакції на зміну мови**: Я змінюю мову за допомогою власного контролера додатка і вимірюю час, поки сторінка чітко не зміниться — те, що помітить відвідувач.
+
+- **Робота рендерингу після зміни мови**: Більш точне спостереження: скільки зусиль доклав інтерфейс для перемальовування для нової мови після початку зміни. Корисно, коли "відчутний" час і витрати фреймворку розходяться.
+
+- **Час початкового завантаження сторінки**: Від навігації до моменту, коли браузер вважає сторінку повністю завантаженою для сценаріїв, які я тестував. Добре для порівняння холодних стартів.
+
+- **Час гідратації (Hydration)**: Час, який клієнт витрачає на перетворення серверного HTML на інтерактивний інтерфейс. Тире в таблицях означає, що ця реалізація не надала надійного показника гідратації в цьому бенчмарку.
+
+## Результати детально
+
+### 1 — Рішення, яких слід уникати
+
+> В екосистемі Vue немає очевидних рішень, яких слід уникати.
+
+### 2 — Прийнятні рішення
+
+**(vue-i18n)** (`vue-i18n@11.4.0`):
+
+- **vue-i18n** безперечно є найбільш використовуваною бібліотекою i18n для Vue, вона має багато функцій і величезну екосистему. Але "під капотом" рішення досить важке. Навіть якщо vue-i18n інтегрує lazy loading для повідомлень, у ній відсутня функція скоупінгу (scoping). У випадку класичного Vue SPA додатка проблем немає, але для nuxt додатка, що використовує @nuxt/i18n, це призводить до включення повідомлень з усіх сторінок в одну. Для великого nuxt додатка з понад 10 сторінками це може стати справді проблематичним.
+
+Пакет дуже важкий (~24.3kb, що приблизно в 9 разів більше за `vue-intlayer`).
+
+**(fluent-vue)** (`fluent-vue@0.5.0`):
+
+- **fluent-vue** пропонує спробу інновації через формат .ftl. Організація повідомлень чудова, легше почати роботу. Але на практиці відсутність безпеки типів підвищує ризик помилок і налагодження може швидко стати трудомістким. Більше того, це рішення завантажує повідомлення за допомогою плагіна vite, який змушує завантажувати весь контент усіма мовами на кожну сторінку. Крім того, це надзвичайно важке рішення (~92.7kb, що приблизно в 34 рази більше за `vue-intlayer`).
+
+### 3 — Рекомендації
+
+**(Intlayer)** (`vue-intlayer@8.7.12`):
+
+Я не буду особисто оцінювати `vue-intlayer` заради об'єктивності, оскільки це моє власне рішення.

package/docs/uk/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-03
+updatedAt: 2026-05-12
 title: Конфігурація
 description: Дізнайтеся, як налаштувати Intlayer для вашого додатка. Зрозумійте різні налаштування та параметри, доступні для адаптації Intlayer під ваші потреби.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "Додано підтримку провайдера LM Studio"
   - version: 8.7.0
     date: 2026-04-07
     changes: "Додано параметри `minify` та `prune` до конфігурації збірки"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * Використовуваний провайдер AI.
-     * Варіанти: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * Варіанти: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * За замовчуванням: 'openai'
      */
     provider: "openai",
@@ -916,16 +919,17 @@ Intlayer підтримує широкий спектр провайдерів A
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| Поле                 | Опис                                                                                                                              | Тип                                                                                                                                                                                                                                                                                                                                                                                            | За замовчуванням | Приклад                                                       | Примітки                                                                                                                                                                                          |
-| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | Провайдер, який використовуватиметься для функцій AI в Intlayer.                                                                  | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` | `undefined`      | `'anthropic'`                                                 | Різні провайдери вимагають різних API-ключів та мають різні ціни.                                                                                                                                 |
-| `model`              | Модель AI, яка використовуватиметься для функцій AI.                                                                              | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Немає            | `'gpt-4o-2024-11-20'`                                         | Конкретні моделі залежать від провайдера.                                                                                                                                                         |
-| `temperature`        | Контролює випадковість відповідей AI.                                                                                             | `number`                                                                                                                                                                                                                                                                                                                                                                                       | Немає            | `0.1`                                                         | Вища температура = креативніші та менш надійні відповіді.                                                                                                                                         |
-| `apiKey`             | Ваш API-ключ для вибраного провайдера.                                                                                            | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Немає            | `process.env.OPENAI_API_KEY`                                  | Повинно зберігатися в секреті; використовуйте змінні середовища.                                                                                                                                  |
-| `applicationContext` | Додатковий контекст про ваш додаток, щоб допомогти AI генерувати точніші переклади (домен, цільова аудиторія, тон, термінологія). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Немає            | `'мій власний контекст додатка'`                              | Може використовуватися для додавання правил (наприклад: `"Ви не повинні перекладати свої URL"` ).                                                                                                 |
-| `baseURL`            | Базовий URL для AI API.                                                                                                           | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Немає            | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Може вказувати на локальні або власні кінцеві точки AI API.                                                                                                                                       |
-| `dataSerialization`  | Формат серіалізації даних для функцій AI.                                                                                         | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined`      | `'toon'`                                                      | • `'json'`: за замовчуванням, надійний; використовує більше токенів.<br/>• `'toon'`: менше токенів, менш стабільно.<br/>• Передає моделі контекст як додатковий параметр (reasoning effort тощо). |
+- **LM Studio**
+
+| Поле                 | Опис                                                                                                                              | Тип                                                                                                                                                                                                                                                                                                                                                                                                                      | За замовчуванням | Приклад                                                       | Примітки                                                                                                                                                                                          |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Провайдер, який використовуватиметься для функцій AI в Intlayer.                                                                  | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` &#124; <br/> `'lmstudio'` | `undefined`      | `'anthropic'`                                                 | Різні провайдери вимагають різних API-ключів та мають різні ціни.                                                                                                                                 |
+| `model`              | Модель AI, яка використовуватиметься для функцій AI.                                                                              | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Немає            | `'gpt-4o-2024-11-20'`                                         | Конкретні моделі залежать від провайдера.                                                                                                                                                         |
+| `temperature`        | Контролює випадковість відповідей AI.                                                                                             | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | Немає            | `0.1`                                                         | Вища температура = креативніші та менш надійні відповіді.                                                                                                                                         |
+| `apiKey`             | Ваш API-ключ для вибраного провайдера.                                                                                            | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Немає            | `process.env.OPENAI_API_KEY`                                  | Повинно зберігатися в секреті; використовуйте змінні середовища.                                                                                                                                  |
+| `applicationContext` | Додатковий контекст про ваш додаток, щоб допомогти AI генерувати точніші переклади (домен, цільова аудиторія, тон, термінологія). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Немає            | `'мій власний контекст додатка'`                              | Може використовуватися для додавання правил (наприклад: `"Ви не повинні перекладати свої URL"` ).                                                                                                 |
+| `baseURL`            | Базовий URL для AI API.                                                                                                           | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Немає            | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Може вказувати на локальні або власні кінцеві точки AI API.                                                                                                                                       |
+| `dataSerialization`  | Формат серіалізації даних для функцій AI.                                                                                         | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined`      | `'toon'`                                                      | • `'json'`: за замовчуванням, надійний; використовує більше токенів.<br/>• `'toon'`: менше токенів, менш стабільно.<br/>• Передає моделі контекст як додатковий параметр (reasoning effort тощо). |
 
 ---