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

package/docs/pt/roadmap.md

@@ -29,6 +29,12 @@ Intlayer é uma solução de gestão de conteúdo e internacionalização projet
 
 ---
 
+## Índice
+
+<TOC/>
+
+---
+
 ## Recursos Atuais
 
 ### 1. Declaração de Conteúdo

package/docs/ru/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 Intlayer позволяет автоматически генерировать переводы для ваших файлов декларации контента. Существует несколько способов достичь этого в зависимости от вашего рабочего процесса.
 
+## Содержание
+
+<TOC/>
+
 ## Использование CMS
 
 С Intlayer вы можете использовать рабочий процесс, при котором локально объявляется только одна локаль, а все переводы управляются удаленно через CMS. Это позволяет полностью отделить контент и переводы от кодовой базы, обеспечивая большую гибкость для редакторов контента и позволяя горячую перезагрузку контента (нет необходимости пересобирать приложение для применения изменений).

package/docs/ru/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# Автоматическое заполнение файлов объявления контента переводов
+
+**Автоматическое заполнение файлов объявления контента** в вашей CI — это способ ускорить рабочий процесс разработки.
+
+## Понимание поведения
+
+Команда `fill` включает два режима:
+
+- **Complete**: Автоматически заполняет все недостающее содержимое для каждой локали и редактирует текущий файл или другой файл, если он указан. То есть режим complete пропустит перевод существующего содержимого, если оно уже переведено.
+- **Review**: Автоматически заполняет **все** содержимое для каждой локали и генерирует для конкретного файла или другого файла, если он указан.
+
+Команда fill будет обрабатывать все ваши файлы объявления содержимого локали. То есть она не будет обрабатывать ваше удаленное содержимое из CMS. CMS включает собственное управление переводами.
+Если вы используете плагины, такие как `@intlayer/sync-json-plugin`, Intlayer преобразует файлы JSON в файлы объявления содержимого локали. То есть они будут обработаны командой `fill`.
+
+Новые сгенерированные файлы включают инструкцию `filled` в качестве метаданных словаря. Эта инструкция будет использоваться Intlayer для определения того, был ли файл автоматически заполнен или нет, и пропустит этот файл от повторного перевода, если она присутствует.
+
+Intlayer также будет учитывать следующую инструкцию для автоматического заполнения:
+
+- Из вашего `.content.{ts|js|json}` → инструкция `fill`
+- Из вашего файла конфигурации `.intlayer.config.ts` → инструкция `dictionary.fill`
+- По умолчанию будет установлено значение `true`
+
+Для файлов объявления содержимого для каждой локали инструкция `true` будет заменена на `./{{fileName}}.fill.content.json`. Это потому, что файл объявления содержимого для каждой локали не может получать дополнительное локализованное содержимое. Поэтому он будет генерировать новый файл, чтобы не перезаписать существующий файл.
+
+## Поведение по умолчанию
+
+По умолчанию `fill` установлено в `true` глобально, что означает, что Intlayer будет автоматически заполнять все файлы контента и редактировать сам файл. Это поведение можно настроить несколькими способами:
+
+### Глобальные параметры конфигурации
+
+1. **`fill: true` (по умолчанию)** - Автоматически заполнить все локали и отредактировать текущий файл
+2. **`fill: false`** - Отключить автоматическое заполнение для этого файла контента
+3. **`fill: "./relative/path/to/file"`** - Создать/обновить указанный файл без редактирования текущего, указав относительный путь, разрешенный на основе расположения текущего файла
+4. **`fill: "/absolute/path/to/file"`** - Создать/обновить указанный файл без редактирования текущего, указав относительный путь, разрешенный на основе расположения базовой директории (поле `baseDir` в файле конфигурации `.intlayer.config.ts`)
+5. **`fill: "C:\\absolute\path\to\file"`** - Создать/обновить указанный файл без редактирования текущего, указав абсолютный путь, разрешенный на основе вашей операционной системы
+6. **`fill: { [key in Locales]?: string }`** - Создать/обновить указанный файл для каждой локали
+
+### Изменения поведения в v7
+
+В v7 поведение команды `fill` было обновлено:
+
+- **`fill: true`** - Перезаписывает текущий файл с заполненным содержимым для всех локалей
+- **`fill: "path/to/file"`** - Заполняет указанный файл без изменения текущего файла
+- **`fill: false`** - Полностью отключает автоматическое заполнение
+
+При использовании опции пути для записи в другой файл механизм заполнения работает через отношение _master-slave_ между файлами объявления содержимого. Основной файл (master) служит источником истины, и при его обновлении Intlayer автоматически применит эти изменения к производным (заполненным) файлам объявления, указанным в пути.
+
 # Переводы файлов декларации автозаполнения контента
 
 **Файлы декларации автозаполнения контента**, это способ ускорить ваш процесс разработки.
@@ -88,6 +135,40 @@ Intlayer автоматически сгенерирует производны
 
 После этого оба файла деклараций будут объединены в один словарь, доступный через стандартный хук `useIntlayer("example")` (react) / композицию (vue).
 
+## Глобальная конфигурация
+
+Вы можете настроить глобальную конфигурацию автозаполнения в файле `intlayer.config.ts`.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // Автогенерация отсутствующих переводов для всех словарей
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // автогенерация отсутствующих переводов для всех словарей, как при использовании "./{{fileName}}.content.json"
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+Вы по-прежнему можете настраивать каждый словарь отдельно, используя поле `fill` в файлах содержимого. Intlayer сначала рассмотрит конфигурацию каждого словаря, а затем вернётся к глобальной конфигурации.
+
 ## Формат автозаполненного файла
 
 Рекомендуемый формат для автоматически заполняемых файлов деклараций, **JSON**, который помогает избежать ограничений форматирования. Однако Intlayer также поддерживает форматы `.ts`, `.js`, `.mjs`, `.cjs` и другие.

package/docs/ru/benchmark/solid.md

@@ -117,6 +117,28 @@ history:
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что фактически появилось в сети и сколько времени это заняло. Размеры указаны **после обычного сжатия веб-контента**, поскольку это ближе к тому, что люди загружают, чем к подсчету необработанного исходного кода.
+
+- **Размер библиотеки интернационализации**: После объединения, удаления неиспользуемого кода и минификации размер библиотеки i18n — это размер поставщиков + код hooks/primitives в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорогостоящей является библиотека до того, как ваш контент вступит в игру.
+
+- **JavaScript на странице**: Для каждого маршрута бенчмарка — сколько скрипта браузер загружает при посещении, усредненное по страницам в наборе (и по языкам, где отчет их объединяет). Тяжелые страницы — медленные страницы.
+
+- **Утечка из других языков**: Это контент той же страницы, но на другом языке, который может быть случайно загружен на проверяемую страницу. Этот контент является ненужным и должен быть избегнут. (например, содержимое страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: То же самое для **других экранов** приложения: загружается ли их контент вместе с ними при открытии только одной страницы. (например, содержимое страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разделение или слишком широкие пакеты.
+
+- **Средний размер пакета компонента**: Общие элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного огромного числа приложения. Это показывает, незаметно ли интернационализация увеличивает повседневные компоненты. Например, если ваш компонент перерисовывается, он загружает все эти данные из памяти. Присоединение большого JSON к любому компоненту похоже на подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Отзывчивость переключения языка**: Я переключаю язык с помощью элемента управления приложением и отсчитываю время до четкого переключения страницы, что заметит посетитель, а не микрошаг в лаборатории.
+
+- **Работа отрисовки после смены языка**: Более узкое продолжение: сколько усилий потребовалось интерфейсу на перерисовку для нового языка после инициирования переключения. Полезно, когда "субъективное" время и затраты фреймворка расходятся.
+
+- **Время начальной загрузки страницы**: От навигации до того, как браузер считает страницу полностью загруженной для проверенных сценариев. Хорошо подходит для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это раскрывает, сколько времени клиент тратит на преобразование HTML сервера в то, на что вы фактически можете щелкнуть. Прочерк в таблицах означает, что эта реализация не предоставила надежное значение гидратации в этом бенчмарке.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/benchmark/svelte.md

@@ -116,6 +116,28 @@ style="border:none;"
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что действительно появилось на сети и сколько времени это заняло. Размеры указаны **после обычного веб-сжатия**, поскольку это ближе к тому, что люди загружают, чем к подсчёту исходного кода.
+
+- **Размер библиотеки интернационализации**: После объединения, встряхивания дерева и минификации размер библиотеки i18n — это размер кода провайдеров и хранилищ в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорога библиотека до того, как ваше содержимое попадёт в картину.
+
+- **JavaScript на странице**: Для каждого маршрута тестирования, сколько скриптов браузер подгружает при этом посещении, усреднённое по страницам в наборе (и по локалям, где отчёт их объединяет). Тяжёлые страницы — это медленные страницы.
+
+- **Утечка из других локалей**: Это содержимое той же страницы, но на другом языке, которое может быть загружено по ошибке в проверяемую страницу. Это содержимое не нужно и его следует избегать. (например, содержимое страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: Та же идея для **других экранов** в приложении: загружается ли их копия, когда вы открыли только одну страницу. (например, содержимое страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разделение или чрезмерно широкие пакеты.
+
+- **Средний размер пакета компонента**: Общие элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного гигантского числа приложения. Это показывает, скрытно ли интернационализация увеличивает повседневные компоненты. Например, если ваш компонент перерисовывается, он загружает все эти данные из памяти. Присоединение большого JSON к любому компоненту похоже на подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Отзывчивость переключения языка**: Я переключаю язык с помощью собственного элемента управления приложения и измеряю, сколько времени проходит, пока страница явно не переключится, что заметил бы посетитель, а не лабораторный микрошаг.
+
+- **Работа рендеринга после изменения языка**: Более узкое продолжение: сколько усилий потребовалось интерфейсу, чтобы перерисовать новый язык, когда переключение уже в пути. Полезно, когда «субъективное» время и стоимость фреймворка расходятся.
+
+- **Время начальной загрузки страницы**: От навигации до того, как браузер считает страницу полностью загруженной для протестированных сценариев. Хорошо для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это раскрывает, сколько времени клиент тратит на превращение HTML-кода сервера во что-то, на что можно действительно щёлкнуть. Тире в таблицах означает, что эта реализация не предоставила надёжную цифру гидратации в этом тесте.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/benchmark/tanstack.md

@@ -124,6 +124,28 @@ history:
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что фактически показалось в сети и сколько времени это заняло. Размеры указаны **после стандартного веб-сжатия**, потому что это ближе к тому, что люди скачивают, чем к подсчёту исходного кода.
+
+- **Размер библиотеки интернационализации**: После bundling, tree-shaking и minification размер библиотеки i18n — это размер поставщиков (например `NextIntlClientProvider`) + код hooks (например `useTranslations`) в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорогой является библиотека, прежде чем в игру вступит ваш контент.
+
+- **JavaScript на странице**: Для каждого маршрута тестирования, сколько скрипта браузер загружает при каждом посещении, усреднённые по страницам в наборе (и по локалям, где отчёт их объединяет). Тяжёлые страницы — медленные страницы.
+
+- **Утечка из других локалей**: Это контент той же страницы, но на другом языке, который по ошибке загружается на проверяемую страницу. Этот контент не нужен и его следует избегать. (например, контент страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: То же самое для **других экранов** приложения: загружается ли их копия вместе с тем, когда вы открыли только одну страницу. (например, контент страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разбиение или слишком широкие пакеты.
+
+- **Средний размер пакета компонента**: Обычные элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного гигантского числа приложения. Это показывает, скрывает ли интернационализация незаметно раздуванием обычные компоненты. Например, если ваш компонент переуходит, он загружает все эти данные из памяти. Привязка большого JSON к любому компоненту — это как подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Скорость переключения языка**: Я переключаю язык с помощью собственного элемента управления приложения и замеряю, сколько времени проходит до того, как страница явно переключится, что заметит посетитель, а не лабораторный микро-шаг.
+
+- **Работа по рендерингу после смены языка**: Более узкое продолжение: сколько усилий затратил интерфейс на перерисовку нового языка после того, как переключение началось. Полезно, когда "ощущаемое" время и стоимость framework расходятся.
+
+- **Время первоначальной загрузки страницы**: От навигации до того момента, когда браузер считает страницу полностью загруженной для тестируемых сценариев. Хорошо подходит для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это предоставляет, как долго клиент потратит на превращение серверного HTML во что-то, на что вы действительно можете нажать. Прочерк в таблицах означает, что эта реализация не предоставила надежный показатель гидратации в этом тесте.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Строительные блоки GitHub Actions
+
+При запуске `intlayer init`, Intlayer определяет ваш package manager (npm, yarn, pnpm или bun) и создает два workflow'а GitHub Actions в папке `.github/workflows/`, с командами, соответствующими вашему package manager'у:
+
+- **`intlayer-fill.yml`** — При каждом pull request'е собирает словари и запускает `intlayer fill --git-diff --mode complete` для генерации недостающих переводов в измененных словарях, а затем коммитит результат обратно в ветку PR.
+- **`intlayer-test.yml`** — При каждом pull request'е собирает словари и запускает `intlayer test`, не пропуская проверку, когда требуемым локалям не хватает переводов.
+
+Существующие файлы workflow никогда не перезаписываются. Чтобы полностью пропустить создание строительных блоков, запустите:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Предоставление доступа к ИИ для рабочего процесса fill
+
+Созданный файл `intlayer-fill.yml` требует доступа к ИИ. Доступны два варианта (настраиваются в блоке `env` рабочего процесса):
+
+1. **Ваш собственный ключ поставщика ИИ** — добавьте секрет `AI_API_KEY` в настройки репозитория (Settings → Secrets and variables → Actions). Рабочий процесс передает его через `--provider`, `--model` и `--api-key`.
+2. **Ключи доступа Intlayer CMS** — добавьте секреты `INTLAYER_CLIENT_ID` и `INTLAYER_CLIENT_SECRET` и свяжите их с разделом `editor` в вашем `intlayer.config`. Ключи доступа CMS предоставляют доступ к ИИ через backend Intlayer.
+
+Рабочий процесс `intlayer-test.yml` не требует доступа к ИИ.
+
 ## Обработка ошибок
 
 - Если `INTLAYER_PROJECT_CREDENTIALS` не установлена, команда завершится с ошибкой.

package/docs/ru/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Проверка документа
 description: Узнайте, как проверять файлы документации на качество, согласованность и полноту для разных локалей.
 keywords:
@@ -15,6 +15,10 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Добавить опцию --log"
 author: aymericzip
 ---
 
@@ -55,8 +59,110 @@ bun x intlayer doc review
 
 ## Аргументы:
 
-Команда `doc review` принимает те же аргументы, что и `doc translate`, позволяя вам проверять конкретные файлы документации и применять проверки качества.
+**Опции списка файлов:**
 
-Если вы активировали одну из опций git, команда будет проверять только ту часть файлов, которая изменяется. Скрипт будет обрабатывать файл по частям (чанкам) и проверять каждый из них. Если в чанке нет изменений, скрипт пропустит его, чтобы ускорить процесс проверки и снизить стоимость использования API AI-провайдера.
+- **`--doc-pattern [docPattern...]`**: Глобальные шаблоны для выбора файлов документации, которые нужно проверить.
 
-Для полного списка аргументов смотрите документацию команды [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/doc-translate.md).
+  > Пример: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Глобальные шаблоны для исключения файлов из проверки.
+
+  > Пример: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Пропустить файл, если он был изменён до указанного времени.
+  - Может быть абсолютным временем, например "2025-12-05" (строка или Date)
+  - Может быть относительным временем в миллисекундах `1 * 60 * 60 * 1000` (1 час)
+  - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
+
+  > Пример: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Пропустить файл, если он был изменён в течение указанного времени.
+  - Может быть абсолютным временем, например "2025-12-05" (строка или Date)
+  - Может быть относительным временем в миллисекундах `1 * 60 * 60 * 1000` (1 час)
+  - Эта опция проверяет время обновления файла с помощью метода `fs.stat`. Поэтому она может быть затронута Git или другими инструментами, которые изменяют файл.
+
+  > Пример: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Пропустить файл, если он уже существует.
+
+  > Пример: `npx intlayer doc review --skip-if-exists`
+
+**Опции режима проверки:**
+
+- **`--log`**: Режим только логирования. Не переводить с помощью ИИ; вместо этого логировать блоки, требующие внимания (с номерами строк и содержимым) для базовой и целевой локалей, чтобы помочь другому агенту сгенерировать переводы.
+
+  > Пример: `npx intlayer doc review --log`
+
+**Опции вывода записей:**
+
+- **`--locales [locales...]`**: Целевые локали для проверки документации.
+
+  > Пример: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Исходная локаль (базовый документ) для сравнения.
+
+  > Пример: `npx intlayer doc review --base-locale en`
+
+**Опции обработки файлов:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Количество файлов, обрабатываемых одновременно для проверки.
+
+  > Пример: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Опции ИИ:**
+
+- **`--model [model]`**: Модель ИИ, используемая для проверки (например, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Провайдер ИИ, используемый для проверки.
+- **`--temperature [temperature]`**: Параметр температуры для модели ИИ.
+- **`--api-key [apiKey]`**: Предоставьте свой собственный API-ключ для сервиса ИИ.
+- **`--application-context [applicationContext]`**: Предоставьте дополнительный контекст для проверки ИИ.
+- **`--data-serialization [dataSerialization]`**: Формат сериализации данных для использования в функциях ИИ Intlayer. Опции: `json` (стандартный, надежный), `toon` (меньше токенов, менее стабильный).
+- **`--custom-prompt [prompt]`**: Настройка базового запроса, используемого для проверки. (Примечание: для большинства случаев рекомендуется использовать опцию `--custom-instructions`, так как она обеспечивает лучший контроль.)
+
+  > Пример: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Мое приложение, магазин для кошек"`
+
+**Опции переменных окружения:**
+
+- **`--env`**: Указать окружение (например, `development`, `production`).
+- **`--env-file [envFile]`**: Указать пользовательский файл окружения для загрузки переменных.
+- **`--base-dir`**: Указать базовую директорию проекта.
+- **`--no-cache`**: Отключить кэш.
+
+  > Пример: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Опции логирования:**
+
+- **`--verbose`**: Включить подробное логирование для отладки. (по умолчанию включено при использовании CLI)
+
+  > Пример: `npx intlayer doc review --verbose`
+
+**Опции пользовательских инструкций:**
+
+- **`--custom-instructions [customInstructions]`**: Пользовательские инструкции, добавляемые в запрос. Полезно для применения специфических правил касательно форматирования, перевода URL и т.д.
+
+  > Пример: `npx intlayer doc review --custom-instructions "Избегайте перевода URL и сохраняйте формат markdown"`
+
+  > Пример: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Опции Git:**
+
+- **`--git-diff`**: Запускать только для файлов, которые содержат изменения от базовой ветки (по умолчанию `origin/main`) до текущей ветки (по умолчанию: `HEAD`).
+- **`--git-diff-base`**: Указать базовую ссылку для git diff (по умолчанию `origin/main`).
+- **`--git-diff-current`**: Указать текущую ссылку для git diff (по умолчанию `HEAD`).
+- **`--uncommitted`**: Включать незафиксированные изменения.
+- **`--unpushed`**: Включать изменения, не отправленные в удалённый репозиторий.
+- **`--untracked`**: Включать неотслеживаемые файлы.
+
+  > Пример: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Пример: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Обратите внимание, что путь к выходному файлу будет определяться путем замены следующих шаблонов:
+>
+> - `/{{baseLocale}}/` на `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` на `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` на `_{{locale}}.`
+> - `{{baseLocale}}_` на `{{locale}}_`
+> - `.{{baseLocaleName}}.` на `.{{localeName}}.`
+>
+> Если шаблон не найден, к расширению файла будет добавлено `.{{locale}}`. Например, `./my/file.md` будет проверен и обновлен в `./my/file.fr.md` для французской локали.

package/docs/ru/cli/fill.md

@@ -47,6 +47,14 @@ bun x intlayer fill
 - Сохраняет существующие переводы, не перезаписывая их.
 - Обрабатывает файлы, части и локали параллельно с использованием системы очередей для увеличения скорости.
 
+## Ключевые моменты:
+
+- Разделяет большие JSON файлы на chunks, чтобы оставаться в пределах контекстного окна AI модели.
+- Повторяет перевод, если формат вывода некорректен.
+- Включает контекст приложения и файла для улучшенной точности перевода.
+- Сохраняет существующие переводы, не перезаписывая их.
+- Обрабатывает файлы, chunks и locales параллельно, используя систему очередей для увеличения скорости.
+
 ## Псевдонимы:
 
 - `npx intlayer dictionaries fill`

package/docs/ru/cli/index.md

@@ -17,7 +17,7 @@ slugs:
   - concept
   - cli
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Добавлена команда scan"
   - version: 8.6.4

package/docs/ru/cli/login.md

@@ -80,42 +80,6 @@ bun x intlayer login --cms-url https://intlayer.org
 
 Вы также можете использовать общие параметры конфигурации:
 
-- `--env-file <path>`: Путь к файлу окружения
-- `-e, --env <env>`: Среда выполнения
-- `--base-dir <dir>`: Базовый каталог проекта
-- `--verbose`: Включить подробный вывод (по умолчанию: true)
-- `--prefix <prefix>`: Префикс для логов
-
-## Как это работает
-
-1. **Запуск локального сервера**: команда запускает локальный HTTP-сервер на случайном порту, чтобы получить учетные данные от CMS
-
-Укажите URL Intlayer CMS, к которой нужно подключиться для аутентификации.
-
-- **Тип**: `string`
-- **По умолчанию**: Значение, настроенное в `intlayer.config.*` или `https://intlayer.org`
-- **Пример**:
-
-```bash packageManager="npm"
-npx intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="yarn"
-yarn intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="bun"
-bun x intlayer login --cms-url https://intlayer.org
-```
-
-### Параметры конфигурации
-
-Вы также можете использовать общие параметры конфигурации:
-
 - `--env-file <path>`: Путь к файлу окружения
 - `-e, --env <env>`: Среда выполнения
 - `--base-dir <dir>`: Базовая директория проекта

package/docs/ru/cli/scan.md

@@ -18,7 +18,7 @@ slugs:
   - cli
   - scan
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-11
     changes: "Добавлена команда scan"
 author: aymericzip

package/docs/ru/compat/i18n-js.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с i18n-js на Intlayer"
+description: "Узнайте, как перенести ваше приложение с i18n-js на Intlayer, используя адаптер совместимости."
+keywords:
+  - i18n-js
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с i18n-js на Intlayer
+
+Переход с библиотеки `i18n-js` на Intlayer - это высокооптимизированная миграция, предназначенная для выгрузки больших конфигураций переводов в систему структурированного разрешения файлов Intlayer.
+
+## Что делать
+
+Выполните следующую команду установки в вашем репозитории:
+
+```bash
+npx intlayer init
+```
+
+Когда `intlayer.config.ts` будет подготовлен, вы можете добавить псевдоним Intlayer в конфигурацию bundler, чтобы любые импорты `i18n-js` указывали на пакет совместимости `@intlayer/i18n-js`.
+
+## Что происходит под капотом
+
+`i18n-js` получает доступ к пространствам имён через выражения такие как `i18n.t('scope.key', {name})` вместе с откатом локали и специфичными сопоставлениями множественного числа.
+
+Под капотом:
+
+- **Интерполяция:** Адаптер совместимости легко анализирует сопоставления `%{name}` в значение целевого словаря времени выполнения.
+- **Множественное число:** Заменяет подключи `one/other` и сопоставляет их с мощными механизмами множественного числа Intlayer (`Intl.PluralRules`), абстрагируя ручные сопоставления.
+- **Локали:** Вместо загрузки монолитных языковых нагрузок при загрузке, словари подаются оптимально на основе текущей конфигурации контекста через встроенную конфигурацию Intlayer.

package/docs/ru/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с i18next на Intlayer"
+description: "Узнайте, как перенести ваше приложение на Vanilla JS/TS с i18next на Intlayer, используя адаптер совместимости."
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с i18next на Intlayer
+
+Для подробного пошагового обучения см. наше полное [руководство по миграции i18next](../migration_from_i18next_to_intlayer.md).
+
+Intlayer идеально воспроизводит основные характеристики runtime `i18next`. Используя пакет совместимости, ваши приложения Vanilla или внутренние модули могут продолжать использовать знакомый синтаксис.
+
+## Что делать
+
+Чтобы начать, инициализируйте Intlayer в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Если вы используете Vite, включите плагин Intlayer, чтобы маршрутизировать импорты на `@intlayer/i18next`:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## Что происходит под капотом
+
+`i18nextVitePlugin` создает псевдонимы импортов `i18next` на `@intlayer/i18next`, избегая раздувания bundle от включений JSON файлов.
+
+Под капотом:
+
+- **Конфигурация экземпляра:** `createInstance` правильно анализирует и применяет откат пространства имён, используя pipeline компиляции Intlayer для получения словаря.
+- **Интерполяция:** Встроенная поддержка замен `{{name}}` и вложения `$t(key)` рекурсивно.
+- **Контекст и множественное число:** Идентифицирует и разрешает форматы суффиксов как `key_male` и `key_one`/`key_other`, оцениваемые против стандарта `Intl.PluralRules`.
+- **Возвратные объекты:** Режим `returnObjects: true` безопасно извлекает деревья из словарей Intlayer.