@intlayer/docs 8.1.6 → 8.1.8

package/docs/uk/cli/login.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-16
 updatedAt: 2025-12-16
-title: CLI — команда login
+title: CLI, команда login
 description: Дізнайтеся, як використовувати команду login Intlayer CLI для автентифікації в Intlayer CMS та отримання облікових даних доступу.
 keywords:
   - CLI
@@ -17,7 +17,7 @@ slugs:
   - login
 ---
 
-# Команда Intlayer CLI — login
+# Команда Intlayer CLI, login
 
 ---
 

package/docs/uk/cli/sdk.md

@@ -17,7 +17,7 @@ slugs:
 
 # SDK для CLI
 
-CLI SDK — це бібліотека, яка дозволяє використовувати Intlayer CLI у вашому власному коді.
+CLI SDK, це бібліотека, яка дозволяє використовувати Intlayer CLI у вашому власному коді.
 
 ```bash packageManager="npm"
 npm install @intlayer/cli --save-dev

package/docs/uk/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2026-02-25
 title: Intlayer Compiler | Автоматизоване витягування контенту для i18n
 description: Автоматизуйте процес інтернаціоналізації за допомогою Intlayer Compiler. Витягуйте контент безпосередньо з ваших компонентів для швидшого та ефективнішого i18n у Vite, Next.js та інших.
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Оновлення опцій компілятора
   - version: 7.3.1
     date: 2025-11-27
     changes: Випуск компілятора
@@ -29,7 +32,7 @@ history:
 
 ## Що таке Intlayer Compiler?
 
-The **Intlayer Compiler** — потужний інструмент, створений для автоматизації процесу інтернаціоналізації (i18n) у ваших додатках. Він сканує ваш вихідний код (JSX, TSX, Vue, Svelte) на наявність декларацій контенту, витягує їх і автоматично генерує необхідні файли словників. Це дозволяє зберігати контент поруч із компонентами, у той час як Intlayer займається керуванням та синхронізацією ваших словників.
+The **Intlayer Compiler**, потужний інструмент, створений для автоматизації процесу інтернаціоналізації (i18n) у ваших додатках. Він сканує ваш вихідний код (JSX, TSX, Vue, Svelte) на наявність декларацій контенту, витягує їх і автоматично генерує необхідні файли словників. Це дозволяє зберігати контент поруч із компонентами, у той час як Intlayer займається керуванням та синхронізацією ваших словників.
 
 ## Чому використовувати Intlayer Compiler?
 
@@ -44,7 +47,7 @@ The **Intlayer Compiler** — потужний інструмент, створ
 
 Хоча компілятор надає відмінний досвід «just works», він також запроваджує певні компроміси, про які слід знати:
 
-- **Heuristic ambiguity**: Компилятор має вгадувати, який контент призначений для користувача, а що — логіка додатка (наприклад, `className="active"`, коди статусу, ідентифікатори продуктів). У складних кодових базах це може призводити до хибних спрацьовувань або пропущених рядків, що вимагатимуть ручних анотацій та винятків.
+- **Heuristic ambiguity**: Компилятор має вгадувати, який контент призначений для користувача, а що, логіка додатка (наприклад, `className="active"`, коди статусу, ідентифікатори продуктів). У складних кодових базах це може призводити до хибних спрацьовувань або пропущених рядків, що вимагатимуть ручних анотацій та винятків.
 - **Static-only extraction**: Екстракція на основі компілятора спирається на статичний аналіз. Рядки, які існують лише під час виконання (коди помилок API, поля CMS тощо), не можуть бути виявлені або перекладені лише компілятором, тому вам усе одно потрібна додаткова стратегія i18n на рівні виконання.
 
 Для більш глибокого архітектурного порівняння див. публікацію в блозі [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/uk/compiler_vs_declarative_i18n.md).
@@ -53,9 +56,12 @@ The **Intlayer Compiler** — потужний інструмент, створ
 
 ## Використання
 
+<Tabs>
+ <Tab value='vite'>
+
 ### Vite
 
-Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор — через плагін `vite-intlayer`.
+Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор, через плагін `vite-intlayer`.
 
 #### Встановлення
 
@@ -79,6 +85,8 @@ export default defineConfig({
 });
 ```
 
+See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+
 #### Підтримка фреймворків
 
 Плагін Vite автоматично визначає та обробляє різні типи файлів:
@@ -97,6 +105,9 @@ npm install @intlayer/vue-compiler
 npm install @intlayer/svelte-compiler
 ```
 
+ </Tab>
+ <Tab value='nextjs'>
+
 ### Next.js (Babel)
 
 Для Next.js або інших додатків на базі Webpack, що використовують Babel, ви можете налаштувати компілятор за допомогою плагіна `@intlayer/babel`.
@@ -131,3 +142,70 @@ 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>
+
+### Користувацька конфігурація
+
+Щоб налаштувати поведінку компілятора, ви можете оновити файл `intlayer.config.ts` у корені вашого проєкту.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    /**
+     * Вказує, чи має бути увімкнено компілятор.
+     * Встановіть 'build-only', щоб пропустити компілятор під час розробки та пришвидшити час запуску.
+     */
+    enabled: true,
+
+    /**
+     * Паттерн для обходу коду для оптимізації.
+     */
+    transformPattern: [
+      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
+      "!**/node_modules/**",
+    ],
+
+    /**
+     * Паттерн для виключення з оптимізації.
+     */
+    excludePattern: ["**/node_modules/**"],
+
+    /**
+     * Вихідний каталог для оптимізованих словників.
+     */
+    outputDir: "i18n",
+
+    /**
+     * Префікс ключа словника
+     */
+    dictionaryKeyPrefix: "", // Видалити базовий префікс
+
+    /**
+     * Вказує, чи мають компоненти зберігатися після перетворення.
+     * Таким чином, компілятор можна запустити лише один раз для перетворення додатка, а потім його можна видалити.
+     */
+    saveComponents: false,
+  },
+};
+
+export default config;
+```
+
+### Заповнити відсутні переклади
+
+Intlayer надає інструмент CLI, який допоможе вам заповнити відсутні переклади. Ви можете використовувати команду `intlayer` для тестування та заповнення відсутніх перекладів у вашому коді.
+
+```bash
+npx intlayer test         # Перевірити наявність відсутніх перекладів
+```
+
+```bash
+npx intlayer fill         # Заповнити відсутні переклади
+```
+
+> Для отримання додаткової інформації зверніться до [документації CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/cli/ci.md)

package/docs/uk/component_i18n.md

@@ -86,7 +86,7 @@ JSON також підтримується, якщо ви віддаєте пе
 
 ## 2) Отримайте свій вміст
 
-### Випадок A — React-додаток (Vite/SPA)
+### Випадок A. React-додаток (Vite/SPA)
 
 Стандартний підхід: використовуйте `useIntlayer` для отримання за ключем. Це тримає компоненти компактними та типізованими.
 
@@ -137,9 +137,9 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### Варіант B — Next.js (App Router)
+### Варіант B. Next.js (App Router)
 
-Надавайте перевагу server components для безпеки даних та продуктивності. Використовуйте `useIntlayer` з `next-intlayer/server` у серверних файлах, а `useIntlayer` з `next-intlayer` — у client components.
+Надавайте перевагу server components для безпеки даних та продуктивності. Використовуйте `useIntlayer` з `next-intlayer/server` у серверних файлах, а `useIntlayer` з `next-intlayer`, у client components.
 
 ```tsx fileName="app/[locale]/example/ServerComponent.tsx"
 import { useIntlayer } from "next-intlayer/server";

package/docs/uk/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: Конфігурація
 description: Дізнайтеся, як налаштувати Intlayer для вашого застосунку. Зрозумійте різні параметри та опції, доступні для налаштування Intlayer відповідно до ваших потреб.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Оновлення опцій компілятора
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -455,6 +458,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -565,7 +579,7 @@ export default config;
   - _За замовчуванням_: `true`
   - _Опис_: Вказує, чи додаток взаємодіє з візуальним редактором.
   - _Приклад_: `process.env.NODE_ENV !== 'production'`
-  - _Примітка_: Якщо `true`, редактор зможе взаємодіяти з додатком. Якщо `false`, редактор не зможе взаємодіяти з додатком. У будь-якому випадку редактор може бути ввімкнений лише візуальним редактором. Вимкнення редактора для окремих середовищ — спосіб підвищити безпеку.
+  - _Примітка_: Якщо `true`, редактор зможе взаємодіяти з додатком. Якщо `false`, редактор не зможе взаємодіяти з додатком. У будь-якому випадку редактор може бути ввімкнений лише візуальним редактором. Вимкнення редактора для окремих середовищ, спосіб підвищити безпеку.
 
 - **clientId**:
   - _Тип_: `string` | `undefined`
@@ -632,7 +646,7 @@ export default config;
   - _Description_: Налаштування для зберігання локалі на клієнті.
 
   - **cookie**:
-    - _Description_: Зберігає дані в cookie — невеликі фрагменти даних, що зберігаються в браузері клієнта, доступні як на стороні клієнта, так і на стороні сервера.
+    - _Description_: Зберігає дані в cookie, невеликі фрагменти даних, що зберігаються в браузері клієнта, доступні як на стороні клієнта, так і на стороні сервера.
     - _Note_: Для зберігання, що відповідає вимогам GDPR, перед використанням забезпечте належну згоду користувача.
     - _Note_: Параметри cookie можна налаштувати, якщо вказати їх як CookiesAttributes (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).
 
@@ -661,7 +675,7 @@ export default config;
   - _Приклад_: `'/my-app'`
   - _Примітка_:
     - Якщо застосунок розміщений за адресою `https://example.com/my-app`
-    - Базовий шлях — `'/my-app'`
+    - Базовий шлях, `'/my-app'`
     - URL буде `https://example.com/my-app/en`
     - Якщо базовий шлях не встановлено, URL буде `https://example.com/en`
 
@@ -1063,7 +1077,7 @@ Intlayer підтримує кількох постачальників ШІ д
   - _Приклад_: `process.env.NODE_ENV === 'production'`
   - _Примітка_: За замовчуванням оптимізація збірки не зафіксована. Якщо не встановлено, Intlayer запустить оптимізацію під час збірки вашого застосунку (vite / nextjs / тощо). Встановлення `true` примусово увімкне оптимізацію збірки, включно з режимом розробки. Встановлення `false` вимкне оптимізацію збірки.
   - _Примітка_: Коли ввімкнено, Intlayer замінює всі виклики словників для оптимізації розбиття на чанки. Таким чином фінальний бандл імпортуватиме лише ті словники, які використовуються. Всі імпорти залишаться статичними, щоб уникнути асинхронної обробки під час завантаження словників.
-  - _Примітка_: Intlayer замінить усі виклики `useIntlayer` на варіант, визначений опцією `importMode`, а `getIntlayer` — на `getDictionary`.
+  - _Примітка_: Intlayer замінить усі виклики `useIntlayer` на варіант, визначений опцією `importMode`, а `getIntlayer`, на `getDictionary`.
   - _Примітка_: Ця опція покладається на плагіни `@intlayer/babel` та `@intlayer/swc`.
   - _Примітка_: Переконайтесь, що всі ключі оголошені статично у викликах `useIntlayer`. Наприклад `useIntlayer('navbar')`.
 
@@ -1106,3 +1120,49 @@ Intlayer підтримує кількох постачальників ШІ д
   - _Note_: Використовуйте це, щоб обмежити оптимізацію релевантними файлами коду та покращити продуктивність збірки.
   - _Note_: Ця опція буде ігнорована, якщо `optimize` вимкнено.
   - _Note_: Використовуйте glob-шаблон.
+
+---
+
+### Конфігурація компілятора
+
+Налаштування, що керують компілятором Intlayer, який витягує словники безпосередньо з ваших компонентів.
+
+#### Властивості
+
+- **enabled**:
+  - _Тип_: `boolean | 'build-only'`
+  - _За замовчуванням_: `true`
+  - _Опис_: Вказує, чи повинен бути ввімкнений компілятор для витягування словників.
+  - _Приклад_: `'build-only'`
+  - _Примітка_: Встановлення значення `'build-only'` призведе до пропуску компілятора під час режиму розробки для прискорення часу запуску. Він буде запускатися лише для команд збірки.
+
+- **dictionaryKeyPrefix**:
+  - _Тип_: `string`
+  - _За замовчуванням_: `'comp-'`
+  - _Опис_: Префікс для витягнутих ключів словника.
+  - _Приклад_: `'my-key-'`
+  - _Примітка_: Під час витягування словників ключ генерується на основі назви файлу. Цей префікс додається до згенерованого ключа, щоб запобігти конфліктам.
+
+- **saveComponents**:
+  - _Тип_: `boolean`
+  - _За замовчуванням_: `false`
+  - _Опис_: Вказує, чи повинні зберігатися компоненти після їх трансформації.
+  - _Примітка_: Якщо встановлено значення true, компілятор замінить оригінальні файли трансформованими. Таким чином, компілятор можна запустити лише один раз для трансформації застосунку, а потім видалити його.
+
+- **transformPattern**:
+  - _Тип_: `string | string[]`
+  - _За замовчуванням_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _Опис_: Шаблони, що визначають, які файли слід обходити під час оптимізації.
+  - _Приклад_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Примітка_: Використовуйте це, щоб обмежити оптимізацію релевантними файлами коду та покращити продуктивність збірки.
+
+- **excludePattern**:
+  - _Тип_: `string | string[]`
+  - _За замовчуванням_: `['**/node_modules/**']`
+  - _Опис_: Шаблони, що визначають, які файли слід виключити під час оптимізації.
+  - _Приклад_: `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _Тип_: `string`
+  - _За замовчуванням_: `'compiler'`
+  - _Опис_: Каталог, у якому будуть зберігатися витягнуті словники, відносно базового шляху вашого проекту.

package/docs/uk/dictionary/content_file.md

@@ -44,7 +44,7 @@ history:
 
 ## Що таке файл контенту?
 
-Файл контенту в Intlayer — це файл, який містить визначення словників.
+Файл контенту в Intlayer, це файл, який містить визначення словників.
 Такі файли оголошують текстовий контент вашого застосунку, переклади та ресурси.
 Файли контенту обробляються Intlayer для генерації словників.
 
@@ -54,7 +54,7 @@ history:
 
 #### Словник
 
-Словник — це структурована колекція контенту, організована за ключами. Кожен словник містить:
+Словник, це структурована колекція контенту, організована за ключами. Кожен словник містить:
 
 - **Ключ**: Унікальний ідентифікатор словника
 - **Контент**: Фактичні значення контенту (текст, числа, об'єкти тощо)
@@ -144,7 +144,7 @@ export default {
      */
     jsxContent: <h1>Мій заголовок</h1>,
   },
-} satisfies Dictionary<Content>; // [необов'язково] Dictionary — generic тип, який дозволяє уточнити форматування вашого словника
+} satisfies Dictionary<Content>; // [необов'язково] Dictionary, generic тип, який дозволяє уточнити форматування вашого словника
 ```
 
 ```javascript fileName="src/example.content.mjx" contentDeclarationFormat="esm"
@@ -323,7 +323,7 @@ module.exports = {
 
 #### Вузли контенту
 
-Вузли контенту — це будівельні блоки вмісту словника. Вони можуть бути:
+Вузли контенту, це будівельні блоки вмісту словника. Вони можуть бути:
 
 - **Примітивні значення**: strings, numbers, booleans, null, undefined
 - **Типізовані вузли**: спеціальні типи контенту, такі як translations, conditions, markdown тощо
@@ -500,7 +500,7 @@ export default aboutPageMetaContent;
 
 - `'local'`: Словник керується лише локально. Він не буде відправлений до віддаленого CMS. Використовуйте це для контенту, який має залишатися у вашій кодовій базі.
 - `'remote'`: Словник керується лише віддалено. Після відправки до CMS він буде від'єднаний від локального файлу. Під час завантаження контенту віддалений словник буде отримано з CMS. Файл `.content` з розташуванням `remote` буде проігноровано після початкової відправки.
-- `'hybrid'`: Словник керується як локально, так і віддалено. Після відправки до CMS він залишиться синхронізованим—зміни з локального файлу відправляються до CMS, а віддалені зміни можуть бути отримані назад у локальний файл.
+- `'hybrid'`: Словник керується як локально, так і віддалено. Після відправки до CMS він залишиться синхронізованим, зміни з локального файлу відправляються до CMS, а віддалені зміни можуть бути отримані назад у локальний файл.
 - `string` (напр., `'plugin'`): Словник керується плагіном або користувацьким джерелом. Коли ви спробуєте відправити його, система запитає вас, що робити.
 
 **Приклад:**

package/docs/uk/dictionary/enumeration.md

@@ -120,7 +120,7 @@ module.exports = carEnumeration;
 
 У цьому прикладі `enu` відображає різні умови на конкретний вміст. При використанні в React-компоненті Intlayer може автоматично вибирати відповідний вміст на основі заданої змінної.
 
-> Порядок оголошення має значення в перерахуваннях Intlayer. Перше допустиме оголошення — те, яке буде обрано. Якщо застосовуються кілька умов, упевніться, що вони розташовані в правильному порядку, щоб уникнути непередбачуваної поведінки.
+> Порядок оголошення має значення в перерахуваннях Intlayer. Перше допустиме оголошення, те, яке буде обрано. Якщо застосовуються кілька умов, упевніться, що вони розташовані в правильному порядку, щоб уникнути непередбачуваної поведінки.
 
 > Якщо не вказано fallback, функція поверне `undefined`, якщо жоден ключ не підходить.
 

package/docs/uk/dictionary/html.md

@@ -91,7 +91,7 @@ Intlayer підтримує HTML-контент, що дозволяє вбуд
 
 ### Вузол `html()`
 
-Функція `html()` — це нова можливість в Intlayer v8, яка дозволяє явно визначати HTML-контент у ваших словниках. Хоча Intlayer часто може автоматично визначати HTML-контент, використання функції `html()` має кілька переваг:
+Функція `html()`, це нова можливість в Intlayer v8, яка дозволяє явно визначати HTML-контент у ваших словниках. Хоча Intlayer часто може автоматично визначати HTML-контент, використання функції `html()` має кілька переваг:
 
 - **Типобезпека**: Функція `html()` дозволяє визначати очікувані пропси для користувацьких компонентів, забезпечуючи краще автодоповнення та перевірку типів у вашому редакторі.
 - **Явне оголошення**: Це гарантує, що рядок завжди буде розглядатися як HTML, навіть якщо він не містить стандартних HTML-тегів, які могли б активувати автоматичне визначення.

package/docs/uk/formatters.md

@@ -241,9 +241,9 @@ getLocalizedUrl("https://example.com/about", "fr", ["en", "fr"], "en", true); //
 
 - **url**: Початковий URL для локалізації
 - **currentLocale**: Поточна локаль
-- **locales**: Необов'язковий масив підтримуваних локалей (за замовчуванням — сконфігуровані локалі)
-- **defaultLocale**: Необов'язкова локаль за замовчуванням (за замовчуванням — сконфігурована локаль за замовчуванням)
-- **prefixDefault**: Чи додавати префікс для локалі за замовчуванням (за замовчуванням — сконфігуроване значення)
+- **locales**: Необов'язковий масив підтримуваних локалей (за замовчуванням, сконфігуровані локалі)
+- **defaultLocale**: Необов'язкова локаль за замовчуванням (за замовчуванням, сконфігурована локаль за замовчуванням)
+- **prefixDefault**: Чи додавати префікс для локалі за замовчуванням (за замовчуванням, сконфігуроване значення)
 
 ### `getHTMLTextDir(locale?)`
 
@@ -257,7 +257,7 @@ getHTMLTextDir("ar"); // повертає "rtl"
 getHTMLTextDir("he"); // повертає "rtl"
 ```
 
-- **locale**: Локаль, для якої потрібно отримати напрямок тексту (за замовчуванням — поточна локаль)
+- **locale**: Локаль, для якої потрібно отримати напрямок тексту (за замовчуванням, поточна локаль)
 - **повертає**: `"ltr"`, `"rtl"`, або `"auto"`
 
 ## Утиліти обробки контенту
@@ -314,7 +314,7 @@ const nestedContent = getIntlayer("common", "fr", customPlugins);
 ```
 
 - **dictionaryKey**: Ключ словника, який необхідно отримати
-- **locale**: Необов'язкова локаль (за замовчуванням — налаштована локаль за замовчуванням)
+- **locale**: Необов'язкова локаль (за замовчуванням, налаштована локаль за замовчуванням)
 - **plugins**: Необов'язковий масив кастомних плагінів трансформації
 
 ## Форматувачі
@@ -395,11 +395,11 @@ date("2025-08-02T14:30:00Z", { locale: "fr", month: "long", day: "numeric" }); /
 
 Форматує відносний час між двома моментами за допомогою `Intl.RelativeTimeFormat`.
 
-- Передайте "now" як перший аргумент, а цільовий — як другий, щоб отримати природне формулювання.
+- Передайте "now" як перший аргумент, а цільовий, як другий, щоб отримати природне формулювання.
 - **from**: `Date | string | number`
-- **to**: `Date | string | number` (за замовчуванням — `new Date()`)
+- **to**: `Date | string | number` (за замовчуванням, `new Date()`)
 - **options**: `{ locale?: LocalesValues; unit?: Intl.RelativeTimeFormatUnit; numeric?: Intl.RelativeTimeFormatNumeric; style?: Intl.RelativeTimeFormatStyle }`
-  - За замовчуванням `unit` — `"second"`.
+  - За замовчуванням `unit`, `"second"`.
 
 Приклади:
 
@@ -471,7 +471,7 @@ list([1, 2, 3], { type: "unit" }); // "1, 2, 3"
 
 - Усі утиліти приймають вхідні значення як `string`; всередині вони приводяться до чисел або дат.
 - Якщо локаль не вказана, за замовчуванням використовується налаштована вами `internationalization.defaultLocale`.
-- Ці утиліти — тонкі обгортки; для просунутого форматування передавайте стандартні опції `Intl`.
+- Ці утиліти, тонкі обгортки; для просунутого форматування передавайте стандартні опції `Intl`.
 
 ## Точки входу та повторні експорти (`@index.ts`)
 

package/docs/uk/how_works_intlayer.md

@@ -27,7 +27,7 @@ history:
 
 ## Огляд
 
-Головна ідея Intlayer — застосувати керування контентом на рівні компонентів. Іншими словами, Intlayer дозволяє вам декларувати контент будь-де у вашому codebase, наприклад у тій самій директорії, що й компонент.
+Головна ідея Intlayer, застосувати керування контентом на рівні компонентів. Іншими словами, Intlayer дозволяє вам декларувати контент будь-де у вашому codebase, наприклад у тій самій директорії, що й компонент.
 
 ```bash
 .
@@ -54,7 +54,7 @@ history:
 
 1. Declaration of content files
    - Content files can be defined in various formats, such as TypeScript, ECMAScript, CommonJS, or JSON.
-   - Файли контенту можуть бути визначені в будь-якому місці проєкту, що дозволяє кращу підтримку та масштабованість. Важливо дотримуватися конвенцій щодо розширень файлів контенту. Це розширення за замовчуванням — `*.content.{js|cjs|mjs|ts|tsx|json}`, але його можна змінити у [файлі конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
+   - Файли контенту можуть бути визначені в будь-якому місці проєкту, що дозволяє кращу підтримку та масштабованість. Важливо дотримуватися конвенцій щодо розширень файлів контенту. Це розширення за замовчуванням, `*.content.{js|cjs|mjs|ts|tsx|json}`, але його можна змінити у [файлі конфігурації](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md).
 
 2. Генерація `dictionaries`
    - Словники генеруються з файлів контенту. За замовчуванням словники Intlayer створюються в директорії `.intlayer/dictionaries` проєкту.
@@ -66,7 +66,7 @@ history:
 
 - Типи словників генеруються з файлів оголошень вмісту Intlayer (`content declaration files`). За замовчуванням типи словників Intlayer генеруються в директорії `.intlayer/types` проєкту.
 
-- Intlayer [module augmentation](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) — це можливість TypeScript, яка дозволяє визначати додаткові типи для Intlayer. Це спрощує досвід розробки, підказуючи доступні або обов'язкові аргументи.
+- Intlayer [module augmentation](https://www.typescriptlang.org/docs/handbook/declaration-merging.html), це можливість TypeScript, яка дозволяє визначати додаткові типи для Intlayer. Це спрощує досвід розробки, підказуючи доступні або обов'язкові аргументи.
   Серед згенерованих типів, типи словників Intlayer або навіть типи конфігурації мов додаються до файлу `types/intlayer.d.ts` і використовуються іншими пакетами. Для цього необхідно, щоб файл `tsconfig.json` був налаштований на включення директорії `types` проекту.
 
 ### Крок інтерпретації словників
@@ -98,8 +98,8 @@ Intlayer також надає візуальний редактор, щоб д
 
 ![visual editor](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif?raw=true)
 
-- Сервер — це проста Express-аплікація, яка прослуховує запити від клієнта та отримує вміст вашого застосунку, такий як `dictionaries`, і конфігурацію, щоб зробити їх доступними на стороні клієнта.
-- З іншого боку, клієнт — це React-аплікація, яка використовується для взаємодії з вашим контентом за допомогою візуального інтерфейсу.
+- Сервер, це проста Express-аплікація, яка прослуховує запити від клієнта та отримує вміст вашого застосунку, такий як `dictionaries`, і конфігурацію, щоб зробити їх доступними на стороні клієнта.
+- З іншого боку, клієнт, це React-аплікація, яка використовується для взаємодії з вашим контентом за допомогою візуального інтерфейсу.
 
 Коли ви викликаєте свій контент за допомогою `useIntlayer` і редактор увімкнений, він автоматично обгортає ваші рядки об'єктом Proxy з ім'ям `IntlayerNode`. Цей вузол використовує `window.postMessage` для зв'язку з вкладеним iframe, що містить інтерфейс візуального редактора.
 На стороні редактора він прослуховує ці повідомлення та імітує реальну взаємодію з вашим контентом, дозволяючи редагувати текст безпосередньо в контексті вашого додатку.
@@ -122,7 +122,7 @@ Intlayer також надає візуальний редактор, щоб д
 
 ## Пакети
 
-Intlayer складається з кількох пакетів, кожен із яких має конкретну роль у процесі перекладу. Нижче — графічне зображення структури цих пакетів:
+Intlayer складається з кількох пакетів, кожен із яких має конкретну роль у процесі перекладу. Нижче, графічне зображення структури цих пакетів:
 
 ![пакети intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/packages_dependency_graph.svg)
 

package/docs/uk/index.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-02-07
 updatedAt: 2025-06-29
-title: "Документація Intlayer — Повний посібник з i18n для JavaScript"
+title: "Документація Intlayer. Повний посібник з i18n для JavaScript"
 description: "Повна документація для Intlayer, сучасної бібліотеки інтернаціоналізації для JavaScript, React, Next.js, Express та інших фреймворків."
 keywords:
   - intlayer
@@ -36,7 +36,7 @@ Intlayer пропонує гнучкий, сучасний підхід до п
   Отримайте огляд того, як працює Intlayer, його основних функцій і чому він змінює підхід до i18n.
 
 - **[Як працює Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/how_works_intlayer.md)**  
-  Зануртеся в архітектурний дизайн і дізнайтеся, як Intlayer обробляє все — від оголошення контенту до доставки перекладів.
+  Зануртеся в архітектурний дизайн і дізнайтеся, як Intlayer обробляє все, від оголошення контенту до доставки перекладів.
 
 - **[Конфігурація](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/configuration.md)**  
   Налаштуйте Intlayer відповідно до потреб вашого проєкту. Дослідіть параметри middleware, структуру директорій і розширені налаштування.
@@ -64,7 +64,7 @@ Intlayer пропонує гнучкий, сучасний підхід до п
 - **[Перелічення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/enumeration.md)**  
   Легко керуйте повторюваними або фіксованими наборами даних у різних мовах.
 
-- **[Умова](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/conditional.md)**  
+- **[Умова](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/condition.md)**  
   Дізнайтеся, як використовувати умовну логіку в Intlayer для створення динамічного контенту.
 
 - **[Гендер](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/gender.md)**  
@@ -79,7 +79,7 @@ Intlayer пропонує гнучкий, сучасний підхід до п
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/markdown.md)**  
   Дізнайтеся, як використовувати Markdown в Intlayer для створення багатого контенту.
 
-- **[Вбудовування файлів](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/file_embeddings.md)**  
+- **[Вбудовування файлів](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/file.md)**  
   Дізнайтеся, як вбудовувати зовнішні файли в Intlayer для використання їх у редакторі контенту.
 
 - **[Вкладення](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/nesting.md)**