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

package/docs/uk/intlayer_with_vite+solid.md

@@ -596,6 +596,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"
@@ -605,7 +607,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Додає плагін компілятора
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/uk/intlayer_with_vite+svelte.md

@@ -460,14 +460,17 @@ $: 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";
 
 // https://vitejs.dev/config/ - конфігурація Vite
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     svelte(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -598,6 +601,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"
@@ -607,7 +612,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Додає плагін компілятора
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/uk/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/uk/intlayer_with_vite+vue.md

@@ -645,14 +645,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"),
+      },
+    }),
   ],
 });
 ```
@@ -977,6 +980,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"
@@ -986,7 +991,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // Додає плагін компілятора
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/uk/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'`, тощо.                                 |
+| `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/uk/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,14 +39,30 @@ 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";
 ```
 
 ### Поліфіл
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ----------------------------------------------------------------------------------------------- |
 | `intlayerPolyfill` | Функція, що застосовує необхідні поліфіли для React Native, щоб забезпечити підтримку Intlayer. |
 
-Імпорт:
+```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
@@ -66,8 +102,6 @@ import "react-native-intlayer";
 | `configMetroIntlayerSync` | Синхронна функція, яка об'єднує конфігурацію Metro без підготовки ресурсів Intlayer. |
 | `exclusionList`           | Створює патерн RegExp для blockList Metro, щоб виключати файли контенту з бандлу.    |
 
-Імпорт:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```

package/docs/uk/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/uk/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/uk/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/uk/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`. Композитні ключі (що використовуються для зіставлення селекторів під час виконання) ніколи не змінюються.