@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.3

package/docs/ru/plugins/sync-json.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-12-13
-title: Плагин синхронизации JSON
-description: Синхронизируйте словари Intlayer с JSON-файлами сторонних i18n (i18next, next-intl, react-intl, vue-i18n и другими). Сохраняйте существующую i18n, используя Intlayer для управления, перевода и тестирования ваших сообщений.
+updatedAt: 2026-06-21
+title: Плагин Sync JSON
+description: Синхронизируйте словари Intlayer со сторонними i18n JSON-файлами (i18next, next-intl, react-intl, vue-i18n и другими). Сохраняйте существующую i18n структуру, используя Intlayer для управления, перевода и тестирования ваших сообщений.
 keywords:
   - Intlayer
-  - Синхронизация JSON
+  - Sync JSON
   - i18next
   - next-intl
   - react-intl
@@ -17,6 +17,7 @@ keywords:
   - Solid-i18next
   - svelte-i18n
   - i18n
+  - translations
   - переводы
 slugs:
   - doc
@@ -24,35 +25,38 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 9.0.0
+    date: 2026-06-21
+    changes: "Добавлена опция splitKeys (один словарь на каждый ключ пространства имен верхнего уровня) для однофайловых структур next-intl / react-intl"
   - version: 7.5.0
     date: 2025-12-13
     changes: "Добавлена поддержка форматов ICU и i18next"
   - version: 6.1.6
     date: 2025-10-05
-    changes: "Начальная документация плагина синхронизации JSON"
+    changes: "Начальная документация плагина Sync JSON"
 author: aymericzip
 ---
 
-# Синхронизация JSON (мосты i18n) - Синхронизация JSON с поддержкой ICU / i18next
+# Sync JSON (i18n bridges) — Синхронизация JSON с поддержкой ICU / i18next
 
-<iframe title="Как поддерживать синхронизацию ваших JSON-переводов с Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="Как синхронизировать ваши JSON-переводы с помощью Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
-Используйте Intlayer в качестве дополнения к вашему существующему стеку i18n. Этот плагин поддерживает синхронизацию ваших JSON-сообщений со словарями Intlayer, чтобы вы могли:
+Используйте Intlayer как дополнение к вашему существующему стеку i18n. Этот плагин синхронизирует ваши сообщения JSON со словарями Intlayer, чтобы вы могли:
 
-- Сохранять использование i18next, next-intl, react-intl, vue-i18n, next-translate, nuxt-i18n, Solid-i18next, svelte-i18n и других.
-- Управлять и переводить ваши сообщения с помощью Intlayer (CLI, CI, провайдеры, CMS), без необходимости рефакторинга вашего приложения.
-- Публиковать обучающие материалы и SEO-контент, ориентированный на каждую экосистему, предлагая Intlayer в качестве слоя управления JSON.
+- Сохраняйте поддержку i18next, next‑intl, react‑intl, vue‑i18n, next‑translate, nuxt‑i18n, Solid‑i18next, svelte‑i18n и других.
+- Управляйте и переводите свои сообщения с помощью Intlayer (CLI, CI, провайдеры, CMS) без рефакторинга вашего приложения.
+- Создавайте руководства и SEO-контент для каждой экосистемы, предлагая Intlayer в качестве слоя управления JSON.
 
-Примечания и текущий охват:
+Заметки и текущая область применения:
 
-- Внешняя интеграция с CMS работает для переводов и классического текста.
-- Пока нет поддержки вставок, множественного числа/ICU или продвинутых функций времени выполнения других библиотек.
-- Визуальный редактор пока не поддерживается для вывода сторонних i18n.
+- Экспорт в CMS работает для переводов и обычного текста.
+- Пока нет поддержки вставок, множественного числа/ICU или продвинутых функций рантайма других библиотек.
+- Визуальный редактор пока не поддерживает вывод i18n сторонних библиотек.
 
 ### Когда использовать этот плагин
 
 - Вы уже используете библиотеку i18n и храните сообщения в JSON-файлах.
-- Вы хотите использовать заполнение с помощью ИИ, тестирование в CI и управление контентом без изменения вашего runtime для рендеринга.
+- Вы хотите использовать автозаполнение с помощью ИИ, тесты в CI и content ops без изменения вашего рантайма рендеринга.
 
 ## Установка
 
@@ -62,9 +66,65 @@ pnpm add -D @intlayer/sync-json-plugin
 npm i -D @intlayer/sync-json-plugin
 ```
 
-## Быстрый старт
+## Плагины
 
-Добавьте плагин в ваш `intlayer.config.ts` и укажите путь к вашей существующей структуре JSON.
+Этот пакет предоставляет два плагина:
+
+- `loadJSON`: Загрузка JSON-файлов в словари Intlayer.
+  - Этот плагин используется для загрузки JSON-файлов из источника и их загрузки в словари Intlayer. Он может сканировать всю codebase и искать определенные JSON-файлы.
+    Этот плагин можно использовать
+    - если вы используете библиотеку i18n, которая требует определенного расположения для загрузки ваших JSON (например, `next-intl`, `i18next`, `react-intl`, `vue-i18n` и т. д.), но вы хотите размещать объявления контента там, где вам удобно в вашей codebase.
+    - Его также можно использовать, если вы хотите получать сообщения из удаленного источника (например, CMS, API и т. д.) и сохранять их в JSON-файлах.
+
+  > Внутри этот плагин будет сканировать всю кодовую базу (codebase), искать определенные JSON-файлы и загружать их в словари Intlayer.
+  > Обратите внимание, что этот плагин не будет записывать результат и переводы обратно в JSON-файлы.
+
+- `syncJSON`: Синхронизация JSON-файлов со словарями Intlayer.
+  - Этот плагин используется для синхронизации JSON-файлов со словарями Intlayer. Он может сканировать указанное местоположение и загружать JSON, соответствующие шаблону для определенных JSON-файлов. Этот плагин полезен, если вы хотите получить преимущества Intlayer, используя при этом другую библиотеку i18n.
+
+## Использование обоих плагинов
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Поддерживайте ваши текущие JSON-файлы в синхронизации со словарями Intlayer
+  plugins: [
+    /**
+     * Загрузит все JSON-файлы в src, которые соответствуют шаблону {key}.i18n json
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Гарантирует, что эти JSON-файлы имеют приоритет над файлами в `./locales/en/${key}.json`
+      format: "intlayer", // Формат содержимого JSON
+    }),
+    /**
+     * Загрузит, а также запишет результат и переводы обратно в JSON-файлы в директории locales
+     */
+    syncJSON({
+      format: "i18next",
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      priority: 0,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
+```
+
+## `syncJSON` plugin
+
+### Быстрый старт
+
+Добавьте плагин в ваш `intlayer.config.ts` и укажите ему на вашу существующую структуру JSON.
 
 ```ts fileName="intlayer.config.ts"
 import { Locales, type IntlayerConfig } from "intlayer";
@@ -76,11 +136,12 @@ const config: IntlayerConfig = {
     defaultLocale: Locales.ENGLISH,
   },
 
-  // Синхронизируйте ваши текущие JSON-файлы со словарями Intlayer
+  // Поддерживайте ваши текущие JSON-файлы в синхронизации со словарями Intlayer
   plugins: [
     syncJSON({
-      // Макет по локалям и пространствам имён (например, next-intl, i18next с пространствами имён)
+      // Макет для каждой локали, для каждого пространства имен (например, next-intl, i18next с пространствами имен)
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      format: "icu",
     }),
   ],
 };
@@ -88,65 +149,111 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Альтернатива: один файл на локаль (распространено в настройках i18next/react-intl):
+Альтернатива: один файл на локаль (часто используется в настройках i18next/react-intl):
 
 ```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "i18next",
+      source: ({ locale }) => `./locales/${locale}.json`,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
 ```
 
-### Как это работает
+#### Как это работает
 
-- Чтение: плагин обнаруживает JSON-файлы с помощью вашего билдера `source` и загружает их как словари Intlayer.
-- Запись: после сборок и заполнения он записывает локализованные JSON обратно по тем же путям (с завершающим переводом строки, чтобы избежать проблем с форматированием).
+- Чтение: плагин обнаруживает JSON-файлы из вашего `source` билдера и загружает их как словари Intlayer.
+- Запись: после сборки и заполнения он записывает локализованный JSON обратно по тем же путям (с конечной новой строкой, чтобы избежать проблем с форматированием).
 - Автозаполнение: плагин объявляет путь `autoFill` для каждого словаря. Запуск `intlayer fill` по умолчанию обновляет только отсутствующие переводы в ваших JSON-файлах.
 
 API:
 
 ```ts
 syncJSON({
-  source: ({ key, locale }) => string, // обязательно
-  location?: string, // необязательная метка, по умолчанию: "plugin"
-  priority?: number, // необязательный приоритет для разрешения конфликтов, по умолчанию: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // необязательный форматтер, используется для совместимости с runtime Intlayer
+  source: ({ key, locale }) => string, // required
+  location?: string, // optional label, default: "plugin"
+  priority?: number, // optional priority for conflict resolution, default: 0
+  format?: 'intlayer' | 'icu' | 'i18next', // optional formatter, used for intlayer runtime compatibility
+  splitKeys?: boolean, // необязательно, разделяет один файл на один словарь для каждого ключа верхнего уровня (автоматическое определение)
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Указывает форматтер, который будет использоваться для содержимого словаря при синхронизации JSON-файлов. Это позволяет использовать различные синтаксисы форматирования сообщений, совместимые с runtime Intlayer.
+Указывает форматтер, который будет использоваться для содержимого словаря при синхронизации JSON-файлов. Это позволяет использовать различные синтаксисы форматирования сообщений, совместимые с рантаймом intlayer.
 
 - `undefined`: Форматтер не будет использоваться, содержимое JSON будет использоваться как есть.
-- `'intlayer'`: Форматтер Intlayer по умолчанию (по умолчанию).
-- `'icu'`: Использует форматирование сообщений ICU (совместимо с библиотеками, такими как react-intl, vue-i18n).
+- `'intlayer'`: Форматтер Intlayer по умолчанию (default).
+- `'icu'`: Использует форматирование сообщений ICU (совместимо с такими библиотеками, как react-intl, vue-i18n).
 - `'i18next'`: Использует форматирование сообщений i18next (совместимо с i18next, next-i18next, Solid-i18next).
 
-> Обратите внимание, что использование форматтера преобразует ваше содержимое JSON на входе и выходе. Для сложных правил JSON, таких как множественные числа ICU, парсинг может не гарантировать соответствие 1 к 1 между входом и выходом.
-> Если вы не используете runtime Intlayer, возможно, лучше не устанавливать форматтер.
+> Обратите внимание, что использование форматтера преобразует содержимое вашего JSON на входе и выходе. Для сложных правил JSON, таких как множественное число ICU, парсинг может не гарантировать отображение один к одному между входом и выходом.
+> Если вы не используете рантайм Intlayer, вы можете предпочесть не устанавливать форматтер.
 
 **Пример:**
 
 ```ts
 syncJSON({
   source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
-  format: "i18next", // Использовать форматирование i18next для совместимости
+  format: "i18next", // Use i18next formatting for compatibility
+}),
+```
+
+#### `splitKeys` (boolean)
+
+Определяет, должен ли один JSON-файл, **ключи первого уровня которого являются пространствами имен**, становиться одним словарем на каждый ключ верхнего уровня, вместо одного словаря, содержащего весь файл.
+
+Это соответствует модели пространств имен таких библиотек, как `next-intl` и `react-intl`, где один файл `messages/{locale}.json` группирует несколько пространств имен по своим ключам первого уровня, каждое из которых адресуется независимо (например, `useTranslations('Hero')` разрешается в словарь `Hero`).
+
+- `undefined` (по умолчанию): **автоматическое определение** — файл разделяется, когда шаблон `source` не содержит сегмента `{key}` (один файл содержит все пространства имен), и сохраняется как один словарь в противном случае (один файл на ключ).
+- `true`: всегда разделять каждый ключ верхнего уровня на свой собственный словарь.
+- `false`: никогда не разделять; весь файл становится одним словарем.
+
+Пример одного файла `messages/{locale}.json`:
+
+```json fileName="messages/en.json"
+{
+  "Hero": { "title": "Full-stack developer" },
+  "Nav": { "work": "Work", "about": "About" },
+  "About": { "lead": "I build apps end to end." }
+}
+```
+
+```ts fileName="intlayer.config.ts"
+syncJSON({
+  format: "icu",
+  source: ({ locale }) => `./messages/${locale}.json`,
+  // splitKeys: true, // подразумевается, потому что шаблон не содержит сегмента `{key}`
 }),
 ```
 
-## Несколько источников JSON и приоритет
+Это создает три словаря — `Hero`, `Nav` и `About` — так что `useTranslations('Hero')` (next-intl) разрешается правильно. При обратной записи все пространства имен снова собираются в тот же файл для каждой локали.
+
+> Когда вы сохраняете явный сегмент `{key}` в вашем `source` (например, `./locales/${locale}/${key}.json`), каждый файл уже является одним пространством имен, поэтому разделение по умолчанию отключено.
 
-Вы можете добавить несколько плагинов `syncJSON` для синхронизации разных источников JSON. Это полезно, если в вашем проекте используются несколько библиотек i18n или разные структуры JSON.
+### Несколько источников JSON и приоритет
 
-### Система приоритетов
+Вы можете добавить несколько плагинов `syncJSON` для синхронизации различных источников JSON. Это полезно, когда у вас есть несколько библиотек i18n или различные структуры JSON в вашем проекте.
 
-Когда несколько плагинов нацелены на один и тот же ключ словаря, параметр `priority` определяет, какой плагин имеет преимущество:
+#### Система приоритетов
 
-- Побеждает плагин с более высоким числом приоритета
+Когда несколько плагинов нацелены на один и тот же ключ словаря, параметр `priority` определяет, какой плагин имеет приоритет:
+
+- Более высокие номера приоритета преобладают над более низкими
 - Приоритет по умолчанию для файлов `.content` равен `0`
-- Приоритет по умолчанию для файлов плагинов равен `-1`
+- Приоритет по умолчанию для плагинов равен `0`
 - Плагины с одинаковым приоритетом обрабатываются в порядке их появления в конфигурации
 
 ```ts fileName="intlayer.config.ts"
@@ -160,7 +267,7 @@ const config: IntlayerConfig = {
   },
 
   plugins: [
-    // Основной источник JSON (наивысший приоритет)
+    // Primary JSON source (highest priority)
     syncJSON({
       format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
@@ -168,7 +275,7 @@ const config: IntlayerConfig = {
       priority: 10,
     }),
 
-    // Резервный источник JSON (низший приоритет)
+    // Fallback JSON source (lower priority)
     syncJSON({
       format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
@@ -176,7 +283,7 @@ const config: IntlayerConfig = {
       priority: 5,
     }),
 
-    // Источник устаревших JSON (самый низкий приоритет)
+    // Legacy JSON source (lowest priority)
     syncJSON({
       format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
@@ -189,93 +296,160 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### Разрешение конфликтов
+## Load JSON plugin
+
+### Быстрый старт
 
-Когда один и тот же ключ перевода присутствует в нескольких JSON-источниках:
+Добавьте плагин в ваш `intlayer.config.ts`, чтобы импортировать существующие JSON-файлы как словари Intlayer. Этот плагин предназначен только для чтения (без записи на диск):
 
-1. Плагин с наивысшим приоритетом определяет итоговое значение
-2. Источники с более низким приоритетом используются как резервные для отсутствующих ключей
-3. Это позволяет поддерживать устаревшие переводы, постепенно переходя на новые структуры
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-## Интеграции
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
 
-Ниже приведены распространённые сопоставления. Не изменяйте ваше окружение выполнения; просто добавьте плагин.
+  plugins: [
+    // Импорт JSON-сообщений, расположенных в любом месте вашего исходного дерева
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      // Загрузка одной локали для каждого экземпляра плагина (по умолчанию используется defaultLocale из конфигурации)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
 
-### i18next
+export default config;
+```
 
-Типичная структура файлов: `./public/locales/{locale}/{namespace}.json` или `./locales/{locale}/{namespace}.json`.
+Альтернатива: макет для каждой локали, только для чтения (загружается только выбранная локаль):
 
 ```ts fileName="intlayer.config.ts"
-import { syncJSON } from "@intlayer/sync-json-plugin";
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-export default {
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
   plugins: [
-    syncJSON({
-      format: "i18next",
+    loadJSON({
+      // Только файлы для Locales.FRENCH будут загружены по этому шаблону
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      locale: Locales.FRENCH,
     }),
   ],
 };
+
+export default config;
 ```
 
-### next-intl
+### Как это работает
 
-JSON-сообщения для каждого локаля (часто `./messages/{locale}.json`) или по namespace.
+- Обнаружение: создает glob из вашего `source` билдера и собирает соответствующие JSON-файлы.
+- Импорт: загружает каждый JSON-файл как словарь Intlayer с предоставленной `locale`.
+- Только для чтения: не записывает и не форматирует выходные файлы; используйте `syncJSON`, если вам нужна двусторонняя синхронизация.
+- Готовность к автозаполнению: определяет шаблон `fill`, чтобы `intlayer content fill` мог заполнять отсутствующие ключи.
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
-  }),
-];
+### API
+
+```ts
+loadJSON({
+  // Build paths to your JSON. `locale` is optional if your structure has no locale segment
+  source: ({ key, locale }) => string,
+
+  // Target locale for the dictionaries loaded by this plugin instance
+  // Defaults to configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // Optional label to identify the source
+  location?: string, // default: "plugin"
+
+  // Priority used for conflict resolution against other sources
+  priority?: number, // default: 0
+
+  // Optional formatter for the JSON content
+  format?: 'intlayer' | 'icu' | 'i18next', // default: 'intlayer'
+
+  // Разделяет один файл на один словарь для каждого ключа верхнего уровня (автоматическое определение)
+  splitKeys?: boolean,
+});
 ```
 
-См. также: `docs/ru/intlayer_with_next-intl.md`.
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+Указывает форматтер, который будет использоваться для содержимого словаря при загрузке JSON-файлов. Это позволяет использовать различные синтаксисы форматирования сообщений, совместимые с различными библиотеками i18n.
 
-### react-intl
+- `'intlayer'`: Форматтер Intlayer по умолчанию (default).
+- `'icu'`: Использует форматирование сообщений ICU (совместимо с такими библиотеками, как react-intl, vue-i18n).
+- `'i18next'`: Использует форматирование сообщений i18next (совместимо с i18next, next-i18next, Solid-i18next).
 
-Обычно используется один JSON на локаль:
+**Пример:**
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+```ts
+loadJSON({
+  source: ({ key }) => `./src/**/${key}.i18n.json`,
+  locale: Locales.ENGLISH,
+  format: "icu", // Use ICU formatting for compatibility
+}),
 ```
 
-### vue-i18n
+#### `splitKeys` (boolean)
 
-Либо один файл на локаль, либо по пространствам имён:
+Поведение такое же, как в [`syncJSON`](#splitkeys-boolean): когда один JSON-файл группирует несколько пространств имен по своим ключам первого уровня, каждый ключ верхнего уровня становится своим собственным словарем.
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`, // источник файлов локализации
-  }),
-];
+- `undefined` (по умолчанию): **автоматическое определение** — разделение происходит, когда шаблон `source` не содержит сегмента `{key}`, в противном случае — один словарь.
+- `true` / `false`: принудительное включение или отключение разделения.
+
+```ts
+loadJSON({
+  source: ({ locale }) => `./messages/${locale}.json`,
+  format: "icu",
+  // splitKeys auto-enabled: `Hero`, `Nav`, `About`, … each become a dictionary
+}),
 ```
 
+### Поведение и соглашения
+
+- Если ваша маска `source` включает плейсхолдер локали, будут импортированы только файлы для выбранной `locale`.
+- Если в вашей маске нет сегмента `{key}`, каждый ключ верхнего уровня файла становится отдельным словарем по умолчанию (см. [splitKeys](#splitkeys-boolean)). Установите `splitKeys: false`, чтобы вместо этого загрузить весь файл как единый словарь `index`.
+- Ключи выводятся из путей к файлам путем подстановки плейсхолдера `{key}` в вашем `source` билдере.
+- Плагин использует только обнаруженные файлы и не создает отсутствующие локали или ключи.
+- Путь `fill` выводится из вашего `source` и используется для обновления отсутствующих значений через CLI, когда вы соглашаетесь.
+
+## Разрешение конфликтов
+
+Когда один и тот же ключ перевода существует в нескольких источниках JSON:
+
+1. Плагин с наивысшим приоритетом определяет окончательное значение
+2. Источники с более низким приоритетом используются в качестве запасных для отсутствующих ключей
+3. Это позволяет вам поддерживать устаревшие переводы, постепенно переходя к новым структурам
+
 ## CLI
 
-Синхронизированные JSON-файлы будут рассматриваться как другие файлы с расширением `.content`. Это означает, что все команды intlayer будут доступны для синхронизированных JSON-файлов, включая:
+Синхронизированные JSON-файлы будут рассматриваться как другие файлы `.content`. Это означает, что все команды intlayer будут доступны для синхронизированных JSON-файлов. Включая:
 
-- `intlayer content test` для проверки отсутствующих переводов
+- `intlayer content test` для проверки наличия отсутствующих переводов
 - `intlayer content list` для вывода списка синхронизированных JSON-файлов
 - `intlayer content fill` для заполнения отсутствующих переводов
 - `intlayer content push` для отправки синхронизированных JSON-файлов
-- `intlayer content pull` для загрузки синхронизированных JSON-файлов
+- `intlayer content pull` для получения синхронизированных JSON-файлов
 
-См. [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md) для получения дополнительной информации.
+Подробнее см. в [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md).
 
 ## Ограничения (текущие)
 
-- Нет поддержки вставок или множественного числа/ICU при работе с библиотеками третьих сторон.
-- Визуальный редактор пока недоступен для сред выполнения, не являющихся Intlayer.
-- Синхронизация только JSON; форматы каталогов, не являющиеся JSON, не поддерживаются.
+- Нет поддержки вставок или множественного числа/ICU при работе со сторонними библиотеками.
+- Визуальный редактор пока недоступен для рантаймов, отличных от Intlayer.
+- Только синхронизация JSON; форматы каталогов, отличные от JSON, не поддерживаются.
 
 ## Почему это важно
 
 - Мы можем рекомендовать проверенные решения i18n и позиционировать Intlayer как дополнение.
-- Мы используем их SEO/ключевые слова с помощью руководств, которые заканчиваются предложением использовать Intlayer для управления JSON.
-- Расширяет целевую аудиторию с «новых проектов» до «любых команд, уже использующих i18n».
+- Мы используем их SEO/ключевые слова с руководствами, которые заканчиваются предложением Intlayer для управления JSON.
+- Расширяет целевую аудиторию от «новых проектов» до «любой команды, уже использующей i18n».