@intlayer/docs 5.7.8 → 5.8.0-canary.0

package/docs/ru/formatters.md

@@ -0,0 +1,239 @@
+---
+createdAt: 2024-08-13
+updatedAt: 2025-08-20
+title: Форматтеры
+description: Утилиты для форматирования с учетом локали на основе Intl для чисел, процентов, валюты, дат, относительного времени, единиц измерения и компактной записи. Включает кешированный помощник Intl.
+keywords:
+  - Форматтеры
+  - Intl
+  - Число
+  - Валюта
+  - Процент
+  - Дата
+  - Относительное время
+  - Единицы измерения
+  - Компактный формат
+  - Интернационализация
+slugs:
+  - doc
+  - formatters
+---
+
+# Форматтеры Intlayer
+
+## Обзор
+
+Intlayer предоставляет набор легковесных помощников, построенных поверх нативных API `Intl`, а также кешированный обертку `Intl`, чтобы избежать повторного создания тяжелых форматтеров. Эти утилиты полностью учитывают локаль и могут использоваться из основного пакета `intlayer`.
+
+### Импорт
+
+```ts
+import {
+  Intl,
+  number,
+  percentage,
+  currency,
+  date,
+  relativeTime,
+  units,
+  compact,
+} from "intlayer";
+```
+
+Если вы используете React, хуки также доступны; смотрите `react-intlayer/format`.
+
+## Кешированный Intl
+
+Экспортируемый `Intl` — это тонкая кешированная обертка вокруг глобального `Intl`. Она мемоизирует экземпляры `NumberFormat`, `DateTimeFormat`, `RelativeTimeFormat`, что позволяет избежать повторного создания одного и того же форматтера.
+
+Поскольку создание форматтера относительно дорогостоящее, такое кеширование улучшает производительность без изменения поведения. Обертка предоставляет тот же API, что и нативный `Intl`, поэтому использование идентично.
+
+- Кеширование происходит на уровне процесса и прозрачно для вызывающих.
+
+> Если `Intl.DisplayNames` недоступен в среде, выводится одно предупреждение только для разработчиков (рекомендуется использовать полифилл).
+
+Пример:
+
+```ts
+import { Intl } from "intlayer";
+
+const numberFormat = new Intl.NumberFormat("en-GB", {
+  style: "currency",
+  currency: "GBP",
+});
+numberFormat.format(1234.5); // "£1,234.50"
+```
+
+## Форматтеры
+
+Все приведённые ниже помощники экспортируются из `intlayer`.
+
+### `number(value, options?)`
+
+Форматирует числовое значение с учётом локальных правил группировки и десятичных знаков.
+
+- **value**: `number | string`
+- **options**: `Intl.NumberFormatOptions & { locale?: LocalesValues }`
+
+Примеры:
+
+```ts
+import { number } from "intlayer";
+
+number(123456.789); // "123,456.789" (в en-US)
+number("1000000", { locale: "fr" }); // "1 000 000"
+number(1234.5, { minimumFractionDigits: 2 }); // "1,234.50"
+```
+
+### `percentage(value, options?)`
+
+Форматирует число в строку с процентами.
+
+Поведение: значения больше 1 интерпретируются как целые проценты и нормализуются (например, `25` → `25%`, `0.25` → `25%`).
+
+- **value**: `number | string`
+- **options**: `Intl.NumberFormatOptions & { locale?: LocalesValues }`
+
+Примеры:
+
+```ts
+import { percentage } from "intlayer";
+
+percentage(0.25); // "25%"
+percentage(25); // "25%"
+percentage(0.237, { minimumFractionDigits: 1 }); // "23.7%"
+```
+
+### `currency(value, options?)`
+
+Форматирует значение как локализованную валюту. По умолчанию используется `USD` с двумя десятичными знаками.
+
+- **value**: `number | string`
+- **options**: `Intl.NumberFormatOptions & { locale?: LocalesValues }`
+  - Общие поля: `currency` (например, `"EUR"`), `currencyDisplay` (`"symbol" | "code" | "name"`)
+
+Примеры:
+
+```ts
+import { currency } from "intlayer";
+
+currency(1234.5, { currency: "EUR" }); // "€1,234.50"
+currency("5000", { locale: "fr", currency: "CAD", currencyDisplay: "code" }); // "5 000,00 CAD"
+```
+
+### `date(date, optionsOrPreset?)`
+
+Форматирует значение даты/времени с помощью `Intl.DateTimeFormat`.
+
+- **date**: `Date | string | number`
+- **optionsOrPreset**: `Intl.DateTimeFormatOptions & { locale?: LocalesValues }` или один из предустановленных вариантов:
+  - Предустановки: `"short" | "long" | "dateOnly" | "timeOnly" | "full"`
+
+Примеры:
+
+```ts
+import { date } from "intlayer";
+
+date(new Date(), "short"); // например, "08/02/25, 14:30"
+date("2025-08-02T14:30:00Z", { locale: "fr", month: "long", day: "numeric" }); // "2 août"
+```
+
+### `relativeTime(from, to = new Date(), options?)`
+
+Форматирует относительное время между двумя моментами с помощью `Intl.RelativeTimeFormat`.
+
+- Передайте "now" в качестве первого аргумента, а целевое время — вторым, чтобы получить естественную формулировку.
+- **from**: `Date | string | number`
+- **to**: `Date | string | number` (по умолчанию `new Date()`)
+- **options**: `{ locale?: LocalesValues; unit?: Intl.RelativeTimeFormatUnit; numeric?: Intl.RelativeTimeFormatNumeric; style?: Intl.RelativeTimeFormatStyle }`
+  - По умолчанию `unit` — `"second"`.
+
+Примеры:
+
+```ts
+import { relativeTime } from "intlayer";
+
+const now = new Date();
+const in3Days = new Date(now.getTime() + 3 * 864e5);
+relativeTime(now, in3Days, { unit: "day" }); // "через 3 дня"
+
+const twoHoursAgo = new Date(now.getTime() - 2 * 3600e3);
+relativeTime(now, twoHoursAgo, { unit: "hour", numeric: "auto" }); // "2 часа назад"
+```
+
+### `units(value, options?)`
+
+Форматирует числовое значение как локализованную строку с единицей измерения, используя `Intl.NumberFormat` с `style: 'unit'`.
+
+- **value**: `number | string`
+- **options**: `Intl.NumberFormatOptions & { locale?: LocalesValues }`
+  - Общие поля: `unit` (например, `"kilometer"`, `"byte"`), `unitDisplay` (`"short" | "narrow" | "long"`)
+  - Значения по умолчанию: `unit: 'day'`, `unitDisplay: 'short'`, `useGrouping: false`
+
+Примеры:
+
+```ts
+import { units } from "intlayer";
+
+units(5, { unit: "kilometer", unitDisplay: "long", locale: "en-GB" }); // "5 kilometers"
+units(1024, { unit: "byte", unitDisplay: "narrow" }); // "1,024B" (зависит от локали)
+```
+
+### `compact(value, options?)`
+
+Форматирует число, используя компактную нотацию (например, `1.2K`, `1M`).
+
+- **value**: `number | string`
+- **options**: `Intl.NumberFormatOptions & { locale?: LocalesValues }` (использует `notation: 'compact'` под капотом)
+
+Примеры:
+
+```ts
+import { compact } from "intlayer";
+
+compact(1200); // "1.2K"
+compact("1000000", { locale: "fr", compactDisplay: "long" }); // "1 миллион"
+```
+
+## Примечания
+
+- Все вспомогательные функции принимают входные данные в виде `string`; они внутренне приводятся к числам или датам.
+- Локаль по умолчанию берется из вашей настройки `internationalization.defaultLocale`, если не указана явно.
+- Эти утилиты являются тонкими обертками; для расширенного форматирования используйте стандартные опции `Intl`.
+
+## Точки входа и реэкспорты (`@index.ts`)
+
+Форматтеры находятся в основном пакете и реэкспортируются из пакетов более высокого уровня для удобства импорта в разных средах выполнения:
+
+Примеры:
+
+```ts
+// Код приложения (рекомендуется)
+import { number, currency, date, Intl } from "intlayer";
+```
+
+### React
+
+Клиентские компоненты:
+
+```ts
+import { useNumber, useCurrency, useDate } from "react-intlayer/format";
+// или в приложениях Next.js
+import { useNumber, useCurrency, useDate } from "next-intlayer/client/format";
+```
+
+Серверные компоненты (или React Server runtime):
+
+```ts
+import { useNumber, useCurrency, useDate } from "intlayer/server/format";
+// или в приложениях Next.js
+import { useNumber, useCurrency, useDate } from "next-intlayer/server/format";
+```
+
+> Эти хуки будут учитывать локаль из `IntlayerProvider` или `IntlayerServerProvider`
+
+## История документации
+
+| Версия | Дата       | Изменения                             |
+| ------ | ---------- | ------------------------------------- |
+| 5.8.0  | 2025-08-18 | Добавлена документация по форматтерам |

package/docs/ru/interest_of_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2025-06-29
+updatedAt: 2025-08-20
 title: Преимущества Intlayer
 description: Узнайте о преимуществах и достоинствах использования Intlayer в ваших проектах. Поймите, почему Intlayer выделяется среди других фреймворков.
 keywords:
@@ -11,58 +11,122 @@ keywords:
   - Сравнение
 slugs:
   - doc
-  - concept
-  - interest
+  - why
 ---
 
-# Intlayer: Индивидуальный способ перевода вашего сайта
+# Почему стоит рассмотреть Intlayer?
 
-**Intlayer** — это библиотека интернационализации, разработанная специально для разработчиков на JavaScript. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, **Intlayer** делает вашу разработку более надежной и эффективной.
+## Что такое Intlayer?
 
-## Пример использования
+**Intlayer** — это библиотека интернационализации, разработанная специально для JavaScript-разработчиков. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, **Intlayer** делает вашу разработку более надежной и эффективной.
+
+## Почему был создан Intlayer?
+
+Intlayer был создан для решения общей проблемы, которая затрагивает все популярные библиотеки i18n, такие как `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl` и `vue-i18n`.
+
+Все эти решения используют централизованный подход для перечисления и управления вашим контентом. Например:
+
+```bash
+.
+├── locales
+│   ├── en.json
+│   ├── fr.json
+│   └── es.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+Или здесь с использованием пространств имён:
+
+```bash
+.
+├── locales
+│   ├── en
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   ├── fr
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   └── es
+│      ├── footer.json
+│      └── navbar.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+Такой тип архитектуры замедляет процесс разработки и усложняет поддержку кода по нескольким причинам:
+
+1. **Для каждого нового созданного компонента необходимо:**
+   - Создать новый ресурс/пространство имён в папке `locales`
+   - Не забыть импортировать новое пространство имён на вашей странице
+   - Перевести ваш контент (часто выполняется вручную путём копирования/вставки из AI-сервисов)
+
+2. **Для любых изменений в ваших компонентах необходимо:**
+   - Найти соответствующий ресурс/пространство имён (которое находится далеко от компонента)
+   - Перевести ваш контент
+   - Убедиться, что ваш контент актуален для всех локалей
+   - Проверить, что в вашем пространстве имён нет неиспользуемых ключей/значений
+   - Убедиться, что структура ваших JSON-файлов одинакова для всех локалей
+
+В профессиональных проектах, использующих эти решения, часто применяются платформы локализации для управления переводом вашего контента. Однако для крупных проектов это может быстро стать дорогостоящим.
+
+Для решения этой проблемы Intlayer использует подход, при котором контент ограничивается областью компонента и хранится рядом с вашим компонентом, как это часто делается с CSS (`styled-components`), типами, документацией (`storybook`) или модульными тестами (`jest`).
 
 ```bash codeFormat="typescript"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.ts
+        ├── index.test.tsx
+        ├── index.stories.tsx
         └── index.tsx
 ```
 
 ```bash codeFormat="commonjs"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.cjs
-        └── index.mjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
 ```
 
 ```bash codeFormat="esm"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.mjs
-        └── index.js
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
 ```
 
-```tsx fileName="./Components/MyComponent/index.content.ts" codeFormat="typescript"
+```tsx fileName="./components/MyComponent/index.content.ts" codeFormat="typescript"
 import { t, type Dictionary } from "intlayer";
 
 const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
-      en: "Hello World", // английский
-      fr: "Bonjour le monde", // французский
-      es: "Hola Mundo", // испанский
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 } satisfies Dictionary;
 
+// Экспортируем контент компонента по умолчанию
 export default componentExampleContent;
 ```
 
-```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+```jsx fileName="./components/MyComponent/index.mjx" codeFormat="esm"
 import { t } from "intlayer";
 
 /** @type {import('intlayer').Dictionary} */
@@ -70,9 +134,9 @@ const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
-      en: "Hello World", // английский
-      fr: "Bonjour le monde", // французский
-      es: "Hola Mundo", // испанский
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -80,25 +144,27 @@ const componentExampleContent = {
 export default componentExampleContent;
 ```
 
-```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+```jsx fileName="./components/MyComponent/index.csx" codeFormat="commonjs"
 const { t } = require("intlayer");
 
 /** @type {import('intlayer').Dictionary} */
+// Определение контента компонента с переводами
 const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
-      en: "Hello World", // английский
-      fr: "Bonjour le monde", // французский
-      es: "Hola Mundo", // испанский
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
 
+// Экспортируем контент компонента для CommonJS
 module.exports = componentExampleContent;
 ```
 
-```tsx fileName="./Components/MyComponent/index.tsx" codeFormat="typescript"
+```tsx fileName="./components/MyComponent/index.tsx" codeFormat="typescript"
 import { useIntlayer } from "react-intlayer";
 
 export const ComponentExample = () => {
@@ -108,7 +174,7 @@ export const ComponentExample = () => {
 };
 ```
 
-```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+```jsx fileName="./components/MyComponent/index.mjx" codeFormat="esm"
 import { useIntlayer } from "react-intlayer";
 
 const ComponentExample = () => {
@@ -118,7 +184,7 @@ const ComponentExample = () => {
 };
 ```
 
-```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+```jsx fileName="./components/MyComponent/index.csx" codeFormat="commonjs"
 const { useIntlayer } = require("react-intlayer");
 
 const ComponentExample = () => {
@@ -128,27 +194,79 @@ const ComponentExample = () => {
 };
 ```
 
-## Почему стоит выбрать Intlayer?
-
-| Особенность                                 | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Управление контентом на базе JavaScript** | Используйте гибкость JavaScript для эффективного определения и управления вашим контентом.                                                                                                                                                                                                                                                                                                                                                                                 |
-| **Типобезопасная среда**                    | Используйте TypeScript, чтобы гарантировать точность и отсутствие ошибок во всех ваших определениях контента.                                                                                                                                                                                                                                                                                                                                                              |
-| **Интегрированные файлы контента**          | Держите ваши переводы рядом с соответствующими компонентами, что повышает удобство поддержки и ясность.                                                                                                                                                                                                                                                                                                                                                                    |
-| **Упрощённая настройка**                    | Быстрый запуск с минимальной конфигурацией, особенно оптимизирован для проектов на Next.js.                                                                                                                                                                                                                                                                                                                                                                                |
-| **Поддержка серверных компонентов**         | Идеально подходит для серверных компонентов Next.js, обеспечивая плавный рендеринг на стороне сервера.                                                                                                                                                                                                                                                                                                                                                                     |
-| **Расширенная маршрутизация**               | Полная поддержка маршрутизации приложений Next.js, плавно адаптирующаяся к сложным структурам приложений.                                                                                                                                                                                                                                                                                                                                                                  |
-| **Организованная кодовая база**             | Поддерживайте вашу кодовую базу более организованной: 1 компонент = 1 словарь в той же папке.                                                                                                                                                                                                                                                                                                                                                                              |
-| **Автоматический перевод в CI**             | Автоматически заполняйте ваши переводы в CI, используя собственный API-ключ OpenAI, исключая необходимость в платформе локализации (L10n).                                                                                                                                                                                                                                                                                                                                 |
-| **Интеграция MCP сервера**                  | Обеспечивает MCP (Model Context Protocol) сервер для автоматизации IDE, позволяя бесшовно управлять контентом и рабочими процессами интернационализации (i18n) непосредственно в вашей среде разработки. [Узнать больше](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md).                                                                                                                                                                     |
-| **Поддержка Markdown**                      | Импорт и интерпретация файлов markdown для многоязычного контента, такого как политики конфиденциальности.                                                                                                                                                                                                                                                                                                                                                                 |
-| **Бесплатный визуальный редактор и CMS**    | Бесплатный визуальный редактор и CMS доступны, если вам нужно работать с авторами контента для ваших переводов, что вновь устраняет необходимость в платформе локализации и позволяет вынести контент за пределы кодовой базы.                                                                                                                                                                                                                                             |
-| **Упрощённый доступ к контенту**            | Нет необходимости вызывать функцию `t` для каждого элемента контента; получите весь ваш контент напрямую, используя один хук.                                                                                                                                                                                                                                                                                                                                              |
-| **Последовательная реализация**             | Одинаковая реализация как для клиентских, так и для серверных компонентов, нет необходимости передавать функцию `t` через каждый серверный компонент.                                                                                                                                                                                                                                                                                                                      |
-| **Контент с возможностью tree-shaking**     | Контент поддерживает tree-shaking, что уменьшает размер итогового бандла.                                                                                                                                                                                                                                                                                                                                                                                                  |
-| **Неблокирующий статический рендеринг**     | Intlayer не блокирует статический рендеринг, в отличие от `next-intl`.                                                                                                                                                                                                                                                                                                                                                                                                     |
-| **Взаимодействие**                          | Обеспечивает взаимодействие с [react-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react-i18next.md), [next-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_next-i18next.md), [next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_next-intl.md) и [react-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_with_react-intl.md). |
-
-## История документации
-
-- 5.5.10 - 2025-06-29: Инициализация истории
+Этот подход позволяет вам:
+
+1. **Увеличить скорость разработки**
+   - Файлы `.content.{{ts|mjs|cjs|json}}` можно создавать с помощью расширения для VSCode
+   - Инструменты автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot) могут помочь вам объявлять ваш контент, уменьшая необходимость копирования/вставки
+
+2. **Снизить сложность вашей кодовой базы**
+
+3. **Повысить поддерживаемость вашей кодовой базы**
+
+4. **Проще дублировать ваши компоненты и связанный с ними контент (например: компоненты входа/регистрации и т.д.)**
+   - Ограничивая риск влияния на контент других компонентов
+   - Копируя и вставляя ваш контент из одного приложения в другое без внешних зависимостей
+
+5. **Избегать загрязнения кодовой базы неиспользуемыми ключами/значениями для неиспользуемых компонентов**
+   - Если вы не используете компонент, вам не нужно импортировать его контент
+   - Если вы удаляете компонент, вам будет проще не забыть удалить связанный с ним контент, так как он будет находиться в той же папке
+
+6. **Снизить затраты на размышления для ИИ-агентов при объявлении вашего многоязычного контента**
+   - ИИ-агенту не нужно сканировать всю вашу кодовую базу, чтобы понять, где реализовать ваш контент
+   - Переводы легко выполняются с помощью инструментов автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot)
+
+7. **Оптимизировать производительность загрузки**
+   - Если компонент загружается лениво, связанный с ним контент будет загружен одновременно
+
+## Дополнительные возможности Intlayer
+
+| Функция                                                                                                                   | Описание                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **Поддержка нескольких фреймворков**<br><br>Intlayer совместим со всеми основными фреймворками и библиотеками, включая Next.js, React, Vite, Vue.js, Nuxt, Preact, Express и другие.                                                                                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true)       | **Управление контентом на основе JavaScript**<br><br>Используйте гибкость JavaScript для эффективного определения и управления вашим контентом. <br><br> - [Объявление контента](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **Файл объявления контента для каждого локалитета**<br><br>Ускорьте разработку, объявляя ваш контент один раз, до автоматической генерации.<br><br> - [Файл объявления контента для каждого локалитета](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                   |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **Типобезопасная среда**<br><br>Используйте TypeScript, чтобы гарантировать отсутствие ошибок в определениях контента и коде, а также получать преимущества автозаполнения в IDE.<br><br> - [Настройка TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **Упрощённая настройка**<br><br>Быстрый старт с минимальной конфигурацией. Легко настраивайте параметры интернационализации, маршрутизации, ИИ, сборки и обработки контента.<br><br> - [Изучите интеграцию с Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **Упрощённый доступ к контенту**<br><br>Нет необходимости вызывать функцию `t` для каждого элемента контента. Получайте весь ваш контент напрямую с помощью одного хука.<br><br> - [Интеграция с React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **Единообразная реализация серверных компонентов**<br><br>Идеально подходит для серверных компонентов Next.js, используйте одну и ту же реализацию как для клиентских, так и для серверных компонентов, нет необходимости передавать функцию `t` через каждый серверный компонент. <br><br> - [Серверные компоненты](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                       |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **Организованная кодовая база**<br><br>Поддерживайте вашу кодовую базу более организованной: 1 компонент = 1 словарь в той же папке. Переводы, расположенные рядом с соответствующими компонентами, повышают удобство сопровождения и ясность. <br><br> - [Как работает Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **Расширенная маршрутизация**<br><br>Полная поддержка маршрутизации приложений, плавно адаптирующаяся к сложным структурам приложений для Next.js, React, Vite, Vue.js и других.<br><br> - [Изучите интеграцию с Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Поддержка Markdown**<br><br>Импортируйте и интерпретируйте локализационные файлы и удалённый Markdown для многоязычного контента, такого как политики конфиденциальности, документация и др. Интерпретируйте и делайте метаданные Markdown доступными в вашем коде.<br><br> - [Файлы контента](https://intlayer.org/doc/concept/content/file)                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **Бесплатный визуальный редактор и CMS**<br><br>Для авторов контента доступен бесплатный визуальный редактор и CMS, что устраняет необходимость в платформе локализации. Сохраняйте синхронизацию контента с помощью Git или полностью/частично внешне управляйте им через CMS.<br><br> - [Редактор Intlayer](https://intlayer.org/doc/concept/editor) <br> - [CMS Intlayer](https://intlayer.org/doc/concept/cms)          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Контент с поддержкой tree-shaking**<br><br>Контент с поддержкой tree-shaking, уменьшающий размер итогового бандла. Загружает контент по компонентам, исключая неиспользуемый контент из вашего бандла. Поддерживает ленивую загрузку для повышения эффективности загрузки приложения. <br><br> - [Оптимизация сборки приложения](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **Статическая отрисовка**<br><br>Не блокирует статическую отрисовку. <br><br> - [Интеграция с Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **Перевод с использованием ИИ**<br><br>Преобразуйте ваш сайт на 231 язык всего одним кликом с помощью продвинутых инструментов перевода на базе ИИ от Intlayer, используя вашего собственного поставщика ИИ/ключ API. <br><br> - [Интеграция CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [CLI Intlayer](https://intlayer.org/doc/concept/cli) <br> - [Автозаполнение](https://intlayer.org/doc/concept/auto-fill) |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **Интеграция сервера MCP**<br><br>Обеспечивает сервер MCP (Model Context Protocol) для автоматизации IDE, позволяя бесшовно управлять контентом и процессами интернационализации (i18n) непосредственно в вашей среде разработки. <br><br> - [Сервер MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/mcp_server.md)                                                                                      |
+| ![Функция](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **Расширение VSCode**<br><br>Intlayer предоставляет расширение для VSCode, которое поможет вам управлять вашим контентом и переводами, создавать словари, переводить ваш контент и многое другое. <br><br> - [Расширение VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **Взаимодействие**<br><br>Обеспечивает взаимодействие с react-i18next, next-i18next, next-intl и react-intl. <br><br> - [Intlayer и react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer и next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer и next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)                                                 |
+
+## Сравнение Intlayer с другими решениями
+
+| Функция                                                   | Intlayer                                                                                                                                         | React-i18next / i18next                                                          | React-Intl (FormatJS)                              | LinguiJS                                           | next-intl                                          | next-i18next                                       | vue-i18n                                                            |
+| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------- |
+| **Переводы рядом с компонентами**                         | Да, контент расположен рядом с каждым компонентом                                                                                                | Нет                                                                              | Нет                                                | Нет                                                | Нет                                                | Нет                                                | Да - с использованием `Single File Components` (SFCs)               |
+| **Интеграция с TypeScript**                               | Продвинутая, автоматически сгенерированные строгие типы                                                                                          | Базовая; дополнительная конфигурация для безопасности                            | Хорошая, но менее строгая                          | Типы, требуется конфигурация                       | Хорошая                                            | Базовая                                            | Хорошая (типы доступны; требуется настройка безопасности ключей)    |
+| **Обнаружение отсутствующих переводов**                   | Ошибка/предупреждение во время сборки                                                                                                            | В основном строки-заменители во время выполнения                                 | Строки-заменители                                  | Требуется дополнительная настройка                 | Строки-заменители во время выполнения              | Строки-заменители во время выполнения              | Строки-заменители/предупреждения во время выполнения (настраиваемо) |
+| **Обогащённый контент (JSX/Markdown/компоненты)**         | Прямая поддержка, включая React-узлы                                                                                                             | Ограничено / только интерполяция                                                 | Синтаксис ICU, не настоящий JSX                    | Ограничено                                         | Не предназначено для сложных узлов                 | Ограничено                                         | Ограничено (компоненты через `<i18n-t>`, Markdown через плагины)    |
+| **Перевод с использованием ИИ**                           | Да, поддерживает нескольких поставщиков ИИ. Можно использовать с собственными API-ключами. Учитывает контекст вашего приложения и объем контента | Нет                                                                              | Нет                                                | Нет                                                | Нет                                                | Нет                                                | Нет                                                                 |
+| **Визуальный редактор**                                   | Да, локальный визуальный редактор + опциональная CMS; может вынести содержимое кодовой базы; встраиваемый                                        | Нет / доступно через внешние платформы локализации                               | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации                  |
+| **Локализованная маршрутизация**                          | Встроенная, поддержка middleware                                                                                                                 | Плагины или ручная настройка                                                     | Не встроена                                        | Плагин/ручная настройка                            | Встроена                                           | Встроена                                           | Вручную через Vue Router (обрабатывается Nuxt i18n)                 |
+| **Динамическая генерация маршрутов**                      | Да                                                                                                                                               | Плагин/экосистема или ручная настройка                                           | Не предоставляется                                 | Плагин/ручная настройка                            | Да                                                 | Да                                                 | Не предоставляется (предоставляется Nuxt i18n)                      |
+| **Множественное число**                                   | Шаблоны на основе перечислений; см. документацию                                                                                                 | Настраиваемо (плагины, такие как i18next-icu)                                    | Продвинутое (ICU)                                  | Продвинутое (ICU/messageformat)                    | Хорошо                                             | Хорошо                                             | Продвинутое (встроенные правила множественного числа)               |
+| **Форматирование (даты, числа, валюты)**                  | Оптимизированные форматтеры (Intl под капотом)                                                                                                   | Через плагины или пользовательское использование Intl                            | Продвинутые ICU форматтеры                         | Помощники ICU/CLI                                  | Хорошо (помощники Intl)                            | Хорошо (помощники Intl)                            | Встроенные форматтеры даты/числа (Intl)                             |
+| **Формат содержимого**                                    | .tsx, .ts, .js, .json, .md, .txt                                                                                                                 | .json                                                                            | .json, .js                                         | .po, .json                                         | .json, .js, .ts                                    | .json                                              | .json, .js                                                          |
+| **Поддержка ICU**                                         | В разработке (родной ICU)                                                                                                                        | Через плагин (i18next-icu)                                                       | Да                                                 | Да                                                 | Да                                                 | Через плагин (i18next-icu)                         | Через пользовательский форматтер/компилятор                         |
+| **SEO помощники (hreflang, sitemap)**                     | Встроенные инструменты: помощники для sitemap, **robots.txt**, метаданные                                                                        | Плагины сообщества/ручное управление                                             | Не является ядром                                  | Не является ядром                                  | Хорошо                                             | Хорошо                                             | Не является ядром (Nuxt i18n предоставляет помощники)               |
+| **Экосистема / Сообщество**                               | Меньше, но быстро растет и активно реагирует                                                                                                     | Самое большое и зрелое                                                           | Большое, корпоративное                             | Растущее, меньше                                   | Среднего размера, ориентировано на Next.js         | Среднего размера, ориентировано на Next.js         | Большое в экосистеме Vue                                            |
+| **Серверный рендеринг и серверные компоненты**            | Да, оптимизировано для SSR / React Server Components                                                                                             | Поддерживается, требуется некоторая настройка                                    | Поддерживается в Next.js                           | Поддерживается                                     | Полная поддержка                                   | Полная поддержка                                   | SSR через Nuxt/Vue SSR (без RSC)                                    |
+| **Tree-shaking (загрузка только используемого контента)** | Да, на уровне компонентов во время сборки с помощью плагинов Babel/SWC                                                                           | Обычно загружает всё (можно улучшить с помощью пространств имён/разделения кода) | Обычно загружает всё                               | Не по умолчанию                                    | Частично                                           | Частично                                           | Частично (с разделением кода/ручной настройкой)                     |
+| **Ленивая загрузка**                                      | Да, по локалям/по компонентам                                                                                                                    | Да (например, бэкенды/пространства имён по требованию)                           | Да (разделение пакетов локалей)                    | Да (динамический импорт каталогов)                 | Да (по маршрутам/локалям)                          | Да (по маршрутам/локалям)                          | Да (асинхронные сообщения локалей)                                  |
+| **Управление крупными проектами**                         | Поощряет модульность, подходит для дизайн-систем                                                                                                 | Требует хорошей дисциплины в работе с файлами                                    | Центральные каталоги могут стать большими          | Может стать сложным                                | Модульный с настройкой                             | Модульный с настройкой                             | Модульный с настройкой Vue Router/Nuxt i18n                         |
+
+## История документа
+
+| Версия | Дата       | Изменения                        |
+| ------ | ---------- | -------------------------------- |
+| 5.8.0  | 2025-08-19 | Обновление сравнительной таблицы |
+| 5.5.10 | 2025-06-29 | Инициализация истории            |