@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/ru/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с NGX-Translate на Intlayer"
+description: "Узнайте, как перенести ваше приложение Angular с ngx-translate на Intlayer, используя адаптер совместимости."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с NGX-Translate на Intlayer
+
+Миграция вашего приложения Angular с `ngx-translate` на Intlayer легко с адаптером совместимости, позволяя вам избежать необходимости переписывать все ваши шаблоны.
+
+## Что делать
+
+Начните с запуска:
+
+```bash
+npx intlayer init
+```
+
+Это устанавливает `intlayer.config.ts`. Замените ваши параметры `TranslateModule.forRoot()` и импортируйте псевдонимы должным образом, чтобы они указывали на `@intlayer/ngx-translate`.
+
+## Что происходит под капотом
+
+`ngx-translate` использует `TranslateService` (`instant`, `get`, `stream`) вместе с трубой `{{ 'KEY' | translate:params }}` и директивой `[translate]`.
+
+Под капотом:
+
+- **Services:** `TranslateService` оборачивает `getIntlayer` и наблюдаемую локаль, предоставляя точно те же методы.
+- **Pipes и директивы:** Переимплементированы для прямого разрешения в словарях Intlayer.
+- **Loaders:** Параметры `TranslateHttpLoader` преобразуются в предупреждающие заглушки, потому что Intlayer по своей природе разрешает и объединяет ваши словари во время сборки (или через стандартные динамические импорты), полностью исключая необходимость в HTTP-загрузчиках.

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

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Миграция с NuxtJS I18n на Intlayer"
+description: "Узнайте, как перенести ваше приложение Nuxt.js с @nuxtjs/i18n на Intlayer, используя адаптер совместимости."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - миграция
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Инициализация истории"
+author: aymericzip
+---
+
+# Миграция с NuxtJS I18n на Intlayer
+
+Миграция вашего приложения Nuxt с `@nuxtjs/i18n` на Intlayer - это бесшовный процесс с использованием модуля Nuxt adapter.
+
+## Что делать
+
+Чтобы инициализировать проект, запустите:
+
+```bash
+npx intlayer init
+```
+
+Это установит `intlayer.config.ts`. Затем добавьте модуль Intlayer Nuxt (например, `@intlayer/nuxt-i18n`) в массив модулей вашего `nuxt.config.ts`. Это автоматически применяет конфигурацию совместимости для вашего приложения.
+
+## Что происходит под капотом
+
+`@nuxtjs/i18n` оборачивает `vue-i18n` при этом предоставляя composables, специфичные для Nuxt (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Под капотом:
+
+- **Переводы:** Изначально полагается на слой совместимости `@intlayer/vue-i18n` для всех задач перевода строк (полностью поддерживая форматы `vue-i18n`, плюральные трубы и реактивность).
+- **Маршрутизация:** Отражает composables маршрутизации, используя помощников локализованного URL Intlayer.
+- **Конфигурация:** Читает `availableLocales` и параметры по умолчанию прямо из вашего `intlayer.config.ts` для автоматической координации страниц Nuxt.

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:
@@ -29,6 +29,7 @@ history:
   - version: 7.3.1
     date: 2025-11-27
     changes: "Выпуск Compiler"
+author: aymericzip
 ---
 
 # Intlayer Compiler | Автоматизированное извлечение контента для i18n
@@ -59,6 +60,8 @@ history:
 
 ## Использование
 
+> 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'>
 
@@ -78,12 +81,15 @@ npm install vite-intlayer
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Добавляет плагин компилятора
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/ru/component_i18n.md

@@ -16,6 +16,7 @@ slugs:
   - i18n
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
+author: aymericzip
 ---
 
 # Как сделать компонент многоязычным (i18n) с Intlayer

package/docs/ru/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-23
 title: Конфигурация (Configuration)
 description: Узнайте, как настроить Intlayer для вашего приложения. Разберитесь в различных параметрах и опциях, доступных для настройки Intlayer в соответствии с вашими потребностями.
 keywords:
@@ -14,6 +14,12 @@ 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` в конфигурацию словаря"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Добавлена поддержка провайдера LM Studio"
@@ -98,6 +104,7 @@ history:
   - version: 5.5.11
     date: 2025-06-29
     changes: "Добавлены команды `docs`"
+author: aymericzip
 ---
 
 # Документация по конфигурации Intlayer
@@ -134,6 +141,7 @@ Intlayer принимает форматы файлов конфигурации
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -581,10 +589,38 @@ const config: IntlayerConfig = {
     }),
   },
 
+  /**
+   * Конфигурация словаря.
+   */
+  dictionary: {
+    /**
+     * Управляет способом импорта словарей.
+     * - "static": Статически импортируется во время сборки.
+     * - "dynamic": Динамически импортируется с помощью Suspense.
+     * - "fetch": Динамически загружается через API живой синхронизации.
+     */
+    importMode: "static",
+
+    /**
+     * Формат сообщений по умолчанию для всех словарей в проекте.
+     * - 'intlayer': Собственный формат intlayer (по умолчанию).
+     * - 'icu': Формат сообщений ICU.
+     * - 'i18next': Формат i18next.
+     * - 'vue-i18n': Формат Vue I18n.
+     * - 'po': Формат GNU Gettext PO.
+     */
+    format: "icu",
+  },
+
   /**
    * Конфигурация плагинов.
    */
-  plugins: [],
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -849,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)
 
 Параметры, управляющие операциями со словарями, включая поведение автоматического заполнения и генерацию контента.
@@ -861,6 +912,7 @@ export default config;
 | `contentAutoTransformation` | Автоматически преобразует строки контента в типизированные узлы (markdown, HTML или вставка).                                                            | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`        | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`.<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')`.<br/>• Вставка : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                      |
 | `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` и т.д.       |
+| `format`                    | Формат сообщений по умолчанию для всех словарей в проекте.                                                                                               | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'`   | `'icu'`                                                                                     | • `'intlayer'`: Собственный формат intlayer.<br/>• `'icu'`: Формат сообщений ICU.<br/>• `'i18next'`: Формат i18next.<br/>• `'vue-i18n'`: Формат Vue I18n.<br/>• `'po'`: Формат GNU Gettext PO.                                                                                                                                                                                                  |
 | `priority`                  | Приоритет словаря. Более высокие значения побеждают более низкие при разрешении конфликтов между словарями.                                              | `number`                                                                                                        | `undefined`    | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `live`                      | Устарело - используйте `importMode: 'fetch'`. Указывало, должен ли контент словаря получаться динамически через Live Sync API.                           | `boolean`                                                                                                       | `undefined`    |                                                                                             | Переименовано в `importMode: 'fetch'` в v8.0.0.                                                                                                                                                                                                                                                                                                                                                 |
 | `schema`                    | Генерируется автоматически Intlayer для валидации JSON-схемы.                                                                                            | `'https://intlayer.org/schema.json'`                                                                            | авто-генерация |                                                                                             | Не редактируйте вручную.                                                                                                                                                                                                                                                                                                                                                                        |
@@ -956,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:
@@ -17,6 +17,7 @@ history:
   - version: 8.5.0
     date: 2026-04-02
     changes: "Добавлена маршрутизация локалей на основе доменов через конфигурацию routing.domains."
+author: aymericzip
 ---
 
 # Пользовательские домены
@@ -171,10 +172,16 @@ GET intlayer.zh/about
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```