@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.6

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/fill.md

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

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/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.

package/docs/ru/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Адаптеры совместимости Intlayer"
+description: "Переведите ваше существующее решение i18n на Intlayer без трения, используя адаптеры совместимости."
+keywords:
+  - compat
+  - миграция
+  - интернационализация
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Адаптеры совместимости Intlayer
+
+Миграция крупного приложения на новую библиотеку интернационализации может быть сложной. Чтобы облегчить этот переход, Intlayer предоставляет **адаптеры совместимости** для наиболее популярных библиотек i18n в экосистеме.
+
+Эти пакеты адаптеров предоставляют **точно такой же публичный API**, как ваши существующие библиотеки i18n, но делегируют всю работу по переводу Intlayer во время выполнения.
+
+## Как это работает
+
+Когда вы используете адаптер совместимости, вам не нужно переписывать импорты приложения или изменять способ использования ваших хуков перевода и компонентов. Вместо этого плагины bundler Intlayer автоматически создают псевдонимы ваших существующих импортов для пакетов совместимости Intlayer.
+
+Например, разработчик заменяет `import { useTranslation } from 'react-i18next'` на `import { useTranslation } from '@intlayer/react-i18next'` (выполняется автоматически через плагин bundler), и приложение продолжает работать с переводами, поступающими из словарей Intlayer. Ключи также типированы в соответствии с вашими словарями Intlayer!
+
+## Доступные адаптеры совместимости
+
+Выберите вашу существующую библиотеку ниже, чтобы увидеть, как перейти на него легко:
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/ru/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с Lingui на Intlayer"
+description: "Узнайте, как перенести ваше приложение с Lingui на Intlayer, используя адаптер совместимости."
+keywords:
+  - lingui
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с Lingui на Intlayer
+
+Если ваш проект в настоящее время полагается на компиляцию на основе макросов Lingui, переход на Intlayer позволяет вам сохранить мощные рабочие процессы макросов, поддерживая их изначально стратегией компиляции JSON Intlayer.
+
+## Что делать
+
+Чтобы начать, инициализируйте Intlayer в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Это создает ваш `intlayer.config.ts`. Убедитесь, что вы сохранили `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` в вашем шаге сборки для запуска _перед_ компилятором Intlayer. Затем используйте псевдоним плагина bundler для маршрутизации `@lingui/core` и `@lingui/react` на `@intlayer/lingui`.
+
+## Что происходит под капотом
+
+Lingui использует макросы (такие как `` t`Hello ${name}` `` и `<Trans>`), которые компилируются в вызовы runtime, такие как `i18n._(id, values)`.
+
+Под капотом:
+
+- **Макросы:** Они компилируются точно так же, как и раньше, обеспечивая отсутствие нарушений в синтаксисе вашего исходного кода.
+- **Перевод runtime:** Aliased `i18n._()` использует словари Intlayer. Как явно названные ID, так и хешированные ID полностью отображаются с использованием плагинов синхронизации `.po` Intlayer для безопасного агрегирования и обрезки ключей.
+- **Возможности ICU:** Поддержка множественного числа, выбора и вариантов ICU остается надежной благодаря унифицированному парсеру ICU Intlayer, обеспечивающему идентичные выходные данные отображения.

package/docs/ru/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с next-i18next на Intlayer"
+description: "Узнайте, как перенести ваше приложение Next.js с next-i18next на Intlayer, используя адаптер совместимости."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с next-i18next на Intlayer
+
+Для полного и подробного пошагового учебника см. наше полное [руководство по миграции next-i18next](../migration_from_next-i18next_to_intlayer.md).
+
+Intlayer прозрачно обрабатывает все реализации Next.js Pages Router и App Router. Использование адаптера позволяет вам перенести вашу реализацию `next-i18next` без переписывания кода.
+
+## Что делать
+
+Чтобы начать, запустите:
+
+```bash
+npx intlayer init
+```
+
+Это создает требуемый файл настройки Intlayer. Чтобы переключиться на Intlayer за кулисами, обновите ваш `next.config.ts`:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Что происходит под капотом
+
+`createNextI18nPlugin` компонует встроенное поведение Next.js вместе с основным плагином `next-intlayer`, вводя все необходимые псевдонимы Webpack/Turbopack для `next-i18next`, `react-i18next` и `i18next`.
+
+Под капотом:
+
+- **`serverSideTranslations` & `appWithTranslation`:** Теперь они функционируют как обертки для внутренних загрузчиков Intlayer, обходя большие статические впрыскивания JSON.
+- **Клиентские хуки:** Немедленно делегирует на `@intlayer/react-i18next`, сохраняя все возможности форматирования, множественного числа и вложенных пространств имён.

package/docs/ru/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с next-intl на Intlayer"
+description: "Узнайте, как перенести ваше приложение Next.js с next-intl на Intlayer, используя адаптер совместимости."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с next-intl на Intlayer
+
+Для полного и подробного пошагового учебника см. наше полное [руководство по миграции next-intl](../migration_from_next-intl_to_intlayer.md).
+
+Миграция с `next-intl` на Intlayer позволяет вам полностью сохранить маршрутизацию и синтаксис приложения.
+
+## Что делать
+
+Выполните следующую команду в вашем репозитории:
+
+```bash
+npx intlayer init
+```
+
+Это создаст `intlayer.config.ts`. В вашем `next.config.ts`, используйте обертку плагина для беспрепятственного впрыскивания псевдонимов `next-intl` в `@intlayer/next-intl`.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Что происходит под капотом
+
+Обертка bundler заменяет переводы, но **оставляет функции `next-intl/navigation` нетронутыми** (например, `Link`, `redirect`, `usePathname`).
+
+Под капотом:
+
+- **ICU runtime:** Множественное число (`=0`, `one`, `other`), select/selectordinal, аргументы `#` и отформатированные аргументы (`{ts, date, long}`) работают правильно, используя общий resolver `resolveMessage(..., 'icu')`.
+- **`useTranslations()` & `getTranslations()`:** Вызовы пустой области извлекают первый сегмент ключа как правильный идентификатор словаря. Вложенные пространства имён грациозно расщепляются на пути словаря и префиксы.
+- **Форматирование Rich:** Оба `t.rich()` и `t.markup()` полностью изначально реализованы, преобразуя HTML-подобные узлы в отображаемые куски React.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange` и именованные форматы из конфигурации моста к основным встроенным форматерам `Intl`.

package/docs/ru/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с Next Translate на Intlayer"
+description: "Узнайте, как перенести ваше приложение Next.js с next-translate на Intlayer, используя адаптер совместимости."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с Next Translate на Intlayer
+
+Миграция с `next-translate` на Intlayer - это почти прямая замена, которая сохраняет ваш существующий синтаксис и теги.
+
+## Что делать
+
+Инициализируйте Intlayer в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+CLI будет строить вашу конфигурацию. Вы можете применить плагин Intlayer в вашем `next.config.ts`, который впрыскивает псевдонимы подпути времени сборки, сопоставляющие `next-translate/useTranslation` с `@intlayer/next-translate`.
+
+## Что происходит под капотом
+
+`next-translate` предоставляет хуки, такие как `useTranslation('ns')`, `t('ns:key.path')` и компонент `<Trans>`.
+
+Под капотом:
+
+- **Интерполяция и множественное число:** Он тесно полагается на поведение адаптера `react-i18next`. Динамически обрабатываются заполнители `{{var}}` и множественное число, отображаемое из суффиксов, таких как `key_0`, `key_one` и `key_other`.
+- **Компонент `<Trans>`:** Прямо поддерживается для парсинга HTML-подобных тегов вместе с prop `components` на основе массива.
+- **Пространства имён:** Подпуть aliasing обеспечивает, что ваш `useTranslation` ссылается на правильные внутренние пространства имён словаря без ручного изменения.

package/docs/ru/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с NGX-Translate на Intlayer"
+description: "Узнайте, как перенести ваше приложение Angular с ngx-translate на Intlayer, используя адаптер совместимости."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с NGX-Translate на Intlayer
+
+Миграция вашего приложения Angular с `ngx-translate` на Intlayer легко с адаптером совместимости, позволяя вам избежать необходимости переписывать все ваши шаблоны.
+
+## Что делать
+
+Начните с запуска:
+
+```bash
+npx intlayer init
+```
+
+Это устанавливает `intlayer.config.ts`. Замените ваши параметры `TranslateModule.forRoot()` и импортируйте псевдонимы должным образом, чтобы они указывали на `@intlayer/ngx-translate`.
+
+## Что происходит под капотом
+
+`ngx-translate` использует `TranslateService` (`instant`, `get`, `stream`) вместе с трубой `{{ 'KEY' | translate:params }}` и директивой `[translate]`.
+
+Под капотом:
+
+- **Services:** `TranslateService` оборачивает `getIntlayer` и наблюдаемую локаль, предоставляя точно те же методы.
+- **Pipes и директивы:** Переимплементированы для прямого разрешения в словарях Intlayer.
+- **Loaders:** Параметры `TranslateHttpLoader` преобразуются в предупреждающие заглушки, потому что Intlayer по своей природе разрешает и объединяет ваши словари во время сборки (или через стандартные динамические импорты), полностью исключая необходимость в HTTP-загрузчиках.

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

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с NuxtJS I18n на Intlayer"
+description: "Узнайте, как перенести ваше приложение Nuxt.js с @nuxtjs/i18n на Intlayer, используя адаптер совместимости."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с NuxtJS I18n на Intlayer
+
+Миграция вашего приложения Nuxt с `@nuxtjs/i18n` на Intlayer - это бесшовный процесс с использованием модуля Nuxt adapter.
+
+## Что делать
+
+Чтобы инициализировать проект, запустите:
+
+```bash
+npx intlayer init
+```
+
+Это установит `intlayer.config.ts`. Затем добавьте модуль Intlayer Nuxt (например, `@intlayer/nuxt-i18n`) в массив модулей вашего `nuxt.config.ts`. Это автоматически применяет конфигурацию совместимости для вашего приложения.
+
+## Что происходит под капотом
+
+`@nuxtjs/i18n` оборачивает `vue-i18n` при этом предоставляя composables, специфичные для Nuxt (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Под капотом:
+
+- **Переводы:** Изначально полагается на слой совместимости `@intlayer/vue-i18n` для всех задач перевода строк (полностью поддерживая форматы `vue-i18n`, плюральные трубы и реактивность).
+- **Маршрутизация:** Отражает composables маршрутизации, используя помощников локализованного URL Intlayer.
+- **Конфигурация:** Читает `availableLocales` и параметры по умолчанию прямо из вашего `intlayer.config.ts` для автоматической координации страниц Nuxt.

package/docs/ru/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с Polyglot.js на Intlayer"
+description: "Узнайте, как перейти с Polyglot.js на Intlayer, используя адаптер совместимости."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с Polyglot.js на Intlayer
+
+Если вы используете Polyglot.js от Airbnb, миграция на Intlayer чрезвычайно проста, используя слой совместимости.
+
+## Что делать
+
+Просто запустите команду инициализации в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Это генерирует `intlayer.config.ts`. Вы можете затем использовать псевдоним плагина bundler для прозрачного перенаправления импортов Polyglot на `@intlayer/polyglot`.
+
+## Что происходит под капотом
+
+Синтаксис Polyglot.js обычно полагается на `polyglot.t('key', {name})` с интерполяциями `%{name}` и множеством `smart_count`, разделенным на `"singular |||| plural"`.
+
+Под капотом:
+
+- **Интерполяция:** Слой совместимости обрабатывает заполнители `%{var}` изначально.
+- **Множественное число:** Строка расщепляется на `||||` и оценивается в отношении встроенного `Intl.PluralRules` в соответствии с активной локалью, отражая собственный порядок bucket Polyglot в каждой локали.
+- **Словари:** Вы обходитесь без необходимости предоставления огромных конфигураций JSON для `new Polyglot()` – Intlayer обрабатывает словари динамически и обрезает их автоматически.