@intlayer/docs 9.0.0-canary.3 → 9.0.0-canary.5

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 обрабатывает словари динамически и обрезает их автоматически.

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

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с react-i18next на Intlayer"
+description: "Узнайте, как перенести ваше приложение React с react-i18next на Intlayer, используя адаптер совместимости."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с react-i18next на Intlayer
+
+Для полного и подробного пошагового учебника см. наше полное [руководство по миграции react-i18next](../migration_from_react-i18next_to_intlayer.md).
+
+Использование адаптера совместимости Intlayer позволяет вам переместить с `react-i18next` без каких-либо изменений в импортах исходного кода.
+
+## Что делать
+
+Чтобы инициализировать проект, запустите:
+
+```bash
+npx intlayer init
+```
+
+Во время инициализации Intlayer установит `@intlayer/react-i18next` и создаст `intlayer.config.ts`. В вашем bundler (например, Vite) примените плагин Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Что происходит под капотом
+
+`reactI18nextVitePlugin` оборачивает основной плагин `vite-intlayer` и впрыскивает resolve псевдонимы для `react-i18next` и `i18next`, перенаправляя их на `@intlayer/react-i18next` и `@intlayer/i18next`.
+
+Под капотом:
+
+- **`useTranslation` & `withTranslation`:** Переписаны для использования встроенных хуков Intlayer, предоставляя вам автоматическое завершение TypeScript для ключей вашего словаря. Это безлично поддерживает пространства имён (например, `t('namespace:key')`).
+- **Множественное число и контекст:** Обрабатывает множественное число на основе суффиксов i18next (`key_one`, `key_other`), используя встроенный `Intl.PluralRules` и суффиксы контекста (`key_male`).
+- **Компонент `<Trans>`:** Переимплементирован для поддержки prop `components`, объектных и массивных форм, и нумерованных тегов `<1>...</1>`, прямо сопоставляющихся с вашими узлами React.
+- **Экземпляр `i18n`:** Разрешает ключи прямо из Intlayer без выборки больших JSON файлов, что приводит к значительно меньшим размерам bundle.

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

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с React Intl на Intlayer"
+description: "Узнайте, как перенести ваше приложение React с react-intl на Intlayer, используя адаптер совместимости."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с React Intl на Intlayer
+
+Если ваше приложение React использует `react-intl` (FormatJS), переход на Intlayer - это удача. Наш слой совместимости безпроблемно обрабатывает ICU MessageFormat и все существующие компоненты `Formatted*`.
+
+## Что делать
+
+Начните с запуска команды инициализации в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Затем установите плагин Intlayer Vite или Next.js в вашу конфигурацию. Этот плагин впрыскивает псевдонимы времени сборки для перенаправления импортов `react-intl` на `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Что происходит под капотом
+
+Плагин bundler создает псевдоним `react-intl` на `@intlayer/react-intl`. Вместо того, чтобы вручную парсить большие JSON файлы и оборачивать ваше приложение в `IntlProvider`, плагин Intlayer статически извлекает ключи и использует словари Intlayer во время выполнения.
+
+Под капотом:
+
+- **ICU MessageFormat:** Intlayer использует resolver `resolveMessage(..., 'icu')`, который полностью поддерживает множественное число ICU, выбор, форматирование дат/чисел и теги rich text изначально.
+- **Вызовы методов и JSX:** `intl.formatMessage({ id: 'a.b' })` и `<FormattedMessage id="a.b">` идентифицируются плагинами компилятора Intlayer (`@intlayer/babel` / `@intlayer/swc`), преобразуя плоские точечные ключи, чтобы первый сегмент правильно разрешал на ключ словаря Intlayer.
+- **Форматеры:** `<FormattedNumber>`, `<FormattedDate>` и т. д. переходят в встроенные `core/formatters`, используя `Intl`.