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

package/docs/ru/intlayer_with_vite+svelte.md

@@ -460,7 +460,7 @@ $: content = useIntlayer('app', locale);
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
   plugins: [intlayerProxy(), // should be placed first
  svelte(), intlayer()],
@@ -570,6 +570,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Компилятор Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Обновите ваш `vite.config.ts`, чтобы включить плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -579,7 +581,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Добавляет плагин компилятора
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ru/intlayer_with_vite+vanilla.md

@@ -205,7 +205,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -466,12 +472,15 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // должен быть первым
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -603,6 +612,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Компилятор Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Обновите `vite.config.ts`, включив плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -612,7 +623,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Добавляет плагин компилятора
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ru/intlayer_with_vite+vue.md

@@ -634,14 +634,17 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue"; // Импорт п
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -966,6 +969,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Компилятор Babel'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 Обновите ваш `vite.config.ts`, чтобы включить плагин `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -975,7 +980,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Добавляет плагин компилятора
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/ru/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Документация пакета @intlayer/babel"
+description: Плагины Babel для Intlayer, управляющие извлечением содержимого, оптимизацией импорта, удалением неиспользуемых полей и сокрытием имен полей во время сборки.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - интернационализация
+  - i18n
+  - компилятор
+  - оптимизация
+  - очистка
+  - минимизация
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Объединение документации по всем экспортируемым модулям"
+author: aymericzip
+---
+
+# Пакет @intlayer/babel
+
+Пакет `@intlayer/babel` предоставляет набор специализированных плагинов Babel для Intlayer. Эти плагины охватывают весь цикл сборки: извлечение объявлений контента, перезапись вызовов `useIntlayer` / `getIntlayer` в оптимизированный импорт словарей, удаление неиспользуемых полей и минимизация имен полей.
+
+## Установка
+
+```bash
+npm install @intlayer/babel
+```
+
+## Экспортируемые модули
+
+Импорт:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Плагины
+
+| Функция / Класс                | Описание                                                                                                                                                                                                           |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `intlayerExtractBabelPlugin`   | Плагин Babel, который извлекает переводимый контент из исходных файлов и автоматически внедряет хуки `useIntlayer` / `getIntlayer`. Разработан для использования с Next.js и инструментами сборки на базе Babel.   |
+| `intlayerOptimizeBabelPlugin`  | Плагин Babel, который преобразует вызовы `useIntlayer` и `getIntlayer` и перезаписывает их импорт в оптимизированный импорт JSON-словарей (статический, динамический или через fetch).                             |
+| `intlayerPurgeBabelPlugin`     | Плагин Babel, который анализирует исходные файлы и перезаписывает скомпилированные JSON-файлы словарей для удаления неиспользуемых полей (`build.purge`) или их переименования в короткие алиасы (`build.minify`). |
+| `intlayerMinifyBabelPlugin`    | Плагин Babel, который перезаписывает исходные файлы для использования коротких алиасов полей, назначенных на этапе минимизации (например, `content.title` ← `content.a`). Зависит от `intlayerPurgeBabelPlugin`.   |
+| `makeFieldRenameBabelPlugin`   | Фабричная функция, создающая плагин Babel для переименования обращений к полям контента словаря в исходных файлах в соответствии с `dictionaryKeyToFieldRenameMap`, заполненной в `PruneContext`.                  |
+| `makeUsageAnalyzerBabelPlugin` | Фабричная функция, создающая плагин Babel для анализа использования `useIntlayer` / `getIntlayer` в исходном коде и агрегирования данных об использовании полей в общем `PruneContext`.                            |
+| `getSharedPruneContext`        | Вспомогательная функция, которая возвращает общий объект `PruneContext` для указанного базового каталога или `null`, если он еще не был инициализирован.                                                           |
+
+---
+
+### Утилиты настройки плагинов
+
+| Функция                    | Описание                                                                                                                                                     |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `getExtractPluginOptions`  | Загружает конфигурацию Intlayer и возвращает `ExtractPluginOptions`, готовые для использования с `intlayerExtractBabelPlugin`.                               |
+| `getOptimizePluginOptions` | Загружает конфигурацию Intlayer и скомпилированные словари, и возвращает `OptimizePluginOptions`, готовые для использования с `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Загружает конфигурацию Intlayer и возвращает `PurgePluginOptions`, готовые для использования с `intlayerPurgeBabelPlugin`.                                   |
+| `getMinifyPluginOptions`   | Загружает конфигурацию Intlayer и возвращает `MinifyPluginOptions`, готовые для использования с `intlayerMinifyBabelPlugin`.                                 |
+
+---
+
+### Типы
+
+| Тип                     | Описание                                                                                                                           |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Режим компилятора: `'dev'` для разработки с поддержкой HMR или `'build'` для продакшен-сборок.                                     |
+| `ExtractPluginOptions`  | Параметры для `intlayerExtractBabelPlugin`: список файлов, конфигурация, callback `onExtract` и т. д.                              |
+| `ExtractResult`         | Результат извлечения: ключ словаря, путь к файлу, содержимое и локаль.                                                             |
+| `OptimizePluginOptions` | Параметры для `intlayerOptimizeBabelPlugin`: пути к словарям, режим импорта, сопоставление режимов для каждого словаря и т. д.     |
+| `PurgePluginOptions`    | Параметры для `intlayerPurgeBabelPlugin`: базовый каталог, флаги purge/minify/optimize, список файлов компонентов.                 |
+| `MinifyPluginOptions`   | Параметры для `intlayerMinifyBabelPlugin`: базовый каталог, флаги minify/optimize/editorEnabled.                                   |
+| `PruneContext`          | Общее состояние плагинов анализа и очистки: карты использования полей, карты переименования и т. д.                                |
+| `DictionaryFieldUsage`  | Результат использования полей для одного словаря: `Set<string>` или `'all'`, когда статический анализ не дает однозначного ответа. |
+| `NestedRenameEntry`     | Узел в дереве переименования: `shortName` и карта дочерних элементов.                                                              |
+| `NestedRenameMap`       | Один уровень в дереве переименования: `Map<string, NestedRenameEntry>`.                                                            |
+| `CompatCallerConfig`    | Конфигурация совместимого анализатора использования для пакетов `compat-adapter` (имя вызывающего модуля и параметры обработки).   |
+| `ScriptBlock`           | Блок скрипта, извлеченный из SFC-файла (Vue или Svelte): содержимое, смещение начала и смещение конца.                             |
+
+---
+
+### Вспомогательные функции
+
+| Функция                           | Описание                                                                                                                                                          |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Преобразует целое число (начиная с нуля) в короткий буквенный идентификатор: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, etc.                                       |
+| `buildNestedRenameMapFromContent` | Рекурсивно строит `NestedRenameMap` на основе значений содержимого скомпилированного словаря с учетом структур узлов Intlayer (translation, enumeration и т. д.). |
+| `createPruneContext`              | Создает новый пустой объект `PruneContext`, инициализированный значениями по умолчанию.                                                                           |
+| `extractScriptBlocks`             | Извлекает блоки `<script>` из SFC-файлов (Vue / Svelte) для последующего анализа в Babel.                                                                         |
+| `BABEL_PARSER_OPTIONS`            | Константа, представляющая параметры парсера Babel, охватывающие поддерживаемые фреймворки (React/Vue/Svelte/Angular/...).                                         |
+| `INTLAYER_CALLER_NAMES`           | Константный список исходных имен вызывающих модулей Intlayer: `['useIntlayer', 'getIntlayer']`.                                                                   |
+
+---
+
+## Пример использования
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Примечание:** Плагин `intlayerPurgeBabelPlugin` должен быть объявлен **перед** `intlayerMinifyBabelPlugin`, так как последний считывает карту переименования, созданную первым. Кроме того, обоим должен предшествовать плагин `intlayerOptimizeBabelPlugin`, чтобы он мог видеть ключи словарей до перезаписи вызовов `useIntlayer`.

package/docs/ru/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: Документация пакета react-native-intlayer
-description: Поддержка React Native для Intlayer, предоставляющая провайдеры и полифилы.
+description: Поддержка React Native для Intlayer, предоставляющая провайдеры, хуки, полифилы и конфигурацию Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Реэкспорт полного API react-intlayer (хуки, утилиты, подпути format/html/markdown), чтобы приложение React Native зависело только от react-native-intlayer"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Унифицированная документация для всех экспортов"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # Пакет react-native-intlayer
 
-Пакет `react-native-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения React Native. Он включает провайдер и полифилы для поддержки локалей.
+Пакет `react-native-intlayer` предоставляет необходимые инструменты для интеграции Intlayer в приложения React Native. Он реэкспортирует полный API `react-intlayer` (хуки и утилиты) с `IntlayerProvider`, адаптированным для React Native, а также полифилы и конфигурацию Metro, необходимые для работы в React Native.
+
+> В приложении React Native импортируйте **всё** из `react-native-intlayer`. Устанавливать или импортировать `react-intlayer` напрямую не нужно.
 
 ## Установка
 
@@ -34,26 +39,57 @@ npm install react-native-intlayer
 
 ### Провайдер
 
-| Компонент          | Описание                                                                                    |
-| ------------------ | ------------------------------------------------------------------------------------------- |
-| `IntlayerProvider` | Провайдер-компонент, который оборачивает ваше приложение и предоставляет контекст Intlayer. |
+| Компонент          | Описание                                                                                                                                  |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerProvider` | Провайдер-компонент, который оборачивает ваше приложение и предоставляет контекст Intlayer. Автоматически применяет необходимые полифилы. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### Хуки и утилиты
+
+Они реэкспортируются из `react-intlayer`, поэтому вы можете импортировать их напрямую из `react-native-intlayer`:
 
-Импорт:
+| Экспорт                                                                                                           | Описание                                            |
+| ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| `useIntlayer`                                                                                                     | Доступ к локализованному контенту по ключу словаря. |
+| `useLocale`                                                                                                       | Чтение и изменение текущей локали.                  |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | Загрузка содержимого словаря различными способами.  |
+| `useI18n`                                                                                                         | Совместимый с i18next хук.                          |
+| `t`                                                                                                               | Вспомогательная функция для встроенного перевода.   |
+| `getIntlayer`, `getDictionary`                                                                                    | Императивные геттеры контента.                      |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | Вспомогательные функции для сохранения локали.      |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
-### Полифилл
+### Полифил
 
 | Функция            | Описание                                                                         |
 | ------------------ | -------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Функция, применяющая необходимые полифилы для поддержки Intlayer в React Native. |
 
-Импорт:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> Полифил применяется автоматически при импорте `IntlayerProvider`. Вызывайте `intlayerPolyfill` вручную только если вам нужны полифилы до монтирования провайдера.
+
+### Форматтеры
+
+Хуки форматирования чисел, дат и другие функции на базе Intl доступны из подпути `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### Markdown и HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### Конфигурация Metro
@@ -64,11 +100,8 @@ import "react-native-intlayer";
 | ------------------------- | ------------------------------------------------------------------------------------------- |
 | `configMetroIntlayer`     | Асинхронная функция, которая подготавливает Intlayer и объединяет конфигурацию Metro.       |
 | `configMetroIntlayerSync` | Синхронная функция, которая объединяет конфигурацию Metro без подготовки ресурсов Intlayer. |
-| `exclusionList`           | Создаёт шаблон RegExp для blockList Metro, чтобы исключать файлы контента из bundle.        |
-
-Импорт:
+| `exclusionList`           | Создаёт шаблон RegExp для blockList Metro, чтобы исключать файлы контента из бандла.        |
 
 ```tsx
-import "react-native-intlayer/metro";
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/ru/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Документация плагина Vite intlayerCompiler | vite-intlayer
+description: Плагин Vite, который извлекает встроенные объявления контента Intlayer из файлов компонентов и записывает их в файлы JSON словаря во время сборки/трансформации.
+keywords:
+  - intlayerCompiler
+  - vite
+  - плагин
+  - компилятор
+  - контент
+  - словарь
+  - интернационализация
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Интегрировано в intlayer(); инициализация доки"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` — это плагин Vite, который сканирует исходные файлы компонентов на наличие **встроенных объявлений контента Intlayer** (inline declarations) — контента, определенного непосредственно внутри компонента, а не в отдельном файле `.content.ts`, — и записывает их в файлы JSON словаря во время фазы трансформации.
+
+> **Начиная с Intlayer v9** `intlayerCompiler` автоматически включается в основной плагин [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md), если в конфигурации Intlayer включен компилятор (`compiler.enabled: true`) и задан путь вывода (`compiler.output`). Вам нужно регистрировать его отдельно только в том случае, если вы хотите полностью контролировать конфигурацию компилятора.
+
+## Использование
+
+### В составе `intlayer()` (рекомендуется, v9+)
+
+Включите компилятор в конфигурации Intlayer:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // куда записываются извлеченные словари
+  },
+});
+```
+
+Затем используйте стандартный плагин без дополнительной регистрации:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Отдельно (при необходимости)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Опции
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Опция            | Тип                       | Описание                                                                                       |
+| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Переопределение конфигурации Intlayer, передаваемое в `getConfiguration()`.                    |
+| `compilerConfig` | `Partial<CompilerConfig>` | Переопределение специфичных настроек компилятора (например, `enabled`, `output`, `filesList`). |
+
+### Пример
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Как это работает
+
+### Фаза трансформации
+
+Для каждого исходного файла, соответствующего `compiler.filesList`, плагин компилятора:
+
+1. Пропускает содержимое файла через `extractContent` из `@intlayer/babel`.
+2. Вызывает `onExtract` для каждого найденного объявления, записывая результирующий JSON словаря в `compiler.output`.
+3. Возвращает трансформированный исходный код со встроенными объявлениями, замененными стандартными вызовами `useIntlayer('key')` / `getIntlayer('key')`.
+
+Поддерживаемые типы файлов: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Когда файл компонента сохраняется в режиме разработки, компилятор:
+
+1. Обнаруживает изменение файла через хук `handleHotUpdate` в Vite.
+2. Повторно извлекает контент из обновленного файла.
+3. Записывает обновленный JSON словаря.
+4. Запускает полную перезагрузку страницы (`server.ws.send({ type: 'full-reload' })`).
+
+Задержка (debounce) в 500 мс предотвращает бесконечный цикл повторного извлечения, вызываемый самой записью словаря (которая также запускает событие изменения файла).
+
+### Дедупликация
+
+`intlayerCompiler` использует тот же механизм дедупликации `createPrimaryInstanceGuard`, что и другие встроенные плагины. Когда присутствуют как `intlayer()` (который включает компилятор), так и ручной вызов `intlayerCompiler()`, запускается только первый зарегистрированный экземпляр — словари не записываются дважды.

package/docs/ru/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Документация плагина Vite intlayerMinify | vite-intlayer
+description: Плагин Vite, который минимизирует скомпилированные файлы JSON словаря Intlayer и опционально скрывает имена полей содержимого для уменьшения размера бандла.
+keywords:
+  - intlayerMinify
+  - vite
+  - плагин
+  - минимизация
+  - размер бандла
+  - словарь
+  - интернационализация
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Инициализация доки"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` — это плагин Vite, который минимизирует скомпилированные JSON-файлы словарей во время сборки для продакшена. Он удаляет все ненужные пробельные символы и, в сочетании с `intlayerPrune`, опционально переименовывает поля содержимого в короткие буквенные алиасы (`a`, `b`, `c`, …) для дополнительного уменьшения размера бандла.
+
+> Плагин уже автоматически включен и настроен, если вы используете [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/packages/vite-intlayer/intlayer.md). Вам нужно регистрировать его вручную только в том случае, если вы самостоятельно собираете стек плагинов.
+
+## Использование
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Условия активации
+
+`intlayerMinify` активен **только** при выполнении всех трех следующих условий:
+
+1. Команда Vite — `build` (не `serve` / dev).
+2. `build.optimize` имеет значение `true` (или `undefined`, что по умолчанию равно `true` для сборок).
+3. `build.minify` имеет значение `true` в вашей конфигурации Intlayer.
+
+Он автоматически **отключается**, когда `editor.enabled` имеет значение `true`, так как редактору требуется полное, понятное человеку содержимое словарей.
+
+## Что минимизируется
+
+Плагин обрабатывает два пути хранения словарей (определяемых из `intlayer.system`):
+
+- `dictionariesDir` — статические словари для всех языков (например, `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — динамические словари для конкретных языков
+
+> Словари в режиме fetch (`fetchDictionariesDir`) **никовы** не минимизируются, поскольку они запрашиваются из удаленного API во время выполнения с использованием исходных имен полей. Переименование полей привело бы к несоответствию между ответом сервера и обращениями к свойствам на стороне клиента.
+
+## Сокрытие имен полей (минимизация свойств)
+
+Когда `intlayerPrune` анализирует кодовую базу и заполняет карту `pruneContext.dictionaryKeyToFieldRenameMap`, `intlayerMinify` также переименовывает имена полей контента в короткие алиасы. Например:
+
+```json
+// до
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// после (с сокрытием)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Соответствующие обращения к свойствам в исходных файлах переименовываются на шаге Babel в `intlayerOptimize`, поэтому поведение в рантайме остается неизменным.
+
+Внутренние поля Intlayer (`nodeType`, `translation` и т.д.) никогда не переименовываются.
+
+## Крайние случаи (Edge-cases)
+
+Словари, отмеченные в `pruneContext.dictionariesWithEdgeCases` (структурные аномалии, обнаруженные во время фазы очистки), полностью пропускаются — они не минимизируются и не скрываются, чтобы избежать отправки поврежденных данных.
+
+## Квалифицированные группы (коллекции / варианты / метаданные)
+
+Для словарей с массивом `qualifierTypes` (коллекции, варианты и метаданные) плагин сохраняет массив `qualifierTypes` и карту `meta` без изменений. Маскируются только имена полей внутри записей `content`. Композитные ключи (используемые для сопоставления селекторов во время выполнения) никогда не изменяются.