@intlayer/docs 8.4.5 → 8.4.6

package/docs/uk/configuration.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-12
-title: Конфігурація
-description: Дізнайтеся, як налаштувати Intlayer для вашого застосунку. Зрозумійте різні параметри та опції, доступні для налаштування Intlayer відповідно до ваших потреб.
+updatedAt: 2026-03-20
+title: Конфігурація (Configuration)
+description: Дізнайтеся, як налаштувати Intlayer для вашого додатка. Зрозумійте різні параметри та опції, доступні для налаштування Intlayer відповідно до ваших потреб.
 keywords:
   - Конфігурація
   - Налаштування
@@ -14,30 +14,42 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.4.0
+    date: 2026-03-20
+    changes: Додано об'єктну нотацію для кожної мови для 'compiler.output' та 'dictionary.fill'
   - version: 8.3.0
     date: 2026-03-11
-    changes: Перемістити 'baseDir' з конфігурації 'content' до конфігурації 'system'
+    changes: Переміщено 'baseDir' з конфігурації 'content' до конфігурації 'system'
   - version: 8.2.0
     date: 2026-03-09
-    changes: Оновлення опцій компілятора, додавання підтримки 'output' та 'noMetadata'
+    changes: Оновлено параметри компілятора (compiler), додано підтримку 'output' та 'noMetadata'
   - version: 8.1.7
     date: 2026-02-25
-    changes: Оновлення опцій компілятора
+    changes: Оновлено параметри компілятора
+  - version: 8.1.5
+    date: 2026-02-23
+    changes: Додано параметр компілятора 'build-only' та префікс словника
   - version: 8.0.6
     date: 2026-02-12
     changes: Додано підтримку провайдерів Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face та Together.ai
   - version: 8.0.5
     date: 2026-02-06
     changes: Додано `dataSerialization` до конфігурації AI
+  - version: 8.0.0
+    date: 2026-01-24
+    changes: Перейменовано режим імпорту `live` на `fetch` для кращого опису механізму роботи.
+  - version: 8.0.0
+    date: 2026-01-22
+    changes: Переміщено конфігурацію збірки `importMode` до конфігурації словника `dictionary`.
   - version: 8.0.0
     date: 2026-01-22
-    changes: Перемістити конфігурацію збірки importMode до конфігурації словника.
+    changes: Додано опцію `rewrite` до конфігурації маршрутизації
   - version: 8.0.0
     date: 2026-01-18
-    changes: Розділити конфігурацію системи від конфігурації контенту. Перемістити внутрішні шляхи до властивості `system`. Додати `codeDir` для розділення файлів контенту та перетворення коду.
+    changes: Відокремлено системну конфігурацію від конфігурації контенту. Переміщено внутрішні шляхи до властивості `system`. Додано `codeDir` для відокремлення файлів контенту та трансформації коду.
   - version: 8.0.0
     date: 2026-01-18
-    changes: Додано опції словника `location` та `schema`
+    changes: Додано параметри словника `location` та `schema`
   - version: 7.5.1
     date: 2026-01-10
     changes: Додано підтримку форматів файлів JSON5 та JSONC
@@ -49,41 +61,41 @@ history:
     changes: Додано конфігурацію `dictionary`
   - version: 7.0.0
     date: 2025-10-21
-    changes: Замінено `middleware` на конфігурацію `routing`
+    changes: Замінено `middleware` конфігурацією маршрутизації `routing`
   - version: 7.0.0
     date: 2025-10-12
     changes: Додано опцію `formatCommand`
   - version: 6.2.0
     date: 2025-10-12
-    changes: Оновлено опцію `excludedPath`
+    changes: Оновлено параметр `excludedPath`
   - version: 6.0.2
     date: 2025-09-23
-    changes: Додано опцію `outputFormat`
+    changes: Додано параметр `outputFormat`
   - version: 6.0.0
     date: 2025-09-21
-    changes: Вилучено поле `dictionaryOutput` та поле `i18nextResourcesDir`
+    changes: Видалено поля `dictionaryOutput` та `i18nextResourcesDir`
   - version: 6.0.0
     date: 2025-09-16
     changes: Додано режим імпорту `live`
   - version: 6.0.0
     date: 2025-09-04
-    changes: Замінено поле `hotReload` на `liveSync` та додано поля `liveSyncPort` і `liveSyncURL`
+    changes: Замінено поле `hotReload` на `liveSync`, додано поля `liveSyncPort` та `liveSyncURL`
   - version: 5.6.1
     date: 2025-07-25
     changes: Замінено `activateDynamicImport` опцією `importMode`
   - version: 5.6.0
     date: 2025-07-13
-    changes: Змінено значення за замовчуванням для contentDir з `['src']` на `['.']`
+    changes: Змінено значення за замовчуванням для `contentDir` з `['src']` на `['.']`
   - version: 5.5.11
     date: 2025-06-29
     changes: Додано команди `docs`
 ---
 
-# Документація конфігурації Intlayer
+# Документація з конфігурації Intlayer
 
 ## Огляд
 
-Файли конфігурації Intlayer дозволяють налаштовувати різні аспекти плагіна, такі як інтернаціоналізація, middleware та обробка контенту. У цьому документі наведено детальний опис кожної властивості конфігурації.
+Конфігураційні файли Intlayer дозволяють налаштовувати різні аспекти плагіна, такі як інтернаціоналізація (internationalization), проміжне програмне забезпечення (middleware) та обробка контенту. Ця документація надає детальний опис кожної властивості в конфігурації.
 
 ---
 
@@ -93,9 +105,9 @@ history:
 
 ---
 
-## Підтримувані формати файлів конфігурації
+## Підтримувані формати конфігураційних файлів
 
-Intlayer підтримує формати файлів конфігурації JSON, JS, MJS та TS:
+Intlayer приймає формати конфігураційних файлів JSON, JS, MJS та TS:
 
 - `intlayer.config.ts`
 - `intlayer.config.js`
@@ -108,7 +120,7 @@ Intlayer підтримує формати файлів конфігурації
 
 ---
 
-## Приклад файлу конфігурації
+## Приклад конфігураційного файлу
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -116,108 +128,108 @@ import { nextjsRewrite } from "intlayer/routing";
 import { z } from "zod";
 
 /**
- * Example Intlayer configuration file showing all available options.
+ * Приклад конфігураційного файлу Intlayer, що відображає всі доступні опції.
  */
 const config: IntlayerConfig = {
   /**
-   * Configuration for internationalization settings.
+   * Налаштування інтернаціоналізації.
    */
   internationalization: {
     /**
-     * List of supported locales in the application.
-     * Default: [Locales.ENGLISH]
+     * Список мов (locales), що підтримуються в додатку.
+     * За замовчуванням: [Locales.ENGLISH]
      */
     locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
 
     /**
-     * List of required locales that must be defined in every dictionary.
-     * If empty, all locales are required in `strict` mode.
-     * Default: []
+     * Список обов'язкових мов, які повинні бути визначені в кожному словнику.
+     * Якщо порожньо, усі мови є обов'язковими в режимі `strict`.
+     * За замовчуванням: []
      */
     requiredLocales: [Locales.ENGLISH],
 
     /**
-     * Strictness level for internationalized content.
-     * - "strict": Errors if any declared locale is missing or undeclared.
-     * - "inclusive": Warnings if a declared locale is missing.
-     * - "loose": Accepts any existing locale.
-     * Default: "inclusive"
+     * Рівень суворості для інтернаціоналізованого контенту.
+     * - "strict": Помилка, якщо будь-яка оголошена мова відсутня або не оголошена.
+     * - "inclusive": Попередження, якщо оголошена мова відсутня.
+     * - "loose": Приймає будь-яку існуючу мову.
+     * За замовчуванням: "inclusive"
      */
     strictMode: "inclusive",
 
     /**
-     * Default locale used as a fallback if the requested locale is not found.
-     * Default: Locales.ENGLISH
+     * Мова за замовчуванням, яка використовується як резервна, якщо запитувана мова не знайдена.
+     * За замовчуванням: Locales.ENGLISH
      */
     defaultLocale: Locales.ENGLISH,
   },
 
   /**
-   * Settings that control dictionary operations and fallback behavior.
+   * Параметри, що контролюють операції зі словниками та поведінку резервного копіювання.
    */
   dictionary: {
     /**
-     * Controls how dictionaries are imported.
-     * - "static": Statically imported at build time.
-     * - "dynamic": Dynamically imported using Suspense.
-     * - "fetch": Fetched dynamically via the live sync API.
-     * Default: "static"
+     * Контролює спосіб імпорту словників.
+     * - "static": Статично імпортується під час збірки.
+     * - "dynamic": Динамічно імпортується за допомогою Suspense.
+     * - "fetch": Динамічно отримується через Live Sync API.
+     * За замовчуванням: "static"
      */
     importMode: "static",
 
     /**
-     * Strategy for auto-filling missing translations using AI.
-     * Can be a boolean or a path pattern to store filled content.
-     * Default: true
+     * Стратегія автоматичного заповнення відсутніх перекладів за допомогою AI.
+     * Може бути логічним значенням або шаблоном шляху для збереження заповненого контенту.
+     * За замовчуванням: true
      */
     fill: true,
 
     /**
-     * Physical location of the dictionary files.
-     * - "local": Stored in the local filesystem.
-     * - "remote": Stored in the Intlayer CMS.
-     * - "hybrid": Stored in the local filesystem and the Intlayer CMS.
-     * - "plugin" (or any custom string): Provided by a plugin or a custom source.
-     * Default: "local"
+     * Фізичне розташування файлів словника.
+     * - "local": Зберігається в локальній файловій системі.
+     * - "remote": Зберігається в Intlayer CMS.
+     * - "hybrid": Зберігається як локально, так і в Intlayer CMS.
+     * - "plugin" (або будь-який користувацький рядок): Надається плагіном або користувацьким джерелом.
+     * За замовчуванням: "local"
      */
     location: "local",
 
     /**
-     * Whether to automatically transform content (e.g., Markdown to HTML).
-     * Default: false
+     * Чи повинен контент автоматично трансформуватися (наприклад, з Markdown в HTML).
+     * За замовчуванням: false
      */
     contentAutoTransformation: false,
   },
 
   /**
-   * Routing and middleware configuration.
+   * Конфігурація маршрутизації та проміжного ПЗ.
    */
   routing: {
     /**
-     * Locale routing strategy.
-     * - "prefix-no-default": Prefix all except the default locale (e.g., /dashboard, /fr/dashboard).
-     * - "prefix-all": Prefix all locales (e.g., /en/dashboard, /fr/dashboard).
-     * - "no-prefix": No locale in the URL.
-     * - "search-params": Use ?locale=...
-     * Default: "prefix-no-default"
+     * Стратегія маршрутизації мов.
+     * - "prefix-no-default": Додає префікс усім мовам, крім мови за замовчуванням (наприклад, /dashboard, /fr/dashboard).
+     * - "prefix-all": Додає префікс усім мовам (наприклад, /en/dashboard, /fr/dashboard).
+     * - "no-prefix": Мова відсутня в URL.
+     * - "search-params": Використовує ?locale=...
+     * За замовчуванням: "prefix-no-default"
      */
     mode: "prefix-no-default",
 
     /**
-     * Where to store the user's selected locale.
-     * Options: 'cookie', 'localStorage', 'sessionStorage', 'header', or an array of these.
-     * Default: ['cookie', 'header']
+     * Де зберігати вибрану користувачем мову.
+     * Опції: 'cookie', 'localStorage', 'sessionStorage', 'header' або їх масив.
+     * За замовчуванням: ['cookie', 'header']
      */
     storage: ["cookie", "header"],
 
     /**
-     * Base path for the application URLs.
-     * Default: ""
+     * Базовий шлях для URL додатка.
+     * За замовчуванням: ""
      */
     basePath: "",
 
     /**
-     * Custom URL rewriting rules for locale-specific paths.
+     * Користувацькі правила перенаправлення (rewrite) URL для конкретних шляхів за мовами.
      */
     rewrite: nextjsRewrite({
       "/[locale]/about": {
@@ -228,130 +240,130 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Settings for finding and processing content files.
+   * Параметри, пов'язані з пошуком та обробкою файлів контенту.
    */
   content: {
     /**
-     * File extensions to scan for dictionaries.
-     * Default: ['.content.ts', '.content.js', '.content.json', etc.]
+     * Розширення файлів для сканування словників.
+     * За замовчуванням: ['.content.ts', '.content.js', '.content.json' тощо]
      */
     fileExtensions: [".content.ts", ".content.js", ".content.json"],
 
     /**
-     * Directories where .content files are located.
-     * Default: ["."]
+     * Директорії, де розташовані файли .content.
+     * За замовчуванням: ["."]
      */
     contentDir: ["src"],
 
     /**
-     * Directories where source code is located.
-     * Used for build optimization and code transformation.
-     * Default: ["."]
+     * Де розташований вихідний код.
+     * Використовується для оптимізації збірки та трансформації коду.
+     * За замовчуванням: ["."]
      */
     codeDir: ["src"],
 
     /**
-     * Patterns to exclude from scanning.
-     * Default: ['node_modules', '.intlayer', etc.]
+     * Шаблони, виключені зі сканування.
+     * За замовчуванням: ['node_modules', '.intlayer' тощо]
      */
     excludedPath: ["node_modules"],
 
     /**
-     * Whether to watch for changes and rebuild dictionaries in development.
-     * Default: true in development
+     * Чи відстежувати зміни та перебудовувати словники під час розробки.
+     * За замовчуванням: true в режимі розробки
      */
     watch: true,
 
     /**
-     * Command to format newly created / updated .content files.
+     * Команда, що використовується для форматування новостворених / оновлених файлів .content.
      */
     formatCommand: 'npx prettier --write "{{file}}"',
   },
 
   /**
-   * Visual Editor configuration.
+   * Конфігурація візуального редактора (Visual Editor).
    */
   editor: {
     /**
-     * Whether the visual editor is enabled.
-     * Default: false
+     * Чи ввімкнено візуальний редактор.
+     * За замовчуванням: false
      */
     enabled: true,
 
     /**
-     * URL of your application for origin validation.
-     * Default: ""
+     * URL вашого додатка для перевірки джерела (origin validation).
+     * За замовчуванням: ""
      */
     applicationURL: "http://localhost:3000",
 
     /**
-     * Port for the local editor server.
-     * Default: 8000
+     * Порт для локального сервера редактора.
+     * За замовчуванням: 8000
      */
     port: 8000,
 
     /**
-     * Public URL for the editor.
-     * Default: "http://localhost:8000"
+     * Публічний URL для редактора.
+     * За замовчуванням: "http://localhost:8000"
      */
     editorURL: "http://localhost:8000",
 
     /**
-     * Intlayer CMS URL.
-     * Default: "https://app.intlayer.org"
+     * URL Intlayer CMS.
+     * За замовчуванням: "https://app.intlayer.org"
      */
     cmsURL: "https://app.intlayer.org",
 
     /**
-     * Backend API URL.
-     * Default: "https://back.intlayer.org"
+     * URL Backend API.
+     * За замовчуванням: "https://back.intlayer.org"
      */
     backendURL: "https://back.intlayer.org",
 
     /**
-     * Whether to enable real-time content synchronization.
-     * Default: false
+     * Чи ввімкнути синхронізацію контенту в реальному часі.
+     * За замовчуванням: false
      */
     liveSync: true,
   },
 
   /**
-   * AI-powered translation and generation settings.
+   * Параметри AI-перекладу та створення контенту.
    */
   ai: {
     /**
-     * AI provider to use.
-     * Options: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
-     * Default: 'openai'
+     * Провайдер AI для використання.
+     * Опції: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * За замовчуванням: 'openai'
      */
     provider: "openai",
 
     /**
-     * Model to use from the selected provider.
+     * Модель вибраного провайдера для використання.
      */
     model: "gpt-4o",
 
     /**
-     * Provider API key.
+     * API ключ провайдера.
      */
     apiKey: process.env.OPENAI_API_KEY,
 
     /**
-     * Global context to guide the AI in generating translations.
+     * Глобальний контекст для спрямування AI при створенні перекладів.
      */
-    applicationContext: "This is a travel booking application.",
+    applicationContext: "Це додаток для бронювання подорожей.",
 
     /**
-     * Base URL for the AI API.
+     * URL базового шляху для AI API.
      */
     baseURL: "http://localhost:3000",
 
     /**
-     * Серіалізація даних
+     * Серіалізація даних (Data Serialization)
      *
      * Опції:
-     * - "json": Стандартний, надійний; використовує більше токенів.
-     * - "toon": Менше токенів, менш послідовний, ніж JSON.
+     * - "json": За замовчуванням, надійно; споживає більше токенів.
+     * - "toon": Споживає менше токенів, може бути не таким стабільним, як JSON.
      *
      * За замовчуванням: "json"
      */
@@ -359,170 +371,170 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Build and optimization settings.
+   * Налаштування збірки та оптимізації.
    */
   build: {
     /**
-     * Build execution mode.
-     * - "auto": Automatic build during app build.
-     * - "manual": Requires explicit build command.
-     * Default: "auto"
+     * Режим виконання збірки.
+     * - "auto": Буде зібрано автоматично під час збірки додатка.
+     * - "manual": Потребує явної команди на збірку.
+     * За замовчуванням: "auto"
      */
     mode: "auto",
 
     /**
-     * Whether to optimize the final bundle by pruning unused dictionaries.
-     * Default: true in production
+     * Чи оптимізувати фінальний бандл шляхом видалення невикористовуваних словників.
+     * За замовчуванням: true у продуктовому середовищі
      */
     optimize: true,
 
     /**
-     * Output format for generated dictionary files.
-     * Default: ['esm', 'cjs']
+     * Формат виводу для згенерованих файлів словника.
+     * За замовчуванням: ['cjs', 'esm']
      */
-    outputFormat: ["esm"],
+    outputFormat: ["cjs", "esm"],
 
     /**
-     * Indicates if the build should check TypeScript types.
-     * Default: false
+     * Визначає, чи повинна збірка перевіряти типи TypeScript.
+     * За замовчуванням: false
      */
     checkTypes: false,
   },
 
   /**
-   * Logger configuration.
+   * Конфігурація логера (Logger).
    */
   log: {
     /**
-     * Logging level.
-     * - "default": Standard logging.
-     * - "verbose": Detailed debug logging.
-     * - "disabled": No logging.
-     * Default: "default"
+     * Рівень логування.
+     * - "default": Стандартне логування.
+     * - "verbose": Поглиблене дебаг-логування.
+     * - "disabled": Вимкнути логування.
+     * За замовчуванням: "default"
      */
     mode: "default",
 
     /**
-     * Prefix for all log messages.
-     * Default: "[intlayer]"
+     * Префікс для всіх повідомлень логування.
+     * За замовчуванням: "[intlayer]"
      */
     prefix: "[intlayer]",
   },
 
   /**
-   * System configuration (Advanced use cases)
+   * Системна конфігурація (Для розширеного використання)
    */
   system: {
     /**
-     * Directory for storing localization dictionaries.
+     * Директорія для зберігання локалізованих словників.
      */
     dictionariesDir: ".intlayer/dictionary",
 
     /**
-     * Directory for module augmentation.
+     * Директорія для розширення модулів TypeScript (module augmentation).
      */
     moduleAugmentationDir: ".intlayer/types",
 
     /**
-     * Directory for storing unmerged dictionaries.
+     * Директорія для зберігання незлитих (unmerged) словників.
      */
     unmergedDictionariesDir: ".intlayer/unmerged_dictionary",
 
     /**
-     * Directory for storing dictionary types.
+     * Директорія для зберігання типів словників.
      */
     typesDir: ".intlayer/types",
 
     /**
-     * Directory where main application files are stored.
+     * Директорія, де зберігаються основні файли додатка.
      */
     mainDir: ".intlayer/main",
 
     /**
-     * Directory where the configuration files are stored.
+     * Директорія, де зберігаються конфігураційні файли.
      */
     configDir: ".intlayer/config",
 
     /**
-     * Directory where the cache files are stored.
+     * Директорія, де зберігаються кеш-файли.
      */
     cacheDir: ".intlayer/cache",
   },
 
   /**
-   * Compiler configuration (Advanced use cases)
+   * Конфігурація компілятора (Для розширеного використання)
    */
   compiler: {
     /**
-     * Вказує, чи має бути увімкнено компілятор.
+     * Визначає, чи має бути ввімкнено компілятор.
      *
-     * - false : Вимкнути компілятор.
-     * - true : Увімкнути компілятор.
-     * - "build-only" : Пропустити компілятор під час розробки для прискорення запуску.
+     * - false: Вимикає компілятор.
+     * - true: Вмикає компілятор.
+     * - "build-only": Пропускає компілятор під час розробки та пришвидшує час запуску.
      *
-     * Значення за замовчуванням : false
+     * За замовчуванням: false
      */
     enabled: true,
 
     /**
-     * Визначає шлях до вихідних файлів. Замінює `outputDir`.
+     * Визначає шлях для вихідних файлів. Замінює `outputDir`.
      *
-     * - Шляхи, що починаються з `./`, розв'язуються відносно каталогу компонента.
-     * - Шляхи, що починаються з `/`, розв'язуються відносно кореня проєкту (`baseDir`).
+     * - Шляхи з `./` розв'язуються відносно директорії компонента.
+     * - Шляхи з `/` розв'язуються відносно кореня проєкту (`baseDir`).
      *
-     * - Включення змінної `{{locale}}` у шлях дозволить генерувати словники, розділені за локалями.
+     * - Додавання змінної `{{locale}}` у шлях активує створення окремих словників для кожної мови.
      *
-     * Приклади:
+     * Приклад:
      * ```ts
      * {
-     *   // Створює багатомовні файли .content.ts поруч із компонентом
+     *   // Створювати багатомовні файли .content.ts поряд з компонентом
      *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
      *
-     *   // output: './{{fileName}}{{extension}}', // Еквівалент з використанням рядкового шаблону
+     *   // output: './{{fileName}}{{extension}}', // Рівноцінно з використанням шаблонного рядка
      * }
      * ```
      *
      * ```ts
      * {
-     *   // Створює централізовані JSON-файли за локалями в корені проєкту
+     *   // Створювати централізовані JSON для кожної мови в корені проєкту
      *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
      *
-     *   // output: '/locales/{{locale}}/{{key}}.content.json', // Еквівалент з використанням рядкового шаблону
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // Рівноцінно з використанням шаблонного рядка
      * }
      * ```
      *
      * Список змінних:
-     *   - `fileName`: Назва файлу.
+     *   - `fileName`: Ім'я файлу.
      *   - `key`: Ключ контенту.
-     *   - `locale`: Локаль контенту.
+     *   - `locale`: Мова контенту.
      *   - `extension`: Розширення файлу.
-     *   - `componentFileName`: Назва файлу компонента.
+     *   - `componentFileName`: Ім'я файлу компонента.
      *   - `componentExtension`: Розширення файлу компонента.
      *   - `format`: Формат словника.
      *   - `componentFormat`: Формат словника компонента.
-     *   - `componentDirPath`: Шлях до каталогу компонента.
+     *   - `componentDirPath`: Шлях до директорії компонента.
      */
     output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Вказує, чи мають компоненти зберігатися після трансформації.
-     * Таким чином компілятор можна запустити лише один раз для трансформації додатка, а потім видалити.
+     * Визначає, чи мають компоненти зберігатися після трансформації.
+     * Таким чином, компілятор можна запустити лише один раз для трансформації вашого додатка, а потім видалити.
      */
     saveComponents: false,
 
     /**
-     * Вставляти лише вміст у згенерований файл. Корисно для JSON-виводів i18next або ICU MessageFormat для кожної локалі.
+     * Вставляє лише контент у згенерований файл. Корисно для JSON-виводу за мовами для i18next або ICU MessageFormat.
      */
     noMetadata: false,
 
     /**
      * Префікс ключа словника
      */
-    dictionaryKeyPrefix: "", // Додайте необов'язковий префікс для витягнутих ключів словника
+    dictionaryKeyPrefix: "", // Додайте необов'язковий префікс до витягнутих ключів словника
   },
 
   /**
-   * Custom schemas to validate the dictionaries content.
+   * Користувацькі схеми (Schemas) для валідації контенту словників.
    */
   schemas: {
     "my-schema": z.object({
@@ -531,7 +543,7 @@ const config: IntlayerConfig = {
   },
 
   /**
-   * Plugins configuration.
+   * Конфігурація плагінів (Plugins).
    */
   plugins: [],
 };
@@ -539,250 +551,116 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
-## Довідник конфігурації
+---
+
+## Довідник конфігурації (Configuration Reference)
 
-Нижченаведені розділи описують різні параметри конфігурації, доступні в Intlayer.
+Наступні розділи описують різні параметри конфігурації, доступні в Intlayer.
 
 ---
 
-### Налаштування інтернаціоналізації
-
-Визначає параметри, пов'язані з інтернаціоналізацією, включно з доступними локалями та локаллю за замовчуванням для застосунку.
-
-#### Властивості
-
-- **locales**:
-  - _Тип_: `string[]`
-  - _За замовчуванням_: `['en']`
-  - _Опис_: Список локалей, які підтримуються в застосунку.
-  - _Приклад_: `['en', 'fr', 'es']`
-
-- **requiredLocales**:
-  - _Тип_: `string[]`
-  - _За замовчуванням_: `[]`
-  - _Опис_: Перелік обов'язкових локалей у застосунку.
-  - _Приклад_: `[]`
-  - _Примітка_: Якщо порожній, усі локалі є обов'язковими в режимі `strict`.
-  - _Примітка_: Переконайтеся, що обов'язкові локалі також визначені в полі `locales`.
-- **strictMode**:
-  - _Тип_: `string`
-  - _Типово_: `inclusive`
-  - _Опис_: Забезпечує суворі реалізації інтернаціоналізованого контенту з використанням TypeScript.
-  - _Примітка_: Якщо встановлено "strict", функція перекладу `t` вимагатиме, щоб кожна оголошена локаль була визначена. Якщо якась локаль відсутня або не зазначена в конфігурації, буде викинута помилка.
-  - _Примітка_: Якщо встановлено "inclusive", функція перекладу `t` вимагатиме, щоб кожна оголошена locale була визначена. Якщо одна locale відсутня, буде виведено попередження. Проте функція прийме locale, яка не оголошена у вашій конфігурації, але існує.
-  - _Примітка_: Якщо встановлено "loose", функція перекладу `t` прийматиме будь-яку наявну locale.
-
-- **defaultLocale**:
-  - _Тип_: `string`
-  - _Типово_: `'en'`
-  - _Опис_: Локаль за замовчуванням, яка використовується як fallback, якщо запитувана локаль не знайдена.
-  - _Приклад_: `'en'`
-  - _Примітка_: Використовується для визначення локалі, коли вона не вказана в URL, cookie або заголовку.
+### Конфігурація інтернаціоналізації (Internationalization Configuration)
+
+Визначає налаштування, пов'язані з інтернаціоналізацією, включаючи доступні мови та мову за замовчуванням для додатка.
+
+| Поле              | Тип        | Опис                                                                                                                          | Приклад              | Примітка                                                                                                                                                                                                                                                                |
+| ----------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `locales`         | `string[]` | Список мов, що підтримуються в додатку. За замовчуванням: `[Locales.ENGLISH]`                                                 | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                         |
+| `requiredLocales` | `string[]` | Список обов'язкових мов у додатку. За замовчуванням: `[]`                                                                     | `[]`                 | Якщо порожньо, усі мови є обов'язковими в режимі `strict`. Переконайтеся, що обов'язкові мови також визначені у полі `locales`.                                                                                                                                         |
+| `strictMode`      | `string`   | Забезпечує надійну реалізацію інтернаціоналізованого контенту завдяки використанню TypeScript. За замовчуванням: `inclusive`  |                      | Якщо `"strict"`: функція `t` вимагає визначення кожної оголошеної мови — видає помилку, якщо будь-яка відсутня або не оголошена. Якщо `"inclusive"`: попереджає про відсутні мови, але приймає існуючі неоголошені мови. Якщо `"loose"`: приймає будь-яку існуючу мову. |
+| `defaultLocale`   | `string`   | Мова за замовчуванням, що використовується як резервна, якщо запитувана мова не знайдена. За замовчуванням: `Locales.ENGLISH` | `'en'`               | Використовується для визначення мови, коли жодна не вказана в URL, кукі або заголовку.                                                                                                                                                                                  |
 
 ---
 
-### Editor Configuration
-
-Визначає налаштування, пов'язані з інтегрованим редактором, включно з портом сервера та статусом активності.
-
-#### Properties
-
-- **applicationURL**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `http://localhost:3000`
-  - _Опис_: URL додатка. Використовується для обмеження origin редактора з міркувань безпеки.
-  - _Приклад_:
-    - `'http://localhost:3000'`
-    - `'https://example.com'`
-    - `process.env.INTLAYER_EDITOR_URL`
-  - _Примітка_: URL додатка. Використовується для обмеження origin редактора з міркувань безпеки. Якщо встановлено в `'*'`, редактор доступний з будь-якого origin.
-
-- **port**:
-  - _Тип_: `number`
-  - _За замовчуванням_: `8000`
-  - _Опис_: Порт, який використовується сервером візуального редактора.
-
-- **editorURL**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `'http://localhost:8000'`
-  - _Опис_: URL сервера редактора. Використовується для обмеження origin редактора з міркувань безпеки.
-    - `'http://localhost:3000'`
-    - `'https://example.com'`
-    - `process.env.INTLAYER_EDITOR_URL`
-  - _Примітка_: URL сервера редактора, до якого звертається додаток. Використовується для обмеження origins, які можуть взаємодіяти з додатком з міркувань безпеки. Якщо встановлено `'*'`, редактор доступний з будь-якого origin. Має бути вказаний, якщо змінено порт або якщо редактор розміщено на іншому домені.
-
-- **cmsURL**:
-  - _Тип_: `string`
-  - _Типово_: `'https://intlayer.org'`
-  - _Опис_: URL Intlayer CMS.
-  - _Приклад_: `'https://intlayer.org'`
-  - _Примітка_: URL Intlayer CMS.
-
-- **backendURL**:
-  - _Тип_: `string`
-  - _Типово_: `https://back.intlayer.org`
-  - _Опис_: URL backend-сервера.
-  - _Приклад_: `http://localhost:4000`
-
-- **enabled**:
-  - _Тип_: `boolean`
-  - _За замовчуванням_: `true`
-  - _Опис_: Вказує, чи додаток взаємодіє з візуальним редактором.
-  - _Приклад_: `process.env.NODE_ENV !== 'production'`
-  - _Примітка_: Якщо `true`, редактор зможе взаємодіяти з додатком. Якщо `false`, редактор не зможе взаємодіяти з додатком. У будь-якому випадку редактор може бути ввімкнений лише візуальним редактором. Вимкнення редактора для окремих середовищ, спосіб підвищити безпеку.
-
-- **clientId**:
-  - _Тип_: `string` | `undefined`
-  - _За замовчуванням_: `undefined`
-  - _Опис_: clientId і clientSecret дозволяють пакетам intlayer автентифікуватися з бекендом за допомогою автентифікації oAuth2. Access token використовується для автентифікації користувача, пов’язаного з проєктом. Щоб отримати access token, перейдіть на https://app.intlayer.org/project та створіть обліковий запис.
-  - _Приклад_: `true`
-  - _Примітка_: Важливо: clientId та clientSecret мають зберігатися в секреті і не розголошуватися публічно. Переконайтеся, що вони зберігаються у безпечному місці, наприклад у змінних оточення.
-
-- **clientSecret**:
-  - _Тип_: `string` | `undefined`
-  - _Типово_: `undefined`
-  - _Опис_: clientId та clientSecret дозволяють пакетам intlayer автентифікуватися з бекендом за допомогою oAuth2. Токен доступу використовується для автентифікації користувача, пов’язаного з проєктом. Щоб отримати токен доступу, перейдіть на https://app.intlayer.org/project і створіть обліковий запис.
-  - _Приклад_: `true`
-  - _Примітка_: Важливо: clientId та clientSecret слід зберігати в таємниці й не розголошувати публічно. Переконайтеся, що зберігаєте їх у безпечному місці, наприклад у environment variables.
-
-- **dictionaryPriorityStrategy**:
-  - _Тип_: `string`
-  - _Типово_: `'local_first'`
-  - _Опис_: Стратегія пріоритету словників у разі наявності як локальних, так і віддалених словників. Якщо встановлено `'distant_first'`, застосунок віддаватиме пріоритет віддаленим словникам над локальними. Якщо встановлено `'local_first'`, застосунок віддаватиме пріоритет локальним словникам над віддаленими.
-  - _Приклад_: `'distant_first'`
-
-- **liveSync**:
-  - _Тип_: `boolean`
-  - _Типово_: `false`
-  - _Опис_: Вказує, чи має сервер застосунку виконувати hot reload контенту застосунку при виявленні змін у CMS / Visual Editor / Backend.
-  - _Приклад_: `true`
-  - _Примітка_: Наприклад, коли додається або оновлюється новий словник, застосунок оновить контент, що відображається на сторінці.
-  - _Примітка_: Live sync потребує винесення вмісту застосунку на інший сервер. Це означає, що це може трохи вплинути на продуктивність застосунку. Щоб обмежити цей вплив, рекомендуємо розміщувати застосунок і live sync сервер на одній машині. Також комбінація live sync та `optimize` може спричинити значну кількість запитів до live sync сервера. Залежно від вашої інфраструктури, рекомендуємо протестувати обидві опції та їх комбінацію.
-
-- **liveSyncPort**:
-  - _Тип_: `number`
-  - _За замовчуванням_: `4000`
-  - _Опис_: Порт live sync сервера.
-  - _Приклад_: `4000`
-  - _Примітка_: Порт live sync сервера.
-
-- **liveSyncURL**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `'http://localhost:{liveSyncPort}'`
-  - _Опис_: URL live sync сервера.
-  - _Приклад_: `'https://example.com'`
-  - _Примітка_: За замовчуванням вказує на localhost, але може бути змінений на будь-який URL у випадку віддаленого live sync сервера.
-
-### Конфігурація маршрутизації
-
-Налаштування, що контролюють поведінку маршрутизації, включно зі структурою URL, зберіганням locale та обробкою middleware.
-
-#### Властивості
-
-- **mode**:
-  - _Тип_: `'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`
-  - _Примітка_: Це налаштування не впливає на керування cookie або зберіганням локалі.
-
-- **storage**:
-  - _Тип_: `false | 'cookie' | 'localStorage' | 'sessionStorage' | 'header' | CookiesAttributes | StorageAttributes | Array`
-  - _Типово_: `'localStorage'`
-  - _Опис_: Налаштування для зберігання локалі на клієнті.
-
-  - **cookie**:
-    - _Опис_: Зберігає дані в cookie, невеликі фрагменти даних, що зберігаються в браузері клієнта, доступні як на стороні клієнта, так і на стороні сервера.
-    - _Примітка_: Для зберігання, що відповідає вимогам GDPR, перед використанням забезпечте належну згоду користувача.
-    - _Примітка_: Параметри cookie можна налаштувати, якщо вказати їх як CookiesAttributes (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).
-
-  - **localStorage**:
-    - _Опис_: Зберігає дані в браузері без дат закінчення терміну дії, що дозволяє зберігати дані між сесіями, доступне лише на боці клієнта.
-    - _Примітка_: Ідеально підходить для зберігання довгострокових даних, проте слід враховувати питання приватності та безпеки через відсутність строку дії, якщо їх не видалити явно.
-    - _Примітка_: Сховище локалі доступне лише на боці клієнта, проксі intlayer не зможе до нього отримати доступ.
-    - _Примітка_: Параметри сховища локалі можна налаштувати, якщо вказати їх як StorageAttributes (`{ type: 'localStorage', name: 'custom-locale' }`).
-
-  - **sessionStorage**:
-    - _Опис_: Зберігає дані протягом сеансу сторінки, тобто вони очищуються після закриття вкладки або вікна, доступне лише на боці клієнта.
-    - _Примітка_: Підходить для тимчасового збереження даних для кожної сесії.
-    - _Примітка_: Сховище локалі доступне лише на стороні клієнта, проксі intlayer не зможе до нього звертатися.
-    - _Примітка_: Параметри збереження локалі можна налаштувати, якщо задати їх як StorageAttributes (`{ type: 'sessionStorage', name: 'custom-locale' }`).
-
-  - **header**:
-    - _Опис_: Використовує HTTP-заголовки для збереження або передачі даних локалі, підходить для визначення мови на стороні сервера.
-    - _Примітка_: Корисно в API-запитах для підтримки узгоджених налаштувань мови між запитами.
-    - _Примітка_: Заголовок доступний лише на стороні сервера, клієнт не зможе отримати до нього доступ.
-    - _Примітка_: Назву заголовка можна змінити, якщо вказати її в StorageAttributes (`{ type: 'header', name: 'custom-locale' }`).
-
-- **basePath**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `''`
-  - _Опис_: Базовий шлях для URL-адрес застосунку.
-  - _Приклад_: `'/my-app'`
-  - _Примітка_:
-    - Якщо застосунок розміщений за адресою `https://example.com/my-app`
-    - Базовий шлях, `'/my-app'`
-    - URL буде `https://example.com/my-app/en`
-    - Якщо базовий шлях не встановлено, URL буде `https://example.com/en`
-
-- **rewrite**:
-  - _Тип_: `Record<string, StrictModeLocaleMap<string>>`
-  - _За замовчуванням_: `undefined`
-  - _Опис_: Користувацькі правила перезапису URL, які перевизначають режим маршрутизації за замовчуванням для певних шляхів. Дозволяє визначати специфічні для локалі шляхи, які відрізняються від стандартної поведінки маршрутизації. Підтримує динамічні параметри маршруту з використанням синтаксису `[param]`.
-  - _Приклад_:
-    ```typescript
-    routing: {
-      mode: "prefix-no-default", // Стратегія відкату
-      rewrite: nextjsRewrite({
-        "/[locale]/about": {
-          en: "/[locale]/about",
-          fr: "/[locale]/a-propos",
-        },
-        "/[locale]/product/[slug]": {
-          en: "/[locale]/product/[slug]",
-          fr: "/[locale]/produit/[slug]",
-        },
-        "/[locale]/blog/[category]/[id]": {
-          en: "/[locale]/blog/[category]/[id]",
-          fr: "/[locale]/journal/[category]/[id]",
-        },
-      }),
-    }
-    ```
-  - _Примітка_: Правила перезапису мають пріоритет над поведінкою `mode` за замовчуванням. Якщо шлях відповідає правилу перезапису, буде використано локалізований шлях з конфігурації перезапису замість стандартного префікса локалі.
-  - _Примітка_: Динамічні параметри маршруту підтримуються з використанням нотації в квадратних дужках (наприклад, `[slug]`, `[id]`). Значення параметрів автоматично витягуються з URL та інтерполюються в перезаписаний шлях.
-  - _Примітка_: Працює з додатками Next.js та Vite. Middleware/proxy автоматично перезапише вхідні запити, щоб відповідати внутрішній структурі маршруту.
-  - _Примітка_: При генерації URL за допомогою `getLocalizedUrl()` правила перезапису автоматично застосовуються, якщо вони відповідають наданому шляху.
-  - _Посилання_: Для отримання додаткової інформації див. [Користувацьке перезаписування URL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/custom_url_rewrites.md).
-
-#### Атрибути cookie
-
-При використанні зберігання в cookie ви можете налаштувати додаткові атрибути cookie:
-
-- **name**: Ім'я cookie (за замовчуванням: `'INTLAYER_LOCALE'`)
-- **domain**: Домен cookie (за замовчуванням: undefined)
-- **path**: Шлях cookie (за замовчуванням: undefined)
-- **secure**: Вимагати HTTPS (за замовчуванням: undefined)
-- **httpOnly**: Прапорець лише для HTTP (httpOnly) (за замовчуванням: undefined)
-- **sameSite**: Політика SameSite (`'strict' | 'lax' | 'none'`)
-- **expires**: Дата закінчення строку дії або кількість днів (значення за замовчуванням: undefined)
-
-#### Атрибути збереження локалі
-
-Коли використовується localStorage або sessionStorage:
-
-- **type**: Тип сховища (`'localStorage' | 'sessionStorage'`)
-- **name**: Ім'я ключа в сховищі (за замовчуванням: `'INTLAYER_LOCALE'`)
+### Конфігурація редактора (Editor Configuration)
+
+Визначає налаштування, пов'язані з інтегрованим редактором, включаючи порт сервера та статус активності.
+
+| Поле                         | Тип                       | Опис                                                                                                                                                                                                                 | Приклад                                                                               | Примітка                                                                                                                                                                                                                         |
+| ---------------------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `applicationURL`             | `string`                  | URL вашого додатка. За замовчуванням: `''`                                                                                                                                                                           | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | Використовується для обмеження джерел (origins) редактора з міркувань безпеки. Якщо встановлено `'*'`, редактор доступний з будь-якого джерела.                                                                                  |
+| `port`                       | `number`                  | Порт, що використовується сервером візуального редактора. За замовчуванням: `8000`                                                                                                                                   |                                                                                       |                                                                                                                                                                                                                                  |
+| `editorURL`                  | `string`                  | URL сервера редактора. За замовчуванням: `'http://localhost:8000'`                                                                                                                                                   | `'http://localhost:3000'`, `'https://example.com'`, `process.env.INTLAYER_EDITOR_URL` | Використовується для обмеження джерел, які можуть взаємодіяти з додатком. Якщо встановлено `'*'`, доступний з будь-якого джерела. Повинен бути встановлений, якщо ви змінюєте порт або якщо редактор розміщено на іншому домені. |
+| `cmsURL`                     | `string`                  | URL Intlayer CMS. За замовчуванням: `'https://intlayer.org'`                                                                                                                                                         | `'https://intlayer.org'`                                                              |                                                                                                                                                                                                                                  |
+| `backendURL`                 | `string`                  | URL сервера бекенду. За замовчуванням: `https://back.intlayer.org`                                                                                                                                                   | `http://localhost:4000`                                                               |                                                                                                                                                                                                                                  |
+| `enabled`                    | `boolean`                 | Визначає, чи буде додаток взаємодіяти з візуальним редактором. За замовчуванням: `true`                                                                                                                              | `process.env.NODE_ENV !== 'production'`                                               | Якщо `false`, редактор не може взаємодіяти з додатком. Вимкнення для певних середовищ підвищує безпеку.                                                                                                                          |
+| `clientId`                   | `string &#124; undefined` | Дозволяє пакетам intlayer проходити автентифікацію на бекенді за допомогою oAuth2. Для отримання токена доступу перейдіть на [intlayer.org/project](https://app.intlayer.org/project). За замовчуванням: `undefined` |                                                                                       | Тримайте в секреті; зберігайте в змінних оточення.                                                                                                                                                                               |
+| `clientSecret`               | `string &#124; undefined` | Дозволяє пакетам intlayer проходити автентифікацію на бекенді за допомогою oAuth2. Для отримання токена доступу перейдіть на [intlayer.org/project](https://app.intlayer.org/project). За замовчуванням: `undefined` |                                                                                       | Тримайте в секреті; зберігайте в змінних оточення.                                                                                                                                                                               |
+| `dictionaryPriorityStrategy` | `string`                  | Стратегія пріоритетності словників за наявності як локальних, так і віддалених словників. За замовчуванням: `'local_first'`                                                                                          | `'distant_first'`                                                                     | `'distant_first'`: Надає пріоритет віддаленим словникам над локальними. `'local_first'`: Надає пріоритет локальним словникам над віддаленими.                                                                                    |
+| `liveSync`                   | `boolean`                 | Визначає, чи повинен сервер додатка виконувати гаряче перезавантаження контенту при виявленні зміни в CMS / візуальному редакторі / бекенді. За замовчуванням: `true`                                                | `true`                                                                                | Коли словник додається/оновлюється, додаток оновлює контент сторінки. Live sync передає контент на аутсорс іншому серверу, що може трохи вплинути на продуктивність. Рекомендується розміщувати обидва на одній машині.          |
+| `liveSyncPort`               | `number`                  | Порт сервера Live Sync. За замовчуванням: `4000`                                                                                                                                                                     | `4000`                                                                                |                                                                                                                                                                                                                                  |
+| `liveSyncURL`                | `string`                  | URL сервера Live Sync. За замовчуванням: `'http://localhost:{liveSyncPort}'`                                                                                                                                         | `'https://example.com'`                                                               | Вказує на localhost за замовчуванням; може бути змінено на віддалений сервер живої синхронізації.                                                                                                                                |
+
+### Конфігурація маршрутизації (Routing Configuration)
+
+Налаштування, що контролюють поведінку маршрутизації, включаючи структуру URL, зберігання мови та обробку проміжного ПЗ.
+
+| Поле       | Тип                                                                                                                                                  | Опис                                                                                                                                                                                        | Приклад                                                                                                                                                                                                      | Примітка                                                                                                                                                                                                                                                                     |
+| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`     | `'prefix-no-default' &#124; 'prefix-all' &#124; 'no-prefix' &#124; 'search-params'`                                                                  | Режим маршрутизації URL для обробки мов. За замовчуванням: `'prefix-no-default'`                                                                                                            | `'prefix-no-default'`: `/dashboard` (en) або `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: мова обробляється іншими засобами. `'search-params'`: використовує `/dashboard?locale=fr` | Не впливає на керування кукі або зберігання мови (locale storage).                                                                                                                                                                                                           |
+| `storage`  | `false &#124; 'cookie' &#124; 'localStorage' &#124; 'sessionStorage' &#124; 'header' &#124; CookiesAttributes &#124; StorageAttributes &#124; Array` | Конфігурація для зберігання мови на клієнті. За замовчуванням: `['cookie', 'header']`                                                                                                       | `'localStorage'`, `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                                | Див. таблицю Параметри зберігання нижче.                                                                                                                                                                                                                                     |
+| `basePath` | `string`                                                                                                                                             | Базовий шлях для URL додатка. За замовчуванням: `''`                                                                                                                                        | `'/my-app'`                                                                                                                                                                                                  | Якщо додаток знаходиться на `https://example.com/my-app`, basePath — це `'/my-app'`, а URL стають на кшталт `https://example.com/my-app/en`.                                                                                                                                 |
+| `rewrite`  | `Record<string, StrictModeLocaleMap<string>>`                                                                                                        | Користувацькі правила перенаправлення (rewrite) URL, що замінюють стандартний режим маршрутизації для певних шляхів. Підтримує динамічні параметри `[param]`. За замовчуванням: `undefined` | Див. приклад нижче                                                                                                                                                                                           | Правила перенаправлення мають пріоритет над `mode`. Працює з Next.js та Vite. `getLocalizedUrl()` автоматично застосовує відповідні правила. Див. [Користувацькі перенаправлення URL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/custom_url_rewrites.md). |
+
+**Приклад `rewrite`**:
+
+```typescript
+routing: {
+  mode: "prefix-no-default", // Резервна стратегія
+  rewrite: nextjsRewrite({
+    "/about": {
+      en: "/about",
+      fr: "/a-propos",
+    },
+    "/product/[slug]": {
+      en: "/product/[slug]",
+      fr: "/produit/[slug]",
+    },
+    "/blog/[category]/[id]": {
+      en: "/blog/[category]/[id]",
+      fr: "/journal/[category]/[id]",
+    },
+  }),
+}
+```
+
+#### Параметри зберігання (Storage Options)
+
+| Значення           | Опис                                                                         | Примітка                                                                                                                                                                                            |
+| ------------------ | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `'cookie'`         | Зберігає мову в кукі — доступно як з клієнтської, так і з серверної сторони. | Для відповідності GDPR переконайтеся, що отримано належну згоду користувача. Налаштовується через `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`). |
+| `'localStorage'`   | Зберігає мову в браузері без терміну дії — лише клієнтська сторона.          | Не закінчується, поки не буде явно очищено. Проксі Intlayer не може отримати доступ до цього. Налаштовується через `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`).         |
+| `'sessionStorage'` | Зберігає мову на час сесії сторінки — лише клієнтська сторона.               | Очищується при закритті вкладки/вікна. Проксі Intlayer не може отримати доступ до цього. Налаштовується через `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).            |
+| `'header'`         | Зберігає або передає мову через HTTP-заголовки — лише серверна сторона.      | Корисно для API-викликів. Клієнтська сторона не може отримати доступ. Налаштовується через `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                       |
+
+#### Атрибути кукі (Cookie Attributes)
+
+При використанні зберігання через кукі ви можете налаштувати додаткові атрибути кукі:
+
+| Поле       | Тип                                   | Опис                                                                          |
+| ---------- | ------------------------------------- | ----------------------------------------------------------------------------- |
+| `name`     | `string`                              | Назва кукі. За замовчуванням: `'INTLAYER_LOCALE'`                             |
+| `domain`   | `string`                              | Домен кукі. За замовчуванням: `undefined`                                     |
+| `path`     | `string`                              | Шлях кукі. За замовчуванням: `undefined`                                      |
+| `secure`   | `boolean`                             | Вимагає HTTPS. За замовчуванням: `undefined`                                  |
+| `httpOnly` | `boolean`                             | Флаг HTTP-only. За замовчуванням: `undefined`                                 |
+| `sameSite` | `'strict' &#124; 'lax' &#124; 'none'` | Політика SameSite.                                                            |
+| `expires`  | `Date &#124; number`                  | Дата закінчення терміну дії або кількість днів. За замовчуванням: `undefined` |
+
+#### Атрибути зберігання мови (Locale Storage Attributes)
+
+При використанні localStorage або sessionStorage:
+
+| Поле   | Тип                                      | Опис                                                          |
+| ------ | ---------------------------------------- | ------------------------------------------------------------- |
+| `type` | `'localStorage' &#124; 'sessionStorage'` | Тип зберігання.                                               |
+| `name` | `string`                                 | Назва ключа зберігання. За замовчуванням: `'INTLAYER_LOCALE'` |
 
 #### Приклади конфігурації
 
-Нижче наведені поширені приклади конфігурації для нової структури маршрутизації v7:
+Ось кілька поширених прикладів конфігурації для нової структури маршрутизації v7:
 
-**Базова конфігурація (за замовчуванням)**:
+**Базова конфігурація (За замовчуванням)**:
 
 ```typescript
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -795,14 +673,14 @@ const config: IntlayerConfig = {
   routing: {
     mode: "prefix-no-default",
     storage: "localStorage",
-    headerName: "x-intlayer-locale",
+    basePath: "",
   },
 };
 
 export default config;
 ```
 
-**Конфігурація, сумісна з GDPR**:
+**Конфігурація для відповідності GDPR**:
 
 ```typescript
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -827,13 +705,14 @@ const config: IntlayerConfig = {
         httpOnly: false,
       },
     ],
+    basePath: "",
   },
 };
 
 export default config;
 ```
 
-**Режим параметрів пошуку**:
+**Режим параметрів пошуку (Search Parameters Mode)**:
 
 ```typescript
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -845,13 +724,15 @@ const config: IntlayerConfig = {
   },
   routing: {
     mode: "search-params",
+    storage: "localStorage",
+    basePath: "",
   },
 };
 
 export default config;
 ```
 
-**Режим без префікса з кастомним сховищем**:
+**Режим без префікса (No Prefix Mode) з користувацьким сховищем**:
 
 ```typescript
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -865,7 +746,43 @@ const config: IntlayerConfig = {
     mode: "no-prefix",
     storage: {
       type: "sessionStorage",
+      name: "app-locale",
     },
+    basePath: "/my-app",
+  },
+};
+
+export default config;
+```
+
+**Користувацьке перенаправлення URL з динамічними шляхами**:
+
+```typescript
+// intlayer.config.ts
+import { nextjsRewrite } from "intlayer/routing";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: ["en", "fr"],
+    defaultLocale: "en",
+  },
+  routing: {
+    mode: "prefix-no-default", // Резервна стратегія для шляхів без перенаправлення
+    storage: "cookie",
+    rewrite: nextjsRewrite({
+      "/about": {
+        en: "/about",
+        fr: "/a-propos",
+      },
+      "/product/[slug]": {
+        en: "/product/[slug]",
+        fr: "/produit/[slug]",
+      },
+      "/blog/[category]/[id]": {
+        en: "/blog/[category]/[id]",
+        fr: "/journal/[category]/[id]",
+      },
+    }),
   },
 };
 
@@ -874,368 +791,132 @@ export default config;
 
 ---
 
-### Конфігурація контенту
+### Конфігурація контенту (Content Configuration)
 
-Налаштування, пов'язані з обробкою контенту в додатку, включаючи назви директорій, розширення файлів та похідні конфігурації.
+Налаштування, пов'язані з обробкою контенту всередині додатка (імена директорій, розширення файлів та похідні конфігурації).
 
-#### Властивості
+| Поле             | Тип        | Опис                                                                                                                                                                                                                      | Приклад                             | Примітка                                                                                                                                             |
+| ---------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `watch`          | `boolean`  | Визначає, чи повинен Intlayer відстежувати зміни у файлах оголошення контенту для перебудови словників. За замовчуванням: `process.env.NODE_ENV === 'development'`                                                        |                                     |                                                                                                                                                      |
+| `fileExtensions` | `string[]` | Розширення файлів, що використовуються для сканування файлів оголошення контенту. За замовчуванням: `['.content.ts', '.content.js', '.content.mjs', '.content.cjs', '.content.json', '.content.json5', '.content.jsonc']` | `['.content.ts', '.content.js']`    |                                                                                                                                                      |
+| `contentDir`     | `string[]` | Шляхи до директорій, де розташовані файли оголошення контенту. За замовчуванням: `['.']`                                                                                                                                  | `['src/content']`                   |                                                                                                                                                      |
+| `codeDir`        | `string[]` | Шляхи до директорій, де розташовані файли вихідного коду вашого додатка. За замовчуванням: `['.']`                                                                                                                        | `['src']`                           | Використовується для оптимізації збірки та гарантії того, що трансформація коду та гаряче перезавантаження застосовуються лише до необхідних файлів. |
+| `excludedPath`   | `string[]` | Шляхи, виключені зі сканування контенту. За замовчуванням: `['node_modules', '.intlayer', '.next', 'dist', 'build']`                                                                                                      | `['src/styles']`                    |                                                                                                                                                      |
+| `formatCommand`  | `string`   | Команда, яка буде виконана для форматування новостворених або оновлених файлів контенту. За замовчуванням: `undefined`                                                                                                    | `'npx prettier --write "{{file}}"'` | Використовується під час вилучення контенту або через візуальний редактор.                                                                           |
 
-- **watch**:
-  - _Тип_: `boolean`
-  - _За замовчуванням_: `process.env.NODE_ENV === 'development'`
-  - _Опис_: Вказує, чи Intlayer має відслідковувати зміни в файлах декларації контенту в додатку, щоб перебудувати відповідні словники.
+---
 
-- **fileExtensions**:
-  - _Тип_: `string[]`
-  - _За замовчуванням_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
-  - _Опис_: Розширення файлів, які слід шукати під час побудови словників.
-  - _Приклад_: `['.data.ts', '.data.js', '.data.json']`
-  - _Примітка_: Налаштування розширень файлів може допомогти уникнути конфліктів.
+### Конфігурація словника (Dictionary Configuration)
 
-- **contentDir**:
-  - _Тип_: `string[]`
-  - _За замовчуванням_: `['.']`
-  - _Приклад_: `['src', '../../ui-library', require.resolve("@my-package/content")]`
-  - _Опис_: Шлях до каталогу, де зберігаються файли визначення контенту (`.content.*`).
-  - _Примітка_: Використовується для відстеження файлів контенту для перебудови словників.
+Налаштування, що контролюють операції зі словниками, включаючи поведінку автоматичного заповнення та створення контенту.
 
-- **codeDir**:
-  - _Тип_: `string[]`
-  - _За замовчуванням_: `['.']`
-  - _Приклад_: `['src', '../../ui-library']`
-  - _Опис_: Шлях до каталогу, де зберігається код, відносно базового каталогу.
-  - _Примітка_: Використовується для відстеження файлів коду для перетворення (обрізання, оптимізація). Тримання цього окремо від `contentDir` може покращити продуктивність збірки, уникаючи непотрібного сканування файлів контенту.
+Ця конфігурація словника має дві основні мети:
+
+1. **Значення за замовчуванням**: Визначення значень за замовчуванням при створенні файлів оголошення контенту.
+2. **Поведінка резервного копіювання**: Дозволяє глобально налаштувати поведінку операцій зі словниками, надаючи резервні значення, коли конкретні поля не визначені.
+
+Для отримання додаткової інформації про те, як застосовуються файли оголошення контенту та значення конфігурації, див. [документацію файлів контенту](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md).
+
+| Поле                        | Тип                                                                                             | Опис                                                                                                             | Приклад            | Примітка                                                                                                                                                                                                                                                                                                                                                           |
+| --------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `fill`                      | `boolean &#124; FilePathPattern &#124; Partial<Record<Locale, boolean &#124; FilePathPattern>>` | Контролює, як генеруються вихідні файли автоматичного заповнення (AI-переклад). За замовчуванням: `true`         | Див. приклад нижче | `true`: шлях за замовчуванням (той самий файл, що й джерело). `false`: вимкнено. Шаблони рядків/функцій генерують файли за мовами. Об'єкт за мовами: кожна мова відповідає своєму шаблону; `false` пропускає цю мову. Включення змінної `{{locale}}` активує генерацію за мовами. `fill` на рівні словника завжди має пріоритет над цією глобальною конфігурацією. |
+| `importMode`                | `'static' &#124; 'dynamic' &#124; 'fetch'`                                                      | Контролює спосіб імпорту словників. За замовчуванням: `'static'`                                                 | `'dynamic'`        | `'static'`: Статично імпортується. `'dynamic'`: Динамічно імпортується через 'Suspense'. `'fetch'`: Динамічно отримується через 'Live Sync API'. Не впливає на `getIntlayer`, `getDictionary`, `useDictionary` тощо.                                                                                                                                               |
+| `location`                  | `'local' &#124; 'remote' &#124; 'hybrid' &#124; string`                                         | Де зберігаються словники. За замовчуванням: `'local'`                                                            | `'remote'`         | `'local'`: файлова система. `'remote'`: Intlayer CMS. `'hybrid'`: обидва.                                                                                                                                                                                                                                                                                          |
+| `contentAutoTransformation` | `boolean`                                                                                       | Чи повинні файли контенту автоматично трансформуватися (наприклад, з Markdown в HTML). За замовчуванням: `false` | `true`             | Корисно для обробки полів Markdown через @intlayer/markdown.                                                                                                                                                                                                                                                                                                       |
+
+**Приклад `fill`**:
+
+```ts
+dictionary: {
+  fill: {
+    en: '/locales/en/{{key}}.content.json',
+    fr: ({ key }) => `/locales/fr/${key}.content.json`,
+    es: false,
+  }
+}
+```
 
 ---
 
-### Конфігурація системи
-
-Налаштування, пов'язані з внутрішніми шляхами та вихідними результатами Intlayer. Ці налаштування зазвичай є внутрішніми і не повинні змінюватися користувачем.
-
-#### Властивості
-
-- **baseDir**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `process.cwd()`
-  - _Опис_: Базова директорія проекту.
-  - _Приклад_: `'/path/to/project'`
-  - _Примітка_: Використовується для визначення всіх директорій, пов'язаних з Intlayer.
-
-- **dictionariesDir**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `'.intlayer/dictionary'`
-  - _Опис_: Каталог для збереження словників локалізації.
-  - _Приклад_: `'translations'`
-
-- **moduleAugmentationDir**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `'.intlayer/types'`
-  - _Опис_: Каталог для module augmentation, що дозволяє покращені підказки IDE та перевірку типів.
-  - _Приклад_: `'intlayer-types'`
-  - _Примітка_: Переконайтеся, що цей каталог включений у `tsconfig.json`.
-
-- **unmergedDictionariesDir**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `'.intlayer/unmerged_dictionary'`
-  - _Опис_: Каталог для збереження незлитих словників.
-  - _Приклад_: `'translations'`
-
-- **typesDir**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `'types'`
-  - _Опис_: Каталог для збереження типів словників.
-  - _Приклад_: `'intlayer-types'`
-
-- **mainDir**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `'main'`
-  - _Опис_: Каталог, де зберігаються основні файли застосунку.
-  - _Приклад_: `'intlayer-main'`
-
-- **excludedPath**:
-  - _Тип_: `string[]`
-  - _За замовчуванням_: `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']`
-  - _Опис_: Каталоги, виключені з пошуку вмісту.
-  - _Примітка_: Ця налаштування ще не використовується, але планується для майбутньої реалізації.
-
-- **formatCommand**:
-  - _Тип_: `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.
-
-### Конфігурація словника
-
-Налаштування, які керують операціями словника, включаючи поведінку автоматичного заповнення та генерацію контенту.
-
-Ця конфігурація словника має дві основні цілі:
-
-1. **Значення за замовчуванням**: Визначати значення за замовчуванням під час створення файлів декларації контенту
-2. **Поведінка при відсутності значень**: Забезпечувати запасні значення, коли певні поля не визначені, що дозволяє задавати поведінку операцій словника глобально
-
-Щоб дізнатися більше про файли декларації контенту та про те, як застосовуються значення конфігурації, див. [Документацію щодо контент-файлів](https://github.com/aymericzip/intlayer/blob/main/docs/docs/uk/dictionary/content_file.md).
-
-#### Властивості
-
-- **fill**
-- **description**
-- **locale**
-- **location**
-- **importMode**:
-  - _Примітка_: **Deprecated**: Use `dictionary.importMode` instead.
-  - _Тип_: `'static' | 'dynamic' | 'fetch'`
-  - _Типово_: `'static'`
-  - _Опис_: Controls how dictionaries are imported.
-  - _Приклад_: `'dynamic'`
-- **priority**
-- **live**
-- **schema**
-- **title**
-- **tags**
-- **version**
+### Конфігурація AI (AI Configuration)
+
+Визначає налаштування для функцій Intlayer на базі AI, таких як переклад при збірці.
+
+| Поле                 | Тип                    | Опис                                                                      | Приклад                                     | Примітка                                                                                           |
+| -------------------- | ---------------------- | ------------------------------------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `provider`           | `string`               | Провайдер AI для використання.                                            | `'openai'`, `'anthropic'`, `'googlevertex'` |                                                                                                    |
+| `model`              | `string`               | Модель AI для використання.                                               | `'gpt-4o'`, `'claude-3-5-sonnet-20240620'`  |                                                                                                    |
+| `apiKey`             | `string`               | API ключ для вибраного провайдера.                                        | `process.env.OPENAI_API_KEY`                |                                                                                                    |
+| `applicationContext` | `string`               | Додатковий контекст про ваш додаток для покращення точності перекладу AI. | `'Навчальна платформа для дітей.'`          |                                                                                                    |
+| `baseURL`            | `string`               | Необов'язковий URL базового шляху для API-викликів.                       |                                             | Корисно, якщо ви використовуєте проксі або локальне розгортання AI.                                |
+| `dataSerialization`  | `'json' &#124; 'toon'` | Визначає, як надсилати дані до AI. За замовчуванням: `'json'`             | `'json'`                                    | `'json'`: більш надійно та точно. `'toon'`: споживає менше токенів, але може бути менш стабільним. |
 
 ---
 
-### Конфігурація логера
-
-Налаштування, що керують логером, включно з префіксом, який слід використовувати.
-
-#### Властивості
-
-- **mode**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `default`
-  - _Опис_: Вказує режим роботи логера.
-  - _Опції_: `default`, `verbose`, `disabled`
-  - _Приклад_: `default`
-  - _Примітка_: Режим роботи логера. Режим `verbose` записуватиме більше інформації й підходить для налагодження. Режим `disabled` вимкне логер.
-
-- **prefix**:
-  - _Тип_: `string`
-  - _Типово_: `'[intlayer] '`
-  - _Опис_: Префікс logger'а.
-  - _Приклад_: `'[my custom prefix] '`
-  - _Примітка_: Префікс logger'а.
-
-### Конфігурація AI
-
-Налаштування, які контролюють AI-функції Intlayer, включно з провайдером, моделлю та API-ключем.
-
-Ця конфігурація є необов'язковою, якщо ви зареєстровані на [Intlayer Dashboard](https://app.intlayer.org/project) і використовуєте ключ доступу. Intlayer автоматично підбере найефективніше та економічно вигідне AI-рішення для ваших потреб. Використання опцій за замовчуванням забезпечує кращу довгострокову підтримуваність, оскільки Intlayer постійно оновлюється, щоб використовувати найбільш релевантні моделі.
-
-Якщо ви віддаєте перевагу використовувати власний API-ключ або конкретну модель, ви можете визначити власну конфігурацію AI.
-Ця конфігурація ШІ буде використовуватися глобально в усьому вашому середовищі Intlayer. Команди CLI використовуватимуть ці налаштування як значення за замовчуванням для команд (наприклад, `fill`), а також SDK, Visual Editor і CMS. Ви можете перевизначати ці значення за замовчуванням для конкретних випадків використання за допомогою параметрів команд.
-
-Intlayer підтримує кількох постачальників ШІ для більшої гнучкості та вибору. Наразі підтримуються такі постачальники:
-
-- **OpenAI** (за замовчуванням)
-- **Anthropic Claude**
-- **Mistral AI**
-- **DeepSeek**
-- **Google Gemini**
-- **Meta Llama**
-- **Ollama**
-- **OpenRouter**
-- **Alibaba Cloud**
-- **Fireworks**
-- **Hugging Face**
-- **Groq**
-- **Amazon Bedrock**
-- **Google AI Studio**
-- **Google Vertex**
-- **Together.ai**
-- **ollama**
-
-#### Властивості
-
-- **provider**:
-  - _Тип_: `string`
-  - _Типово_: `'openai'`
-  - _Опис_: Постачальник, який використовуватиметься для функцій ШІ Intlayer.
-  - _Options_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`, `'ollama'`, `'openrouter'`, `'alibaba'`, `'fireworks'`, `'groq'`, `'huggingface'`, `'bedrock'`, `'googleaistudio'`, `'googlevertex'`, `'togetherai'`
-  - _Приклад_: `'anthropic'`
-  - _Примітка_: Різні провайдери можуть вимагати різні API-ключі та мати різні моделі ціноутворення.
-
-- **model**:
-  - _Тип_: `string`
-  - _Типово_: None
-  - _Опис_: Модель, яку слід використовувати для функцій ШІ в Intlayer.
-  - _Приклад_: `'gpt-4o-2024-11-20'`
-  - _Примітка_: Конкретна модель для використання залежить від провайдера.
-
-- **temperature**:
-  - _Тип_: `number`
-  - _Типово_: None
-  - _Опис_: Параметр temperature контролює випадковість відповідей ШІ.
-  - _Приклад_: `0.1`
-  - _Примітка_: Вища температура зробить ШІ більш креативним та менш передбачуваним.
-
-- **apiKey**:
-  - _Тип_: `string`
-  - _Типово_: None
-  - _Опис_: Ваш API-ключ для вибраного провайдера.
-  - _Приклад_: `process.env.OPENAI_API_KEY`
-  - _Примітка_: Важливо: API-ключі слід зберігати в таємниці та не поширювати публічно. Будь ласка, зберігайте їх у безпечному місці, наприклад у змінних середовища.
-
-- **applicationContext**:
-  - _Тип_: `string`
-  - _Типово_: None
-  - _Опис_: Надає додатковий контекст про ваш застосунок для AI-моделі, допомагаючи їй генерувати точніші та контекстуально доречні переклади. Це може включати інформацію про домен вашого додатку, цільову аудиторію, тон або специфічну термінологію.
-  - _Примітка_: Ви можете використовувати його, щоб додати більше правил для AI-моделі (e.g. "You should not transform urls").
-  - _Приклад_: `'My application context'`
-
-- **baseURL**:
-  - _Тип_: `string`
-  - _Типово_: None
-  - _Опис_: Базовий URL для AI API.
-  - _Приклад_: `'https://api.openai.com/v1'`
-  - _Приклад_: `'http://localhost:5000'`
-  - _Примітка_: Може використовуватися для вказівки локального або кастомного AI API endpoint.
-
-- **dataSerialization**:
-  - _Тип_: `'json' | 'toon'`
-  - _За замовчуванням_: `'json'`
-  - _Опис_: Формат серіалізації даних для використання у функціях ШІ Intlayer.
-  - _Приклад_: `'toon'`
-  - _Примітка_: `json`: Стандартний, надійний; використовує більше токенів. `toon`: Менше токенів, менш стабільний, ніж JSON.
-
-> Якщо ви надаєте додаткові параметри, Intlayer передасть їх AI-моделі як контекст. Це можна використовувати для налаштування інтенсивності міркувань, детальності тексту тощо
-
-### Конфігурація збірки
-
-Налаштування, що контролюють, як Intlayer оптимізує та збирає інтернаціоналізацію вашого застосунку.
-
-Параметри збірки застосовуються до плагінів `@intlayer/babel` та `@intlayer/swc`.
-
-> У режимі розробки Intlayer використовує статичні імпорти словників, щоб спростити процес розробки.
-
-> У режимі оптимізації Intlayer замінює виклики словників для оптимізації розбиття на чанки (chunking), тож фінальний бандл імпортує лише ті словники, які фактично використовуються.
-
-#### Властивості
-
-- **mode**:
-  - _Тип_: `'auto' | 'manual'`
-  - _За замовчуванням_: `'auto'`
-  - _Опис_: Керує режимом збірки.
-  - _Приклад_: `'manual'`
-  - _Примітка_: Якщо 'auto', збірка буде увімкнена автоматично під час побудови застосунку.
-  - _Примітка_: Якщо 'manual', збірка буде встановлена лише під час виконання команди збірки.
-  - _Примітка_: Може використовуватися для вимкнення збірки словників, наприклад, коли слід уникати виконання в середовищі Node.js.
-
-- **optimize**:
-  - _Тип_: `boolean`
-  - _За замовчуванням_: `undefined`
-  - _Опис_: Керує тим, чи слід оптимізувати збірку.
-  - _Приклад_: `process.env.NODE_ENV === 'production'`
-  - _Примітка_: За замовчуванням оптимізація збірки не зафіксована. Якщо не встановлено, Intlayer запустить оптимізацію під час збірки вашого застосунку (vite / nextjs / тощо). Встановлення `true` примусово увімкне оптимізацію збірки, включно з режимом розробки. Встановлення `false` вимкне оптимізацію збірки.
-  - _Примітка_: Коли ввімкнено, Intlayer замінює всі виклики словників для оптимізації розбиття на чанки. Таким чином фінальний бандл імпортуватиме лише ті словники, які використовуються. Всі імпорти залишаться статичними, щоб уникнути асинхронної обробки під час завантаження словників.
-  - _Примітка_: Intlayer замінить усі виклики `useIntlayer` на варіант, визначений опцією `importMode`, а `getIntlayer`, на `getDictionary`.
-  - _Примітка_: Ця опція покладається на плагіни `@intlayer/babel` та `@intlayer/swc`.
-  - _Примітка_: Переконайтесь, що всі ключі оголошені статично у викликах `useIntlayer`. Наприклад `useIntlayer('navbar')`.
-
-- **checkTypes**:
-  - _Тип_: `boolean`
-  - _Типово_: `false`
-  - _Опис_: Вказує, чи повинна збірка перевіряти типи TypeScript та реєструвати помилки.
-  - _Примітка_: Це може уповільнити процес збірки.
-
-- **outputFormat**:
-  - _Тип_: `'esm' | 'cjs'`
-  - _Типово_: `'esm'`
-  - _Опис_: Керує форматом виводу словників.
-  - _Приклад_: `'cjs'`
-  - _Примітка_: Формат виводу словників.
-
-- **traversePattern**:
-  - _Тип_: `string[]`
-  - _Типово_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
-  - _Опис_: Шаблони, що визначають, які файли слід обходити під час оптимізації.
-    - _Приклад_: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}', '!**/node_modules/**']`
-  - _Примітка_: Використовуйте це, щоб обмежити оптимізацію релевантними файлами коду та покращити продуктивність збірки.
-  - _Примітка_: Ця опція буде ігнорована, якщо `optimize` вимкнено.
-  - _Примітка_: Використовуйте glob-шаблон.
+### Конфігурація збірки (Build Configuration)
+
+Налаштування процесу збірки та оптимізації Intlayer.
+
+| Поле           | Тип                      | Опис                                                                                                                           | Приклад | Примітка |
+| -------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------- | -------- |
+| `mode`         | `'auto' &#124; 'manual'` | Визначає, чи повинен Intlayer запускатися автоматично під час етапів pre-build додатка. За замовчуванням: `'auto'`             |         |          |
+| `optimize`     | `boolean`                | Визначає, чи повинні скомпільовані словники бути оптимізовані для рантайму. За замовчуванням: `true` у продуктовому середовищі |         |          |
+| `outputFormat` | `('cjs' &#124; 'esm')[]` | Формат виводу для згенерованих файлів словника. За замовчуванням: `['cjs', 'esm']`                                             |         |          |
+| `checkTypes`   | `boolean`                | Визначає, чи має Intlayer перевіряти типи в згенерованих файлах. За замовчуванням: `false`                                     |         |          |
 
 ---
 
-### Конфігурація компілятора
-
-Налаштування, що керують компілятором Intlayer, який витягує словники безпосередньо з ваших компонентів.
-
-#### Властивості
-
-- **enabled**:
-  - _Тип_: `boolean | 'build-only'`
-  - _За замовчуванням_: `true`
-  - _Опис_: Вказує, чи повинен бути ввімкнений компілятор для витягування словників.
-  - _Приклад_: `'build-only'`
-  - _Примітка_: Встановлення значення `'build-only'` призведе до пропуску компілятора під час режиму розробки для прискорення часу запуску. Він буде запускатися лише для команд збірки.
-
-- **dictionaryKeyPrefix**:
-  - _Тип_: `string`
-  - _За замовчуванням_: `''`
-  - _Опис_: Префікс для витягнутих ключів словника.
-  - _Приклад_: `'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/**']`
-
-- **output**:
-  - _Тип_: `FilePathPattern`
-  - _Типово_: `undefined`
-  - _Опис_: Визначає шлях до вихідних файлів. Замінює `outputDir`. Підтримує динамічні змінні через рядкові шаблони або функцію. Підтримувані змінні: `{{fileName}}`, `{{key}}`, `{{locale}}`, `{{extension}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{format}}`, `{{componentFormat}}`, та `{{componentDirPath}}`.
-  - _Примітка_: Шляхи, що починаються з `./`, розв'язуються відносно каталогу компонента. Шляхи, що починаються з `/`, розв'язуються відносно кореня проєкту (`baseDir`).
-  - _Примітка_: Включення змінної `{{locale}}` у шлях дозволить генерувати словники, розділені за локалями.
-  - _Приклад_:
-    - **Багатомовний файл поруч із компонентом**:
-    - Рядок: `'./{{fileName}}{{extension}}'`
-    - Функція: `({ fileName, extension }) => \`./${fileName}${extension}\``
-
-    - **Централізовані JSON-файли для кожної локалі**:
-    - Рядок: `'/locales/{{locale}}/{{key}}.content.json'`
-    - Функція: `({ key, locale }) => \`/locales/${locale}/${key}.content.json\``
-
-- **noMetadata**:
-  - _Тип_: `boolean`
-  - _Типово_: `false`
-  - _Опис_: Вказує, чи мають метадані зберігатися у файлі. Якщо true, компілятор не зберігатиме метадані словників (ключ, оболонка вмісту). Корисно для виводу JSON для i18next або ICU MessageFormat для кожної локалі.
-  - _Примітка_: Корисно при використанні з плагіном `loadJSON`.
-  - _Приклад_:
-    Якщо `true` :
-
-    ```json
-    {
-      "key": "value"
-    }
-    ```
-
-    Якщо `false`:
-
-    ```json
-    {
-      "key": "value",
-      "content": {
-        "key": "value"
-      }
-    }
-    ```
+### Системна конфігурація (System Configuration)
+
+Ці налаштування призначені для розширених випадків використання та внутрішньої конфігурації Intlayer.
+
+| Поле                      | Тип      | Опис                                              | За замовчуванням                  |
+| ------------------------- | -------- | ------------------------------------------------- | --------------------------------- |
+| `dictionariesDir`         | `string` | Директорія скомпільованих словників.              | `'.intlayer/dictionary'`          |
+| `moduleAugmentationDir`   | `string` | Директорія для розширення модулів TypeScript.     | `'.intlayer/types'`               |
+| `unmergedDictionariesDir` | `string` | Директорія незлитих словників.                    | `'.intlayer/unmerged_dictionary'` |
+| `typesDir`                | `string` | Директорія згенерованих типів.                    | `'.intlayer/types'`               |
+| `mainDir`                 | `string` | Директорія основного файлу Intlayer.              | `'.intlayer/main'`                |
+| `configDir`               | `string` | Директорія скомпільованих конфігураційних файлів. | `'.intlayer/config'`              |
+| `cacheDir`                | `string` | Директорія кеш-файлів.                            | `'.intlayer/cache'`               |
+
+---
+
+### Конфігурація компілятора (Compiler Configuration)
+
+Налаштування компілятора Intlayer (`intlayer compiler`).
+
+| Поле                  | Тип                      | Опис                                                                                  | За замовчуванням |
+| --------------------- | ------------------------ | ------------------------------------------------------------------------------------- | ---------------- |
+| `enabled`             | `boolean`                | Визначає, чи активний компілятор.                                                     | `false`          |
+| `output`              | `string &#124; Function` | Шлях виводу для витягнутих словників.                                                 |                  |
+| `saveComponents`      | `boolean`                | Визначає, чи слід перезаписувати оригінальні вихідні файли трансформованими версіями. | `false`          |
+| `noMetadata`          | `boolean`                | Якщо `true`, компілятор не включатиме метадані у згенеровані файли.                   | `false`          |
+| `dictionaryKeyPrefix` | `string`                 | Необов'язковий префікс ключа словника.                                                | `''`             |
+
+---
+
+### Конфігурація логера (Logger Configuration)
+
+Налаштування для кастомізації виводу логів Intlayer.
+
+| Поле     | Тип                                            | Опис                           | За замовчуванням |
+| -------- | ---------------------------------------------- | ------------------------------ | ---------------- |
+| `mode`   | `'default' &#124; 'verbose' &#124; 'disabled'` | Режим логування.               | `'default'`      |
+| `prefix` | `string`                                       | Префікс повідомлень логування. | `'[intlayer]'`   |
+
+---
+
+### Користувацькі схеми (Custom Schemas)
+
+| Поле      | Тип                         | Опис                                                                  |
+| --------- | --------------------------- | --------------------------------------------------------------------- |
+| `schemas` | `Record<string, ZodSchema>` | Дозволяє визначати Zod-схеми для валідації структури ваших словників. |
+
+---
+
+### Плагіни (Plugins)
+
+| Поле      | Тип                | Опис                                    |
+| --------- | ------------------ | --------------------------------------- |
+| `plugins` | `IntlayerPlugin[]` | Список плагінів Intlayer для активації. |