@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/ru/benchmark/svelte.md

@@ -0,0 +1,148 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Лучшее i18n решение для Svelte в 2026 году - Отчет о бенчмарке
+description: Сравните библиотеки интернационализации (i18n) для Svelte, такие как svelte-i18n, Paraglide и Intlayer. Подробный отчет о производительности, размере бандла, утечках и реактивности.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - svelte
+  - производительность
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - svelte
+author: Aymeric PINEAU
+applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
+history:
+  - version: 8.7.12
+    date: 2026-01-06
+    changes: "Инициализация бенчмарка"
+---
+
+# Библиотеки i18n для Svelte — Отчет о бенчмарке 2026
+
+Эта страница представляет собой отчет о бенчмарке i18n-решений для Svelte.
+
+## Содержание
+
+<Toc/>
+
+## Интерактивный бенчмарк
+
+<I18nBenchmark framework="vite-svelte" vertical/>
+
+## Ссылка на результаты:
+
+<iframe 
+  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md" 
+  width="100%" 
+  height="600px"
+  style="border:none;">
+</iframe>
+
+> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_svelte.md
+
+Полный репозиторий бенчмарка можно найти [здесь](https://github.com/intlayer-org/benchmark-i18n/tree/main).
+
+## Введение
+
+Решения для интернационализации являются одними из самых тяжелых зависимостей в Svelte-приложении. Основной риск заключается в передаче ненужного контента: переводов для других страниц и других локалей в бандле одного маршрута.
+
+По мере роста вашего приложения эта проблема может быстро привести к раздуванию JavaScript, отправляемого клиенту, и замедлению навигации.
+
+На практике в наименее оптимизированных реализациях интернационализированная страница может оказаться в несколько раз тяжелее версии без i18n.
+
+Другой аспект — это опыт разработчика: то, как вы объявляете контент, типы, организацию пространств имен, динамическую загрузку и реактивность при смене локали.
+
+## TL;DR
+
+- **Intlayer**: Самый эффективный выбор с точки зрения производительности (v8.7.12) с минимальным влиянием на размер.
+- **Paraglide**: Сильный конкурент для tree-shaking, но имеет более сложный опыт разработки и накладные расходы на реактивность.
+- **svelte-i18n**: Полнофункциональный и стандартный для Svelte, но имеет гораздо больший вес бандла (~7 раз больше Intlayer).
+
+## Проверьте свое приложение
+
+Чтобы быстро выявить проблемы с утечкой i18n, я настроил бесплатный сканер, доступный [здесь](https://intlayer.org/i18n-seo-scanner).
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Проблема
+
+Два рычага необходимы для ограничения стоимости мультиязычного приложения:
+
+- Разделение контента по страницам / пространствам имен, чтобы не загружать целые словари, когда они вам не нужны.
+- Динамическая загрузка нужной локали только тогда, когда она требуется.
+
+Понимание технических ограничений этих подходов:
+
+**Динамическая загрузка**
+
+Без динамической загрузки большинство решений хранят сообщения в памяти с первого рендеринга, что создает значительные накладные расходы для приложений с множеством маршрутов и локалей.
+
+При использовании динамической загрузки вы идете на компромисс: меньше начального JS, но иногда дополнительный запрос при переключении языка.
+
+**Разделение контента**
+
+Синтаксис, построенный вокруг `t('a.b.c')`, очень удобен, но часто способствует хранению больших JSON-объектов во время выполнения. Эта модель затрудняет tree-shaking, если библиотека не предлагает реальную стратегию разделения контента для каждой страницы.
+
+## Методология
+
+Для этого бенчмарка мы сравнили следующие библиотеки:
+
+- `Base App` (Без библиотеки i18n)
+- `svelte-intlayer` (v8.7.12)
+- `svelte-i18n` (v4.0.1)
+- `@inlang/paraglide-js` (v2.17.0)
+
+Фреймворк — `Svelte` с мультиязычным приложением из **10 страниц** и **10 языков**.
+
+Мы сравнили **четыре стратегии загрузки**:
+
+| Стратегия                 | Без пространств имен (глобальная)               | С пространствами имен (локальная/scoped)                                         |
+| :------------------------ | :---------------------------------------------- | :------------------------------------------------------------------------------- |
+| **Статическая загрузка**  | **Static**: Все в памяти при запуске.           | **Scoped static**: Разделено по пространствам имен; все загружается при запуске. |
+| **Динамическая загрузка** | **Dynamic**: Загрузка по требованию для локали. | **Scoped dynamic**: Гранулярная загрузка по пространствам имен и локалям.        |
+
+## Резюме стратегий
+
+- **Статическая (Static)**: Простота; отсутствие задержек сети после начальной загрузки. Минус: большой размер бандла.
+- **Динамическая (Dynamic)**: Уменьшает начальный вес (ленивая загрузка). Идеально при наличии множества локалей.
+- **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
+- **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
+
+## Результаты в деталях
+
+### 1 — Решения, которых следует избегать
+
+> В экосистеме Svelte нет однозначных решений, которых следует избегать.
+
+### 2 — Приемлемые решения
+
+**(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
+
+`Paraglide` предлагает инновационный, хорошо продуманный подход. В контексте приложения Vite + Svelte рекламируемый ими tree-shaking работает как ожидалось, что здорово.
+Но в случае с React + TanStack Start tree-shaking не сработал как ожидалось, то же самое и с Next.js. Тем не менее, я бы перепроверил использование Paraglide в проектах Svelte и TanStack Start.
+Процесс работы и DX также сложнее, чем у других вариантов.
+Лично мне не нравится необходимость регенерировать JS-файлы перед каждым пушем, что создает постоянный риск конфликтов при слиянии в PR. Инструмент также кажется более ориентированным на Vite, чем на Next.js.
+Наконец, по сравнению с другими решениями, Paraglide не использует стор (например, Svelte store) для получения поточної локали для рендеринга. Для каждого обработанного узла он запрашивает локаль из localStorage / куки и т.д. Это приводит к выполнению ненужной логики, что влияет на реактивность компонентов.
+
+> Примечание о paraglide: решение внедряет код в вашу кодовую базу для импорта, в результате чего метрика 'размер библиотеки' в отчете бенчмарка практически равна 0. Генерация кода — это хорошо, потому что используемая функция будет включать только необходимую логику (полный префикс против отсутствия префикса, куки против хранилища и т. д.). Для сравнения, Intlayer выполняет эту фильтрацию с помощью внедрения переменных окружения во время сборки, чтобы заставить бандлер выполнять tree-shaking контента в зависимости от логики. Благодаря этому paraglide и intlayer в итоге оказываются в 6-10 раз легче, чем i18next или next-intl.
+
+**(svelte-i18n)** (`svelte-i18n@3.4.0`):
+
+Это решение отвечает всем потребностям i18n в Svelte-проекте. Но, как и в случае с i18next или другими основными решениями i18n, оно немного тяжеловато (~15.9 КБ, что примерно в 7 раз больше `svelte-intlayer`).
+
+### 3 — Рекомендации
+
+**(Intlayer)** (`svelte-intlayer@8.7.12`):
+
+Я не буду лично оценивать `svelte-intlayer` ради объективности, так как это мое собственное решение.
+
+### Личное примечание
+
+Это примечание является личным и не влияет на результаты бенчмарка. Тем не менее, в мире i18n часто можно встретить консенсус вокруг паттерна типа `const t = useTranslation('xx')` + `<>{t('xx.xx')}</>` для переведенного контента.
+
+В Svelte-приложениях внедрение функции в качестве `Slot`, на мой взгляд, является антипаттерном. Это также добавляет лишнюю сложность и накладные расходы на выполнение JavaScript (даже если это почти незаметно).

package/docs/ru/benchmark/tanstack.md

@@ -57,6 +57,13 @@ history:
 
 Другой аспект — это опыт разработчика: то, как вы объявляете контент, типы, организацию пространств имен, динамическую загрузку и реактивность при смене локали.
 
+## TL;DR
+
+- **Intlayer**: Обеспечивает лучшую производительность и наименьший размер бандла (v8.7.12) для TanStack Start.
+- **react-i18next** и **use-intl**: Зрелые альтернативы с большими экосистемами, но значительно тяжелее и сложнее в оптимизации.
+- **Paraglide**: Инновационная идея tree-shaking, которая не работает на практике. Сложный DX и накладные расходы на реактивность в TanStack Start.
+- **Избегайте**: **General Translation (GT)** и **Lingo.dev** из-за серьезных проблем с производительностью, лимитов AI и привязки к вендору (vendor lock-in).
+
 ## Проверьте свое приложение
 
 Чтобы быстро выявить проблемы с утечкой i18n, я настроил бесплатный сканер, доступный [здесь](https://intlayer.org/i18n-seo-scanner).
@@ -87,12 +94,12 @@ history:
 Для этого бенчмарка мы сравнили следующие библиотеки:
 
 - `Base App` (Без библиотеки i18n)
-- `react-intlayer` (v8.7.5-canary.0)
+- `react-intlayer` (v8.7.12)
 - `react-i18next` (v17.0.2)
 - `use-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
 - `@inlang/paraglide-js` (v2.15.1)
-- `tolgee` (v7.0.0)
+- `@tolgee/react` (v7.0.0)
 - `react-intl` (v10.1.1)
 - `wuchale` (v0.22.11)
 - `gt-react` (vlatest)
@@ -150,7 +157,9 @@ history:
 
 `Paraglide` предлагает инновационный, хорошо продуманный подход. Тем не менее, в этом бенчмарке обещанный tree-shaking не сработал ни для моей реализации на Next.js, ни для TanStack Start. Процесс работы и DX также сложнее, чем у других вариантов. Лично я не в восторге от необходимости перегенерировать JS-файлы перед каждым пушем, что создает постоянный риск конфликтов при слиянии в PR.
 
-**(Tolgee)** (`tolgee@7.0.0`):
+> Примечание о paraglide: решение внедряет код в вашу кодовую базу для импорта, в результате чего метрика 'размер библиотеки' в отчете бенчмарка практически равна 0. Генерация кода — это хорошо, потому что используемая функция будет включать только необходимую логику (полный префикс против отсутствия префикса, куки против хранилища и т. д.). Для сравнения, Intlayer выполняет эту фильтрацию с помощью внедрения переменных окружения в сборку, чтобы заставить бандлер выполнять tree-shaking контента в зависимости от логики. Благодаря этому paraglide и intlayer в итоге оказываются в 6-10 раз легче, чем i18next или next-intl.
+
+**(Tolgee)** (`@tolgee/react@7.0.0`):
 
 `Tolgee` решает многие из упомянутых ранее проблем. Мне показалось, что начать работу с ним сложнее, чем с другими инструментами с похожими подходами. Он не обеспечивает типобезопасность, что значительно затрудняет отлов отсутствующих ключей на этапе компиляции. Мне пришлось обернуть API Tolgee своими собственными, чтобы добавить обнаружение отсутствующих ключей.
 

package/docs/ru/benchmark/vue.md

@@ -0,0 +1,160 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Лучшее i18n решение для Vue в 2026 году - Отчет о бенчмарке
+description: Сравните библиотеки интернационализации (i18n) для Vue, такие как vue-i18n, fluent-vue и Intlayer. Подробный отчет о производительности, размере бандла, утечках и реактивности.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - vue
+  - производительность
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - vue
+author: Aymeric PINEAU
+applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
+history:
+  - version: 8.7.12
+    date: 2026-01-06
+    changes: "Инициализация бенчмарка"
+---
+
+# Библиотеки i18n для Vue — Отчет о бенчмарке 2026
+
+Эта страница представляет собой отчет о бенчмарке i18n-решений для Vue.
+
+## Содержание
+
+<Toc/>
+
+## Интерактивный бенчмарк
+
+<I18nBenchmark framework="vite-vue" vertical/>
+
+## Ссылка на результаты:
+
+<iframe 
+  src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md" 
+  width="100%" 
+  height="600px"
+  style="border:none;">
+</iframe>
+
+> https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vite_vue.md
+
+Полный репозиторий бенчмарка можно найти [здесь](https://github.com/intlayer-org/benchmark-i18n/tree/main).
+
+## Введение
+
+Решения для интернационализации являются одними из самых тяжелых зависимостей во Vue-приложении. Основной риск заключается в передаче ненужного контента: переводов для других страниц и других локалей в бандле одного маршрута.
+
+По мере роста вашего приложения эта проблема может быстро привести к раздуванию JavaScript, отправляемого клиенту, и замедлению навигации.
+
+На практике в наименее оптимизированных реализациях интернационализированная страница может оказаться в несколько раз тяжелее версии без i18n.
+
+Другой аспект — это опыт разработчика: то, как вы объявляете контент, типы, организацию пространств имен, динамическую загрузку и реактивность при смене локали.
+
+## TL;DR
+
+- **Intlayer**: Самое легкое решение (v8.7.12) со встроенным разделением (scoping) и динамической загрузкой.
+- **vue-i18n**: Индустриальный стандарт с богатой экосистемой, но может быть значительно тяжелее и сложнее в оптимизации для разделения кода в больших приложениях.
+- **fluent-vue**: Инновационная организация сообщений, но не хватает типобезопасности и является чрезвычайно тяжелым решением.
+
+## Проверьте свое приложение
+
+Чтобы быстро выявить проблемы с утечкой i18n, я настроил бесплатный сканер, доступный [здесь](https://intlayer.org/i18n-seo-scanner).
+
+<iframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Проблема
+
+Два рычага необходимы для ограничения стоимости мультиязычного приложения:
+
+- Разделение контента по страницам / пространствам имен, чтобы не загружать целые словари, когда они вам не нужны.
+- Динамическая загрузка нужной локали только тогда, когда она требуется.
+
+Понимание технических ограничений этих подходов:
+
+**Динамическая загрузка**
+
+Без динамической загрузки большинство решений хранят сообщения в памяти с первого рендеринга, что создает значительные накладные расходы для приложений с множеством маршрутов и локалей.
+
+При использовании динамической загрузки вы идете на компромисс: меньше начального JS, но иногда дополнительный запрос при переключении языка.
+
+**Разделение контента**
+
+Синтаксис, построенный вокруг `const { t } = useI18n()` + `t('a.b.c')`, очень удобен, но часто способствует хранению больших JSON-объектов во время выполнения. Эта модель затрудняет tree-shaking, если библиотека не предлагает реальную стратегию разделения контента для каждой страницы.
+
+## Методология
+
+Для этого бенчмарка мы сравнили следующие библиотеки:
+
+- `Base App` (Без библиотеки i18n)
+- `vue-intlayer` (v8.7.12)
+- `vue-i18n` (v11.4.0)
+- `fluent-vue` (v3.8.2)
+
+Фреймворк — `Vue` с мультиязычным приложением из **10 страниц** и **10 языков**.
+
+Мы сравнили **четыре стратегии загрузки**:
+
+| Стратегия                 | Без пространств имен (глобальная)               | С пространствами имен (локальная/scoped)                                         |
+| :------------------------ | :---------------------------------------------- | :------------------------------------------------------------------------------- |
+| **Статическая загрузка**  | **Static**: Все в памяти при запуске.           | **Scoped static**: Разделено по пространствам имен; все загружается при запуске. |
+| **Динамическая загрузка** | **Dynamic**: Загрузка по требованию для локали. | **Scoped dynamic**: Гранулярная загрузка по пространствам имен и локалям.        |
+
+## Резюме стратегий
+
+- **Статическая (Static)**: Простота; отсутствие задержек сети после начальной загрузки. Минус: большой размер бандла.
+- **Динамическая (Dynamic)**: Уменьшает начальный вес (ленивая загрузка). Идеально при наличии множества локалей.
+- **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
+- **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
+
+### Что я вимірював:
+
+Я запускал одно и то же мультиязычное приложение в реальном браузере для каждого стека, а затем фиксировал, что на самом деле передавалось по сети и сколько времени это занимало. Размеры указаны **после обычного веб-сжатия**, так как это ближе к тому, что люди реально скачивают.
+
+- **Размер библиотеки интернационализации**: После сборки, tree-shaking и минификации, размер библиотеки i18n — это размер кода провайдеров + композиблов (composables) в пустом компоненте. Это не включает загрузку файлов перевода. Это показывает, насколько "дорогая" библиотека еще до появления вашего контента.
+
+- **JavaScript на страницу**: Для каждого тестового маршрута — сколько скриптов загружает браузер во время посещения, усреднено по страницам теста (и по локалям). Тяжелые страницы — это медленные страницы.
+
+- **Утечка из других локалей (Leakage)**: Это контент той же страницы, но на другом языке, который по ошибке загружается на проверяемую страницу. Этот контент является лишним и его следует избегать (например, контент страницы `/fr/about` в бандле страницы `/en/about`).
+
+- **Утечка из других маршрутов**: Та же идея для **других экранов** в приложении: передаются ли их тексты, когда вы открыли только одну страницу (например, контент страницы `/en/about` в бандле страницы `/en/contact`). Высокий показатель свидетельствует о слабом разделении или слишком широких бандлах.
+
+- **Средний размер бандла компонента**: Отдельные UI-элементы измеряются **по одному**, а не прячутся внутри одного гигантского общего показателя приложения. Это показывает, "раздувает" ли интернационализация обычные компоненты. Например, если ваш компонент перерендерится, он будет загружать все эти данные из памяти. Привязка гигантского JSON к любому компоненту похожа на подключение большого хранилища неиспользуемых данных, что замедляет производительность ваших компонентов.
+
+- **Скорость реакции на переключение языка**: Я переключаю язык через собственный интерфейс приложения и замеряю время до момента, когда страница явно обновилась — то, что заметит посетитель.
+
+- **Работа рендеринга после смены языка**: Более узкий показатель: сколько усилий затратил интерфейс на перерисовку для нового языка после начала переключения. Полезно, когда "ощутимое" время и стоимость работы фреймворка различаются.
+
+- **Время начальной загрузки страницы**: От навигации до момента, когда браузер считает страницу полностью загруженной для тестируемых сценариев. Полезно для сравнения "холодных стартов".
+
+- **Время гидратации (Hydration)**: Время, которое клиент тратит на превращение HTML от сервера в интерактивный интерфейс. Прочерк в таблицах означает, что данная реализация не предоставила надежных данных о гидратации в этом тесте.
+
+## Результаты в деталях
+
+### 1 — Решения, которых следует избегать
+
+> В экосистеме Vue нет однозначных решений, которых следует избегать.
+
+### 2 — Приемлемые решения
+
+**(vue-i18n)** (`vue-i18n@11.4.0`):
+
+- **vue-i18n**, без сомнения, является самой используемой i18n-библиотекой для Vue, у нее много функций и огромная экосистема. Однако внутри это решение довольно тяжелое. Даже если vue-i18n интегрирует ленивую загрузку сообщений, в нем отсутствует функция разделения (scoping). В случае классического Vue SPA приложения это не проблема, но для приложения Nuxt, использующего @nuxt/i18n, это приводит к включению сообщений со всех страниц в одну. Для большого приложения Nuxt, включающего более 10 страниц, это может стать действительно проблематичным.
+
+Пакет очень тяжелый (~24.3 КБ, что примерно в 9 раз больше `vue-intlayer`).
+
+**(fluent-vue)** (`fluent-vue@0.5.0`):
+
+- **fluent-vue** предлагает попытку инновации через формат .ftl. Организация сообщений отличная, с ней легче начать работу. Но на практике отсутствие типобезопасности повышает риск ошибок и может быстро стать трудозатратным при отладке. Более того, это решение загружает сообщения с помощью плагина vite, который принудительно загружает весь контент на всех языках в каждую страницу. Кроме того, это чрезвычайно тяжелое решение (~92.7 КБ, что примерно в 34 раза больше `vue-intlayer`).
+
+### 3 — Рекомендации
+
+**(Intlayer)** (`vue-intlayer@8.7.12`):
+
+Я не буду лично оценивать `vue-intlayer` ради объективности, так как это мое собственное решение.

package/docs/ru/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-04-08
+updatedAt: 2026-05-12
 title: Конфигурация (Configuration)
 description: Узнайте, как настроить Intlayer для вашего приложения. Разберитесь в различных параметрах и опциях, доступных для настройки Intlayer в соответствии с вашими потребностями.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.9.4
+    date: 2026-05-12
+    changes: "Добавлена поддержка провайдера LM Studio"
   - version: 8.7.0
     date: 2026-04-08
     changes: "Добавлены опции `prune` и `minify` в конфигурацию сборки"
@@ -350,7 +353,7 @@ const config: IntlayerConfig = {
   ai: {
     /**
      * Используемый ИИ-провайдер.
-     * Опции: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai'
+     * Опции: 'openai', 'anthropic', 'mistral', 'deepseek', 'gemini', 'ollama', 'openrouter', 'alibaba', 'fireworks', 'groq', 'huggingface', 'bedrock', 'googlevertex', 'togetherai', 'lmstudio'
      * По умолчанию: 'openai'
      */
     provider: "openai",
@@ -916,16 +919,17 @@ Intlayer поддерживает несколько ИИ-провайдеров
 - **Groq**
 - **Amazon Bedrock**
 - **Together.ai**
-
-| Поле                 | Описание                                                                                                                                      | Тип                                                                                                                                                                                                                                                                                                                                                                                            | По умолчанию | Пример                                                        | Примечание                                                                                                                                                                                                  |
-| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | Провайдер, используемый для ИИ-функций Intlayer.                                                                                              | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` | `undefined`  | `'anthropic'`                                                 | Разные провайдеры требуют разные API-ключи и имеют разную стоимость.                                                                                                                                        |
-| `model`              | Модель, используемая для ИИ-функций.                                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Нет          | `'gpt-4o-2024-11-20'`                                         | Конкретная модель зависит от провайдера.                                                                                                                                                                    |
-| `temperature`        | Управляет случайностью ответов ИИ.                                                                                                            | `number`                                                                                                                                                                                                                                                                                                                                                                                       | Нет          | `0.1`                                                         | Выше температура = более креативно и менее предсказуемо.                                                                                                                                                    |
-| `apiKey`             | Ваш API-ключ для выбранного провайдера.                                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Нет          | `process.env.OPENAI_API_KEY`                                  | Должно храниться в секрете; используйте переменные окружения.                                                                                                                                               |
-| `applicationContext` | Дополнительный контекст о вашем приложении, чтобы помочь ИИ генерировать более точные переводы (домен, целевая аудитория, тон, терминология). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Нет          | `'My own application context'`                                | Можно использовать для добавления правил (например: `"You should not transform URLs"`).                                                                                                                     |
-| `baseURL`            | Базовый URL для ИИ API.                                                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                       | Нет          | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Может указывать на локальный или кастомный эндпоинт ИИ API.                                                                                                                                                 |
-| `dataSerialization`  | Формат сериализации данных для ИИ-функций.                                                                                                    | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined`  | `'toon'`                                                      | • `'json'`: по умолчанию, надежно; потребляет больше токенов.<br/>• `'toon'`: меньше токенов, менее стабильно.<br/>• Дополнительные параметры передаются в модель как контекст (усилия рассуждения и т.д.). |
+- **LM Studio**
+
+| Поле                 | Описание                                                                                                                                      | Тип                                                                                                                                                                                                                                                                                                                                                                                                                      | По умолчанию | Пример                                                        | Примечание                                                                                                                                                                                                  |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | Провайдер, используемый для ИИ-функций Intlayer.                                                                                              | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` &#124; <br/> `'lmstudio'` | `undefined`  | `'anthropic'`                                                 | Разные провайдеры требуют разные API-ключи и имеют разную стоимость.                                                                                                                                        |
+| `model`              | Модель, используемая для ИИ-функций.                                                                                                          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Нет          | `'gpt-4o-2024-11-20'`                                         | Конкретная модель зависит от провайдера.                                                                                                                                                                    |
+| `temperature`        | Управляет случайностью ответов ИИ.                                                                                                            | `number`                                                                                                                                                                                                                                                                                                                                                                                                                 | Нет          | `0.1`                                                         | Выше температура = более креативно и менее предсказуемо.                                                                                                                                                    |
+| `apiKey`             | Ваш API-ключ для выбранного провайдера.                                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Нет          | `process.env.OPENAI_API_KEY`                                  | Должно храниться в секрете; используйте переменные окружения.                                                                                                                                               |
+| `applicationContext` | Дополнительный контекст о вашем приложении, чтобы помочь ИИ генерировать более точные переводы (домен, целевая аудитория, тон, терминология). | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Нет          | `'My own application context'`                                | Можно использовать для добавления правил (например: `"You should not transform URLs"`).                                                                                                                     |
+| `baseURL`            | Базовый URL для ИИ API.                                                                                                                       | `string`                                                                                                                                                                                                                                                                                                                                                                                                                 | Нет          | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | Может указывать на локальный или кастомный эндпоинт ИИ API.                                                                                                                                                 |
+| `dataSerialization`  | Формат сериализации данных для ИИ-функций.                                                                                                    | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                                           | `undefined`  | `'toon'`                                                      | • `'json'`: по умолчанию, надежно; потребляет больше токенов.<br/>• `'toon'`: меньше токенов, менее стабильно.<br/>• Дополнительные параметры передаются в модель как контекст (усилия рассуждения и т.д.). |
 
 ---
 

package/docs/ru/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: Файл контента
 description: Узнайте, как настраивать расширения для ваших файлов декларации контента. Следуйте этой документации, чтобы эффективно реализовывать условия в вашем проекте.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Добавить тип узла содержимого `plural`"
   - version: 8.0.0
     date: 2026-01-28
     changes: "Добавлен тип узла содержимого `html`"
@@ -66,6 +69,7 @@ import { type ReactNode } from "react";
 import {
   t,
   enu,
+  plural,
   cond,
   nest,
   md,
@@ -84,7 +88,8 @@ interface Content {
     };
   };
   multilingualContent: string; // мультиязычный контент
-  quantityContent: string; // контент с количеством
+  quantityContent: string;
+  pluralContent: string; // контент с количеством
   conditionalContent: string; // условный контент
   markdownContent: never; // markdown контент (никогда не используется)
   htmlContent: never; // HTML контент
@@ -121,6 +126,10 @@ export default {
       ">5": "Несколько машин",
       ">19": "Много машин",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "Валидация включена",
       false: "Валидация отключена",
@@ -175,6 +184,13 @@ export default {
         ">5": "Некоторые машины",
         ">19": "Много машин",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condition",
@@ -222,6 +238,7 @@ export default {
 - **Примитивные значения**: строки, числа, булевы значения, null, undefined
 - **Типизированные узлы**: специальные типы содержимого, такие как переводы, условия, markdown и т.д.
 - **Функции**: динамическое содержимое, которое может быть вычислено во время выполнения [см. Получение функций](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/function_fetching.md)
+- **Множественное число**: См. Множественное число [См. Множественное число](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/plural.md)
 - **Вложенное содержимое**: ссылки на другие словари
 
 #### Типы содержимого
@@ -567,6 +584,8 @@ multilingualContent: t({
 });
 ```
 
+> См. [Переводимый контент (`t`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/translation.md) для получения дополнительной информации.
+
 ### Условный контент (`cond`)
 
 Контент, который меняется в зависимости от булевых условий:
@@ -580,6 +599,8 @@ conditionalContent: cond({
 });
 ```
 
+> См. [Условный контент (`cond`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/condition.md) для получения дополнительной информации.
+
 ### Перечисляемый контент (`enu`)
 
 Контент, который меняется в зависимости от перечисленных значений:
@@ -594,6 +615,23 @@ statusContent: enu({
 });
 ```
 
+> См. [Перечисляемый контент (`enu`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/enumeration.md) для получения дополнительной информации.
+
+### Множественное число (`plural`)
+
+Контент, который варьируется в зависимости от правил множественного числа:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> См. [Множественное число документацию](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/plural.md) для получения дополнительной информации.
+
 ### Вставляемый контент (`insert`)
 
 Контент, который можно вставлять в другой контент:
@@ -604,6 +642,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Этот текст можно вставить куда угодно");
 ```
 
+> См. [Вставляемый контент (`insert`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/insertion.md) для получения дополнительной информации.
+
 ### Вложенный контент (`nest`)
 
 Ссылки на другие словари:
@@ -614,6 +654,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> См. [Вложенный контент (`nest`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/nesting.md) для получения дополнительной информации.
+
 ### Контент в формате Markdown (`md`)
 
 Форматированный текст в формате Markdown:
@@ -626,6 +668,8 @@ markdownContent: md(
 );
 ```
 
+> См. [Контент в формате Markdown (`md`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/markdown.md) для получения дополнительной информации.
+
 ### HTML-контент (`html`)
 
 Богатый HTML-контент, который может использовать стандартные теги или пользовательские компоненты:
@@ -643,6 +687,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> См. [HTML-контент (`html`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/html.md) для получения дополнительной информации.
+
 ### Контент по половому признаку (`gender`)
 
 Контент, который меняется в зависимости от пола:
@@ -657,6 +703,8 @@ genderContent: gender({
 });
 ```
 
+> См. [Контент по половому признаку (`gender`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/gender.md) для получения дополнительной информации.
+
 ### Контент из файла (`file`)
 
 Ссылки на внешние файлы:
@@ -667,6 +715,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> См. [Контент из файла (`file`) Документация](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/dictionary/file.md) для получения дополнительной информации.
+
 ## Создание файлов контента
 
 ### Основная структура файла контента