@intlayer/docs 9.4.1 → 9.4.3

package/blog/ru/i18n_testing_strategies.md

@@ -0,0 +1,179 @@
+---
+createdAt: 2026-09-02
+updatedAt: 2026-09-02
+title: "Как тестировать переводы без создания хрупких тестов"
+description: Что стоит тестировать в приложении с i18n, а что нет. Тесты рендеринга на основе провайдера, псевдолокализация, покрытие RTL и плюрализации, а также ловушка снэпшотов.
+keywords:
+  - тестирование переводов
+  - i18n тестирование
+  - testing library i18n
+  - псевдолокализация
+  - тесты провайдера локали
+  - snapshot test i18n
+slugs:
+  - blog
+  - i18n-testing-strategies
+author: aymericzip
+---
+
+# Как тестировать переводы без создания хрупких тестов
+
+Большинство наборов тестов i18n ломаются по одной из двух причин. Либо они проверяют буквальный текст, из-за чего любая смена формулировки ломает пятьдесят тестов и команда их удаляет. Либо они рендерят всё в локали по умолчанию, ничего не проверяя для остальных семнадцати языков. Оба пути ведут в одну точку, набору тестов перестают доверять.
+
+## Содержание
+
+<TOC/>
+
+## Паттерны не зависят от библиотеки
+
+Каждый приведенный ниже паттерн работает на любом стеке i18n. Замените провайдер на `I18nextProvider`, `NextIntlClientProvider` или `IntlProvider`, и тесты останутся идентичными, поскольку они проверяют отрендеренный вывод, а не API конкретной библиотеки.
+
+Инструменты проверки покрытия также переносимы: с [плагином Sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/plugins/sync-json.md), направленным на ваши каталоги, или [адаптером совместимости](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/index.md), создающим псевдонимы для ваших текущих импортов, проверка покрытия выполняется прямо по существующему JSON.
+
+## Определите, что вы на самом деле тестируете
+
+Качество перевода не проверяется тестами кода. Никакой ассерт не определит, звучит ли немецкий язык естественно, и попытка проверить это лишь заполнит тесты захардкоженными строками.
+
+Механические вещи, которые действительно стоит тестировать:
+
+| Стоит тестировать                             | Не стоит тестировать              |
+| :-------------------------------------------- | :-------------------------------- |
+| Каждая обязательная локаль имеет значение     | Красоту формулировок              |
+| Правильная локаль передается в компонент      | Точный текст каждого лейбла       |
+| Формы множественного числа для категорий      | Насколько переводчик был прилежен |
+| RTL-локали задают направление и зеркальность  | Каждую строку во всех языках      |
+| Форматированные даты и числа учитывают локаль | Внутреннюю корректность `Intl`    |
+
+Проверка покрытия должна проводиться в отдельном тесте на основе данных, а не в компонентных тестах. Это подробно описано в статье [как находить недостающие переводы](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/detecting_missing_translations.md); данный материал посвящен остальным аспектам.
+
+## Рендеринг внутри провайдера и поиск по ролям
+
+Основной паттерн состоит в том, чтобы монтировать компонент внутри провайдера локали и искать элементы по роли или test-id, а не по тексту.
+
+```tsx fileName="CartSummary.test.tsx"
+import { render, screen } from "@testing-library/react";
+import { IntlayerProvider } from "react-intlayer/client";
+import { CartSummary } from "./CartSummary";
+
+test("рендерит заголовок сводки на французском", () => {
+  render(
+    <IntlayerProvider locale="fr-FR">
+      <CartSummary />
+    </IntlayerProvider>
+  );
+
+  expect(screen.getByRole("heading")).toBeInTheDocument();
+});
+```
+
+Поиск `getByRole("heading")` устойчив к изменениям текста. `getByText("Récapitulatif")` сломается при первой же правке. Используйте точный текст только тогда, когда сама строка является объектом проверки, что бывает редко.
+
+Для таких атрибутов, как `aria-label`, вам понадобится необработанная строка, а не React-узел. В React записи `useIntlayer` предоставляют поле `.value` для этой цели.
+
+## Параметризуйте тесты по локалям
+
+Один универсальный тест, запускаемый для каждой локали, гораздо полезнее десятка отдельных тестов для каждого языка.
+
+```tsx fileName="direction.test.tsx"
+import { getHTMLTextDir } from "intlayer";
+import { render } from "@testing-library/react";
+import { IntlayerProvider } from "react-intlayer/client";
+
+describe.each(["en", "fr", "ja", "ar"])("локаль %s", (locale) => {
+  it("рендерится без отката к ключу", () => {
+    const { container } = render(
+      <IntlayerProvider locale={locale}>
+        <CartSummary />
+      </IntlayerProvider>
+    );
+
+    // Если отрендерился ключ, значит поиск не удался.
+    expect(container.textContent).not.toMatch(/^[a-z]+(\.[a-z]+)+$/);
+  });
+
+  it("устанавливает правильное направление текста", () => {
+    expect(getHTMLTextDir(locale)).toBe(locale === "ar" ? "rtl" : "ltr");
+  });
+});
+```
+
+Первая проверка дает отличный универсальный результат: если поиск значения завершился неудачей и библиотека вывела ключ, в DOM окажется строка формата `cart.summary.title`. Это отлавливает целый класс ошибок без привязки к конкретным фразам.
+
+## Псевдолокализация находит то, что скрыто от каталогов
+
+Добавьте тестовую локаль, которая видоизменяет каждую строку, например превращая `Checkout` в `[!!! Çĥéçķöũţ !!!]`. Затем отрендерите страницу на этом языке.
+
+Всё, что осталось на обычном английском, захардкожено в коде. Никакой аудит каталогов этого не заметит, так как для инструментов этой строки просто не существует. Скобки решают вторую задачу: они удлиняют текст примерно на 30 процентов, выявляя переполнения верстки еще до того, как они проявятся на немецком.
+
+Эту проверку лучше запускать в виде визуального или end-to-end прогона, а не юнит-теста, поскольку дефекты видны визуально.
+
+## Для множественных чисел нужен тест на категорию, а не на язык
+
+Ошибки плюрализации часто остаются незамеченными, потому что в английском языке всего две формы, и большинство разработчиков тестируют только их. В польском языке четыре формы, в арабском шесть.
+
+```ts fileName="plural.test.ts"
+// Арабский проверяет zero, one, two, few, many, other.
+describe.each([0, 1, 2, 3, 11, 100])("число %i", (count) => {
+  it("возвращает непустую строку на арабском", () => {
+    expect(formatItems(count, "ar")).not.toBe("");
+  });
+});
+```
+
+Выбирайте значения, попадающие во все категории CLDR для самого сложного языка, вместо того чтобы проверять только 1 и 2. `Intl.PluralRules` сообщает, в какую категорию попадает число, позволяя составить выборку без угадывания. Подробнее о категориях в [статье о формате сообщений ICU](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/icu_message_format.md).
+
+## Ловушка снэпшот-тестов (Snapshots)
+
+Снэпшоты и i18n плохо сочетаются. Снэпшот локализованного компонента фиксирует каждую строку: когда переводчик исправляет опечатку в португальском, зеленый тест становится красным в файле, который ревьюер не может объективно оценить. После нескольких ложных тревог кто-то запускает `-u` не глядя, и снэпшоты теряют всякий смысл.
+
+Если вы хотите использовать снэпшоты, делайте их только для одной локали и воспринимайте как структурную, а не контентную проверку. Всё языкозависимое должно проверяться явными ассертами.
+
+## Тестируйте согласование локали, а не только рендеринг
+
+Самая частая ошибка i18n в продакшене, не отсутствие перевода строки. Это выбор неверной локали: URL указывает на `/fr/`, клиент считывает `navigator.language`, и они конфликтуют.
+
+Тестируйте порядок разрешения напрямую как чистую функцию, отдельно от компонентов:
+
+```ts fileName="locale-resolution.test.ts"
+it("отдает приоритет URL перед сохраненными настройками", () => {
+  expect(resolveLocale({ url: "/fr/about", stored: "de", header: "ja" })).toBe(
+    "fr"
+  );
+});
+
+it("откатывается к заголовку, когда в URL нет префикса", () => {
+  expect(resolveLocale({ url: "/about", stored: null, header: "ja" })).toBe(
+    "ja"
+  );
+});
+```
+
+Это самый ценный i18n-тест, которого не хватает большинству проектов, и ему не требуется DOM.
+
+## Что и где запускать
+
+- **Unit**: согласование локалей, форматтеры, категории множественного числа. Быстро, без DOM.
+- **Component**: один рендеринг с провайдером на локаль с проверкой ролей и отсутствия сырых ключей.
+- **Coverage**: проверка на основе данных, гарантирующая отсутствие пропусков в обязательных локалях.
+- **Visual или E2E**: прогон псевдолокализации и страницы с RTL, так как эти проблемы визуальные.
+
+Первые три запускайте в пайплайне на каждый коммит. Последний экономичнее запускать в ночных сборках.
+
+## Распространенные ошибки
+
+- **Проверка точного текста во всех тестах.** Гарантирует удаление набора тестов через пару месяцев.
+- **Снэпшоты локализованных компонентов.** Переводчики ломают билд, а ревьюеры одобряют изменения вслепую.
+- **Тестирование только локали по умолчанию.** Единственная локаль, в которой перевод гарантированно есть.
+- **Тестирование только 1 и 2 для множественного числа.** Пропускает категории, отсутствующие в английском.
+- **Мокирование библиотеки i18n.** В итоге вы тестируете лишь то, что ваш мок возвращает строки.
+- **Игнорирование тестов согласования.** Самый частый сбой в продакшене и самый легкий для проверки.
+
+## Полезные материалы
+
+- [Тестирование контента: аудит CLI, программный API и UI-ассерты](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/testing.md)
+- [Плагин ESLint: поиск захардкоженных строк и неиспользуемого контента](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/eslint.md)
+- [Форматтеры и утилиты локалей, включая `getHTMLTextDir`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/formatters.md)
+- [Отчеты производительности между различными фреймворками](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/benchmark/index.md)
+- [Адаптер совместимости react-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/compat/react-i18next.md)
+- [Как находить недостающие переводы](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/detecting_missing_translations.md)
+- [Формат сообщений ICU: множественные числа, выбор и скелетоны](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/icu_message_format.md)

package/blog/ru/intlayer_with_i18next.md

@@ -74,15 +74,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/blog/ru/intlayer_with_next-i18next.md

@@ -67,15 +67,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/blog/ru/intlayer_with_next-intl.md

@@ -68,15 +68,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/blog/ru/intlayer_with_react-i18next.md

@@ -68,15 +68,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/blog/ru/intlayer_with_react-intl.md

@@ -66,15 +66,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/blog/ru/intlayer_with_vue-i18n.md

@@ -68,15 +68,15 @@ npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer@canary init --interactive
+pnpm dlx intlayer init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer@canary init --interactive
+yarn dlx intlayer init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer@canary init --interactive
+bunx intlayer init --interactive
 ```
 
 > флаг `--interactive` не является обязательным. Используйте `intlayer-cli init`, если вы являетесь ИИ-агентом.

package/blog/ru/is_i18next_outdated.md

@@ -0,0 +1,315 @@
+---
+createdAt: 2026-09-02
+updatedAt: 2026-09-02
+title: Устарел ли i18next в 2026 году?
+description: i18next используется на миллионах сайтов, но его runtime-архитектура 2011 года устаревает. Анализ раздувания бандла, ограничений tree-shaking и замедления инноваций.
+keywords:
+  - i18next
+  - react-i18next
+  - next-i18next
+  - Intlayer
+  - Интернационализация
+  - i18n
+  - Размер бандла
+  - Блог
+slugs:
+  - blog
+  - is-i18next-outdated
+author: aymericzip
+---
+
+# Устарел ли i18next в 2026 году?
+
+`i18next` появился в 2011 году, задолго до того, как компоненты React, сборка через Webpack или TypeScript стали общепринятым стандартом. Он завоевал экосистему благодаря гибкости и повсеместности, получив плагины под любой стек и ответы на StackOverflow на каждый вопрос.
+
+Проект не заброшен, обновления и патчи выходят регулярно. Однако есть существенная разница между поддержанием работоспособности старого движка и активной адаптацией к современным архитектурам фронтенда.
+
+За последние годы фронтенд перешел к компиляции на этапе сборки, React Server Components (RSC), агрессивному tree-shaking и процессам на базе ИИ. Ядро i18next остается тем же, что и десять лет назад: синглтон времени выполнения, сопоставляющий строковые ключи на стороне клиента.
+
+<TOC/>
+
+## Главные выводы
+
+**Режим поддержки:**
+
+За прошедший год `next-i18next` получил ~63 коммита (примерно один в неделю), а `react-i18next` ~157, в основном для обновления зависимостей и мелких правок.
+
+**Ощутимый runtime-оверхед:**
+
+`react-i18next` и `next-i18next` добавляют ~17–18 КБ gzipped (~60 КБ minified) еще до рендеринга первого переведенного слова, что почти в 4 раза тяжелее `next-intlayer` (~4.7 КБ).
+
+**Серьезная утечка данных:**
+
+При стандартных статических конфигурациях до **89.8%** объема переводов, передаваемых на страницу, относится к другим маршрутам или неиспользуемым языкам.
+
+**Невозможность tree-shaking:**
+
+Динамические вызовы вроде `t("home.hero.title")` не поддаются статическому анализу бандлеров, вынуждая включать полные JSON-файлы в клиентский бандл.
+
+**Коммерческие приоритеты:**
+
+Создатели развивают Locize. Интеграция бесплатного локального ИИ-перевода напрямую в CLI напрямую конкурировала бы с их основным источником дохода.
+
+## Поддержка vs. активная эволюция
+
+Количество звезд на GitHub отражает историческую популярность, а не актуальность архитектуры.
+
+| Репозиторий             | Звезды                                                                                                                                                     | Всего коммитов                                                                                                                                                          | Коммитов / год                                                                                                                                                         | Последний коммит                                                                                                                                 |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `i18next/i18next`       | [![stars](https://img.shields.io/github/stars/i18next/i18next?style=for-the-badge&label=stars)](https://github.com/i18next/i18next/stargazers)             | [![commits](https://img.shields.io/github/commit-activity/t/i18next/i18next?style=for-the-badge&label=commits)](https://github.com/i18next/i18next/commits)             | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/i18next/commits)             | [![last](https://img.shields.io/github/last-commit/i18next/i18next?style=for-the-badge)](https://github.com/i18next/i18next/commits)             |
+| `i18next/react-i18next` | [![stars](https://img.shields.io/github/stars/i18next/react-i18next?style=for-the-badge&label=stars)](https://github.com/i18next/react-i18next/stargazers) | [![commits](https://img.shields.io/github/commit-activity/t/i18next/react-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/react-i18next/commits) | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/react-i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/react-i18next/commits) | [![last](https://img.shields.io/github/last-commit/i18next/react-i18next?style=for-the-badge)](https://github.com/i18next/react-i18next/commits) |
+| `i18next/next-i18next`  | [![stars](https://img.shields.io/github/stars/i18next/next-i18next?style=for-the-badge&label=stars)](https://github.com/i18next/next-i18next/stargazers)   | [![commits](https://img.shields.io/github/commit-activity/t/i18next/next-i18next?style=for-the-badge&label=commits)](https://github.com/i18next/next-i18next/commits)   | [![yearly](https://img.shields.io/github/commit-activity/y/i18next/next-i18next?style=for-the-badge&label=%2Fyear)](https://github.com/i18next/next-i18next/commits)   | [![last](https://img.shields.io/github/last-commit/i18next/next-i18next?style=for-the-badge)](https://github.com/i18next/next-i18next/commits)   |
+| `aymericzip/intlayer`   | [![stars](https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&label=stars)](https://github.com/aymericzip/intlayer/stargazers)     | [![commits](https://img.shields.io/github/commit-activity/t/aymericzip/intlayer?style=for-the-badge&label=commits)](https://github.com/aymericzip/intlayer/commits)     | [![yearly](https://img.shields.io/github/commit-activity/y/aymericzip/intlayer?style=for-the-badge&label=%2Fyear)](https://github.com/aymericzip/intlayer/commits)     | [![last](https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge)](https://github.com/aymericzip/intlayer/commits)     |
+
+Активность за прошедшие 12 месяцев:
+
+| Проект          | Коммитов за все время | За 12 месяцев | Направление                             |
+| --------------- | --------------------- | ------------- | --------------------------------------- |
+| `next-i18next`  | 1 311                 | **63**        | Поддержка Next.js и патчи               |
+| `react-i18next` | 1 988                 | **157**       | Типизация и исправления                 |
+| `i18next` core  | 2 626                 | **259**       | Небольшие патчи                         |
+| Intlayer        | 7 156                 | **4 343**     | Компилятор, инструменты IDE и движок ИИ |
+
+[![Star History Chart](https://api.star-history.com/chart?repos=i18next%2Fi18next%2Ci18next%2Freact-i18next%2Ci18next%2Fnext-i18next%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#i18next/i18next&i18next/react-i18next&i18next/next-i18next&aymericzip/intlayer)
+
+Компактная библиотека может быть стабильной, но инструменты локализации не стоят на месте: сборщики удаляют неиспользуемый контент во время сборки, языковые модели переводят прямо в CI, а среды разработки используют Language Server (LSP) и ИИ-агентов. Ограниченная временем выполнения архитектура i18next затрудняет внедрение этих инноваций.
+
+## Оценка влияния на бандл
+
+<I18nBenchmark framework="tanstack" vertical/>
+
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-tanstack.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
+
+> Измерения в production-сборке на 10 маршрутах и 10 языках со сжатием gzip. Подробности в [отчете о бенчмарке i18n](https://intlayer.org/ru/doc/benchmark).
+
+### Базовый оверхед библиотек
+
+Размер до добавления переведенного текста:
+
+| Библиотека             | Gzipped    | Minified    |
+| ---------------------- | ---------- | ----------- |
+| `next-i18next@16.0.5`  | 17.8 КБ    | 61.2 КБ     |
+| `react-i18next@17.0.2` | 17.3 КБ    | 59.8 КБ     |
+| `intlayer@8.7.12`      | **4.7 КБ** | **12.8 КБ** |
+
+### Вес страницы и утечка контента
+
+Тестирование на React / TanStack Start (статическая стратегия):
+
+| Библиотека            | Ср. JS / стр. (gz) | Утечка языков | Утечка др. страниц | Ср. компонент (gz) | Гидратация  |
+| --------------------- | ------------------ | ------------- | ------------------ | ------------------ | ----------- |
+| `react-i18next`       | 180.3 КБ           | **50.0%**     | **89.8%**          | 24.3 КБ            | 85.1 мс     |
+| Intlayer              | **127.8 КБ**       | 50.0%         | **0.8%**           | **7.1 КБ**         | **24.1 мс** |
+| Intlayer (scoped dyn) | **118.1 КБ**       | **0.0%**      | **0.8%**           | **4.6 КБ**         | 23.7 мс     |
+
+В Next.js:
+
+| Библиотека      | Ср. JS / стр. (gz) | Утечка др. страниц | Ср. компонент (gz) |
+| --------------- | ------------------ | ------------------ | ------------------ |
+| База (без i18n) | 150.8 КБ           | 0.0%               | 0.7 КБ             |
+| `next-i18next`  | **227.5 КБ**       | **89.8%**          | 24.5 КБ            |
+| `next-intlayer` | **152.1 КБ**       | **0.0%**           | **7.2 КБ**         |
+
+### Ключевые результаты
+
+**Вес страниц:**
+
+В Next.js `next-i18next` добавляет **76.7 КБ gzipped** к базовому приложению (+50%). `next-intlayer` добавляет лишь 1.3 КБ.
+
+**Утечка переводов:**
+
+По умолчанию почти **90% текста**, отправляемого на страницу, относится к другим маршрутам. Ручное разделение на неймспейсы сложно поддерживать без ошибок.
+
+**Задержка гидратации:**
+
+Компоненты с `react-i18next` гидратировались **85 мс** против **24 мс** у Intlayer. Передача объемных структур JSON клиенту замедляет взаимодействие.
+
+## Почему i18next тяжелый?
+
+### Накопление функций в runtime
+
+Работа исключительно в браузере требует загрузки всех механизмов сразу: интерполяции, правил множественного числа, контекстов, форматирования и шины событий. Даже базовый вывод строки оплачивает полный движок.
+
+### Динамические ключи исключают tree-shaking
+
+Так как `"hero.title"` вычисляется динамически во время выполнения, бандлеры не могут определить, какие ключи задействованы. Неиспользуемые строки неизбежно остаются в бандле.
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="i18next" value="i18next">
+
+```tsx fileName="Component.tsx"
+const { t } = useTranslation("home");
+
+return <h1>{t("hero.title")}</h1>;
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```tsx fileName="Hero.tsx"
+const { title } = useIntlayer("hero");
+
+return <h1>{title}</h1>;
+```
+
+  </Tab>
+</Tabs>
+
+[Компилятор Intlayer](https://intlayer.org/ru/doc/compiler) проверяет реальное использование полей в `Hero.tsx` и исключает лишние данные до создания клиентских бандлов. Подробнее в разделе [оптимизация бандла](https://intlayer.org/ru/doc/concept/bundle-optimization).
+
+## Опыт разработки
+
+### Разрозненный JSON против ко-локации
+
+В i18next переводы изолированы в отдельных директориях JSON вдалеке от компонентов. Intlayer размещает файлы контента рядом с компонентами:
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="i18next" value="i18next">
+
+```json fileName="locales/en/hero.json"
+{
+  "title": "Ship in every language"
+}
+```
+
+```json fileName="locales/ru/hero.json"
+{
+  "title": "Запускайте на любом языке"
+}
+```
+
+```tsx fileName="Hero.tsx"
+import { useTranslation } from "react-i18next";
+
+export const Hero = () => {
+  const { t } = useTranslation("hero");
+  return <h1>{t("title")}</h1>;
+};
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero",
+  content: {
+    title: t({
+      en: "Ship in every language",
+      ru: "Запускайте на любом языке",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+```tsx fileName="Hero.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const Hero = () => {
+  const { title } = useIntlayer("hero");
+  return <h1>{title}</h1>;
+};
+```
+
+  </Tab>
+</Tabs>
+
+При переносе или удалении `Hero.tsx` его переводы перемещаются или удаляются вместе с ним.
+
+### Автодополнение против строгой безопасности типов
+
+Расширение `CustomTypeOptions` дает подсказки в IDE, но не проверяет наличие реального перевода. Удаление ключа из `ru/home.json` не остановит сборку, а лишь вызовет runtime-фоллбэк.
+
+Intlayer создает типы на основе объявлений контента, а режим [`strictMode`](https://intlayer.org/ru/doc/concept/configuration) превращает отсутствующие переводы в строгие ошибки сборки.
+
+### Сравнение экосистемы
+
+| Возможность                 | Экосистема i18next | Intlayer                                                                   |
+| --------------------------- | ------------------ | -------------------------------------------------------------------------- |
+| **Расширение VS Code**      | Только стороннее   | ✅ [Официальное расширение](https://intlayer.org/ru/doc/vs-code-extension) |
+| **Language Server (LSP)**   | ❌ Нет             | ✅ [Выделенный LSP](https://intlayer.org/ru/doc/lsp)                       |
+| **MCP Server (для ИИ)**     | ❌ Нет             | ✅ [Встроенный MCP-сервер](https://intlayer.org/ru/doc/mcp-server)         |
+| **Навыки агентов (Skills)** | ❌ Нет             | ✅ [Готовые навыки](https://intlayer.org/ru/doc/agent_skills)              |
+| **Визуальная CMS**          | Locize (Платно)    | ✅ [Бесплатно и Open Source](https://intlayer.org/ru/doc/concept/editor)   |
+
+## Модель переводов и подход Locize
+
+Locize является коммерческим сервисом от создателей i18next. Устойчивость открытого кода важна, но такая модель создает конфликт целей: сервис, зарабатывающий на платной платформе переводов, не заинтересован во внедрении бесплатного локального ИИ-перевода прямо в CLI.
+
+Intlayer предлагает открытое решение:
+
+- [`intlayer fill`](https://intlayer.org/ru/doc/concept/auto-fill) дополняет недостающие переводы в консоли или CI с помощью ваших собственных ключей OpenAI, Anthropic, Mistral или Gemini.
+- [Intlayer CMS](https://intlayer.org/ru/doc/concept/cms) имеет открытый исходный код и запускается локально через Docker Compose.
+- Компилятор, CLI, редактор и CMS распространяются под лицензией Apache 2.0.
+
+## Когда i18next по-прежнему актуален?
+
+<AccordionGroup>
+<Accordion header="Стабильные работающие проекты">
+
+Если приложение работает надежно, а размер бандла не является узким местом, срочной необходимости в переписывании нет.
+
+</Accordion>
+<Accordion header="Нестандартные среды">
+
+Обширная коллекция плагинов i18next охватывает платформы (Electron, старый стек на jQuery, кастомные нативные мосты), которые современные компиляторы редко поддерживают напрямую.
+
+</Accordion>
+<Accordion header="Накопленная база решений">
+
+Многолетний архив вопросов на StackOverflow и GitHub помогает быстро разбирать редкие проблемы.
+
+</Accordion>
+</AccordionGroup>
+
+## Как улучшить текущую конфигурацию i18next?
+
+Intlayer предлагает готовые пакеты совместимости, полностью повторяющие сигнатуры функций библиотек i18next (`i18next`, `react-i18next` и `next-i18next`). Вам не нужно переписывать компоненты, чтобы получить преимущества современной архитектуры на базе компилятора.
+
+Настройка выполняется одной командой:
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer init --interactive
+```
+
+Интерактивный интерфейс командной строки:
+
+1. Устанавливает пакет совместимости `@intlayer/i18next`.
+2. Настраивает алиасы сборщика, чтобы привычные импорты (`useTranslation`, `Trans`, `t`) прозрачно ссылались на Intlayer, позволяя удалить старую библиотеку из `package.json`.
+3. Сразу подключает поддержку языкового сервера (LSP) в редакторе, оптимизацию бандла на этапе сборки (полный tree-shaking) и локальные инструменты перевода с помощью ИИ.
+
+Подробные инструкции можно найти в наших руководствах:
+
+- **Слои совместимости:** Сохраняйте существующий синтаксис с адаптерами для [i18next](https://intlayer.org/ru/doc/compatibility/i18next), [react-i18next](https://intlayer.org/ru/doc/compatibility/react-i18next) и [next-i18next](https://intlayer.org/ru/doc/compatibility/next-i18next).
+- **Миграция каталогов:** Конвертируйте JSON-файлы в строго типизированные словари: [с i18next](https://intlayer.org/ru/doc/migration/i18next), [с react-i18next](https://intlayer.org/ru/doc/migration/react-i18next) или [с next-i18next](https://intlayer.org/ru/doc/migration/next-i18next).
+- **Гибридная архитектура:** Оставьте движок i18next в работе, [подключив Intlayer](https://intlayer.org/ru/blog/intlayer-with-i18next) для типизации и автоматического перевода каталогов.
+
+Проверьте ваш сайт на вес и утечки с помощью бесплатного [SEO-сканера i18n](https://intlayer.org/i18n-seo-scanner):
+
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Рекомендуемые материалы
+
+- [Бенчмарк Next.js i18n: детальный анализ производительности](https://intlayer.org/ru/doc/benchmark/nextjs)
+- [react-i18next против react-intl и Intlayer](https://intlayer.org/ru/blog/react-i18next-vs-react-intl-vs-intlayer)
+- [Устарел ли next-intl в 2026 году?](https://intlayer.org/ru/blog/is-next-intl-outdated)
+- [Компиляция против декларативной i18n](https://intlayer.org/ru/blog/compiler-vs-declarative-i18n)