@intlayer/docs 8.1.7 → 8.1.9

package/docs/uk/agent_skills.md

@@ -18,9 +18,11 @@ history:
     changes: Ініціалізація
 ---
 
+# Навички агента
+
 ## Команда `intlayer init skills`
 
-Команда `intlayer init skills` — це найпростіший спосіб налаштувати Agent Skills у вашому проєкті. Вона визначає ваше середовище й встановлює необхідні конфігураційні файли для обраних платформ.
+Команда `intlayer init skills`, це найпростіший спосіб налаштувати Agent Skills у вашому проєкті. Вона визначає ваше середовище й встановлює необхідні конфігураційні файли для обраних платформ.
 
 ```bash
 npx intlayer init skills
@@ -53,7 +55,7 @@ Cursor підтримує MCP (Model Context Protocol) сервери та ко
 
 ### 2. Windsurf
 
-Windsurf — це AI-IDE. Запуск `intlayer init skills` встановить навички для конкретного фреймворку в директорію `.windsurf/skills`.
+Windsurf, це AI-IDE. Запуск `intlayer init skills` встановить навички для конкретного фреймворку в директорію `.windsurf/skills`.
 
 ### 3. VS Code
 
@@ -64,7 +66,7 @@ Windsurf — це AI-IDE. Запуск `intlayer init skills` встановит
 
 ### 4. OpenCode
 
-OpenCode — інтерактивний CLI-агент, призначений для завдань з розробки програмного забезпечення. Intlayer надає специфічні навички, щоб допомогти OpenCode у виконанні ваших задач з інтернаціоналізації. Вони встановлюються в директорію `.opencode/skills`.
+OpenCode, інтерактивний CLI-агент, призначений для завдань з розробки програмного забезпечення. Intlayer надає специфічні навички, щоб допомогти OpenCode у виконанні ваших задач з інтернаціоналізації. Вони встановлюються в директорію `.opencode/skills`.
 
 ### 5. Claude Code
 

package/docs/uk/autoFill.md

@@ -32,7 +32,7 @@ history:
 
 # Заповнення файлів декларації контенту
 
-**Файли декларації контенту з автозаповненням** у вашому CI — це спосіб прискорити робочий процес розробки.
+**Файли декларації контенту з автозаповненням** у вашому CI, це спосіб прискорити робочий процес розробки.
 
 ## Розуміння поведінки
 
@@ -41,7 +41,7 @@ history:
 - **Complete**: Автоматично заповнює весь відсутній контент для кожної локалі та редагує поточний файл або інший файл, якщо вказано. Тобто режим Complete пропускає переклад наявного контенту, якщо він уже перекладений.
 - **Review**: Автоматично заповнює **весь** контент для кожної локалі та генерує файл для поточного або вказаного іншого файлу.
 
-Команда `fill` обробляє лише ваші локальні файли декларації контенту. Тобто вона не обробляє віддалений контент із CMS — CMS має власну систему керування перекладами.
+Команда `fill` обробляє лише ваші локальні файли декларації контенту. Тобто вона не обробляє віддалений контент із CMS. CMS має власну систему керування перекладами.
 Якщо ви використовуєте плагіни, такі як `@intlayer/sync-json-plugin`, Intlayer перетворить JSON-файли на файли декларацій локалізованого контенту. Тобто вони будуть оброблятися командою `fill`.
 
 У новостворених файлах міститься інструкція `filled` як метадані словника. Ця інструкція використовується Intlayer, щоб визначити, чи файл був автозаповнений, і, якщо так, пропустити цей файл при наступному перекладі.
@@ -50,7 +50,7 @@ Intlayer також враховуватиме такі інструкції д
 
 - Із вашого файлу `.content.{ts|js|json}` → інструкція `fill`
 - Із конфігураційного файлу `.intlayer.config.ts` → інструкція `dictionary.fill`
-- Якщо ніде не вказано — за замовчуванням буде встановлено `true`
+- Якщо ніде не вказано, за замовчуванням буде встановлено `true`
 
 Для деклараційних файлів вмісту, що призначені для окремої локалі (per-locale), інструкція `true` буде замінена на `./{{fileName}}.fill.content.json`. Це відбувається тому, що такий per-locale деклараційний файл вмісту не може отримувати додатковий локалізований вміст. Отже, буде згенеровано новий файл, щоб не перезаписувати існуючий файл.
 
@@ -181,7 +181,7 @@ export default config;
 
 ## Формат автозаповнених файлів
 
-Рекомендований формат для автозаповнених файлів декларацій — **JSON**, оскільки це допомагає уникнути обмежень форматування. Однак Intlayer також підтримує `.ts`, `.js`, `.mjs`, `.cjs` та інші формати.
+Рекомендований формат для автозаповнених файлів декларацій, **JSON**, оскільки це допомагає уникнути обмежень форматування. Однак Intlayer також підтримує `.ts`, `.js`, `.mjs`, `.cjs` та інші формати.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {

package/docs/uk/bundle_optimization.md

@@ -23,7 +23,7 @@ history:
 
 # Оптимізація розміру бандла та продуктивності i18n
 
-Одна з найпоширеніших проблем традиційних i18n-рішень, що базуються на JSON-файлах — це керування розміром контенту. Якщо розробники не розділяють контент вручну по неймспейсах, користувачі часто в кінцевому підсумку завантажують переклади для всіх сторінок і, можливо, для всіх мов лише для перегляду однієї сторінки.
+Одна з найпоширеніших проблем традиційних i18n-рішень, що базуються на JSON-файлах, це керування розміром контенту. Якщо розробники не розділяють контент вручну по неймспейсах, користувачі часто в кінцевому підсумку завантажують переклади для всіх сторінок і, можливо, для всіх мов лише для перегляду однієї сторінки.
 
 Наприклад, застосунок з 10 сторінками, перекладеними на 10 мов, може призвести до того, що користувач завантажує контент 100 сторінок, хоча йому потрібна лише **одна** (поточна сторінка поточною мовою). Це призводить до марної витрати трафіку та повільнішого завантаження.
 
@@ -45,7 +45,7 @@ Intlayer використовує **підхід на рівні компоне
 
 Це гарантує, що:
 
-- Якщо компонент не імпортується, його вміст не включається до бандла (видалення мертвого коду — Dead Code Elimination).
+- Якщо компонент не імпортується, його вміст не включається до бандла (видалення мертвого коду. Dead Code Elimination).
 - Якщо компонент завантажується lazy-loaded, його вміст також завантажується lazy-loaded.
 
 ## Налаштування за платформою

package/docs/uk/cli/fill.md

@@ -103,7 +103,7 @@ Affected dictionary keys for processing: app, comp-test, hello-world, lang-switc
 
 - **`--output-locales [outputLocales...]`**: Цільові локалі для перекладу. Якщо не вказано, будуть використані всі локалі з вашої конфігурації, за винятком початкової локалі.
 
-- **`--mode [mode]`**: Режим перекладу: `complete`, `review`. За замовчуванням — `complete`. `complete` заповнює весь відсутній контент, `review` заповнює відсутній контент та переглядає наявні ключі.
+- **`--mode [mode]`**: Режим перекладу: `complete`, `review`. За замовчуванням, `complete`. `complete` заповнює весь відсутній контент, `review` заповнює відсутній контент та переглядає наявні ключі.
 
 **Параметри Git:**
 

package/docs/uk/cli/index.md

@@ -61,7 +61,7 @@ history:
     changes: Ініціалізація історії
 ---
 
-# Intlayer CLI — Усі команди Intlayer CLI для вашого багатомовного сайту
+# Intlayer CLI. Усі команди Intlayer CLI для вашого багатомовного сайту
 
 ---
 

package/docs/uk/cli/list_projects.md

@@ -35,7 +35,7 @@ npx intlayer projects list
 
 ## Аргументи:
 
-- **`--base-dir [path]`**: Вкажіть базову директорію для пошуку. За замовчуванням — поточна робоча директорія.
+- **`--base-dir [path]`**: Вкажіть базову директорію для пошуку. За замовчуванням, поточна робоча директорія.
 
   > Приклад: `npx intlayer projects list --base-dir /path/to/workspace`
 

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).
@@ -58,7 +61,7 @@ The **Intlayer Compiler** — потужний інструмент, створ
 
 ### Vite
 
-Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор — через плагін `vite-intlayer`.
+Для додатків на базі Vite (React, Vue, Svelte тощо) найпростіший спосіб використовувати компілятор, через плагін `vite-intlayer`.
 
 #### Встановлення
 
@@ -144,6 +147,55 @@ See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymer
 
  </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` для тестування та заповнення відсутніх перекладів у вашому коді.

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 тощо
@@ -489,7 +489,7 @@ const aboutPageMetaContent = {
     title: "About Our Company - Learn More About Us",
     description: "Discover our company's mission, values, and team.",
   },
-} satisfies Dictionary<"seo-metadata">;
+} satisfies Dictionary;
 
 export default aboutPageMetaContent;
 ```
@@ -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)