@intlayer/docs 8.2.4 → 8.3.0-canary.0

package/docs/uk/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add 'output' and 'noMetadata' support
   - version: 8.1.7
     date: 2026-02-25
     changes: Оновлення опцій компілятора
@@ -437,7 +440,7 @@ const config: IntlayerConfig = {
    */
   compiler: {
     /**
-     * Indicates if the compiler should be enabled.
+     * Вказує, чи має бути увімкнено компілятор.
      */
     enabled: true,
 
@@ -455,18 +458,23 @@ const config: IntlayerConfig = {
     excludePattern: ["**/node_modules/**"],
 
     /**
-     * Output directory for the optimized dictionaries.
+     * Вихідний каталог для оптимізованих словників.
      */
-    outputDir: "compiler",
+    output: ({ key }) => `compiler/${key}.content.json`,
 
     /**
-     * Dictionary key prefix
+     * Вставте лише вміст у згенерований файл, без ключа.
+     */
+    noMetadata: false,
+
+    /**
+     * Префікс ключа словника
      */
     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,
   },
@@ -510,24 +518,24 @@ export default config;
 - **requiredLocales**:
   - _Тип_: `string[]`
   - _За замовчуванням_: `[]`
-  - _Description_: Перелік обов'язкових локалей у застосунку.
-  - _Example_: `[]`
-  - _Note_: Якщо порожній, усі локалі є обов'язковими в режимі `strict`.
-  - _Note_: Переконайтеся, що обов'язкові локалі також визначені в полі `locales`.
+  - _Опис_: Перелік обов'язкових локалей у застосунку.
+  - _Приклад_: `[]`
+  - _Примітка_: Якщо порожній, усі локалі є обов'язковими в режимі `strict`.
+  - _Примітка_: Переконайтеся, що обов'язкові локалі також визначені в полі `locales`.
 - **strictMode**:
-  - _Type_: `string`
-  - _Default_: `inclusive`
-  - _Description_: Забезпечує суворі реалізації інтернаціоналізованого контенту з використанням TypeScript.
-  - _Note_: Якщо встановлено "strict", функція перекладу `t` вимагатиме, щоб кожна оголошена локаль була визначена. Якщо якась локаль відсутня або не зазначена в конфігурації, буде викинута помилка.
-  - _Note_: Якщо встановлено "inclusive", функція перекладу `t` вимагатиме, щоб кожна оголошена locale була визначена. Якщо одна locale відсутня, буде виведено попередження. Проте функція прийме locale, яка не оголошена у вашій конфігурації, але існує.
-  - _Note_: Якщо встановлено "loose", функція перекладу `t` прийматиме будь-яку наявну locale.
+  - _Тип_: `string`
+  - _Типово_: `inclusive`
+  - _Опис_: Забезпечує суворі реалізації інтернаціоналізованого контенту з використанням TypeScript.
+  - _Примітка_: Якщо встановлено "strict", функція перекладу `t` вимагатиме, щоб кожна оголошена локаль була визначена. Якщо якась локаль відсутня або не зазначена в конфігурації, буде викинута помилка.
+  - _Примітка_: Якщо встановлено "inclusive", функція перекладу `t` вимагатиме, щоб кожна оголошена locale була визначена. Якщо одна locale відсутня, буде виведено попередження. Проте функція прийме locale, яка не оголошена у вашій конфігурації, але існує.
+  - _Примітка_: Якщо встановлено "loose", функція перекладу `t` прийматиме будь-яку наявну locale.
 
 - **defaultLocale**:
-  - _Type_: `string`
-  - _Default_: `'en'`
-  - _Description_: Локаль за замовчуванням, яка використовується як fallback, якщо запитувана локаль не знайдена.
-  - _Example_: `'en'`
-  - _Note_: Використовується для визначення локалі, коли вона не вказана в URL, cookie або заголовку.
+  - _Тип_: `string`
+  - _Типово_: `'en'`
+  - _Опис_: Локаль за замовчуванням, яка використовується як fallback, якщо запитувана локаль не знайдена.
+  - _Приклад_: `'en'`
+  - _Примітка_: Використовується для визначення локалі, коли вона не вказана в URL, cookie або заголовку.
 
 ---
 
@@ -538,7 +546,7 @@ export default config;
 #### Properties
 
 - **applicationURL**:
-  - _Type_: `string`
+  - _Тип_: `string`
   - _За замовчуванням_: `http://localhost:3000`
   - _Опис_: URL додатка. Використовується для обмеження origin редактора з міркувань безпеки.
   - _Приклад_:
@@ -559,23 +567,23 @@ export default config;
     - `'http://localhost:3000'`
     - `'https://example.com'`
     - `process.env.INTLAYER_EDITOR_URL`
-  - _Note_: URL сервера редактора, до якого звертається додаток. Використовується для обмеження origins, які можуть взаємодіяти з додатком з міркувань безпеки. Якщо встановлено `'*'`, редактор доступний з будь-якого origin. Має бути вказаний, якщо змінено порт або якщо редактор розміщено на іншому домені.
+  - _Примітка_: URL сервера редактора, до якого звертається додаток. Використовується для обмеження origins, які можуть взаємодіяти з додатком з міркувань безпеки. Якщо встановлено `'*'`, редактор доступний з будь-якого origin. Має бути вказаний, якщо змінено порт або якщо редактор розміщено на іншому домені.
 
 - **cmsURL**:
-  - _Type_: `string`
-  - _Default_: `'https://intlayer.org'`
-  - _Description_: URL Intlayer CMS.
-  - _Example_: `'https://intlayer.org'`
-  - _Note_: URL Intlayer CMS.
+  - _Тип_: `string`
+  - _Типово_: `'https://intlayer.org'`
+  - _Опис_: URL Intlayer CMS.
+  - _Приклад_: `'https://intlayer.org'`
+  - _Примітка_: URL Intlayer CMS.
 
 - **backendURL**:
-  - _Type_: `string`
-  - _Default_: `https://back.intlayer.org`
-  - _Description_: URL backend-сервера.
-  - _Example_: `http://localhost:4000`
+  - _Тип_: `string`
+  - _Типово_: `https://back.intlayer.org`
+  - _Опис_: URL backend-сервера.
+  - _Приклад_: `http://localhost:4000`
 
 - **enabled**:
-  - _Type_: `boolean`
+  - _Тип_: `boolean`
   - _За замовчуванням_: `true`
   - _Опис_: Вказує, чи додаток взаємодіє з візуальним редактором.
   - _Приклад_: `process.env.NODE_ENV !== 'production'`
@@ -584,29 +592,29 @@ export default config;
 - **clientId**:
   - _Тип_: `string` | `undefined`
   - _За замовчуванням_: `undefined`
-  - _Description_: clientId і clientSecret дозволяють пакетам intlayer автентифікуватися з бекендом за допомогою автентифікації oAuth2. Access token використовується для автентифікації користувача, пов’язаного з проєктом. Щоб отримати access token, перейдіть на https://app.intlayer.org/project та створіть обліковий запис.
-  - _Example_: `true`
-  - _Note_: Важливо: clientId та clientSecret мають зберігатися в секреті і не розголошуватися публічно. Переконайтеся, що вони зберігаються у безпечному місці, наприклад у змінних оточення.
+  - _Опис_: clientId і clientSecret дозволяють пакетам intlayer автентифікуватися з бекендом за допомогою автентифікації oAuth2. Access token використовується для автентифікації користувача, пов’язаного з проєктом. Щоб отримати access token, перейдіть на https://app.intlayer.org/project та створіть обліковий запис.
+  - _Приклад_: `true`
+  - _Примітка_: Важливо: clientId та clientSecret мають зберігатися в секреті і не розголошуватися публічно. Переконайтеся, що вони зберігаються у безпечному місці, наприклад у змінних оточення.
 
 - **clientSecret**:
-  - _Type_: `string` | `undefined`
-  - _Default_: `undefined`
-  - _Description_: clientId та clientSecret дозволяють пакетам intlayer автентифікуватися з бекендом за допомогою oAuth2. Токен доступу використовується для автентифікації користувача, пов’язаного з проєктом. Щоб отримати токен доступу, перейдіть на https://app.intlayer.org/project і створіть обліковий запис.
-  - _Example_: `true`
-  - _Note_: Важливо: clientId та clientSecret слід зберігати в таємниці й не розголошувати публічно. Переконайтеся, що зберігаєте їх у безпечному місці, наприклад у environment variables.
+  - _Тип_: `string` | `undefined`
+  - _Типово_: `undefined`
+  - _Опис_: clientId та clientSecret дозволяють пакетам intlayer автентифікуватися з бекендом за допомогою oAuth2. Токен доступу використовується для автентифікації користувача, пов’язаного з проєктом. Щоб отримати токен доступу, перейдіть на https://app.intlayer.org/project і створіть обліковий запис.
+  - _Приклад_: `true`
+  - _Примітка_: Важливо: clientId та clientSecret слід зберігати в таємниці й не розголошувати публічно. Переконайтеся, що зберігаєте їх у безпечному місці, наприклад у environment variables.
 
 - **dictionaryPriorityStrategy**:
-  - _Type_: `string`
-  - _Default_: `'local_first'`
-  - _Description_: Стратегія пріоритету словників у разі наявності як локальних, так і віддалених словників. Якщо встановлено `'distant_first'`, застосунок віддаватиме пріоритет віддаленим словникам над локальними. Якщо встановлено `'local_first'`, застосунок віддаватиме пріоритет локальним словникам над віддаленими.
-  - _Example_: `'distant_first'`
+  - _Тип_: `string`
+  - _Типово_: `'local_first'`
+  - _Опис_: Стратегія пріоритету словників у разі наявності як локальних, так і віддалених словників. Якщо встановлено `'distant_first'`, застосунок віддаватиме пріоритет віддаленим словникам над локальними. Якщо встановлено `'local_first'`, застосунок віддаватиме пріоритет локальним словникам над віддаленими.
+  - _Приклад_: `'distant_first'`
 
 - **liveSync**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Вказує, чи має сервер застосунку виконувати hot reload контенту застосунку при виявленні змін у CMS / Visual Editor / Backend.
-  - _Example_: `true`
-  - _Note_: Наприклад, коли додається або оновлюється новий словник, застосунок оновить контент, що відображається на сторінці.
+  - _Тип_: `boolean`
+  - _Типово_: `false`
+  - _Опис_: Вказує, чи має сервер застосунку виконувати hot reload контенту застосунку при виявленні змін у CMS / Visual Editor / Backend.
+  - _Приклад_: `true`
+  - _Примітка_: Наприклад, коли додається або оновлюється новий словник, застосунок оновить контент, що відображається на сторінці.
   - _Примітка_: Live sync потребує винесення вмісту застосунку на інший сервер. Це означає, що це може трохи вплинути на продуктивність застосунку. Щоб обмежити цей вплив, рекомендуємо розміщувати застосунок і live sync сервер на одній машині. Також комбінація live sync та `optimize` може спричинити значну кількість запитів до live sync сервера. Залежно від вашої інфраструктури, рекомендуємо протестувати обидві опції та їх комбінацію.
 
 - **liveSyncPort**:
@@ -619,9 +627,9 @@ export default config;
 - **liveSyncURL**:
   - _Тип_: `string`
   - _За замовчуванням_: `'http://localhost:{liveSyncPort}'`
-  - _Description_: URL live sync сервера.
-  - _Example_: `'https://example.com'`
-  - _Note_: За замовчуванням вказує на localhost, але може бути змінений на будь-який URL у випадку віддаленого live sync сервера.
+  - _Опис_: URL live sync сервера.
+  - _Приклад_: `'https://example.com'`
+  - _Примітка_: За замовчуванням вказує на localhost, але може бути змінений на будь-який URL у випадку віддаленого live sync сервера.
 
 ### Конфігурація маршрутизації
 
@@ -630,25 +638,25 @@ export default config;
 #### Властивості
 
 - **mode**:
-  - _Type_: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
-  - _Default_: `'prefix-no-default'`
-  - _Description_: Режим маршрутизації URL для обробки locale.
+  - _Тип_: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+  - _Типово_: `'prefix-no-default'`
+  - _Опис_: Режим маршрутизації URL для обробки locale.
   - _Examples_:
     - `'prefix-no-default'`: `/dashboard` (en) або `/fr/dashboard` (fr)
     - `'prefix-all'`: `/en/dashboard` (en) або `/fr/dashboard` (fr)
     - `'no-prefix'`: `/dashboard` (locale обробляється іншими способами`)
     - `'search-params'`: `/dashboard?locale=fr`
-  - _Note_: Це налаштування не впливає на керування cookie або зберіганням локалі.
+  - _Примітка_: Це налаштування не впливає на керування cookie або зберіганням локалі.
 
 - **storage**:
-  - _Type_: `false | 'cookie' | 'localStorage' | 'sessionStorage' | 'header' | CookiesAttributes | StorageAttributes | Array`
-  - _Default_: `'localStorage'`
-  - _Description_: Налаштування для зберігання локалі на клієнті.
+  - _Тип_: `false | 'cookie' | 'localStorage' | 'sessionStorage' | 'header' | CookiesAttributes | StorageAttributes | Array`
+  - _Типово_: `'localStorage'`
+  - _Опис_: Налаштування для зберігання локалі на клієнті.
 
   - **cookie**:
-    - _Description_: Зберігає дані в cookie, невеликі фрагменти даних, що зберігаються в браузері клієнта, доступні як на стороні клієнта, так і на стороні сервера.
-    - _Note_: Для зберігання, що відповідає вимогам GDPR, перед використанням забезпечте належну згоду користувача.
-    - _Note_: Параметри cookie можна налаштувати, якщо вказати їх як CookiesAttributes (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).
+    - _Опис_: Зберігає дані в cookie, невеликі фрагменти даних, що зберігаються в браузері клієнта, доступні як на стороні клієнта, так і на стороні сервера.
+    - _Примітка_: Для зберігання, що відповідає вимогам GDPR, перед використанням забезпечте належну згоду користувача.
+    - _Примітка_: Параметри cookie можна налаштувати, якщо вказати їх як CookiesAttributes (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).
 
   - **localStorage**:
     - _Опис_: Зберігає дані в браузері без дат закінчення терміну дії, що дозволяє зберігати дані між сесіями, доступне лише на боці клієнта.
@@ -658,15 +666,15 @@ export default config;
 
   - **sessionStorage**:
     - _Опис_: Зберігає дані протягом сеансу сторінки, тобто вони очищуються після закриття вкладки або вікна, доступне лише на боці клієнта.
-    - _Note_: Підходить для тимчасового збереження даних для кожної сесії.
-    - _Note_: Сховище локалі доступне лише на стороні клієнта, проксі intlayer не зможе до нього звертатися.
-    - _Note_: Параметри збереження локалі можна налаштувати, якщо задати їх як StorageAttributes (`{ type: 'sessionStorage', name: 'custom-locale' }`).
+    - _Примітка_: Підходить для тимчасового збереження даних для кожної сесії.
+    - _Примітка_: Сховище локалі доступне лише на стороні клієнта, проксі intlayer не зможе до нього звертатися.
+    - _Примітка_: Параметри збереження локалі можна налаштувати, якщо задати їх як StorageAttributes (`{ type: 'sessionStorage', name: 'custom-locale' }`).
 
   - **header**:
-    - _Description_: Використовує HTTP-заголовки для збереження або передачі даних локалі, підходить для визначення мови на стороні сервера.
-    - _Note_: Корисно в API-запитах для підтримки узгоджених налаштувань мови між запитами.
-    - _Note_: Заголовок доступний лише на стороні сервера, клієнт не зможе отримати до нього доступ.
-    - _Note_: Назву заголовка можна змінити, якщо вказати її в StorageAttributes (`{ type: 'header', name: 'custom-locale' }`).
+    - _Опис_: Використовує HTTP-заголовки для збереження або передачі даних локалі, підходить для визначення мови на стороні сервера.
+    - _Примітка_: Корисно в API-запитах для підтримки узгоджених налаштувань мови між запитами.
+    - _Примітка_: Заголовок доступний лише на стороні сервера, клієнт не зможе отримати до нього доступ.
+    - _Примітка_: Назву заголовка можна змінити, якщо вказати її в StorageAttributes (`{ type: 'header', name: 'custom-locale' }`).
 
 - **basePath**:
   - _Тип_: `string`
@@ -902,18 +910,18 @@ export default config;
 - **excludedPath**:
   - _Тип_: `string[]`
   - _За замовчуванням_: `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']`
-  - _Description_: Каталоги, виключені з пошуку вмісту.
-  - _Note_: Ця налаштування ще не використовується, але планується для майбутньої реалізації.
+  - _Опис_: Каталоги, виключені з пошуку вмісту.
+  - _Примітка_: Ця налаштування ще не використовується, але планується для майбутньої реалізації.
 
 - **formatCommand**:
-  - _Type_: `string`
-  - _Default_: `undefined`
-  - _Description_: Команда для форматування вмісту. Коли Intlayer записуватиме ваші .content файли локально, ця команда буде використана для форматування вмісту.
-  - _Example_: `'npx prettier --write "{{file}}" --log-level silent'` За допомогою Prettier
-  - _Example_: `'npx biome format "{{file}}" --write --log-level none'` За допомогою Biome
-  - _Example_: `'npx eslint --fix "{{file}}"  --quiet'` За допомогою ESLint
-  - _Note_: Intlayer замінить {{file}} на шлях до файлу, який потрібно форматувати.
-  - _Note_: Якщо не вказано, Intlayer спробує визначити команду форматування автоматично. Він буде намагатися знайти такі команди: prettier, biome, eslint.
+  - _Тип_: `string`
+  - _Типово_: `undefined`
+  - _Опис_: Команда для форматування вмісту. Коли Intlayer записуватиме ваші .content файли локально, ця команда буде використана для форматування вмісту.
+  - _Приклад_: `'npx prettier --write "{{file}}" --log-level silent'` За допомогою Prettier
+  - _Приклад_: `'npx biome format "{{file}}" --write --log-level none'` За допомогою Biome
+  - _Приклад_: `'npx eslint --fix "{{file}}"  --quiet'` За допомогою ESLint
+  - _Примітка_: Intlayer замінить {{file}} на шлях до файлу, який потрібно форматувати.
+  - _Примітка_: Якщо не вказано, Intlayer спробує визначити команду форматування автоматично. Він буде намагатися знайти такі команди: prettier, biome, eslint.
 
 ### Конфігурація словника
 
@@ -933,11 +941,11 @@ export default config;
 - **locale**
 - **location**
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
-  - _Type_: `'static' | 'dynamic' | 'fetch'`
-  - _Default_: `'static'`
-  - _Description_: Controls how dictionaries are imported.
-  - _Example_: `'dynamic'`
+  - _Примітка_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Тип_: `'static' | 'dynamic' | 'fetch'`
+  - _Типово_: `'static'`
+  - _Опис_: Controls how dictionaries are imported.
+  - _Приклад_: `'dynamic'`
 - **priority**
 - **live**
 - **schema**
@@ -962,11 +970,11 @@ export default config;
   - _Примітка_: Режим роботи логера. Режим `verbose` записуватиме більше інформації й підходить для налагодження. Режим `disabled` вимкне логер.
 
 - **prefix**:
-  - _Type_: `string`
-  - _Default_: `'[intlayer] '`
-  - _Description_: Префікс logger'а.
-  - _Example_: `'[my custom prefix] '`
-  - _Note_: Префікс logger'а.
+  - _Тип_: `string`
+  - _Типово_: `'[intlayer] '`
+  - _Опис_: Префікс logger'а.
+  - _Приклад_: `'[my custom prefix] '`
+  - _Примітка_: Префікс logger'а.
 
 ### Конфігурація AI
 
@@ -1000,48 +1008,48 @@ Intlayer підтримує кількох постачальників ШІ д
 #### Властивості
 
 - **provider**:
-  - _Type_: `string`
-  - _Default_: `'openai'`
-  - _Description_: Постачальник, який використовуватиметься для функцій ШІ Intlayer.
+  - _Тип_: `string`
+  - _Типово_: `'openai'`
+  - _Опис_: Постачальник, який використовуватиметься для функцій ШІ Intlayer.
   - _Options_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`, `'ollama'`, `'openrouter'`, `'alibaba'`, `'fireworks'`, `'groq'`, `'huggingface'`, `'bedrock'`, `'googleaistudio'`, `'googlevertex'`, `'togetherai'`
-  - _Example_: `'anthropic'`
-  - _Note_: Різні провайдери можуть вимагати різні API-ключі та мати різні моделі ціноутворення.
+  - _Приклад_: `'anthropic'`
+  - _Примітка_: Різні провайдери можуть вимагати різні API-ключі та мати різні моделі ціноутворення.
 
 - **model**:
-  - _Type_: `string`
-  - _Default_: None
-  - _Description_: Модель, яку слід використовувати для функцій ШІ в Intlayer.
-  - _Example_: `'gpt-4o-2024-11-20'`
-  - _Note_: Конкретна модель для використання залежить від провайдера.
+  - _Тип_: `string`
+  - _Типово_: None
+  - _Опис_: Модель, яку слід використовувати для функцій ШІ в Intlayer.
+  - _Приклад_: `'gpt-4o-2024-11-20'`
+  - _Примітка_: Конкретна модель для використання залежить від провайдера.
 
 - **temperature**:
-  - _Type_: `number`
-  - _Default_: None
-  - _Description_: Параметр temperature контролює випадковість відповідей ШІ.
-  - _Example_: `0.1`
-  - _Note_: Вища температура зробить ШІ більш креативним та менш передбачуваним.
+  - _Тип_: `number`
+  - _Типово_: None
+  - _Опис_: Параметр temperature контролює випадковість відповідей ШІ.
+  - _Приклад_: `0.1`
+  - _Примітка_: Вища температура зробить ШІ більш креативним та менш передбачуваним.
 
 - **apiKey**:
-  - _Type_: `string`
-  - _Default_: None
-  - _Description_: Ваш API-ключ для вибраного провайдера.
-  - _Example_: `process.env.OPENAI_API_KEY`
-  - _Note_: Важливо: API-ключі слід зберігати в таємниці та не поширювати публічно. Будь ласка, зберігайте їх у безпечному місці, наприклад у змінних середовища.
+  - _Тип_: `string`
+  - _Типово_: None
+  - _Опис_: Ваш API-ключ для вибраного провайдера.
+  - _Приклад_: `process.env.OPENAI_API_KEY`
+  - _Примітка_: Важливо: API-ключі слід зберігати в таємниці та не поширювати публічно. Будь ласка, зберігайте їх у безпечному місці, наприклад у змінних середовища.
 
 - **applicationContext**:
-  - _Type_: `string`
-  - _Default_: None
-  - _Description_: Надає додатковий контекст про ваш застосунок для AI-моделі, допомагаючи їй генерувати точніші та контекстуально доречні переклади. Це може включати інформацію про домен вашого додатку, цільову аудиторію, тон або специфічну термінологію.
-  - _Note_: Ви можете використовувати його, щоб додати більше правил для AI-моделі (e.g. "You should not transform urls").
-  - _Example_: `'My application context'`
+  - _Тип_: `string`
+  - _Типово_: None
+  - _Опис_: Надає додатковий контекст про ваш застосунок для AI-моделі, допомагаючи їй генерувати точніші та контекстуально доречні переклади. Це може включати інформацію про домен вашого додатку, цільову аудиторію, тон або специфічну термінологію.
+  - _Примітка_: Ви можете використовувати його, щоб додати більше правил для AI-моделі (e.g. "You should not transform urls").
+  - _Приклад_: `'My application context'`
 
 - **baseURL**:
-  - _Type_: `string`
-  - _Default_: None
-  - _Description_: Базовий URL для AI API.
-  - _Example_: `'https://api.openai.com/v1'`
-  - _Example_: `'http://localhost:5000'`
-  - _Note_: Може використовуватися для вказівки локального або кастомного AI API endpoint.
+  - _Тип_: `string`
+  - _Типово_: None
+  - _Опис_: Базовий URL для AI API.
+  - _Приклад_: `'https://api.openai.com/v1'`
+  - _Приклад_: `'http://localhost:5000'`
+  - _Примітка_: Може використовуватися для вказівки локального або кастомного AI API endpoint.
 
 - **dataSerialization**:
   - _Тип_: `'json' | 'toon'`
@@ -1065,7 +1073,7 @@ Intlayer підтримує кількох постачальників ШІ д
 #### Властивості
 
 - **mode**:
-  - _Type_: `'auto' | 'manual'`
+  - _Тип_: `'auto' | 'manual'`
   - _За замовчуванням_: `'auto'`
   - _Опис_: Керує режимом збірки.
   - _Приклад_: `'manual'`
@@ -1085,7 +1093,7 @@ Intlayer підтримує кількох постачальників ШІ д
   - _Примітка_: Переконайтесь, що всі ключі оголошені статично у викликах `useIntlayer`. Наприклад `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Note_: **Deprecated**: Use `dictionary.importMode` instead.
+  - _Примітка_: **Deprecated**: Use `dictionary.importMode` instead.
   - _Тип_: `'static' | 'dynamic' | 'fetch'`
   - _За замовчуванням_: `'static'`
   - _Опис_: Керує тим, як імпортуються словники.
@@ -1094,35 +1102,35 @@ Intlayer підтримує кількох постачальників ШІ д
     - "static": Словники імпортуються статично. Замінює `useIntlayer` на `useDictionary`.
     - "dynamic": Словники імпортуються динамічно з використанням Suspense. Замінює `useIntlayer` на `useDictionaryDynamic`.
     - "fetch": Словники отримуються динамічно з використанням live sync API. Замінює `useIntlayer` на `useDictionaryDynamic`.
-  - _Note_: Динамічні імпорти залежать від Suspense і можуть дещо вплинути на продуктивність рендерингу.
-  - _Note_: Якщо вимкнено, усі локалі будуть завантажені одночасно, навіть якщо вони не використовуються.
-  - _Note_: Ця опція покладається на плагіни `@intlayer/babel` та `@intlayer/swc`.
-  - _Note_: Переконайтеся, що всі ключі оголошені статично у викликах `useIntlayer`. Наприклад `useIntlayer('navbar')`.
-  - _Note_: Ця опція буде ігноруватися, якщо `optimize` вимкнено.
-  - _Note_: Якщо встановлено в "live", лише ті словники, які містять віддалений контент і позначені прапорцем "live", будуть перетворені у live-режим. Інші будуть імпортовані динамічно як режим "dynamic" для оптимізації кількості запитів і швидкості завантаження.
-  - _Note_: У режимі live буде використовуватися Live Sync API для отримання словників. Якщо виклик API завершиться невдачею, словники будуть імпортовані динамічно в режимі "dynamic".
-  - _Note_: Ця опція не вплине на функції `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` та `useDictionaryDynamic`.
+  - _Примітка_: Динамічні імпорти залежать від Suspense і можуть дещо вплинути на продуктивність рендерингу.
+  - _Примітка_: Якщо вимкнено, усі локалі будуть завантажені одночасно, навіть якщо вони не використовуються.
+  - _Примітка_: Ця опція покладається на плагіни `@intlayer/babel` та `@intlayer/swc`.
+  - _Примітка_: Переконайтеся, що всі ключі оголошені статично у викликах `useIntlayer`. Наприклад `useIntlayer('navbar')`.
+  - _Примітка_: Ця опція буде ігноруватися, якщо `optimize` вимкнено.
+  - _Примітка_: Якщо встановлено в "live", лише ті словники, які містять віддалений контент і позначені прапорцем "live", будуть перетворені у live-режим. Інші будуть імпортовані динамічно як режим "dynamic" для оптимізації кількості запитів і швидкості завантаження.
+  - _Примітка_: У режимі live буде використовуватися Live Sync API для отримання словників. Якщо виклик API завершиться невдачею, словники будуть імпортовані динамічно в режимі "dynamic".
+  - _Примітка_: Ця опція не вплине на функції `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` та `useDictionaryDynamic`.
 - **checkTypes**:
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Вказує, чи повинна збірка перевіряти типи TypeScript та реєструвати помилки.
-  - _Note_: Це може уповільнити процес збірки.
+  - _Тип_: `boolean`
+  - _Типово_: `false`
+  - _Опис_: Вказує, чи повинна збірка перевіряти типи TypeScript та реєструвати помилки.
+  - _Примітка_: Це може уповільнити процес збірки.
 
 - **outputFormat**:
-  - _Type_: `'esm' | 'cjs'`
-  - _Default_: `'esm'`
-  - _Description_: Керує форматом виводу словників.
-  - _Example_: `'cjs'`
-  - _Note_: Формат виводу словників.
+  - _Тип_: `'esm' | 'cjs'`
+  - _Типово_: `'esm'`
+  - _Опис_: Керує форматом виводу словників.
+  - _Приклад_: `'cjs'`
+  - _Примітка_: Формат виводу словників.
 
 - **traversePattern**:
-  - _Type_: `string[]`
-  - _Default_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
-  - _Description_: Шаблони, що визначають, які файли слід обходити під час оптимізації.
-    - _Example_: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}', '!**/node_modules/**']`
-  - _Note_: Використовуйте це, щоб обмежити оптимізацію релевантними файлами коду та покращити продуктивність збірки.
-  - _Note_: Ця опція буде ігнорована, якщо `optimize` вимкнено.
-  - _Note_: Використовуйте glob-шаблон.
+  - _Тип_: `string[]`
+  - _Типово_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
+  - _Опис_: Шаблони, що визначають, які файли слід обходити під час оптимізації.
+    - _Приклад_: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Примітка_: Використовуйте це, щоб обмежити оптимізацію релевантними файлами коду та покращити продуктивність збірки.
+  - _Примітка_: Ця опція буде ігнорована, якщо `optimize` вимкнено.
+  - _Примітка_: Використовуйте glob-шаблон.
 
 ---
 
@@ -1169,3 +1177,31 @@ Intlayer підтримує кількох постачальників ШІ д
   - _Тип_: `string`
   - _За замовчуванням_: `'compiler'`
   - _Опис_: Каталог, у якому будуть зберігатися витягнуті словники, відносно базового шляху вашого проекту.
+
+- **output**:
+  - _Тип_: `FilePathPattern`
+  - _Типово_: `({ key }) => 'compiler/${key}.content.json'`
+  - _Опис_: Визначає шлях до вихідних файлів. Замінює `outputDir`. Обробляє динамічні змінні, такі як `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}` та `{{componentFormat}}`. Можна встановити як рядок у форматі `'my/{{var}}/path'` або як функцію.
+  - _Примітка_: Шляхи `./**/*` розв'язуються відносно компонента. Шляхи `/**/*` розв'язуються відносно `baseDir` Intlayer.
+  - _Приклад_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+
+- **noMetadata**:
+  - _Тип_: `boolean`
+  - _Типово_: `false`
+  - _Опис_: Вказує, чи мають метадані зберігатися у файлі. Якщо true, компілятор не зберігатиме метадані словників (ключ, оболонка вмісту).
+  - _Примітка_: Корисно при використанні з плагіном `loadJSON`.
+  - _Приклад_: Якщо `true`:
+    ```json
+    {
+      "key": "value"
+    }
+    ```
+    Якщо `false`:
+    ```json
+    {
+      "key": "value",
+      "content": {
+        "key": "value"
+      }
+    }
+    ```

package/docs/uk/intlayer_with_nextjs_compiler.md

@@ -20,6 +20,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: Перший випуск
@@ -128,23 +131,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Вказує, чи повинен бути включений компілятор.
+     * Вказує, чи має бути увімкнено компілятор.
      */
     enabled: true,
 
     /**
      * Вихідний каталог для оптимізованих словників.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Вставте лише вміст у згенерований файл, без ключа.
+     */
+    noMetadata: false,
 
     /**
      * Префікс ключа словника
      */
-    dictionaryKeyPrefix: "", // Видалити базовий префікс
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Вказує, чи повинні компоненти зберігатися після трансформації.
-     * Таким чином, компілятор можна запустити один раз для трансформації додатка, після чого його можна видалити.
+     * Вказує, чи мають компоненти зберігатися після трансформації.
+     * Таким чином компілятор можна запустити лише один раз для трансформації додатка, а потім видалити.
      */
     saveComponents: false,
   },

package/docs/uk/intlayer_with_vite+react_compiler.md

@@ -19,6 +19,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 history:
+  - version: 8.2.0
+    date: 2026-03-09
+    changes: Update compiler options, add FilePathPattern support
   - version: 8.1.6
     date: 2026-02-23
     changes: Початковий реліз
@@ -125,23 +128,28 @@ const config: IntlayerConfig = {
   },
   compiler: {
     /**
-     * Вказує, чи повинен бути включений компілятор.
+     * Вказує, чи має бути увімкнено компілятор.
      */
     enabled: true,
 
     /**
      * Вихідний каталог для оптимізованих словників.
      */
-    outputDir: "compiler",
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+
+    /**
+     * Вставте лише вміст у згенерований файл, без ключа.
+     */
+    noMetadata: false,
 
     /**
      * Префікс ключа словника
      */
-    dictionaryKeyPrefix: "", // Видалити базовий префікс
+    dictionaryKeyPrefix: "", // Remove base prefix
 
     /**
-     * Вказує, чи повинні компоненти зберігатися після трансформації.
-     * Таким чином, компілятор можна запустити один раз для трансформації додатка, після чого його можна видалити.
+     * Вказує, чи мають компоненти зберігатися після трансформації.
+     * Таким чином компілятор можна запустити лише один раз для трансформації додатка, а потім видалити.
      */
     saveComponents: false,
   },