@intlayer/docs 9.4.4 → 9.5.1

package/docs/uk/bundle_optimization.md

@@ -133,8 +133,6 @@ export default config;
 
 > Purge і мініфікація виконуються лише під час `next build` — конвеєр оптимізації вимкнено під час `next dev`.
 
-> Вони також вимикаються, коли налаштовано викликачів з адаптерів сумісності (`swcExtraCallers`, які задають пакети сумісності, як-от `@intlayer/next-intl` чи `@intlayer/react-i18next`): ці місця виклику невидимі для аналізатора використання, тож purge видалив би поля, які код усе ще читає. Переписування імпортів залишається активним.
-
 **Раніші версії (до 9.2.1)** потребували `@intlayer/babel` і файл `babel.config.js`, що оголошує `intlayerPurgeBabelPlugin` та `intlayerMinifyBabelPlugin`. Цей файл більше не потрібен і його можна видалити.
 
  </Tab>

package/docs/uk/cli/index.md

@@ -70,14 +70,10 @@ author: aymericzip
 
 # Intlayer CLI - Усі команди Intlayer CLI для вашого багатомовного вебсайту
 
----
-
 ## Зміст
 
 <TOC/>
 
----
-
 ## Встановлення пакета
 
 Встановіть необхідні пакети за допомогою npm:

package/docs/uk/cli/login.md

@@ -20,8 +20,6 @@ author: aymericzip
 
 # Команда Intlayer CLI, login
 
----
-
 ## Опис
 
 Команда `login` Intlayer CLI дозволяє вам автентифікуватися в Intlayer CMS. Ця команда автоматично відкриває ваш браузер за замовчуванням для завершення процесу автентифікації та отримання необхідних облікових даних (Client ID та Client Secret) для використання сервісів Intlayer.

package/docs/uk/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-06-23
+updatedAt: 2026-09-08
 title: Intlayer Compiler | Автоматизоване витягування контенту для i18n
 description: Автоматизуйте процес інтернаціоналізації за допомогою Intlayer Compiler. Витягуйте контент безпосередньо з ваших компонентів для швидшого та ефективнішого i18n у Vite, Next.js та інших.
 keywords:
@@ -68,7 +68,7 @@ author: aymericzip
 
 ## Використання
 
-> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+> Найшвидший спосіб підключити компілятор — інтерактивне налаштування: запустіть `npx intlayer init --interactive` і виберіть **Compiler**. У Next.js та Vite він активується автоматично, щойно встановлено `compiler.enabled` і налаштовано шлях `compiler.output`.
 
 <Tabs>
  <Tab value='vite'>
@@ -92,19 +92,13 @@ import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [
-    intlayer({
-      proxy: {
-        ignore: (req) => req.url?.startsWith("/api"),
-      },
-    }),
-  ],
+  plugins: [intlayer()],
 });
 ```
 
 > Плагін `intlayerCompiler()` все ще експортується для розширених налаштувань. Реєстрація його разом з `intlayer()` є безпечною — компілятор дублює себе та запускається лише один раз.
 
-See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+See complete tutorial: [Translate Vite and React with Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react.md)
 
 #### Підтримка фреймворків
 
@@ -131,7 +125,33 @@ npm install @intlayer/svelte-compiler
  </Tab>
  <Tab value='nextjs'>
 
-### Next.js (Babel)
+### Next.js
+
+У Next.js компілятор працює як завантажувач бандлера, `next-intlayer/extractor-loader`. `withIntlayer` реєструє його для вас **як** у Turbopack, так і у webpack, писати `babel.config.js` не потрібно.
+
+#### Встановлення
+
+```bash
+npm install @intlayer/babel
+```
+
+#### Налаштування
+
+Нічого налаштовувати не потрібно. Поки ваш `next.config.ts` проходить через `withIntlayer`, встановлення `@intlayer/babel` достатньо для реєстрації завантажувача:
+
+```ts fileName="next.config.ts"
+import { withIntlayer } from "next-intlayer/server";
+
+export default withIntlayer({});
+```
+
+Завантажувач виконується для файлів `.tsx` і `.jsx` перед `next-swc-loader`, тому він читає ваш вихідний JSX. Вміст, оголошений у ваших компонентах, витягується у файли `.content` і збирається в `.intlayer` під час компіляції файлу.
+
+</Tab>
+
+ <Tab value="Babel">
+
+### Babel
 
 Для Next.js або інших додатків на базі Webpack, що використовують Babel, ви можете налаштувати компілятор за допомогою плагіна `@intlayer/babel`.
 
@@ -166,8 +186,6 @@ module.exports = {
 
 Ця конфігурація гарантує, що контент, оголошений у ваших компонентах, буде автоматично витягнутий і використаний для генерації словників під час процесу збірки.
 
-See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
-
  </Tab>
 </Tabs>
 

package/docs/uk/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Конфігураційні файли Intlayer дозволяють налаштовувати різні аспекти плагіна, такі як інтернаціоналізація (i18n), проміжне ПЗ та керування контентом. Цей документ містить детальний опис кожної властивості в конфігурації.
 
----
-
 ## Зміст
 
 <TOC/>
 
----
-
 ## Підтримка конфігураційних файлів
 
 Intlayer приймає формати конфігураційних файлів JSON, JS, MJS та TS:
@@ -143,8 +139,6 @@ Intlayer приймає формати конфігураційних файлі
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Приклад конфігураційного файлу
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -696,14 +690,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Довідник з конфігурації
 
 Нижче наведено детальний опис різних характеристик конфігурації, доступних в Intlayer.
 
----
-
 ### Конфігурація інтернаціоналізації (Internationalization)
 
 Визначає налаштування, пов'язані з інтернаціоналізацією, включаючи доступні локалі та локаль за замовчуванням.
@@ -715,8 +705,6 @@ export default config;
 | `strictMode`      | Забезпечує суворе впровадження інтернаціоналізованого контенту за допомогою TypeScript.       | `string`   | `'inclusive'`       |                      | • Якщо `"strict"`: Обов'язкове визначення кожної оголошеної локалі для функції `t` - помилка в разі відсутності або неоголошеної локалі.<br/>• Якщо `"inclusive"`: Попередження для відсутніх локалей, але дозволяє використання існуючих неоголошених локалей.<br/>• Якщо `"loose"`: Приймає будь-яку існуючу локаль. |
 | `defaultLocale`   | Локаль за замовчуванням, яка використовується як резервна, якщо запитувана локаль недоступна. | `string`   | `Locales.ENGLISH`   | `'en'`               | Використовується для визначення локалі, якщо її не вказано в URL, файлах cookie або заголовку.                                                                                                                                                                                                                         |
 
----
-
 ### Конфігурація редактора (Editor)
 
 Визначає налаштування для візуального редактора, включаючи порт сервера та статус активації.
@@ -748,8 +736,6 @@ export default config;
 | `flushInterval` | Мілісекунди між автоматичними пакетними відправками на бекенд.         | `number`  | `20000`          | `10000` |                                                                                                                                                                                      |
 | `sampleRate`    | Частка сеансів для запису, від `0` (жодного) до `1` (усі).             | `number`  | `1`              | `0.5`   | Вибірка є детермінованою для кожного сеансу, тому записаний сеанс повідомляє про всі свої події (без часткових воронок).                                                             |
 
----
-
 ### Конфігурація маршрутизації (Routing)
 
 Налаштування для контролю поведінки маршрутизації, включаючи структуру URL, зберігання локалі та керування проміжним ПЗ.
@@ -951,8 +937,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### Конфігурація контенту (Content)
 
 Налаштування керування контентом у вашому додатку, включаючи назви директорій, розширення файлів та похідні конфігурації.
@@ -966,8 +950,6 @@ export default config;
 | `excludedPath`   | Директорії, які слід виключити зі сканування контенту.                                               | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Наразі не використовується; заплановано на майбутнє.                                                                                                                  |
 | `formatCommand`  | Команда для форматування файлів контенту, коли Intlayer записує їх локально.                         | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` буде замінено на шлях до файлу.<br/>• Якщо не визначено, Intlayer спробує визначити автоматично (тестує prettier, biome, eslint).                        |
 
----
-
 ### Конфігурація системи
 
 Параметри, пов'язані з внутрішніми шляхами та результатами виведення Intlayer. Ці параметри зазвичай є внутрішніми і не повинні потребувати змін користувачем.
@@ -1022,8 +1004,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Конфігурація логера (Log)
 
 Параметри для налаштування виводу логів Intlayer.
@@ -1094,8 +1074,6 @@ Intlayer підтримує широкий спектр провайдерів A
 | `outputFormat`        | Керує форматом виводу словників.                                                                                                  | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `traversePattern`     | Шаблон для файлів, які слід сканувати під час оптимізації.                                                                        | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Покращує продуктивність збірки, обмежуючи оптимізацію відповідними файлами.<br/>• Ігнорується, якщо `optimize` вимкнено.<br/>• Використовує glob-патерни.                                                                                                                                                                                                                                                                                                                                                                                       |
 
----
-
 ### Конфігурація компілятора (Compiler)
 
 Керує налаштуваннями компілятора Intlayer, який збирає словники безпосередньо з ваших компонентів.
@@ -1115,8 +1093,6 @@ Intlayer підтримує широкий спектр провайдерів A
 | --------- | --------------------------------------------------------------------- | --------------------------- |
 | `schemas` | Дозволяє визначати Zod-схеми для валідації структури ваших словників. | `Record<string, ZodSchema>` |
 
----
-
 ### Плагіни (Plugins)
 
 | Поле      | Опис                                         | Тип                |
@@ -1132,25 +1108,21 @@ Intlayer підтримує широкий спектр провайдерів A
 У кореневому каталозі проекту, поруч із `package.json`. Intlayer сканує робочий каталог і батьківські каталоги на наявність `intlayer.config.ts`, `intlayer.config.js`, `intlayer.config.mjs` або `intlayer.config.cjs`. Ви також можете передати власний шлях через прапорець `--config` у командах CLI.
 
 </Question>
-
 <Question title="Скільки i18n додає до розміру бандла?">
 
 Значно менше, ніж рішення на основі просторів імен (namespaces), оскільки сторінка ніколи не завантажує каталог, який вона не рендерить. Розмітка, що рендериться на сервері, отримує свій контент безпосередньо на сервері, а компілятор під час збирання замінює виклики `useIntlayer` точними записами словника, які використовує компонент, тому невикористані ключі та мови видаляються. [Динамічні словники](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md) розділяють залишок за окремими локалями. У порівнянні зі звичними альтернативами Intlayer зменшує розмір бандла та сторінки до 50%. Див. [оптимізацію бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md) та [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/benchmark/index.md).
 
 </Question>
-
 <Question title="Чи можу я мігрувати з i18next, next-intl або react-i18next без переписування моїх компонентів?">
 
 Так, і для цього є два шляхи. Ви можете переносити контент поступово, користуючись [посібником з міграції з i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_i18next_to_intlayer.md) або [посібником з міграції з next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_next-intl_to_intlayer.md). Або ви можете повністю зберегти свій поточний API: [адаптери сумісності](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md) надають абсолютно той самий інтерфейс, що й `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` та `Lingui`, але дані беруться зі словників Intlayer, завдяки чому змінюються лише імпорти, а код компонентів залишається незмінним.
 
 </Question>
-
 <Question title="Чи можу я зберігати мої існуючі JSON файли перекладів?">
 
 Так. [sync JSON плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md) зберігає ваші файли `/messages/{locale}/{namespace}.json` як джерело істини та генерує словники Intlayer з них в обох напрямках. [sync PO плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-po.md) робить те ж саме для gettext каталогів, а [файли для окремих локалей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/per_locale_file.md) дозволяють розділити контент за мовами замість групування локалей в один файл.
 
 </Question>
-
 <Question title="Чи потрібно переносити вміст ключ за ключем?">
 
 Ні. Запустіть `npx intlayer extract`, і Intlayer прочитає ваші файли, витягне призначені для користувача рядки і створить файл `.content` поруч із кожним компонентом, завдяки чому ви переглядаєте diff замість копіювання рядків у каталог вручну. Див. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md).
@@ -1158,7 +1130,6 @@ Intlayer підтримує широкий спектр провайдерів A
 Для повністю автоматизованого робочого процесу [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compiler.md) робить те саме під час збирання у коді JSX, TSX, Vue та Svelte, генеруючи словники під час кожної зміни, тому вручну підтримувати ключі не потрібно. Оскільки він працює через статичний аналіз, динамічні рядки середовища виконання залишаються поза його досяжністю.
 
 </Question>
-
 <Question title="Які інструменти для редактора та AI агентів доступні?">
 
 П'ять інструментів, усі опціональні:
@@ -1170,49 +1141,41 @@ Intlayer підтримує широкий спектр провайдерів A
 - **[Плагін ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/eslint.md)**: правило `no-raw-text` відстежує жорстко закодовані рядки.
 
 </Question>
-
 <Question title="Як додати нову мову до мого додатку?">
 
 Додайте код локалі до масиву `internationalization.locales`, а потім запустіть `npx intlayer fill`, щоб автоматично перекласти наявний контент. Компілятор врахує нову мову під час наступного збирання.
 
 </Question>
-
 <Question title="Як видалити префікс локалі з моїх адрес URL?">
 
 Налаштуйте `routing.mode`. Значення `"no-prefix"` видаляє префікс для всіх мов, визначаючи локаль через cookie, заголовок або домен. Значення `"prefix-no-default"` (за замовчуванням) приховує префікс тільки для основної мови.
 
 </Question>
-
 <Question title="Чи можу я обслуговувати кожну мову з власного домену?">
 
 Так. Опція `routing.domains` прив'язує кожну локаль до хоста, наприклад `{ uk: 'example.ua', en: 'example.com' }`. Визначення за доменом має пріоритет над префіксами шляху, а `getMultilingualUrls` генерує повні адреси для `hreflang`.
 
 </Question>
-
 <Question title="Як визначається мова користувача?">
 
 Через `routing.storage`, де перелічені джерела за порядком пріоритету: зазвичай спочатку URL, далі cookie, потім заголовок `Accept-Language`, а в разі їх відсутності - мова за замовчуванням.
 
 </Question>
-
 <Question title="Що робить routing.enableProxy?">
 
 Керує проксі маршрутизації локалей - middleware, що обробляє префікси та редиректи. За замовчуванням проксі активне у режимах dev та production. Встановіть `false`, якщо керуєте адресами власноруч.
 
 </Question>
-
 <Question title="У чому різниця між importMode static, dynamic та fetch?">
 
 Значення `"static"` (за замовчуванням) імпортує словники статично, тому вони пакуються в бандл і читаються синхронно. `"dynamic"` завантажує словники асинхронно для кожної мови, полегшуючи початковий бандл. `"fetch"` отримує словники з сервера або CMS під час виконання.
 
 </Question>
-
 <Question title="Де встановити AI провайдера та ключ API для автоматичного перекладу?">
 
 У файлі конфігурації в секції `ai` або в командному рядку за допомогою прапорців `--provider`, `--model` та `--api-key`. Ключ залишається на вашому боці й ніколи не залишає вашого оточення. Див. [довідник конфігурації AI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
 
 </Question>
-
 <Question title="Чи потрібно перезапускати сервер розробки після зміни конфігурації?">
 
 Зазвичай ні. Watcher Intlayer відстежує файл `intlayer.config.ts`: під час збереження він перезавантажує налаштування та оновлює словники у фоновому режимі.

package/docs/uk/dictionary/html.md

@@ -120,8 +120,6 @@ const myContent = html(
 
 При використанні методу `.use()` для HTML-вузла надані вами компоненти будуть перевірятися на відповідність визначенню, вказаному у функції `html()` (якщо воно доступне).
 
----
-
 ## Відтворення HTML
 
 Відтворення може виконуватися автоматично системою контенту Intlayer або вручну за допомогою спеціалізованих інструментів.
@@ -475,8 +473,6 @@ const myContent = html(
   </Tab>
 </Tabs>
 
----
-
 ### Ручне відтворення та розширені інструменти
 
 Якщо вам потрібно відтворити сирі HTML-рядки або ви хочете більше контролю над мапуванням компонентів, використовуйте наступні інструменти.
@@ -649,8 +645,6 @@ const myContent = html(
   </Tab>
 </Tabs>
 
----
-
 ## Довідник опцій
 
 Ці опції можна передавати в `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` та `renderHTML`.

package/docs/uk/dictionary/markdown.md

@@ -1171,8 +1171,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Рендеринг на стороні сервера (SSR) та гідратація
 
 У порівнянні з іншими парсерами Markdown, такими як remark / rehype, Intlayer Markdown не має залежностей і працює як на клієнті, так і на сервері.

package/docs/uk/how_works_intlayer.md

@@ -267,25 +267,21 @@ The `@intlayer/api` package is an API SDK to interact with the backend.
 Під час збирання. Плагін Intlayer сканує файли `.content.ts`, компілює їх в оптимізовані словники та записує до теки `.intlayer`. У середовищі розробки цей процес виконується миттєво при кожному збереженні файлу.
 
 </Question>
-
 <Question title="Скільки i18n додає до розміру бандла?">
 
 Значно менше, ніж рішення на основі просторів імен (namespaces), оскільки сторінка ніколи не завантажує каталог, який вона не рендерить. Розмітка, що рендериться на сервері, отримує свій контент безпосередньо на сервері, а компілятор під час збирання замінює виклики `useIntlayer` точними записами словника, які використовує компонент, тому невикористані ключі та мови видаляються. [Динамічні словники](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md) розділяють залишок за окремими локалями. У порівнянні зі звичними альтернативами Intlayer зменшує розмір бандла та сторінки до 50%. Див. [оптимізацію бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md) та [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/benchmark/index.md).
 
 </Question>
-
 <Question title="Чи можу я мігрувати з i18next, next-intl або react-i18next без переписування моїх компонентів?">
 
 Так, і для цього є два шляхи. Ви можете переносити контент поступово, користуючись [посібником з міграції з i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_i18next_to_intlayer.md) або [посібником з міграції з next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_next-intl_to_intlayer.md). Або ви можете повністю зберегти свій поточний API: [адаптери сумісності](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md) надають абсолютно той самий інтерфейс, що й `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` та `Lingui`, але дані беруться зі словників Intlayer, завдяки чому змінюються лише імпорти, а код компонентів залишається незмінним.
 
 </Question>
-
 <Question title="Чи можу я зберігати мої існуючі JSON файли перекладів?">
 
 Так. [sync JSON плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md) зберігає ваші файли `/messages/{locale}/{namespace}.json` як джерело істини та генерує словники Intlayer з них в обох напрямках. [sync PO плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-po.md) робить те ж саме для gettext каталогів, а [файли для окремих локалей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/per_locale_file.md) дозволяють розділити контент за мовами замість групування локалей в один файл.
 
 </Question>
-
 <Question title="Чи потрібно переносити вміст ключ за ключем?">
 
 Ні. Запустіть `npx intlayer extract`, і Intlayer прочитає ваші файли, витягне призначені для користувача рядки і створить файл `.content` поруч із кожним компонентом, завдяки чому ви переглядаєте diff замість копіювання рядків у каталог вручну. Див. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md).
@@ -293,7 +289,6 @@ The `@intlayer/api` package is an API SDK to interact with the backend.
 Для повністю автоматизованого робочого процесу [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compiler.md) робить те саме під час збирання у коді JSX, TSX, Vue та Svelte, генеруючи словники під час кожної зміни, тому вручну підтримувати ключі не потрібно. Оскільки він працює через статичний аналіз, динамічні рядки середовища виконання залишаються поза його досяжністю.
 
 </Question>
-
 <Question title="Які інструменти для редактора та AI агентів доступні?">
 
 П'ять інструментів, усі опціональні:
@@ -305,43 +300,36 @@ The `@intlayer/api` package is an API SDK to interact with the backend.
 - **[Плагін ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/eslint.md)**: правило `no-raw-text` відстежує жорстко закодовані рядки.
 
 </Question>
-
 <Question title="Що таке тека .intlayer і чи слід комітити її в git?">
 
 Це скомпільований результат: згенеровані словники та типи TypeScript. Вона повністю генерується з ваших файлів вмісту, тому її слід додати до `.gitignore` і збирати в CI/CD за допомогою команди `intlayer build`.
 
 </Question>
-
 <Question title="Як визначається активна локаль?">
 
 З джерел, зазначених у `routing.storage`, за чергою: префікс URL, файл cookie, заголовок `Accept-Language` та мова за замовчуванням.
 
 </Question>
-
 <Question title="У чому різниця між локальними та віддаленими словниками?">
 
 Локальний словник оголошується у вашій кодовій базі та компілюється разом із додатком. Віддалений словник керується в CMS і підтягується через API, що дозволяє оновлювати тексти без повторного збирання додатку.
 
 </Question>
-
 <Question title="Чи працює Intlayer без TypeScript?">
 
 Так. Файли вмісту можна писати на TypeScript, JavaScript, ESM, CommonJS або JSON. Проте саме TypeScript забезпечує строгу типізацію та автодоповнення ключів у вашому редакторі.
 
 </Question>
-
 <Question title="Як серверний рендеринг і клієнтський рендеринг ділять один і той самий контент?">
 
 Сервер вирішує вміст компонентів, що рендеряться на стороні сервера, напряму, тому для них клієнту не відправляється жодних словників. Клієнтські компоненти отримують лише ті словники, які потрібні для інтерактивності в браузері.
 
 </Question>
-
 <Question title="Як Intlayer уникає помилок гідратації (hydration mismatch), пов'язаних із мовою?">
 
 Мова визначається один раз на сервері й передається клієнтському провайдеру замість повторного визначення в браузері, що гарантує повну відповідність серверного та клієнтського HTML.
 
 </Question>
-
 <Question title="Чи потрібно перезбирати додаток під час додавання перекладу?">
 
 У режимі розробки ні: плагін відстежує файли та оновлює словники на льоту. У продакшні так: локальні словники вбудовуються в кінцеві файли під час етапу збирання.

package/docs/uk/interest_of_intlayer.md

@@ -44,43 +44,36 @@ author: aymericzip
 Замість того, щоб завантажувати великі файли JSON на свої сторінки, завантажуйте лише необхідний вміст. Intlayer допомагає **зменшити розмір бандлу і сторінок до 50%**.
 
 </Accordion>
-
 <Accordion header="Підтримуваність">
 
 Організація вмісту за окремими областями (scoping) **полегшує технічне обслуговування** великомасштабних програм. Ви можете скопіювати або видалити окрему папку функцій без розумового навантаження перегляду всієї кодової бази вмісту. Крім того, Intlayer **повністю типізований (fully typed)**, щоб забезпечити точність вашого вмісту.
 
 </Accordion>
-
 <Accordion header="Агент AI">
 
 Спільне розміщення вмісту **зменшує контекст, необхідний** для великих мовних моделей (LLM). Intlayer також постачається з набором інструментів, наприклад **CLI** для перевірки відсутніх перекладів,**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** і **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/agent_skills.md)**, щоб зробити роботу розробника (DX) ще зручнішою для агентів ШІ.
 
 </Accordion>
-
 <Accordion header="Функція">
 
 Intlayer пропонує низку додаткових функцій, яких немає в інших рішеннях i18n, як-от [підтримка Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/markdown.md), [отримання зовнішніх вміст](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/function_fetching.md), [завантаження вмісту файлу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/file.md), [живий вміст оновлення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/live.md), [візуальний редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md) тощо.
 
 </Accordion>
-
 <Accordion header="Автоматизація">
 
 Використовуйте автоматизацію для перекладу в конвеєрі CI/CD за допомогою LLM за вашим вибором за рахунок вашого постачальника штучного інтелекту. Intlayer також пропонує **компілятор** для автоматизації екстракція вмісту, а також [веб-платформу](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md), щоб допомогти **перекладати у фоновому режимі**.
 
 </Accordion>
-
 <Accordion header="Продуктивність">
 
 Підключення великих файлів JSON до компонентів може призвести до проблем з продуктивністю та реакцією. Intlayer оптимізує завантаження вмісту під час збірки (build time).
 
 </Accordion>
-
 <Accordion header="Співпраця з не-розробниками">
 
 Більше ніж просто рішення i18n, Intlayer пропонує **власний [візуальний редактор](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** і **[повний CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, щоб допомогти вам керувати своїм багатомовним вмістом у **реальному часі**, спрощуючи співпрацю з перекладачами, копірайтерами та іншими членами команди. Контент можна зберігати локально та/або віддалено.
 
 </Accordion>
-
 <Accordion header="Крос фреймворк дизайн">
 
 Якщо ви використовуєте різні фреймворки для різних частин вашої програми (наприклад, React, React-native, Vue, Angular, Svelte тощо), Intlayer надає спосіб **використовувати загальний синатаксис і реалізацію в усіх основних інтерфейсних фреймворках**. Ви також зможете поділитися своєю декларацією вмісту у своїй системі дизайну, програмах, серверній частині тощо.
@@ -284,8 +277,6 @@ export const ComponentExample = () => {
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
----
-
 ## Взаємосумісність
 
 `intlayer` також може допомогти в управлінні просторами назв `react-intl`, `react-i18next`, `next-intl`, `next-i18next` та `vue-i18n`.
@@ -307,25 +298,21 @@ export const ComponentExample = () => {
 - **Бібліотеки з шаром контенту (Content layer)**: `Intlayer`. Оголошення поруч із компонентом, tree-shaking, типи TypeScript, переклад за допомогою AI та візуальний редактор.
 
 </Question>
-
 <Question title="Скільки i18n додає до розміру бандла?">
 
 Значно менше, ніж рішення на основі просторів імен (namespaces), оскільки сторінка ніколи не завантажує каталог, який вона не рендерить. Розмітка, що рендериться на сервері, отримує свій контент безпосередньо на сервері, а компілятор під час збирання замінює виклики `useIntlayer` точними записами словника, які використовує компонент, тому невикористані ключі та мови видаляються. [Динамічні словники](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dynamic_dictionaries/index.md) розділяють залишок за окремими локалями. У порівнянні зі звичними альтернативами Intlayer зменшує розмір бандла та сторінки до 50%. Див. [оптимізацію бандла](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/bundle_optimization.md) та [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/benchmark/index.md).
 
 </Question>
-
 <Question title="Чи можу я мігрувати з i18next, next-intl або react-i18next без переписування моїх компонентів?">
 
 Так, і для цього є два шляхи. Ви можете переносити контент поступово, користуючись [посібником з міграції з i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_i18next_to_intlayer.md) або [посібником з міграції з next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/migration_from_next-intl_to_intlayer.md). Або ви можете повністю зберегти свій поточний API: [адаптери сумісності](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compat/index.md) надають абсолютно той самий інтерфейс, що й `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` та `Lingui`, але дані беруться зі словників Intlayer, завдяки чому змінюються лише імпорти, а код компонентів залишається незмінним.
 
 </Question>
-
 <Question title="Чи можу я зберігати мої існуючі JSON файли перекладів?">
 
 Так. [sync JSON плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-json.md) зберігає ваші файли `/messages/{locale}/{namespace}.json` як джерело істини та генерує словники Intlayer з них в обох напрямках. [sync PO плагін](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/plugins/sync-po.md) робить те ж саме для gettext каталогів, а [файли для окремих локалей](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/per_locale_file.md) дозволяють розділити контент за мовами замість групування локалей в один файл.
 
 </Question>
-
 <Question title="Чи потрібно переносити вміст ключ за ключем?">
 
 Ні. Запустіть `npx intlayer extract`, і Intlayer прочитає ваші файли, витягне призначені для користувача рядки і створить файл `.content` поруч із кожним компонентом, завдяки чому ви переглядаєте diff замість копіювання рядків у каталог вручну. Див. [команду extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/extract.md).
@@ -333,7 +320,6 @@ export const ComponentExample = () => {
 Для повністю автоматизованого робочого процесу [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/compiler.md) робить те саме під час збирання у коді JSX, TSX, Vue та Svelte, генеруючи словники під час кожної зміни, тому вручну підтримувати ключі не потрібно. Оскільки він працює через статичний аналіз, динамічні рядки середовища виконання залишаються поза його досяжністю.
 
 </Question>
-
 <Question title="Які інструменти для редактора та AI агентів доступні?">
 
 П'ять інструментів, усі опціональні:
@@ -345,43 +331,36 @@ export const ComponentExample = () => {
 - **[Плагін ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/eslint.md)**: правило `no-raw-text` відстежує жорстко закодовані рядки.
 
 </Question>
-
 <Question title="Чим Intlayer відрізняється від next-intl?">
 
 `next-intl` - це шар повідомлень для Next.js, заснований на JSON файлах під кожну мову. Intlayer оголошує вміст безпосередньо біля компонента, видаляє невикористані ключі під час збирання, створює суворі типи TypeScript для кожного словника і надає вбудований переклад AI та візуальний редактор.
 
 </Question>
-
 <Question title="Чим Intlayer відрізняється від i18next та react-i18next?">
 
 `i18next` вирішує рядкові ключі під час виконання, що у разі помилки в назві ключа призводить до порожнього тексту на екрані. Intlayer перевіряє ключі статично під час компіляції, виключає непотрібні мови з бандла та автоматизує процес перекладу.
 
 </Question>
-
 <Question title="Чи є Intlayer швидшим або легшим за альтернативи?">
 
 Щодо розміру бандла та сторінки - так: відмова від завантаження непотрібних сторінці каталогів скорочує обсяг бандла до 50%. Щодо швидкодії - попередня компіляція усуває витрати на парсинг у runtime. Див. [бенчмарк](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/benchmark/index.md).
 
 </Question>
-
 <Question title="Чи варто мігрувати наявний додаток?">
 
 Це залежить від поточних проблем. Якщо вам заважає великий розмір бандла, пропущені переклади чи труднощі нетехнічних спеціалістів із редагуванням текстів, Intlayer вирішує ці задачі, а адаптери сумісності дозволяють мігрувати поступово без переписування коду.
 
 </Question>
-
 <Question title="Що пропонує Intlayer, чого немає в інших бібліотеках i18n?">
 
 Підтримку [Markdown вмісту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/markdown.md), завантаження контенту з CMS, інтегрований візуальний редактор, автоматичний переклад через AI з прапорцем `--git-diff` та автодоповнення TypeScript на основі структури компонентів.
 
 </Question>
-
 <Question title="Чи можу я використовувати Intlayer лише як менеджер перекладів і зберегти поточну бібліотеку?">
 
 Так. Intlayer може генерувати простори імен у форматі та шляху, очікуваному вашою поточною бібліотекою (наприклад `/messages/{locale}/{namespace}.json`), що дозволяє використовувати CLI та редактор Intlayer без зміни коду додатку.
 
 </Question>
-
 <Question title="Чи є Intlayer безкоштовним та відкритим кодом?">
 
 Так, під ліцензією Apache 2.0, включно з комерційним використанням. Хмарна CMS - це додаткова послуга, яку також можна [розгорнути на власному сервері](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/self_hosting.md).