@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.20

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'>
 
@@ -79,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/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: Конфигурация (Configuration)
 description: Узнайте, как настроить Intlayer для вашего приложения. Разберитесь в различных параметрах и опциях, доступных для настройки Intlayer в соответствии с вашими потребностями.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Добавлена конфигурация `analytics`"
+  - 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` в конфигурацию словаря"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Конфигурация аналитики (analytics).
+   */
+  analytics: {
+    /**
+     * Включён ли сбор аналитики (просмотры страниц, показы контента, события A/B).
+     * Требует, чтобы был задан `editor.clientId` для атрибуции.
+     * По умолчанию: false
+     */
+    enabled: true,
+
+    /**
+     * Миллисекунды между автоматическими пакетными отправками на бэкенд.
+     * По умолчанию: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Доля сессий для записи, от 0 (ни одной) до 1 (все).
+     * По умолчанию: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Настройки переводов и генерации с помощью ИИ.
    */
@@ -665,6 +695,20 @@ export default config;
 
 ---
 
+### Конфигурация аналитики (Analytics)
+
+Определяет настройки, связанные с аналитикой Intlayer: сбор данных о том, какой контент действительно показывается пользователям (просмотры страниц, показы контента), и поддержку A/B-тестирования контента.
+
+Аналитика строго опциональна (opt-in): ничего не собирается, если `analytics.enabled` явно не установлен в `true` **и** не настроен ключ проекта (`editor.clientId`) для атрибуции. При отключении (по умолчанию) вся интеграция аналитики удаляется из сборки вашего приложения (dead-code elimination).
+
+| Поле            | Описание                                                                   | Тип       | По умолчанию | Пример  | Примечание                                                                                                                        |
+| --------------- | -------------------------------------------------------------------------- | --------- | ------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Включает сбор аналитики (просмотры страниц, показы контента, события A/B). | `boolean` | `false`      | `true`  | Требует, чтобы был задан `editor.clientId` для атрибуции; иначе аналитика остаётся отключённой, даже если `enabled` равно `true`. |
+| `flushInterval` | Миллисекунды между автоматическими пакетными отправками на бэкенд.         | `number`  | `20000`      | `10000` |                                                                                                                                   |
+| `sampleRate`    | Доля сессий для записи, от `0` (ни одной) до `1` (все).                    | `number`  | `1`          | `0.5`   | Выборка детерминирована для каждой сессии, поэтому записанная сессия сообщает обо всех своих событиях (без частичных воронок).    |
+
+---
+
 ### Конфигурация маршрутизации (Routing)
 
 Настройки, управляющие поведением маршрутизации, включая структуру URL, хранение языков и управление middleware.
@@ -882,6 +926,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 +1049,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:
@@ -172,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"),
+      },
+    }),
+  ],
 });
 ```
 

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:
@@ -340,10 +340,16 @@ export function middleware(request: NextRequest) {
 
 ```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"),
+      },
+    }),
+  ],
 });
 ```
 

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 предоставляет несколько специализированных типов узлов контента, которые расширяют базовые примитивные значения: