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

package/docs/ru/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с Polyglot.js на Intlayer"
+description: "Узнайте, как перейти с Polyglot.js на Intlayer, используя адаптер совместимости."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с Polyglot.js на Intlayer
+
+Если вы используете Polyglot.js от Airbnb, миграция на Intlayer чрезвычайно проста, используя слой совместимости.
+
+## Что делать
+
+Просто запустите команду инициализации в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Это генерирует `intlayer.config.ts`. Вы можете затем использовать псевдоним плагина bundler для прозрачного перенаправления импортов Polyglot на `@intlayer/polyglot`.
+
+## Что происходит под капотом
+
+Синтаксис Polyglot.js обычно полагается на `polyglot.t('key', {name})` с интерполяциями `%{name}` и множеством `smart_count`, разделенным на `"singular |||| plural"`.
+
+Под капотом:
+
+- **Интерполяция:** Слой совместимости обрабатывает заполнители `%{var}` изначально.
+- **Множественное число:** Строка расщепляется на `||||` и оценивается в отношении встроенного `Intl.PluralRules` в соответствии с активной локалью, отражая собственный порядок bucket Polyglot в каждой локали.
+- **Словари:** Вы обходитесь без необходимости предоставления огромных конфигураций JSON для `new Polyglot()` – Intlayer обрабатывает словари динамически и обрезает их автоматически.

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

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

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

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

package/docs/ru/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с Svelte I18n на Intlayer"
+description: "Узнайте, как перенести ваше приложение Svelte с svelte-i18n на Intlayer, используя адаптер совместимости."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с Svelte I18n на Intlayer
+
+Переместить ваше приложение Svelte с `svelte-i18n` на Intlayer занимает всего минуту, используя адаптер совместимости.
+
+## Что делать
+
+Просто запустите команду инициализации в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Это генерирует `intlayer.config.ts`. Убедитесь, что ваши плагины SvelteKit / Vite обернуты плагином alias Intlayer для бесшовного сопоставления `svelte-i18n` с `@intlayer/svelte-i18n`.
+
+## Что происходит под капотом
+
+Svelte-i18n полагается на интенсивно используемые хранилища (`$_`, `$t`, `$format` и т. д.) и ICU MessageFormat.
+
+Под капотом:
+
+- **Хранилища:** Intlayer проксирует хранилища `svelte-i18n`. `$_` становится производным хранилищем текущей локали, возвращающей resolver Intlayer.
+- **Ключи:** Ваши плоские ключи (например, `$_('home.title')`) оцениваются таким образом, что первый сегмент пути представляет словарь Intlayer.
+- **Синтаксис ICU:** Полностью обрабатывается общим resolver ICU (парсинг, эквивалентный `intl-messageformat`).
+- **Форматеры:** Вызовы `$date`, `$time`, `$number` безопасно перенаправляются на встроенные форматеры Intlayer core.
+- **Анализ Babel/SWC:** Анализатор Intlayer читает вызовы хранилища Svelte (`$_`) внутри ваших исходных файлов `.svelte` перед компиляцией, чтобы автоматически построить релевантные куски словаря.

package/docs/ru/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с Transloco на Intlayer"
+description: "Узнайте, как перенести ваше приложение Angular с Transloco на Intlayer, используя адаптер совместимости."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с Transloco на Intlayer
+
+Если ваше приложение Angular в настоящее время использует `@jsverse/transloco`, вы можете перейти на Intlayer, используя наш адаптер совместимости. Этот переход позволяет вам сохранить существующий синтаксис шаблона, используя мощную структуру словаря Intlayer.
+
+## Что делать
+
+Просто запустите команду инициализации в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Это генерирует необходимую конфигурацию `intlayer.config.ts`. Вы затем замените ваши импорты Transloco модулями `@intlayer/transloco` или полагаетесь на pseudonym сборки.
+
+## Что происходит под капотом
+
+Transloco использует области и `TranslocoService` (`translate`, `selectTranslate`), вместе со структурными директивами (`*transloco="let t"`) и трубами (`| transloco`).
+
+Под капотом:
+
+- **Области:** Естественно сопоставляются с ключами словаря Intlayer, предоставляя отличную историю обрезки для оптимизации bundle.
+- **Сервис и директивы:** Адаптер Intlayer Angular безпроблемно заменяет providers, позволяя существующим трубам шаблона и директивам разрешать строки в словарях Intlayer.
+- **Парсинг времени сборки:** Анализатор TypeScript распознает вызовы `instant/get`, и откат обрезки обеспечивает правильность даже когда использование шаблона не подлежит статическому отслеживанию.

package/docs/ru/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с Vue I18n на Intlayer"
+description: "Узнайте, как перенести ваше приложение Vue с vue-i18n на Intlayer, используя адаптер совместимости."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с Vue I18n на Intlayer
+
+Если ваше приложение Vue в настоящее время использует `vue-i18n`, вы можете перейти на Intlayer без переписывания ваших компонентов или переводов хуков. Intlayer предоставляет адаптер совместимости, который идеально отражает API `vue-i18n`, используя мощные возможности Intlayer под капотом.
+
+## Что делать
+
+Чтобы начать, просто запустите команду инициализации в вашем проекте:
+
+```bash
+npx intlayer init
+```
+
+Во время инициализации Intlayer установит ваш файл конфигурации (`intlayer.config.ts`) и подготовит ваш проект к миграции. Вам нужно будет просто добавить плагин Intlayer в вашу конфигурацию Vite для автоматического создания псевдонима импортов `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Что происходит под капотом
+
+`vueI18nVitePlugin` впрыскивает псевдоним модуля в ваш bundler. Любой импорт `vue-i18n` в вашей кодовой базе будет прозрачно перенаправлен на `@intlayer/vue-i18n`.
+
+**Под капотом адаптер обрабатывает сложный синтаксис `vue-i18n` изначально:**
+
+- **Интерполяция и множественное число:** Разрешает интерполяции `{name}` и список `{0}`. Трубные множественные числа (`"car | cars"`) преобразуются в перечисление/плюральные узлы Intlayer на основе позиционной семантики.
+- **Форматы:** Функции как `d()` и `n()` оборачивают `Intl` под капотом, соблюдая `datetimeFormats` и `numberFormats`, определенные в ваших опциях.
+- **Глобальное и локальное состояние:** `global.locale` отображается на `WritableComputedRef`, поддерживаемый клиентом Intlayer, поэтому реактивность ведет себя точно, как ожидалось (например, `locale.value = 'fr'`).
+- **Директивы:** Директива `v-t` зарегистрирована и функционирует нормально.
+
+Ваше приложение продолжает отображаться точно, как раньше, но контент питается ваши словари Intlayer, давая вам безопасность типов, лучшую оптимизацию bundle и беспрепятственную интеграцию CMS.

package/docs/ru/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer Compiler | Автоматизированное извлечение контента для i18n
 description: Автоматизируйте процесс интернационализации с помощью Intlayer Compiler. Извлекайте контент напрямую из ваших компонентов для более быстрого и эффективного i18n в Vite, Next.js и других.
 keywords:
@@ -60,6 +60,8 @@ author: aymericzip
 
 ## Использование
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 

package/docs/ru/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-06-23
 title: Конфигурация (Configuration)
 description: Узнайте, как настроить Intlayer для вашего приложения. Разберитесь в различных параметрах и опциях, доступных для настройки Intlayer в соответствии с вашими потребностями.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "Добавлена опция `format` в конфигурацию словаря"
@@ -882,6 +885,21 @@ export default config;
 
 ---
 
+### Конфигурация системы
+
+Параметры, связанные с внутренними путями и результатами вывода Intlayer. Эти параметры обычно являются внутренними и не должны требовать изменения пользователем.
+
+| Field                     | Description                                                                                | Type     | Default                           | Example              | Note                                                               |
+| ------------------------- | ------------------------------------------------------------------------------------------ | -------- | --------------------------------- | -------------------- | ------------------------------------------------------------------ |
+| `baseDir`                 | Базовая директория для проекта.                                                            | `string` | `process.cwd()`                   | `'/path/to/project'` | Используется для разрешения всех директорий, связанных с Intlayer. |
+| `dictionariesDir`         | Путь директории для хранения словарей локализации.                                         | `string` | `'.intlayer/dictionary'`          |                      |                                                                    |
+| `moduleAugmentationDir`   | Директория для расширения модулей, обеспечивающая лучшие предложения IDE и проверку типов. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | Убедитесь, что это включено в `tsconfig.json`.                     |
+| `unmergedDictionariesDir` | Директория для хранения неслитых словарей.                                                 | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                                    |
+| `typesDir`                | Директория для хранения типов словарей.                                                    | `string` | `'.intlayer/types'`               |                      |                                                                    |
+| `mainDir`                 | Директория, где хранятся основные файлы приложения.                                        | `string` | `'.intlayer/main'`                |                      |                                                                    |
+| `configDir`               | Директория, где хранятся файлы конфигурации.                                               | `string` | `'.intlayer/config'`              |                      |                                                                    |
+| `cacheDir`                | Директория, где хранятся файлы кеша.                                                       | `string` | `'.intlayer/cache'`               |                      |                                                                    |
+
 ### Конфигурация словарей (Dictionary)
 
 Параметры, управляющие операциями со словарями, включая поведение автоматического заполнения и генерацию контента.
@@ -990,22 +1008,6 @@ Intlayer поддерживает несколько ИИ-провайдеров
 
 ---
 
-### Системная конфигурация (System)
-
-Эти настройки предназначены для продвинутых случаев использования и внутренней конфигурации Intlayer.
-
-| Поле                      | Описание                                         | Тип      | По умолчанию                      | Пример | Примечание |
-| ------------------------- | ------------------------------------------------ | -------- | --------------------------------- | ------ | ---------- |
-| `dictionariesDir`         | Директория для скомпилированных словарей.        | `string` | `'.intlayer/dictionary'`          |        |            |
-| `moduleAugmentationDir`   | Директория для расширения модулей TypeScript.    | `string` | `'.intlayer/types'`               |        |            |
-| `unmergedDictionariesDir` | Директория для хранения неслитых словарей.       | `string` | `'.intlayer/unmerged_dictionary'` |        |            |
-| `typesDir`                | Директория для сгенерированных типов.            | `string` | `'.intlayer/types'`               |        |            |
-| `mainDir`                 | Директория основного файла Intlayer.             | `string` | `'.intlayer/main'`                |        |            |
-| `configDir`               | Директория скомпилированных файлов конфигурации. | `string` | `'.intlayer/config'`              |        |            |
-| `cacheDir`                | Директория файлов кэша.                          | `string` | `'.intlayer/cache'`               |        |            |
-
----
-
 ### Конфигурация компилятора (Compiler)
 
 Настройки, управляющие компилятором Intlayer, который извлекает словари напрямую из ваших компонентов.

package/docs/ru/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: Пользовательские домены
 description: Узнайте, как настроить маршрутизацию локалей на основе доменов в Intlayer для обслуживания различных локалей с выделенных хост-имен.
 keywords:

package/docs/ru/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: Пользовательские перезаписи URL
 description: Узнайте, как настроить и использовать пользовательские перезаписи URL в Intlayer для задания путей, специфичных для локали.
 keywords:

package/docs/ru/dictionary/content_file.md

@@ -332,26 +332,6 @@ Intlayer поддерживает различные типы содержимо
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Указывает форматтер, который будет использоваться для содержимого словаря. Это позволяет использовать различные синтаксисы форматирования сообщений.
-
-- `'intlayer'`: Форматтер Intlayer по умолчанию.
-- `'icu'`: Использует форматирование сообщений ICU.
-- `'i18next'`: Использует форматирование сообщений i18next.
-
-**Пример:**
-
-```typescript
-{
-  key: "my-dictionary",
-  format: "icu",
-  content: {
-    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
-  }
-}
-```
-
-#### `format` ('intlayer' | 'icu' | 'i18next')
-
 Указывает форматтер для использования содержимого словаря. Это позволяет использовать различные синтаксисы форматирования сообщений.
 
 - `'intlayer'`: Форматтер Intlayer по умолчанию.
@@ -602,6 +582,10 @@ JSON-схема, используемая для валидации структ
 
 Для удалённых словарей это уникальный идентификатор словаря на удалённом сервере. Используется для получения и управления удалённым контентом.
 
+##### `projectIds` (string[])
+
+Для удалённых словарей этот массив содержит идентификаторы проектов, которые могут использовать этот словарь. Удалённый словарь может быть общим для нескольких проектов.
+
 ##### `localId` (LocalDictionaryId)
 
 Уникальный идентификатор для локальных словарей. Автоматически генерируется Intlayer для помощи в идентификации словаря и определения, является ли он локальным или удалённым, а также его расположения.
@@ -622,13 +606,6 @@ JSON-схема, используемая для валидации структ
 
 Указывает, был ли словарь автоматически заполнен из внешних источников. В случае конфликтов базовые словари имеют приоритет над автоматически заполненными.
 
-##### `location` ('distant' | 'locale')
-
-Указывает расположение словаря:
-
-- `'locale'`: Локальный словарь (из файлов контента)
-- `'distant'`: Удалённый словарь (из внешнего источника)
-
 ## Типы узлов контента
 
 Intlayer предоставляет несколько специализированных типов узлов контента, которые расширяют базовые примитивные значения: