@intlayer/docs 5.8.1 → 6.0.0-canary.1

package/docs/ru/configuration.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2025-06-29
+updatedAt: 2025-09-16
 title: Конфигурация
-description: Узнайте, как настроить Intlayer для вашего приложения. Поймите разные настройки и параметры, доступные для настройки Intlayer под ваши нужды.
+description: Узнайте, как настроить Intlayer для вашего приложения. Поймите различные параметры и опции, доступные для настройки Intlayer под ваши нужды.
 keywords:
   - Конфигурация
   - Настройки
@@ -19,7 +19,7 @@ slugs:
 
 ## Обзор
 
-Файлы конфигурации Intlayer позволяют настраивать различные аспекты плагина, такие как интернационализация, middleware и обработка контента. В этом документе приведено подробное описание каждого свойства конфигурации.
+Файлы конфигурации Intlayer позволяют настраивать различные аспекты плагина, такие как интернационализация, промежуточное ПО и обработка контента. В этом документе приведено подробное описание каждого свойства в конфигурации.
 
 ---
 
@@ -43,23 +43,24 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   internationalization: {
-    locales: [Locales.ENGLISH],
+    locales: [Locales.ENGLISH], // локали для интернационализации
   },
   content: {
-    contentDir: ["src", "../ui-library"],
+    autoFill: "./{{fileName}}.content.json", // автозаполнение контента из файла
+    contentDir: ["src", "../ui-library"], // директории с контентом
   },
   middleware: {
-    noPrefix: false,
+    noPrefix: false, // использовать префикс в маршрутах
   },
   editor: {
-    applicationURL: "https://example.com",
+    applicationURL: "https://example.com", // URL приложения для редактора
   },
   ai: {
-    apiKey: process.env.OPENAI_API_KEY,
-    applicationContext: "Это тестовое приложение",
+    apiKey: process.env.OPENAI_API_KEY, // ключ API для AI
+    applicationContext: "This is a test application", // контекст приложения для AI
   },
   build: {
-    importMode: "dynamic",
+    importMode: "dynamic", // режим импорта модулей
   },
 };
 
@@ -72,23 +73,23 @@ const { Locales } = require("intlayer");
 /** @type {import('intlayer').IntlayerConfig} */
 const config = {
   internationalization: {
-    locales: [Locales.ENGLISH],
+    locales: [Locales.ENGLISH], // локали для интернационализации
   },
   content: {
-    contentDir: ["src", "../ui-library"],
+    contentDir: ["src", "../ui-library"], // директории с контентом
   },
   middleware: {
-    noPrefix: false,
+    noPrefix: false, // использовать префикс в маршрутах
   },
   editor: {
-    applicationURL: "https://example.com",
+    applicationURL: "https://example.com", // URL приложения для редактора
   },
   ai: {
-    apiKey: process.env.OPENAI_API_KEY,
-    applicationContext: "Это тестовое приложение", // This is a test application
+    apiKey: process.env.OPENAI_API_KEY, // ключ API для AI
+    applicationContext: "Это тестовое приложение", // контекст приложения для AI
   },
   build: {
-    importMode: "dynamic",
+    importMode: "dynamic", // режим импорта модулей
   },
 };
 
@@ -98,13 +99,23 @@ module.exports = config;
 ```json5 fileName=".intlayerrc" codeFormat="json"
 {
   "internationalization": {
-    "locales": ["en"],
+    "locales": ["en"], // локали для интернационализации
   },
   "content": {
-    "typesDir": "content/types",
+    "contentDir": ["src", "../ui-library"], // директории с контентом
   },
   "middleware": {
-    "noPrefix": false,
+    "noPrefix": false, // использовать префикс в маршрутах
+  },
+  "editor": {
+    "applicationURL": "https://example.com", // URL приложения для редактора
+  },
+  "ai": {
+    "apiKey": "XXXX",
+    "applicationContext": "Это тестовое приложение",
+  },
+  "build": {
+    "importMode": "dynamic",
   },
 }
 ```
@@ -139,35 +150,35 @@ module.exports = config;
 - **strictMode**:
   - _Тип_: `string`
   - _По умолчанию_: `inclusive`
-  - _Описание_: Обеспечивает строгую реализацию интернационализированного контента с использованием TypeScript.
-  - _Примечание_: Если установлено значение "strict", функция перевода `t` потребует, чтобы каждая объявленная локаль была определена. Если одна локаль отсутствует или локаль не объявлена в вашей конфигурации, будет выброшена ошибка.
-  - _Примечание_: Если установлено значение "inclusive", функция перевода `t` потребует, чтобы каждая объявленная локаль была определена. Если одна локаль отсутствует, будет выдано предупреждение. Но будет принято, если локаль не объявлена в вашей конфигурации, но существует.
+  - _Описание_: Обеспечивает строгую реализацию интернационализированного контента с использованием typescript.
+  - _Примечание_: Если установлено значение "strict", функция перевода `t` потребует определения каждой объявленной локали. Если одна локаль отсутствует или не объявлена в вашей конфигурации, будет выброшена ошибка.
+  - _Примечание_: Если установлено значение "inclusive", функция перевода `t` потребует определения каждой объявленной локали. Если одна локаль отсутствует, будет выдано предупреждение. Но будет принято, если локаль не объявлена в вашей конфигурации, но существует.
   - _Примечание_: Если установлено значение "loose", функция перевода `t` примет любую существующую локаль.
 
 - **defaultLocale**:
   - _Тип_: `string`
   - _По умолчанию_: `'en'`
-  - _Описание_: Локаль по умолчанию, используемая в качестве резервной, если запрашиваемая локаль не найдена.
+  - _Описание_: Локаль по умолчанию, используемая в качестве резервной, если запрошенная локаль не найдена.
   - _Пример_: `'en'`
-  - _Примечание_: Используется для определения локали, если она не указана в URL, cookie или заголовке.
+  - _Примечание_: Используется для определения локали, когда она не указана в URL, cookie или заголовке.
 
 ---
 
 ### Конфигурация редактора
 
-Определяет настройки, связанные с интегрированным редактором, включая порт сервера и активный статус.
+Определяет настройки, связанные с интегрированным редактором, включая порт сервера и статус активности.
 
 #### Свойства
 
 - **applicationURL**:
   - _Тип_: `string`
   - _По умолчанию_: `http://localhost:3000`
-  - _Описание_: URL приложения. Используется для ограничения происхождения редактора в целях безопасности.
+  - _Описание_: URL приложения. Используется для ограничения источника редактора по соображениям безопасности.
   - _Пример_:
     - `'http://localhost:3000'`
     - `'https://example.com'`
     - `process.env.INTLAYER_EDITOR_URL`
-  - _Примечание_: URL приложения. Используется для ограничения происхождения редактора в целях безопасности. Если установлено значение `'*'`, редактор доступен с любого источника.
+  - _Примечание_: URL приложения. Используется для ограничения источника редактора по соображениям безопасности. Если установлено значение `'*'`, редактор доступен с любого источника.
 
 - **port**:
   - _Тип_: `number`
@@ -177,23 +188,23 @@ module.exports = config;
 - **editorURL**:
   - _Тип_: `string`
   - _По умолчанию_: `'http://localhost:8000'`
-  - _Описание_: URL сервера редактора. Используется для ограничения происхождения редактора в целях безопасности.
+  - _Описание_: URL сервера редактора. Используется для ограничения источника редактора по соображениям безопасности.
     - `'http://localhost:3000'`
     - `'https://example.com'`
     - `process.env.INTLAYER_EDITOR_URL`
-  - _Примечание_: URL сервера редактора для доступа из приложения. Используется для ограничения источников, которые могут взаимодействовать с приложением в целях безопасности. Если установлено значение `'*'`, редактор доступен с любого источника. Должно быть установлено, если порт изменен или если редактор размещен на другом домене.
+  - _Примечание_: URL сервера редактора, к которому нужно обращаться из приложения. Используется для ограничения источников, которые могут взаимодействовать с приложением, в целях безопасности. Если установлено значение `'*'`, редактор доступен с любого источника. Должно быть установлено, если порт изменён или если редактор размещён на другом домене.
 
 - **cmsURL**:
   - _Тип_: `string`
   - _По умолчанию_: `'https://intlayer.org'`
-  - _Описание_: URL CMS Intlayer.
+  - _Описание_: URL Intlayer CMS.
   - _Пример_: `'https://intlayer.org'`
-  - _Примечание_: URL CMS Intlayer.
+  - _Примечание_: URL Intlayer CMS.
 
 - **backendURL**:
   - _Тип_: `string`
   - _По умолчанию_: `https://back.intlayer.org`
-  - _Описание_: URL сервера backend.
+  - _Описание_: URL сервера бэкенда.
   - _Пример_: `http://localhost:4000`
 
 - **enabled**:
@@ -201,39 +212,53 @@ module.exports = config;
   - _По умолчанию_: `true`
   - _Описание_: Указывает, взаимодействует ли приложение с визуальным редактором.
   - _Пример_: `process.env.NODE_ENV !== 'production'`
-  - _Примечание_: Если true, редактор сможет взаимодействовать с приложением. Если false, редактор не сможет взаимодействовать с приложением. В любом случае редактор может быть включен только визуальным редактором. Отключение редактора для определенных сред - это способ обеспечения безопасности.
+  - _Примечание_: Если значение true, редактор сможет взаимодействовать с приложением. Если false, редактор не сможет взаимодействовать с приложением. В любом случае, редактор может быть включен только визуальным редактором. Отключение редактора для определённых окружений является способом обеспечения безопасности.
 
 - **clientId**:
   - _Тип_: `string` | `undefined`
   - _По умолчанию_: `undefined`
-  - _Описание_: clientId и clientSecret позволяют пакетам intlayer аутентифицироваться с backend с использованием аутентификации oAuth2. Токен доступа используется для аутентификации пользователя, связанного с проектом. Чтобы получить токен доступа, перейдите на https://intlayer.org/dashboard/project и создайте учетную запись.
+  - _Описание_: clientId и clientSecret позволяют пакетам intlayer аутентифицироваться на сервере с использованием аутентификации oAuth2. Токен доступа используется для аутентификации пользователя, связанного с проектом. Чтобы получить токен доступа, перейдите на https://intlayer.org/dashboard/project и создайте учетную запись.
   - _Пример_: `true`
-  - _Примечание_: Важно: clientId и clientSecret должны храниться в секрете и не должны быть общедоступными. Убедитесь, что они хранятся в безопасном месте, например, в переменных окружения.
+  - _Примечание_: Важно: clientId и clientSecret должны храниться в секрете и не должны быть доступны публично. Пожалуйста, убедитесь, что они хранятся в безопасном месте, например, в переменных окружения.
 
 - **clientSecret**:
   - _Тип_: `string` | `undefined`
   - _По умолчанию_: `undefined`
-  - _Описание_: clientId и clientSecret позволяют пакетам Intlayer аутентифицироваться с backend с использованием аутентификации oAuth2. Токен доступа используется для аутентификации пользователя, связанного с проектом. Чтобы получить токен доступа, перейдите на https://intlayer.org/dashboard/project и создайте учетную запись.
+  - _Описание_: clientId и clientSecret позволяют пакетам intlayer аутентифицироваться на сервере с помощью аутентификации oAuth2. Токен доступа используется для аутентификации пользователя, связанного с проектом. Чтобы получить токен доступа, перейдите на https://intlayer.org/dashboard/project и создайте учетную запись.
   - _Пример_: `true`
-  - _Примечание_: Важно: clientId и clientSecret должны храниться в секрете и не должны быть общедоступными. Убедитесь, что они хранятся в безопасном месте, например, в переменных окружения.
+  - _Примечание_: Важно: clientId и clientSecret должны храниться в секрете и не должны быть доступны публично. Пожалуйста, храните их в безопасном месте, например, в переменных окружения.
 
-- **hotReload**:
+- **dictionaryPriorityStrategy**:
+  - _Тип_: `string`
+  - _По умолчанию_: `'local_first'`
+  - _Описание_: Стратегия приоритизации словарей в случае наличия как локальных, так и удалённых словарей. Если установлено значение `'distant_first'`, приложение будет отдавать приоритет удалённым словарям перед локальными. Если установлено значение `'local_first'`, приложение будет отдавать приоритет локальным словарям перед удалёнными.
+  - _Пример_: `'distant_first'`
+
+- **liveSync**:
   - _Тип_: `boolean`
   - _По умолчанию_: `false`
-  - _Описание_: Указывает, должно ли приложение автоматически обновлять конфигурации локалей при обнаружении изменений.
+  - _Описание_: Указывает, должен ли сервер приложения автоматически обновлять содержимое приложения при обнаружении изменений в CMS / Визуальном редакторе / Бэкенде.
   - _Пример_: `true`
-  - _Примечание_: Например, когда добавляется или обновляется новый словарь, приложение обновит контент для отображения на странице.
-  - _Примечание_: Поскольку горячая перезагрузка требует постоянного соединения с сервером, она доступна только для клиентов с планом `enterprise`.
+  - _Примечание_: Например, когда добавляется или обновляется новый словарь, приложение обновит содержимое для отображения на странице.
+  - _Примечание_: Live sync требует внешнего размещения контента приложения на другом сервере. Это может немного повлиять на производительность приложения. Чтобы ограничить это, мы рекомендуем размещать приложение и сервер live sync на одной машине. Также комбинация live sync и `optimize` может привести к значительному количеству запросов к серверу live sync. В зависимости от вашей инфраструктуры, мы рекомендуем протестировать оба варианта и их комбинацию.
 
-- **dictionaryPriorityStrategy**:
+- **liveSyncPort**:
+  - _Тип_: `number`
+  - _По умолчанию_: `4000`
+  - _Описание_: Порт сервера live sync.
+  - _Пример_: `4000`
+  - _Примечание_: Порт сервера live sync.
+
+- **liveSyncURL**:
   - _Тип_: `string`
-  - _По умолчанию_: `'local_first'`
-  - _Описание_: Стратегия приоритизации словарей в случае наличия как локальных, так и удаленных словарей. Если установлено значение `'distant_first'`, приложение будет отдавать приоритет удаленным словарям над локальными. Если установлено значение `'local_first'`, приложение будет отдавать приоритет локальным словарям над удаленными.
-  - _Пример_: `'distant_first'`
+  - _По умолчанию_: `'http://localhost:{liveSyncPort}'`
+  - _Описание_: URL сервера live sync.
+  - _Пример_: `'https://example.com'`
+  - _Примечание_: По умолчанию указывает на localhost, но может быть изменён на любой URL в случае удалённого сервера live sync.
 
 ### Конфигурация Middleware
 
-Настройки, которые управляют поведением middleware, включая то, как приложение обрабатывает cookies, заголовки и префиксы URL для управления локалями.
+Настройки, управляющие поведением middleware, включая обработку cookies, заголовков и префиксов URL для управления локализацией.
 
 #### Свойства
 
@@ -242,7 +267,7 @@ module.exports = config;
   - _По умолчанию_: `'x-intlayer-locale'`
   - _Описание_: Имя HTTP-заголовка, используемого для определения локали.
   - _Пример_: `'x-custom-locale'`
-  - _Примечание_: Это полезно для определения локали на основе API.
+  - _Примечание_: Полезно для определения локали через API.
 
 - **cookieName**:
   - _Тип_: `string`
@@ -257,8 +282,8 @@ module.exports = config;
   - _Описание_: Включать ли локаль по умолчанию в URL.
   - _Пример_: `true`
   - _Примечание_:
-    - Если `true` и `defaultLocale = 'en'`: path = `/en/dashboard` или `/fr/dashboard`
-    - Если `false` и `defaultLocale = 'en'`: path = `/dashboard` или `/fr/dashboard`
+    - Если `true` и `defaultLocale = 'en'`: путь = `/en/dashboard` или `/fr/dashboard`
+    - Если `false` и `defaultLocale = 'en'`: путь = `/dashboard` или `/fr/dashboard`
 
 - **basePath**:
   - _Тип_: `string`
@@ -266,27 +291,27 @@ module.exports = config;
   - _Описание_: Базовый путь для URL приложения.
   - _Пример_: `'/my-app'`
   - _Примечание_:
-    - Если приложение размещено на `https://example.com/my-app`
-    - Базовый путь `'/my-app'`
+    - Если приложение размещено по адресу `https://example.com/my-app`
+    - Базовый путь будет `'/my-app'`
     - URL будет `https://example.com/my-app/en`
     - Если базовый путь не установлен, URL будет `https://example.com/en`
 
 - **serverSetCookie**:
   - _Тип_: `string`
   - _По умолчанию_: `'always'`
-  - _Описание_: Правило для установки cookie локали на сервере.
+  - _Описание_: Правило установки cookie локали на сервере.
   - _Опции_: `'always'`, `'never'`
   - _Пример_: `'never'`
-  - _Примечание_: Управляет, устанавливается ли cookie локали при каждом запросе или никогда.
+  - _Примечание_: Управляет тем, устанавливается ли cookie локали при каждом запросе или никогда.
 
 - **noPrefix**:
   - _Тип_: `boolean`
   - _По умолчанию_: `false`
-  - _Описание_: Исключать ли префикс локали из URL.
+  - _Описание_: Нужно ли опускать префикс локали в URL.
   - _Пример_: `true`
   - _Примечание_:
-    - Если `true`: Без префикса в URL
-    - Если `false`: С префиксом в URL
+    - Если `true`: префикс в URL отсутствует
+    - Если `false`: префикс в URL присутствует
     - Пример с `basePath = '/my-app'`:
       - Если `noPrefix = false`: URL будет `https://example.com/my-app/en`
       - Если `noPrefix = true`: URL будет `https://example.com`
@@ -294,22 +319,22 @@ module.exports = config;
 - **detectLocaleOnPrefetchNoPrefix**:
   - _Тип_: `boolean`
   - _По умолчанию_: `false`
-  - _Описание_: Управляет, происходит ли обнаружение локали во время запросов предварительной загрузки Next.js.
+  - _Описание_: Управляет тем, происходит ли определение локали во время запросов предварительной загрузки (prefetch) в Next.js.
   - _Пример_: `true`
-  - _Примечание_: Эта настройка влияет на то, как Next.js обрабатывает предварительную загрузку локали:
+  - _Примечание_: Эта настройка влияет на то, как Next.js обрабатывает предварительную загрузку локалей:
     - **Пример сценария:**
-      - Язык браузера пользователя `'fr'`
-      - Текущая страница `/fr/about`
+      - Язык браузера пользователя — `'fr'`
+      - Текущая страница — `/fr/about`
       - Ссылка предварительно загружает `/about`
-    - **С `detectLocaleOnPrefetchNoPrefix: true`:**
-      - Предварительная загрузка обнаруживает локаль `'fr'` из браузера
+    - **При `detectLocaleOnPrefetchNoPrefix: true`:**
+      - Предварительная загрузка определяет локаль `'fr'` из браузера
       - Перенаправляет предварительную загрузку на `/fr/about`
-    - **С `detectLocaleOnPrefetchNoPrefix: false` (по умолчанию):**
+    - **При `detectLocaleOnPrefetchNoPrefix: false` (по умолчанию):**
       - Предварительная загрузка использует локаль по умолчанию
-      - Перенаправляет предварительную загрузку на `/en/about` (предполагая, что `'en'` по умолчанию)
+      - Перенаправляет предварительную загрузку на `/en/about` (предполагается, что `'en'` — локаль по умолчанию)
     - **Когда использовать `true`:**
-      - Ваше приложение использует нелокализованные внутренние ссылки (например, `<a href="/about">`)
-      - Вы хотите согласованное поведение обнаружения локали между обычными и предварительными запросами
+      - Ваше приложение использует внутренние ссылки без локализации (например, `<a href="/about">`)
+      - Вы хотите обеспечить согласованное поведение определения локали между обычными и предварительными запросами
     - **Когда использовать `false` (по умолчанию):**
       - Ваше приложение использует ссылки с префиксом локали (например, `<a href="/fr/about">`)
       - Вы хотите оптимизировать производительность предварительной загрузки
@@ -319,28 +344,40 @@ module.exports = config;
 
 ### Конфигурация контента
 
-Настройки, связанные с обработкой контента в приложении, включая имена директорий, расширения файлов и производные конфигурации.
+Настройки, связанные с обработкой контента в приложении, включая имена каталогов, расширения файлов и производные конфигурации.
 
 #### Свойства
 
+- **autoFill**:
+  - _Тип_: `boolean | string | { [key in Locales]?: string }`
+  - _По умолчанию_: `undefined`
+  - _Описание_: Указывает, как содержимое должно автоматически заполняться с помощью ИИ. Может быть объявлено глобально в файле `intlayer.config.ts`.
+  - _Пример_: true
+  - _Пример_: `'./{{fileName}}.content.json'`
+  - _Пример_: `{ fr: './{{fileName}}.fr.content.json', es: './{{fileName}}.es.content.json' }`
+  - _Примечание_: Конфигурация автозаполнения. Может быть:
+    - boolean: Включить автозаполнение для всех локалей
+    - string: Путь к одному файлу или шаблону с переменными
+    - object: Пути к файлам для каждой локали
+
 - **watch**:
   - _Тип_: `boolean`
   - _По умолчанию_: `process.env.NODE_ENV === 'development'`
-  - _Описание_: Указывает, должен ли Intlayer отслеживать изменения в файлах декларации контента в приложении для пересборки связанных словарей.
+  - _Описание_: Указывает, должен ли Intlayer отслеживать изменения в файлах декларации контента в приложении для перестройки соответствующих словарей.
 
 - **fileExtensions**:
   - _Тип_: `string[]`
   - _По умолчанию_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
-  - _Описание_: Расширения файлов, которые нужно искать при построении словарей.
+  - _Описание_: Расширения файлов, которые следует искать при построении словарей.
   - _Пример_: `['.data.ts', '.data.js', '.data.json']`
   - _Примечание_: Настройка расширений файлов может помочь избежать конфликтов.
 
 - **baseDir**:
   - _Тип_: `string`
   - _По умолчанию_: `process.cwd()`
-  - _Описание_: Базовая директория для проекта.
+  - _Описание_: Базовый каталог проекта.
   - _Пример_: `'/path/to/project'`
-  - _Примечание_: Используется для разрешения всех связанных с Intlayer директорий.
+  - _Примечание_: Используется для разрешения всех директорий, связанных с Intlayer.
 
 - **dictionaryOutput**:
   - _Тип_: `string[]`
@@ -349,14 +386,14 @@ module.exports = config;
 
 - **contentDir**:
   - _Тип_: `string[]`
-  - _По умолчанию_: `['src']`
+  - _По умолчанию_: `['.']`
   - _Пример_: `['src', '../../ui-library', require.resolve("@my-package/content")]`
   - _Описание_: Путь к директории, где хранится контент.
 
 - **dictionariesDir**:
   - _Тип_: `string`
   - _По умолчанию_: `'.intlayer/dictionaries'`
-  - _Описание_: Путь к директории для хранения промежуточных или выходных результатов.
+  - _Описание_: Путь к директории для хранения промежуточных или итоговых результатов.
 
 - **moduleAugmentationDir**:
   - _Тип_: `string`
@@ -368,43 +405,43 @@ module.exports = config;
 - **unmergedDictionariesDir**:
   - _Тип_: `string`
   - _По умолчанию_: `'.intlayer/unmerged_dictionary'`
-  - _Описание_: Директория для хранения несмёрженных словарей.
+  - _Описание_: Директория для хранения неслитых словарей.
   - _Пример_: `'translations'`
 
 - **dictionariesDir**:
   - _Тип_: `string`
   - _По умолчанию_: `'.intlayer/dictionary'`
-  - _Описание_: Директория для хранения словарей локализации.
+  - _Описание_: Каталог для хранения словарей локализации.
   - _Пример_: `'translations'`
 
 - **i18nextResourcesDir**:
   - _Тип_: `string`
   - _По умолчанию_: `'i18next_dictionary'`
-  - _Описание_: Директория для хранения словарей i18n.
+  - _Описание_: Каталог для хранения словарей i18n.
   - _Пример_: `'translations'`
-  - _Примечание_: Убедитесь, что эта директория настроена для типа вывода i18next.
+  - _Примечание_: Убедитесь, что этот каталог настроен для типа вывода i18next.
 
 - **typesDir**:
   - _Тип_: `string`
   - _По умолчанию_: `'types'`
-  - _Описание_: Директория для хранения типов словарей.
+  - _Описание_: Каталог для хранения типов словарей.
   - _Пример_: `'intlayer-types'`
 
 - **mainDir**:
   - _Тип_: `string`
   - _По умолчанию_: `'main'`
-  - _Описание_: Директория, где хранятся основные файлы приложения.
+  - _Описание_: Каталог, где хранятся основные файлы приложения.
   - _Пример_: `'intlayer-main'`
 
 - **excludedPath**:
   - _Тип_: `string[]`
   - _По умолчанию_: `['node_modules']`
-  - _Описание_: Директории, исключённые из поиска контента.
+  - _Описание_: Каталоги, исключённые из поиска контента.
   - _Примечание_: Эта настройка пока не используется, но планируется к реализации в будущем.
 
 ### Конфигурация логгера
 
-Настройки, управляющие логгером, включая используемый префикс.
+Настройки, управляющие логгером, включая префикс для использования.
 
 #### Свойства
 
@@ -414,7 +451,7 @@ module.exports = config;
   - _Описание_: Указывает режим работы логгера.
   - _Опции_: `default`, `verbose`, `disabled`
   - _Пример_: `default`
-  - _Примечание_: Режим логгера. Режим verbose будет выводить больше информации, но может использоваться для отладки. Режим disabled отключает логгер.
+  - _Примечание_: Режим работы логгера. Режим verbose выводит больше информации и может использоваться для отладки. Режим disabled отключает логгер.
 
 - **prefix**:
   - _Тип_: `string`
@@ -423,13 +460,16 @@ module.exports = config;
   - _Пример_: `'[my custom prefix] '`
   - _Примечание_: Префикс логгера.
 
-### Конфигурация AI
+### Конфигурация ИИ
+
+Настройки, управляющие функциями ИИ в Intlayer, включая провайдера, модель и API-ключ.
 
-Настройки, управляющие функциями AI в Intlayer, включая провайдера, модель и API-ключ.
-Эта конфигурация является необязательной, если вы зарегистрированы на [Intlayer Dashboard](https://intlayer.org/dashboard/project) с использованием ключа доступа. Intlayer автоматически управляет наиболее эффективным и экономичным AI-решением для ваших нужд. Использование настроек по умолчанию обеспечивает лучшую долгосрочную поддержку, так как Intlayer постоянно обновляется для использования наиболее актуальных моделей.
+Эта конфигурация является необязательной, если вы зарегистрированы на [Панели управления Intlayer](https://intlayer.org/dashboard/project) с использованием ключа доступа. Intlayer автоматически управляет наиболее эффективным и экономичным решением ИИ для ваших нужд. Использование настроек по умолчанию обеспечивает лучшую долгосрочную поддержку, поскольку Intlayer постоянно обновляется для использования наиболее актуальных моделей.
 
-Если вы предпочитаете использовать свой собственный API-ключ или конкретную модель, вы можете определить свою пользовательскую конфигурацию AI. Эта конфигурация AI будет использоваться глобально во всей вашей среде Intlayer. Команды CLI будут использовать эти настройки по умолчанию для команд (например, `fill`), а также SDK, Visual Editor и CMS. Вы можете переопределить эти значения по умолчанию для конкретных случаев использования, используя параметры команд.
-Intlayer поддерживает нескольких провайдеров AI для повышения гибкости и выбора. В настоящее время поддерживаются следующие провайдеры:
+Если вы предпочитаете использовать собственный API-ключ или конкретную модель, вы можете определить свою собственную конфигурацию ИИ.
+Эта конфигурация ИИ будет использоваться глобально во всей вашей среде Intlayer. Команды CLI будут использовать эти настройки по умолчанию для команд (например, `fill`), а также SDK, Визуальный редактор и CMS. Вы можете переопределить эти значения по умолчанию для конкретных случаев использования с помощью параметров команд.
+
+Intlayer поддерживает несколько провайдеров ИИ для повышения гибкости и выбора. В настоящее время поддерживаются следующие провайдеры:
 
 - **OpenAI** (по умолчанию)
 - **Anthropic Claude**
@@ -443,85 +483,92 @@ Intlayer поддерживает нескольких провайдеров AI
 - **provider**:
   - _Тип_: `string`
   - _По умолчанию_: `'openai'`
-  - _Описание_: Провайдер, используемый для функций AI в Intlayer.
+  - _Описание_: Провайдер, используемый для функций ИИ в Intlayer.
   - _Опции_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`
   - _Пример_: `'anthropic'`
-  - _Примечание_: Разные провайдеры могут требовать разные API-ключи и иметь разные модели ценообразования.
+  - _Примечание_: Разные провайдеры могут требовать разные API-ключи и иметь различные модели ценообразования.
 
 - **model**:
   - _Тип_: `string`
   - _По умолчанию_: Нет
-  - _Описание_: Модель, используемая для функций AI в Intlayer.
+  - _Описание_: Модель, используемая для функций ИИ в Intlayer.
   - _Пример_: `'gpt-4o-2024-11-20'`
   - _Примечание_: Конкретная модель зависит от провайдера.
 
 - **temperature**:
   - _Тип_: `number`
   - _По умолчанию_: Нет
-  - _Описание_: Температура контролирует случайность ответов AI.
+  - _Описание_: Параметр temperature контролирует случайность ответов ИИ.
   - _Пример_: `0.1`
-  - _Примечание_: Более высокая температура делает AI более креативным и менее предсказуемым.
+  - _Примечание_: Более высокое значение temperature делает ИИ более креативным и менее предсказуемым.
 
 - **apiKey**:
   - _Тип_: `string`
   - _По умолчанию_: Нет
   - _Описание_: Ваш API-ключ для выбранного провайдера.
   - _Пример_: `process.env.OPENAI_API_KEY`
-  - _Примечание_: Важно: API-ключи должны храниться в секрете и не должны быть общедоступными. Убедитесь, что они хранятся в безопасном месте, например, в переменных окружения.
+  - _Примечание_: Важно: ключи API должны храниться в секрете и не должны быть доступны публично. Пожалуйста, убедитесь, что они хранятся в безопасном месте, например, в переменных окружения.
 
 - **applicationContext**:
   - _Тип_: `string`
   - _По умолчанию_: Нет
-  - _Описание_: Предоставляет дополнительный контекст о вашем приложении для AI-модели, помогая ей генерировать более точные и контекстно-подходящие переводы. Это может включать информацию о домене вашего приложения, целевой аудитории, тоне или специальной терминологии.
+  - _Описание_: Предоставляет дополнительный контекст о вашем приложении для модели ИИ, помогая ей генерировать более точные и контекстно уместные переводы. Это может включать информацию о домене вашего приложения, целевой аудитории, тоне или специфической терминологии.
 
 ### Конфигурация сборки
 
 Настройки, которые контролируют, как Intlayer оптимизирует и собирает интернационализацию вашего приложения.
 
-Параметры сборки применяются к плагинам `@intlayer/babel` и `@intlayer/swc`.
+Опции сборки применяются к плагинам `@intlayer/babel` и `@intlayer/swc`.
 
-> В режиме разработки Intlayer использует статические импорты для словарей, чтобы упростить процесс разработки.
+> В режиме разработки Intlayer использует статические импорты словарей для упрощения процесса разработки.
 
-> При оптимизации Intlayer заменит вызовы словарей для оптимизации разделения на чанки, чтобы финальный бандл импортировал только действительно используемые словари.
+> При оптимизации Intlayer заменяет вызовы словарей для оптимизации разбиения на чанки, так что итоговый бандл импортирует только те словари, которые действительно используются.
 
 #### Свойства
 
 - **optimize**:
   - _Тип_: `boolean`
   - _По умолчанию_: `process.env.NODE_ENV === 'production'`
-  - _Описание_: Контролирует, должна ли быть оптимизирована сборка.
+  - _Описание_: Управляет тем, должна ли сборка быть оптимизирована.
   - _Пример_: `true`
-  - _Примечание_: При включении Intlayer заменит все вызовы словарей для оптимизации разделения на чанки. Таким образом, финальный бандл будет импортировать только используемые словари. Все импорты останутся статическими, чтобы избежать асинхронной обработки при загрузке словарей.
-  - _Примечание_: Intlayer заменит все вызовы `useIntlayer` на режим, определенный опцией `importMode`, и `getIntlayer` на `getDictionary`.
+  - _Примечание_: При включении Intlayer заменит все вызовы словарей для оптимизации разбиения на чанки. Таким образом, итоговый бандл будет импортировать только используемые словари. Все импорты останутся статическими, чтобы избежать асинхронной обработки при загрузке словарей.
+  - _Примечание_: Intlayer заменит все вызовы `useIntlayer` на режим, определённый опцией `importMode`, а `getIntlayer` — на `getDictionary`.
   - _Примечание_: Эта опция зависит от плагинов `@intlayer/babel` и `@intlayer/swc`.
-  - _Примечание_: Убедитесь, что все ключи объявлены статически в вызовах `useIntlayer`. например: `useIntlayer('navbar')`.
+  - _Примечание_: Убедитесь, что все ключи объявлены статически в вызовах `useIntlayer`, например `useIntlayer('navbar')`.
 
 - **importMode**:
-  - _Тип_: `'static' | 'dynamic' | 'async'`
+  - _Тип_: `'static' | 'dynamic' | 'live'`
   - _По умолчанию_: `'static'`
-  - _Описание_: Контролирует, как импортируются словари.
+  - _Описание_: Управляет способом импорта словарей.
   - _Пример_: `'dynamic'`
   - _Примечание_: Доступные режимы:
     - "static": Словари импортируются статически. Заменяет `useIntlayer` на `useDictionary`.
     - "dynamic": Словари импортируются динамически с использованием Suspense. Заменяет `useIntlayer` на `useDictionaryDynamic`.
-    - "async": Словари импортируются динамически асинхронно. Заменяет `useIntlayer` на `await useDictionaryAsync`.
-  - _Примечание_: Динамические импорты зависят от Suspense и могут немного влиять на производительность рендеринга.
-  - _Примечание_: Если отключено, все локали будут загружены одновременно, даже если они не используются.
-  - _Примечание_: Эта опция зависит от плагинов `@intlayer/babel` и `@intlayer/swc`.
-  - _Примечание_: Убедитесь, что все ключи объявлены статически в вызовах `useIntlayer`. например: `useIntlayer('navbar')`.
-  - _Примечание_: Эта опция будет проигнорирована, если `optimize` отключен.
-  - _Примечание_: В большинстве случаев `"dynamic"` будет использоваться для React-приложений, `"async"` для Vue.js-приложений.
+- "live": Словари загружаются динамически с использованием API живой синхронизации. Заменяет `useIntlayer` на `useDictionaryFetch`.
+- _Примечание_: Динамические импорты зависят от Suspense и могут незначительно повлиять на производительность рендеринга.
+- _Примечание_: Если отключено, все локали будут загружены одновременно, даже если они не используются.
+- _Примечание_: Эта опция зависит от плагинов `@intlayer/babel` и `@intlayer/swc`.
+- _Примечание_: Убедитесь, что все ключи объявлены статически в вызовах `useIntlayer`, например `useIntlayer('navbar')`.
+- _Примечание_: Эта опция будет игнорироваться, если `optimize` отключен.
+  - _Примечание_: Если установлено значение "live", только словари, содержащие удалённый контент и помеченные флагом "live", будут преобразованы в режим live. Остальные будут импортироваться динамически в режиме "dynamic" для оптимизации количества запросов и производительности загрузки.
+  - _Примечание_: Режим live использует API живой синхронизации для получения словарей. Если вызов API не удаётся, словари будут импортированы динамически в режиме "dynamic".
   - _Примечание_: Эта опция не повлияет на функции `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` и `useDictionaryDynamic`.
 
 - **traversePattern**:
   - _Тип_: `string[]`
-  - _По умолчанию_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,mjx,cjx}', '!**/node_modules/**']`
+  - _По умолчанию_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx,mjx,cjx}', '!**\/node_modules/**']`
   - _Описание_: Шаблоны, определяющие, какие файлы должны быть обработаны во время оптимизации.
-    - _Пример_: `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']`
-  - _Примечание_: Используйте это для ограничения оптимизации релевантными файлами кода и улучшения производительности сборки.
-  - _Примечание_: Эта опция будет проигнорирована, если `optimize` отключен.
-  - _Примечание_: Используйте шаблоны glob.
+    - _Пример_: `['src/**\/*.{ts,tsx}', '../ui-library/**\/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Примечание_: Используйте это, чтобы ограничить оптимизацию только релевантными файлами кода и улучшить производительность сборки.
+  - _Примечание_: Этот параметр будет игнорироваться, если `optimize` отключен.
+  - _Примечание_: Используйте шаблон glob.
 
 ## История документации
 
-- 5.5.11 - 2025-06-29: Добавлены команды `docs`
+| Версия | Дата       | Изменения                                                                              |
+| ------ | ---------- | -------------------------------------------------------------------------------------- |
+| 6.0.0  | 2025-09-16 | Добавлен режим импорта `live`                                                          |
+| 6.0.0  | 2025-09-04 | Заменить поле `hotReload` на `liveSync` и добавить поля `liveSyncPort` и `liveSyncURL` |
+| 5.6.1  | 2025-07-25 | Заменить `activateDynamicImport` на опцию `importMode`                                 |
+| 5.6.0  | 2025-07-13 | Изменить значение по умолчанию для contentDir с `['src']` на `['.']`                   |
+| 5.5.11 | 2025-06-29 | Добавить команды `docs`                                                                |