@intlayer/docs 8.9.8 → 8.10.0-canary.0

package/docs/ru/benchmark/vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: Лучшее i18n решение для Vue в 2026 году - Отчет о бенчмарке
 description: Сравните библиотеки интернационализации (i18n) для Vue, такие как vue-i18n, fluent-vue и Intlayer. Подробный отчет о производительности, размере бандла, утечках и реактивности.
 keywords:
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Добавить сравнение звезд GitHub"
   - version: 8.7.12
     date: 2026-01-06
     changes: "Инициализация бенчмарка"
 ---
 
-# Библиотеки i18n для Vue — Отчет о бенчмарке 2026
+# Библиотеки i18n для Vue - Отчет о бенчмарке 2026
 
 Эта страница представляет собой отчет о бенчмарке i18n-решений для Vue.
 
@@ -55,7 +58,7 @@ style="border:none;"
 
 На практике в наименее оптимизированных реализациях интернационализированная страница может оказаться в несколько раз тяжелее версии без i18n.
 
-Другой аспект — это опыт разработчика: то, как вы объявляете контент, типы, организацию пространств имен, динамическую загрузку и реактивность при смене локали.
+Другой аспект - это опыт разработчика: то, как вы объявляете контент, типы, организацию пространств имен, динамическую загрузку и реактивность при смене локали.
 
 ## TL;DR
 
@@ -97,7 +100,7 @@ style="border:none;"
 - `vue-i18n` (v11.4.0)
 - `fluent-vue` (v3.8.2)
 
-Фреймворк — `Vue` с мультиязычным приложением из **10 страниц** и **10 языков**.
+Фреймворк - `Vue` с мультиязычным приложением из **10 страниц** и **10 языков**.
 
 Мы сравнили **четыре стратегии загрузки**:
 
@@ -117,9 +120,9 @@ style="border:none;"
 
 Я запускал одно и то же мультиязычное приложение в реальном браузере для каждого стека, а затем фиксировал, что на самом деле передавалось по сети и сколько времени это занимало. Размеры указаны **после обычного веб-сжатия**, так как это ближе к тому, что люди реально скачивают.
 
-- **Размер библиотеки интернационализации**: После сборки, tree-shaking и минификации, размер библиотеки i18n — это размер кода провайдеров + композиблов (composables) в пустом компоненте. Это не включает загрузку файлов перевода. Это показывает, насколько "дорогая" библиотека еще до появления вашего контента.
+- **Размер библиотеки интернационализации**: После сборки, tree-shaking и минификации, размер библиотеки i18n - это размер кода провайдеров + композиблов (composables) в пустом компоненте. Это не включает загрузку файлов перевода. Это показывает, насколько "дорогая" библиотека еще до появления вашего контента.
 
-- **JavaScript на страницу**: Для каждого тестового маршрута — сколько скриптов загружает браузер во время посещения, усреднено по страницам теста (и по локалям). Тяжелые страницы — это медленные страницы.
+- **JavaScript на страницу**: Для каждого тестового маршрута - сколько скриптов загружает браузер во время посещения, усреднено по страницам теста (и по локалям). Тяжелые страницы - это медленные страницы.
 
 - **Утечка из других локалей (Leakage)**: Это контент той же страницы, но на другом языке, который по ошибке загружается на проверяемую страницу. Этот контент является лишним и его следует избегать (например, контент страницы `/fr/about` в бандле страницы `/en/about`).
 
@@ -127,7 +130,7 @@ style="border:none;"
 
 - **Средний размер бандла компонента**: Отдельные UI-элементы измеряются **по одному**, а не прячутся внутри одного гигантского общего показателя приложения. Это показывает, "раздувает" ли интернационализация обычные компоненты. Например, если ваш компонент перерендерится, он будет загружать все эти данные из памяти. Привязка гигантского JSON к любому компоненту похожа на подключение большого хранилища неиспользуемых данных, что замедляет производительность ваших компонентов.
 
-- **Скорость реакции на переключение языка**: Я переключаю язык через собственный интерфейс приложения и замеряю время до момента, когда страница явно обновилась — то, что заметит посетитель.
+- **Скорость реакции на переключение языка**: Я переключаю язык через собственный интерфейс приложения и замеряю время до момента, когда страница явно обновилась - то, что заметит посетитель.
 
 - **Работа рендеринга после смены языка**: Более узкий показатель: сколько усилий затратил интерфейс на перерисовку для нового языка после начала переключения. Полезно, когда "ощутимое" время и стоимость работы фреймворка различаются.
 
@@ -135,13 +138,19 @@ style="border:none;"
 
 - **Время гидратации (Hydration)**: Время, которое клиент тратит на превращение HTML от сервера в интерактивный интерфейс. Прочерк в таблицах означает, что данная реализация не предоставила надежных данных о гидратации в этом тесте.
 
+## Звезды на GitHub
+
+Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&aymericzip/intlayer)
+
 ## Результаты в деталях
 
-### 1 — Решения, которых следует избегать
+### 1 - Решения, которых следует избегать
 
 > В экосистеме Vue нет однозначных решений, которых следует избегать.
 
-### 2 — Приемлемые решения
+### 2 - Приемлемые решения
 
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
@@ -153,7 +162,7 @@ style="border:none;"
 
 - **fluent-vue** предлагает попытку инновации через формат .ftl. Организация сообщений отличная, с ней легче начать работу. Но на практике отсутствие типобезопасности повышает риск ошибок и может быстро стать трудозатратным при отладке. Более того, это решение загружает сообщения с помощью плагина vite, который принудительно загружает весь контент на всех языках в каждую страницу. Кроме того, это чрезвычайно тяжелое решение (~92.7 КБ, что примерно в 34 раза больше `vue-intlayer`).
 
-### 3 — Рекомендации
+### 3 - Рекомендации
 
 **(Intlayer)** (`vue-intlayer@8.7.12`):
 

package/docs/ru/bundle_optimization.md

@@ -35,7 +35,7 @@ history:
 
 ## Сканирование бандла
 
-Анализ бандла — это первый шаг к выявлению "тяжелых" JSON-файлов и возможностей разделения кода. Эти инструменты генерируют визуальную древовидную карту (treemap) скомпилированного кода вашего приложения, позволяя вам точно увидеть, какие библиотеки занимают больше всего места.
+Анализ бандла - это первый шаг к выявлению "тяжелых" JSON-файлов и возможностей разделения кода. Эти инструменты генерируют визуальную древовидную карту (treemap) скомпилированного кода вашего приложения, позволяя вам точно увидеть, какие библиотеки занимают больше всего места.
 
 <Tabs>
  <Tab value="vite">

package/docs/ru/cli/index.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2026-03-31
-title: CLI — Все команды Intlayer CLI для вашего многоязычного сайта
+title: CLI - Все команды Intlayer CLI для вашего многоязычного сайта
 description: Узнайте, как использовать Intlayer CLI для управления вашим многоязычным сайтом. Следуйте шагам в этой онлайн-документации, чтобы настроить свой проект за считанные минуты.
 keywords:
   - CLI
@@ -64,7 +64,7 @@ history:
     changes: "Инициализация истории"
 ---
 
-# Intlayer CLI — Все команды Intlayer CLI для вашего многоязычного сайта
+# Intlayer CLI - Все команды Intlayer CLI для вашего многоязычного сайта
 
 ---
 
@@ -121,51 +121,51 @@ Intlayer принимает несколько форматов файлов к
 
 ### Аутентификация
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/login.md)** — Аутентификация в Intlayer CMS и получение учетных данных для доступа
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/login.md)** - Аутентификация в Intlayer CMS и получение учетных данных для доступа
 
 ### Основные команды
 
-- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/build.md)** — Сборка словарей из файлов объявления контента
-- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/watch.md)** — Отслеживание изменений и автоматическая сборка словарей
-- **[Create Standalone Bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/standalone.md)** — Создание автономной JavaScript-сборки, содержащей Intlayer и указанные пакеты
-- **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/version.md)** — Проверка версии установленного Intlayer CLI
-- **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/list_projects.md)** — Список всех проектов Intlayer в директории или git-репозитории
+- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/build.md)** - Сборка словарей из файлов объявления контента
+- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/watch.md)** - Отслеживание изменений и автоматическая сборка словарей
+- **[Create Standalone Bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/standalone.md)** - Создание автономной JavaScript-сборки, содержащей Intlayer и указанные пакеты
+- **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/version.md)** - Проверка версии установленного Intlayer CLI
+- **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/list_projects.md)** - Список всех проектов Intlayer в директории или git-репозитории
 
 ### Управление словарями
 
-- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/push.md)** — Отправка словарей в редактор Intlayer и CMS
-- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/pull.md)** — Получение словарей из редактора Intlayer и CMS
-- **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/fill.md)** — Заполнение, аудит и перевод словарей с помощью ИИ
-- **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/test.md)** — Тестирование и выявление недостающих переводов
-- **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/list.md)** — Список всех файлов объявления контента в вашем проекте
+- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/push.md)** - Отправка словарей в редактор Intlayer и CMS
+- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/pull.md)** - Получение словарей из редактора Intlayer и CMS
+- **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/fill.md)** - Заполнение, аудит и перевод словарей с помощью ИИ
+- **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/test.md)** - Тестирование и выявление недостающих переводов
+- **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/list.md)** - Список всех файлов объявления контента в вашем проекте
 
 ### Управление компонентами
 
-- **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md)** — Извлечение строк из компонентов в файл .content рядом с компонентом
+- **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/extract.md)** - Извлечение строк из компонентов в файл .content рядом с компонентом
 
 ### Конфигурация
 
-- **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/init.md)** — Настройка Intlayer в вашем проекте с автоматической конфигурацией
-- **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/configuration.md)** — Получение и отправка вашей конфигурации Intlayer в CMS
+- **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/init.md)** - Настройка Intlayer в вашем проекте с автоматической конфигурацией
+- **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/configuration.md)** - Получение и отправка вашей конфигурации Intlayer в CMS
 
 ### Управление документацией
 
-- **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/doc-translate.md)** — Автоматический перевод файлов документации с помощью ИИ
-- **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/doc-review.md)** — Проверка файлов документации на качество и согласованность
+- **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/doc-translate.md)** - Автоматический перевод файлов документации с помощью ИИ
+- **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/doc-review.md)** - Проверка файлов документации на качество и согласованность
 
 ### Редактор и Live Sync
 
-- **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/editor.md)** — Использование команд редактора Intlayer
-- **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/live.md)** — Использование Live Sync для применения изменений контента из CMS во время выполнения
+- **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/editor.md)** - Использование команд редактора Intlayer
+- **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/live.md)** - Использование Live Sync для применения изменений контента из CMS во время выполнения
 
 ### CI/CD и автоматизация
 
-- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/ci.md)** — Выполнение команд Intlayer с автоматически подставляемыми учетными данными для конвейеров CI/CD
+- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/ci.md)** - Выполнение команд Intlayer с автоматически подставляемыми учетными данными для конвейеров CI/CD
 
 ### Инструменты разработчика
 
-- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/sdk.md)** — Использование Intlayer CLI SDK в вашем собственном коде
-- **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/debug.md)** — Отладка и устранение неполадок Intlayer CLI
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/sdk.md)** - Использование Intlayer CLI SDK в вашем собственном коде
+- **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/debug.md)** - Отладка и устранение неполадок Intlayer CLI
 
 ## Использование команд Intlayer в вашем `package.json`
 

package/docs/ru/cli/init.md

@@ -55,12 +55,12 @@ bun x intlayer init
 
 Команда `init` выполняет следующие задачи по настройке:
 
-1. **Проверяет структуру проекта** — Убеждается, что вы находитесь в директории валидного проекта с файлом `package.json`.
-2. **Обновляет `.gitignore`** — Добавляет `.intlayer` в ваш файл `.gitignore`, чтобы исключить сгенерированные файлы из системы контроля версий (можно пропустить с помощью `--no-gitignore`).
-3. **Настраивает TypeScript** — Обновляет любые файлы `tsconfig.json`, чтобы включить определения типов Intlayer (`.intlayer/**/*.ts`).
-4. **Создает файл конфигурации** — Генерирует `intlayer.config.ts` (для проектов на TypeScript) или `intlayer.config.mjs` (для проектов на JavaScript) с настройками по умолчанию.
-5. **Обновляет конфиг Vite** — Если обнаружен файл конфигурации Vite, добавляет импорт плагина `vite-intlayer`.
-6. **Обновляет конфиг Next.js** — Если обнаружен файл конфигурации Next.js, добавляет импорт плагина `next-intlayer`.
+1. **Проверяет структуру проекта** - Убеждается, что вы находитесь в директории валидного проекта с файлом `package.json`.
+2. **Обновляет `.gitignore`** - Добавляет `.intlayer` в ваш файл `.gitignore`, чтобы исключить сгенерированные файлы из системы контроля версий (можно пропустить с помощью `--no-gitignore`).
+3. **Настраивает TypeScript** - Обновляет любые файлы `tsconfig.json`, чтобы включить определения типов Intlayer (`.intlayer/**/*.ts`).
+4. **Создает файл конфигурации** - Генерирует `intlayer.config.ts` (для проектов на TypeScript) или `intlayer.config.mjs` (для проектов на JavaScript) с настройками по умолчанию.
+5. **Обновляет конфиг Vite** - Если обнаружен файл конфигурации Vite, добавляет импорт плагина `vite-intlayer`.
+6. **Обновляет конфиг Next.js** - Если обнаружен файл конфигурации Next.js, добавляет импорт плагина `next-intlayer`.
 
 ## Примеры:
 
@@ -138,7 +138,7 @@ Checking Intlayer configuration...
 
 ## Примечания:
 
-- Команда идемпотентна — вы можете безопасно запускать ее несколько раз. Она пропустит уже выполненные шаги.
+- Команда идемпотентна - вы можете безопасно запускать ее несколько раз. Она пропустит уже выполненные шаги.
 - Если файл конфигурации уже существует, он не будет перезаписан.
 - Конфигурационные файлы TypeScript без массива `include` (например, конфигурации в стиле solution со ссылками) пропускаются.
 - Команда завершится с ошибкой, если в корне проекта не найден `package.json`.

package/docs/ru/cli/standalone.md

@@ -122,11 +122,11 @@ bun x intlayer standalone --packages intlayer --format iife
 
 ## Что она делает:
 
-1. **Создает временную среду** — Настраивает временную директорию для управления зависимостями.
-2. **Устанавливает пакеты** — Использует `npm` или `bun` (если доступен) для установки запрошенных пакетов и их зависимостей.
-3. **Генерирует точку входа** — Создает временный файл точки входа, который экспортирует все запрошенные пакеты и делает их доступными в виде глобальных переменных при запуске в браузере.
-4. **Собирает с помощью esbuild** — Использует esbuild для объединения всего в один файл с применением минификации и форматирования в соответствии с запросом.
-5. **Генерирует файл** — Записывает итоговую сборку по указанному пути вывода.
+1. **Создает временную среду** - Настраивает временную директорию для управления зависимостями.
+2. **Устанавливает пакеты** - Использует `npm` или `bun` (если доступен) для установки запрошенных пакетов и их зависимостей.
+3. **Генерирует точку входа** - Создает временный файл точки входа, который экспортирует все запрошенные пакеты и делает их доступными в виде глобальных переменных при запуске в браузере.
+4. **Собирает с помощью esbuild** - Использует esbuild для объединения всего в один файл с применением минификации и форматирования в соответствии с запросом.
+5. **Генерирует файл** - Записывает итоговую сборку по указанному пути вывода.
 
 ## Глобальные переменные
 

package/docs/ru/compiler.md

@@ -35,7 +35,7 @@ history:
 
 ## Что такое Intlayer Compiler?
 
-**Intlayer Compiler** — это мощный инструмент, разработанный для автоматизации процесса интернационализации (i18n) в ваших приложениях. Он сканирует ваш исходный код (JSX, TSX, Vue, Svelte) на предмет объявлений контента, извлекает их и автоматически генерирует необходимые файлы словарей. Это позволяет вам хранить контент вместе с компонентами, в то время как Intlayer управляет и синхронизирует ваши словари.
+**Intlayer Compiler** - это мощный инструмент, разработанный для автоматизации процесса интернационализации (i18n) в ваших приложениях. Он сканирует ваш исходный код (JSX, TSX, Vue, Svelte) на предмет объявлений контента, извлекает их и автоматически генерирует необходимые файлы словарей. Это позволяет вам хранить контент вместе с компонентами, в то время как Intlayer управляет и синхронизирует ваши словари.
 
 ## Почему стоит использовать Intlayer Compiler?
 
@@ -50,7 +50,7 @@ history:
 
 Хотя компилятор предлагает отличный опыт "работает из коробки", он также вводит некоторые компромиссы, о которых вы должны знать:
 
-- **Эвристическая неоднозначность**: Компилятор должен угадывать, что является пользовательским контентом, а что — логикой приложения (например, `className="active"`, коды состояния, ID продуктов). В сложных кодовых базах это может привести к ложным срабатываниям или пропущенным строкам, которые требуют ручных аннотаций и исключений.
+- **Эвристическая неоднозначность**: Компилятор должен угадывать, что является пользовательским контентом, а что - логикой приложения (например, `className="active"`, коды состояния, ID продуктов). В сложных кодовых базах это может привести к ложным срабатываниям или пропущенным строкам, которые требуют ручных аннотаций и исключений.
 - **Только статическое извлечение**: Извлечение на основе компилятора полагается на статический анализ. Строки, которые существуют только во время выполнения (коды ошибок API, поля CMS и т.д.), не могут быть обнаружены или переведены компилятором в одиночку, поэтому вам все еще нужна дополнительная стратегия i18n времени выполнения.
 
 Для более глубокого архитектурного сравнения см. блог-пост [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/compiler_vs_declarative_i18n.md).
@@ -64,7 +64,7 @@ history:
 
 ### Vite
 
-Для приложений на базе Vite (React, Vue, Svelte и др.) самый простой способ использовать компилятор — через плагин `vite-intlayer`.
+Для приложений на базе Vite (React, Vue, Svelte и др.) самый простой способ использовать компилятор - через плагин `vite-intlayer`.
 
 #### Установка
 

package/docs/ru/configuration.md

@@ -606,7 +606,7 @@ export default config;
 | ----------------- | ----------------------------------------------------------------------------------------- | ---------- | ------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `locales`         | Список языков, поддерживаемых в приложении.                                               | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                                                                              |
 | `requiredLocales` | Список обязательных языков в приложении.                                                  | `string[]` | `[]`                | `[]`                 | • Если пусто, все языки обязательны в режиме `strict`.<br/>• Убедитесь, что обязательные языки также определены в поле `locales`.                                                                                                                                                                                            |
-| `strictMode`      | Обеспечивает надежную реализацию интернационализированного контента с помощью TypeScript. | `string`   | `'inclusive'`       |                      | • Если `"strict"`: функция `t` требует определения каждого объявленного языка — вызывает ошибку, если какой-то отсутствует или не объявлен.<br/>• Если `"inclusive"`: предупреждает об отсутствующих языках, но разрешает использование существующих необъявленных.<br/>• Если `"loose"`: принимает любой существующий язык. |
+| `strictMode`      | Обеспечивает надежную реализацию интернационализированного контента с помощью TypeScript. | `string`   | `'inclusive'`       |                      | • Если `"strict"`: функция `t` требует определения каждого объявленного языка - вызывает ошибку, если какой-то отсутствует или не объявлен.<br/>• Если `"inclusive"`: предупреждает об отсутствующих языках, но разрешает использование существующих необъявленных.<br/>• Если `"loose"`: принимает любой существующий язык. |
 | `defaultLocale`   | Язык по умолчанию, используемый как запасной, если запрошенный язык не найден.            | `string`   | `Locales.ENGLISH`   | `'en'`               | Используется для определения языка, когда он не указан в URL, куки или заголовке.                                                                                                                                                                                                                                            |
 
 ---
@@ -640,9 +640,9 @@ export default config;
 | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `mode`     | Режим маршрутизации URL для управления языками.                                                                                                                                                                            | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) или `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: язык управляется другими способами. `'search-params'`: `/dashboard?locale=fr` | Не влияет на управление куками или хранилищем языков.                                                                                                                                                                                                                                           |
 | `storage`  | Конфигурация хранения языка на клиенте.                                                                                                                                                                                    | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                               | См. таблицу параметров хранения ниже.                                                                                                                                                                                                                                                           |
-| `basePath` | Базовый путь для URL-адресов приложения.                                                                                                                                                                                   | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                      | Если приложение находится по адресу `https://example.com/my-app`, basePath — `'/my-app'`, а URL становятся `https://example.com/my-app/en`.                                                                                                                                                     |
+| `basePath` | Базовый путь для URL-адресов приложения.                                                                                                                                                                                   | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                      | Если приложение находится по адресу `https://example.com/my-app`, basePath - `'/my-app'`, а URL становятся `https://example.com/my-app/en`.                                                                                                                                                     |
 | `rewrite`  | Пользовательские правила перезаписи URL, которые переопределяют режим маршрутизации по умолчанию для определенных путей. Поддерживает динамические параметры `[param]`.                                                    | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | См. пример ниже                                                                                                                                                                                  | • Правила перезаписи имеют приоритет над `mode`.<br/>• Работает с Next.js и Vite.<br/>• `getLocalizedUrl()` автоматически применяет соответствующие правила.<br/>• См. [Пользовательские перезаписи URL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
-| `domains`  | Сопоставляет локали с именами хостов доменов для маршрутизации на основе доменов. Когда установлено, URL-адреса для локали используют этот домен в качестве базы (абсолютный URL), и к пути не добавляется префикс локали. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                      | • Протокол по умолчанию — `https://`, если он не указан в имени хоста.<br/>• Сам домен идентифицирует локаль, поэтому префикс `/zh/` не добавляется.<br/>• `getLocalizedUrl('/', 'zh')` возвращает `https://intlayer.zh/`.                                                                      |
+| `domains`  | Сопоставляет локали с именами хостов доменов для маршрутизации на основе доменов. Когда установлено, URL-адреса для локали используют этот домен в качестве базы (абсолютный URL), и к пути не добавляется префикс локали. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                      | • Протокол по умолчанию - `https://`, если он не указан в имени хоста.<br/>• Сам домен идентифицирует локаль, поэтому префикс `/zh/` не добавляется.<br/>• `getLocalizedUrl('/', 'zh')` возвращает `https://intlayer.zh/`.                                                                      |
 
 **Пример `rewrite`**:
 
@@ -670,10 +670,10 @@ routing: {
 
 | Значение           | Примечание                                                                                                                                                                                            | Описание                                                                   |
 | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
-| `'cookie'`         | • Для соответствия GDPR обеспечьте надлежащее согласие пользователя.<br/>• Настраивается через `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).      | Хранит язык в куках — доступно как на клиенте, так и на сервере.           |
-| `'localStorage'`   | • Не истекает, если не будет явно очищено.<br/>• Прокси Intlayer не может получить к этому доступ.<br/>• Настраивается через `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`). | Хранит язык в браузере без ограничения срока — только на стороне клиента.  |
-| `'sessionStorage'` | • Очищается при закрытии вкладки/окна.<br/>• Прокси Intlayer не может получить к этому доступ.<br/>• Настраивается через `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).   | Хранит язык на время сессии страницы — только на стороне клиента.          |
-| `'header'`         | • Полезно для вызовов API.<br/>• Сторона клиента не может получить доступ.<br/>• Настраивается через `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                               | Хранит или передает язык через HTTP-заголовки — только на стороне сервера. |
+| `'cookie'`         | • Для соответствия GDPR обеспечьте надлежащее согласие пользователя.<br/>• Настраивается через `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`).      | Хранит язык в куках - доступно как на клиенте, так и на сервере.           |
+| `'localStorage'`   | • Не истекает, если не будет явно очищено.<br/>• Прокси Intlayer не может получить к этому доступ.<br/>• Настраивается через `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`). | Хранит язык в браузере без ограничения срока - только на стороне клиента.  |
+| `'sessionStorage'` | • Очищается при закрытии вкладки/окна.<br/>• Прокси Intlayer не может получить к этому доступ.<br/>• Настраивается через `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).   | Хранит язык на время сессии страницы - только на стороне клиента.          |
+| `'header'`         | • Полезно для вызовов API.<br/>• Сторона клиента не может получить доступ.<br/>• Настраивается через `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                               | Хранит или передает язык через HTTP-заголовки - только на стороне сервера. |
 
 #### Атрибуты куки (Cookies Attributes)
 
@@ -861,7 +861,7 @@ export default config;
 | `location`                  | Указывает, где хранятся файлы словарей и как они синхронизируются с CMS.                                                                                 | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`      | `'hybrid'`                                                                                  | • `'local'`: управление только локально.<br/>• `'remote'`: управление только удаленно (CMS).<br/>• `'hybrid'`: управление и локально, и удаленно.<br/>• `'plugin'` или кастомная строка: управление плагином или кастомным источником.                                                                                                                                                          |
 | `importMode`                | Управляет способом импорта словарей.                                                                                                                     | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`     | `'dynamic'`                                                                                 | • `'static'`: статический импорт.<br/>• `'dynamic'`: динамический импорт через Suspense.<br/>• `'fetch'`: получение через Live Sync API; откат к `'dynamic'` при неудаче.<br/>• Требует плагины `@intlayer/babel` и `@intlayer/swc`.<br/>• Ключи должны быть объявлены статически.<br/>• Игнорируется, если `optimize` выключен.<br/>• Не влияет на `getIntlayer`, `getDictionary` и т.д.       |
 | `priority`                  | Приоритет словаря. Более высокие значения побеждают более низкие при разрешении конфликтов между словарями.                                              | `number`                                                                                                        | `undefined`    | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                 |
-| `live`                      | Устарело — используйте `importMode: 'fetch'`. Указывало, должен ли контент словаря получаться динамически через Live Sync API.                           | `boolean`                                                                                                       | `undefined`    |                                                                                             | Переименовано в `importMode: 'fetch'` в v8.0.0.                                                                                                                                                                                                                                                                                                                                                 |
+| `live`                      | Устарело - используйте `importMode: 'fetch'`. Указывало, должен ли контент словаря получаться динамически через Live Sync API.                           | `boolean`                                                                                                       | `undefined`    |                                                                                             | Переименовано в `importMode: 'fetch'` в v8.0.0.                                                                                                                                                                                                                                                                                                                                                 |
 | `schema`                    | Генерируется автоматически Intlayer для валидации JSON-схемы.                                                                                            | `'https://intlayer.org/schema.json'`                                                                            | авто-генерация |                                                                                             | Не редактируйте вручную.                                                                                                                                                                                                                                                                                                                                                                        |
 | `title`                     | Помогает идентифицировать словарь в редакторе и CMS.                                                                                                     | `string`                                                                                                        | `undefined`    | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `tags`                      | Категоризирует словари и предоставляет контекст или инструкции для редактора и ИИ.                                                                       | `string[]`                                                                                                      | `undefined`    | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                 |

package/docs/ru/custom_domains.md

@@ -34,8 +34,8 @@ Intlayer поддерживает маршрутизацию локалей на
 
 Ключевое различие заключается в **эксклюзивности**:
 
-- **Эксклюзивный домен** — только одна локаль сопоставляется с этим хост-именем (например, `zh → intlayer.zh`). Сам домен идентифицирует локаль, поэтому префикс локали не добавляется к пути. `https://intlayer.zh/about` обслуживает китайский контент.
-- **Общий домен** — несколько локалей сопоставляются с одним и тем же хост-именем (например, и `en`, и `fr` сопоставляются с `intlayer.org`). Применяется стандартная маршрутизация на основе префиксов. `intlayer.org/fr/about` обслуживает французский контент.
+- **Эксклюзивный домен** - только одна локаль сопоставляется с этим хост-именем (например, `zh → intlayer.zh`). Сам домен идентифицирует локаль, поэтому префикс локали не добавляется к пути. `https://intlayer.zh/about` обслуживает китайский контент.
+- **Общий домен** - несколько локалей сопоставляются с одним и тем же хост-именем (например, и `en`, и `fr` сопоставляются с `intlayer.org`). Применяется стандартная маршрутизация на основе префиксов. `intlayer.org/fr/about` обслуживает французский контент.
 
 ## Конфигурация
 
@@ -55,9 +55,9 @@ const config: IntlayerConfig = {
   routing: {
     mode: "prefix-no-default",
     domains: {
-      // Общий домен — en и fr используют префиксную маршрутизацию на intlayer.org
+      // Общий домен - en и fr используют префиксную маршрутизацию на intlayer.org
       en: "intlayer.org",
-      // Эксклюзивный домен — у zh есть собственное имя хоста, префикс /zh/ не нужен
+      // Эксклюзивный домен - у zh есть собственное имя хоста, префикс /zh/ не нужен
       zh: "intlayer.zh",
     },
   },
@@ -96,7 +96,7 @@ getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.org" });
 ```ts
 // Текущая страница: intlayer.zh/about
 getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.zh" });
-// → "/about"  (уже на правильном домене — относительный URL)
+// → "/about"  (уже на правильном домене - относительный URL)
 
 getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 // → "https://intlayer.org/fr/about"  (междоменная ссылка обратно на intlayer.org)
@@ -108,14 +108,14 @@ getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 
 1. Имя хоста из абсолютного входного URL (например, `https://intlayer.org/about` → `intlayer.org`).
 2. `window.location.hostname` в браузерной среде.
-3. Если ни один из вариантов недоступен (SSR без явного указания параметра), возвращается относительный URL для локалей на том же домене, а абсолютный URL не создается — это безопасный резервный вариант.
+3. Если ни один из вариантов недоступен (SSR без явного указания параметра), возвращается относительный URL для локалей на том же домене, а абсолютный URL не создается - это безопасный резервный вариант.
 
 ```ts
-// Браузер — window.location.hostname === 'intlayer.org'
+// Браузер - window.location.hostname === 'intlayer.org'
 getLocalizedUrl("/about", "zh");
 // → "https://intlayer.zh/about"  (автоматически определено из window)
 
-// Из абсолютного URL — домен определяется автоматически
+// Из абсолютного URL - домен определяется автоматически
 getLocalizedUrl("https://intlayer.org/about", "zh");
 // → "https://intlayer.zh/about"
 ```
@@ -151,14 +151,14 @@ export const config = {
 };
 ```
 
-**Перенаправление (Redirect)** — запрос поступает на неправильный домен для данного префикса локали:
+**Перенаправление (Redirect)** - запрос поступает на неправильный домен для данного префикса локали:
 
 ```
 GET intlayer.org/zh/about
 → 301 https://intlayer.zh/about
 ```
 
-**Перезапись (Rewrite)** — запрос поступает на эксклюзивный домен локали без префикса:
+**Перезапись (Rewrite)** - запрос поступает на эксклюзивный домен локали без префикса:
 
 ```
 GET intlayer.zh/about
@@ -209,7 +209,7 @@ export const LocaleSwitcher = () => {
 };
 ```
 
-Никакой дополнительной настройки не требуется — `useLocale` внутренне определяет `window.location.hostname` и выбирает между `router.replace` (тот же домен) и `window.location.href` (другой домен).
+Никакой дополнительной настройки не требуется - `useLocale` внутренне определяет `window.location.hostname` и выбирает между `router.replace` (тот же домен) и `window.location.href` (другой домен).
 
 ## SEO: альтернативные ссылки `hreflang`
 
@@ -247,4 +247,4 @@ export const generateMetadata = (): Metadata => {
 | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
 | `getLocalizedUrl(url, locale, { currentDomain })` | Возвращает относительный или абсолютный URL в зависимости от того, находится ли целевая локаль на текущем домене. |
 | `getMultilingualUrls(url, { currentDomain })`     | Возвращает карту локализованных URL по локалям, смешивая относительные и абсолютные URL по мере необходимости.    |
-| `getPrefix(locale, { domains })`                  | Возвращает пустой префикс для локалей с эксклюзивным доменом, в противном случае — обычный префикс.               |
+| `getPrefix(locale, { domains })`                  | Возвращает пустой префикс для локалей с эксклюзивным доменом, в противном случае - обычный префикс.               |

package/docs/ru/dictionary/content_file.md

@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.10.0
+    date: 2026-05-19
+    changes: "Добавлена поддержка форматов файлов YAML и Markdown"
   - version: 8.9.0
     date: 2026-05-12
     changes: "Добавить тип узла содержимого `plural`"
@@ -811,6 +814,40 @@ You can also create content files in JSON format:
 }
 ```
 
+### Markdown Content File
+
+```markdown
+---
+key: welcome-page
+locale: en
+title: Welcome Page Content
+description: Content for the main welcome page
+tags:
+  - page
+  - welcome
+---
+
+# Welcome to Our Platform
+
+## Build amazing applications with ease
+```
+
+### YAML Content File
+
+```yaml
+key: welcome-page
+title: Welcome Page Content
+description: Content for the main welcome page
+locale: "en"
+tags:
+  - page
+  - welcome
+content:
+  hero:
+    title: Welcome to Our Platform
+    subtitle: Build amazing applications with ease
+```
+
 ### Файлы контента для каждого локаля
 
 Для словарей, специфичных для локали, укажите свойство `locale`:
@@ -862,6 +899,10 @@ Intlayer позволяет настраивать расширения для
 - `.content.mjx`
 - `.content.cjs`
 - `.content.cjx`
+- `.content.md`
+- `.content.mdx`
+- `.content.yaml`
+- `.content.yml`
 
 Эти расширения по умолчанию подходят для большинства приложений. Однако, если у вас есть специфические требования, вы можете определить собственные расширения, чтобы оптимизировать процесс сборки и снизить риск конфликтов с другими компонентами.
 

package/docs/ru/dictionary/html.md

@@ -280,7 +280,7 @@ const myContent = html(
     );
     ```
 
-    > Динамический импорт рендерера HTML — хороший способ уменьшить размер бандла вашего приложения.
+    > Динамический импорт рендерера HTML - хороший способ уменьшить размер бандла вашего приложения.
 
   </Tab>
   <Tab label="Vue" value="vue">
@@ -325,7 +325,7 @@ const myContent = html(
     app.mount("#app");
     ```
 
-    > Динамический импорт рендерера HTML — хороший способ уменьшить размер бандла вашего приложения.
+    > Динамический импорт рендерера HTML - хороший способ уменьшить размер бандла вашего приложения.
 
   </Tab>
   <Tab label="Svelte" value="svelte">
@@ -362,7 +362,7 @@ const myContent = html(
     </HTMLProvider>
     ```
 
-    > Динамический импорт рендерера HTML — хороший способ уменьшить размер бандла вашего приложения.
+    > Динамический импорт рендерера HTML - хороший способ уменьшить размер бандла вашего приложения.
 
   </Tab>
   <Tab label="Preact" value="preact">
@@ -398,7 +398,7 @@ const myContent = html(
     );
     ```
 
-    > Динамический импорт рендерера HTML — хороший способ уменьшить размер бандла вашего приложения.
+    > Динамический импорт рендерера HTML - хороший способ уменьшить размер бандла вашего приложения.
 
   </Tab>
   <Tab label="Solid" value="solid">
@@ -434,7 +434,7 @@ const myContent = html(
     );
     ```
 
-    > Динамический импорт рендерера HTML — хороший способ уменьшить размер бандла вашего приложения.
+    > Динамический импорт рендерера HTML - хороший способ уменьшить размер бандла вашего приложения.
 
   </Tab>
   <Tab label="Angular" value="angular">
@@ -471,7 +471,7 @@ const myContent = html(
     };
     ```
 
-    > Динамический импорт рендерера HTML — хороший способ уменьшить размер бандла вашего приложения.
+    > Динамический импорт рендерера HTML - хороший способ уменьшить размер бандла вашего приложения.
 
   </Tab>
 </Tabs>