@intlayer/docs 8.3.0-canary.4 → 8.3.1

package/docs/pt/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-12-30
+updatedAt: 2026-03-12
 title: Vite + Vue i18n - Como traduzir uma aplicação Vue em 2026
 description: Descubra como tornar seu site Vite e Vue multilíngue. Siga a documentação para internacionalizar (i18n) e traduzir.
 keywords:
@@ -1037,6 +1037,162 @@ const { myMarkdownContent } = useIntlayer("my-component");
 </script>
 ```
 
+### (Opcional) Etapa 1 : Extrair o conteúdo dos seus componentes
+
+Se você tiver uma base de código existente, transformar milhares de arquivos pode ser demorado.
+
+Para facilitar esse processo, o Intlayer propõe um [compilador](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/compiler.md) / [extrator](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/extract.md) para transformar seus componentes e extrair o conteúdo.
+
+Para configurá-lo, você pode adicionar uma seção `compiler` no seu arquivo `intlayer.config.ts`:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Resto da sua configuração
+  compiler: {
+    /**
+     * Indica se o compilador deve ser ativado.
+     */
+    enabled: true,
+
+    /**
+     * Define o caminho dos arquivos de saída
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Indica se os componentes devem ser salvos após serem transformados. Dessa forma, o compilador pode ser executado apenas uma vez para transformar o aplicativo e depois removido.
+     */
+    saveComponents: false,
+
+    /**
+     * Prefixo da chave do dicionário
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Resto da sua configuração
+  compiler: {
+    /**
+     * Indica se o compilador deve ser ativado.
+     */
+    enabled: true,
+
+    /**
+     * Define o caminho dos arquivos de saída
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Indica se os componentes devem ser salvos após serem transformados. Dessa forma, o compilador pode ser executado apenas uma vez para transformar o aplicativo e depois removido.
+     */
+    saveComponents: false,
+
+    /**
+     * Prefixo da chave do dicionário
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Resto da sua configuração
+  compiler: {
+    /**
+     * Indica se o compilador deve ser ativado.
+     */
+    enabled: true,
+
+    /**
+     * Define o caminho dos arquivos de saída
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * Indica se os componentes devem ser salvos após serem transformados. Dessa forma, o compilador pode ser executado apenas uma vez para transformar o aplicativo e depois removido.
+     */
+    saveComponents: false,
+
+    /**
+     * Prefixo da chave do dicionário
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+module.exports = config;
+```
+
+<Tabs>
+ <Tab value='Comando de extração'>
+
+Execute o extrator para transformar seus componentes e extrair o conteúdo
+
+```bash packageManager="npm"
+npx intlayer extract
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer extract
+```
+
+```bash packageManager="yarn"
+yarn intlayer extract
+```
+
+```bash packageManager="bun"
+bunx intlayer extract
+```
+
+ </Tab>
+ <Tab value='Compilador Babel'>
+
+Atualize seu `vite.config.ts` para incluir o plugin `intlayerCompiler`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer(),
+    intlayerCompiler(), // Adiciona o plugin do compilador
+  ],
+});
+```
+
+```bash packageManager="npm"
+npm run build # Ou npm run dev
+```
+
+```bash packageManager="pnpm"
+pnpm run build # Or pnpm run dev
+```
+
+```bash packageManager="yarn"
+yarn build # Or yarn dev
+```
+
+```bash packageManager="bun"
+bun run build # Or bun run dev
+```
+
+ </Tab>
+</Tabs>
+
 ### Configurar TypeScript
 
 O Intlayer utiliza a ampliação de módulos para aproveitar os benefícios do TypeScript e tornar sua base de código mais robusta.

package/docs/ru/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-10
+updatedAt: 2026-03-12
 title: Intlayer Compiler | Автоматизированное извлечение контента для i18n
 description: Автоматизируйте процесс интернационализации с помощью Intlayer Compiler. Извлекайте контент напрямую из ваших компонентов для более быстрого и эффективного i18n в Vite, Next.js и других.
 keywords:
@@ -21,8 +21,8 @@ slugs:
   - compiler
 history:
   - version: 8.2.0
-    date: 2026-03-10
-    changes: Update compiler options, add FilePathPattern support
+    date: 2026-03-09
+    changes: Обновление опций компилятора, добавление поддержки FilePathPattern
   - version: 8.1.7
     date: 2026-02-25
     changes: Обновление опций компилятора
@@ -35,7 +35,7 @@ history:
 
 ## Что такое Intlayer Compiler?
 
-**Intlayer Compiler**, это мощный инструмент, разработанный для автоматизации процесса интернационализации (i18n) в ваших приложениях. Он сканирует ваш исходный код (JSX, TSX, Vue, Svelte) на предмет объявлений контента, извлекает их и автоматически генерирует необходимые файлы словарей. Это позволяет вам хранить контент вместе с компонентами, в то время как Intlayer управляет и синхронизирует ваши словари.
+**Intlayer Compiler** — это мощный инструмент, разработанный для автоматизации процесса интернационализации (i18n) в ваших приложениях. Он сканирует ваш исходный код (JSX, TSX, Vue, Svelte) на предмет объявлений контента, извлекает их и автоматически генерирует необходимые файлы словарей. Это позволяет вам хранить контент вместе с компонентами, в то время как Intlayer управляет и синхронизирует ваши словари.
 
 ## Почему стоит использовать Intlayer Compiler?
 
@@ -50,7 +50,7 @@ history:
 
 Хотя компилятор предлагает отличный опыт "работает из коробки", он также вводит некоторые компромиссы, о которых вы должны знать:
 
-- **Эвристическая неоднозначность**: Компилятор должен угадывать, что является пользовательским контентом, а что, логикой приложения (например, `className="active"`, коды состояния, ID продуктов). В сложных кодовых базах это может привести к ложным срабатываниям или пропущенным строкам, которые требуют ручных аннотаций и исключений.
+- **Эвристическая неоднозначность**: Компилятор должен угадывать, что является пользовательским контентом, а что — логикой приложения (например, `className="active"`, коды состояния, ID продуктов). В сложных кодовых базах это может привести к ложным срабатываниям или пропущенным строкам, которые требуют ручных аннотаций и исключений.
 - **Только статическое извлечение**: Извлечение на основе компилятора полагается на статический анализ. Строки, которые существуют только во время выполнения (коды ошибок API, поля CMS и т.д.), не могут быть обнаружены или переведены компилятором в одиночку, поэтому вам все еще нужна дополнительная стратегия i18n времени выполнения.
 
 Для более глубокого архитектурного сравнения см. блог-пост [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/ru/compiler_vs_declarative_i18n.md).
@@ -64,7 +64,7 @@ history:
 
 ### Vite
 
-Для приложений на базе Vite (React, Vue, Svelte и др.) самый простой способ использовать компилятор, через плагин `vite-intlayer`.
+Для приложений на базе Vite (React, Vue, Svelte и др.) самый простой способ использовать компилятор — через плагин `vite-intlayer`.
 
 #### Установка
 
@@ -136,9 +136,9 @@ const {
 module.exports = {
   presets: ["next/babel"],
   plugins: [
-    // Extract content from components into dictionaries
+    // Извлечение контента из компонентов в словари
     [intlayerExtractBabelPlugin, getExtractPluginOptions()],
-    // Optimize imports by replacing useIntlayer with direct dictionary imports
+    // Оптимизация импорта путем замены useIntlayer на прямой импорт словарей
     [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
   ],
 };
@@ -149,73 +149,83 @@ module.exports = {
 See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
 
  </Tab>
+</Tabs>
 
 ### Пользовательская конфигурация
 
 Чтобы настроить поведение компилятора, вы можете обновить файл `intlayer.config.ts` в корне вашего проекта.
 
-```ts fileName="intlayer.config.ts"
+````ts fileName="intlayer.config.ts"
 import { type IntlayerConfig, Locales } from "intlayer";
 
 const config: IntlayerConfig = {
   compiler: {
     /**
+     * Указывает, должен ли компилятор быть включен.
      * Установите значение 'build-only', чтобы пропустить компилятор во время разработки и ускорить запуск.
      */
     enabled: true,
 
     /**
-     * Pattern to traverse the code to optimize.
+     * Определяет путь к выходным файлам. Заменяет `outputDir`.
+     *
+     * - Пути, начинающиеся с `./`, разрешаются относительно каталога компонента.
+     * - Пути, начинающиеся с `/`, разрешаются относительно корня проекта (`baseDir`).
+     *
+     * - Включение переменной `{{locale}}` в путь позволит создавать словари, разделенные по языкам.
+     *
+     * Примеры:
+     * ```ts
+     * {
+     *   // Создавать многоязычные файлы .content.ts рядом с компонентом
+     *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+     *
+     *   // output: './{{fileName}}{{extension}}', // Эквивалентное использование строки шаблона
+     * }
+     * ```
+     *
+     * ```ts
+     * {
+     *   // Создавать централизованные JSON-файлы по языкам в корне проекта
+     *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+     *
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // Эквивалентное использование строки шаблона
+     * }
+     * ```
+     *
+     * Список переменных:
+     *   - `fileName`: Имя файла.
+     *   - `key`: Ключ контента.
+     *   - `locale`: Язык контента.
+     *   - `extension`: Расширение файла.
+     *   - `componentFileName`: Имя файла компонента.
+     *   - `componentExtension`: Расширение файла компонента.
+     *   - `format`: Формат словаря.
+     *   - `componentFormat`: Формат словаря компонента.
+     *   - `componentDirPath`: Путь к каталогу компонента.
      */
-    transformPattern: [
-      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
-      "!**/node_modules/**",
-    ],
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * Pattern to exclude from the optimization.
-     */
-    excludePattern: ["**/node_modules/**"],
-
-    /**
-     * Выходной каталог для оптимизированных словарей.
+     * Указывает, должны ли компоненты сохраняться после трансформации.
+     * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
      */
-    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+    saveComponents: false,
 
     /**
-     * Вставьте только содержимое в сгенерированный файл, без ключа.
+     * Вставить только контент в сгенерированный файл. Полезно для JSON-вывода i18next или ICU MessageFormat для каждого языка.
+     *
+     * - `output: ({ locale, key }) => `./locale/${locale}/${key}.json`,`
      */
     noMetadata: false,
 
     /**
      * Префикс ключа словаря
      */
-    dictionaryKeyPrefix: "", // Remove base prefix
-
-    /**
-     * Указывает, должны ли компоненты сохраняться после трансформации.
-     * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
-     */
-    saveComponents: false,
+    dictionaryKeyPrefix: "", // Добавьте необязательный префикс для извлеченных ключей словаря
   },
 };
-
-export default config;
-```
-
-### Заполнить недостающие переводы
-
-Intlayer предоставляет инструмент CLI, который поможет вам заполнить недостающие переводы. Вы можете использовать команду `intlayer` для тестирования и заполнения недостающих переводов в вашем коде.
-
-```bash
-npx intlayer test         # Проверить наличие недостающих переводов
-```
-
-```bash
-npx intlayer fill         # Заполнить недостающие переводы
-```
-
-> Для получения более подробной информации обратитесь к [документации CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/ci.md)
+````
 
 ### Справочник по конфигурации компилятора
 
@@ -225,36 +235,37 @@ npx intlayer fill         # Заполнить недостающие перев
   - _Тип_: `boolean | 'build-only'`
   - _По умолчанию_: `true`
   - _Описание_: Указывает, должен ли компилятор быть включен.
+
 - **dictionaryKeyPrefix**:
   - _Тип_: `string`
-  - _По умолчанию_: `'comp-'`
+  - _По умолчанию_: `''`
   - _Описание_: Префикс для извлеченных ключей словаря.
+
 - **transformPattern**:
   - _Тип_: `string | string[]`
   - _По умолчанию_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
-  - _Описание_: Шаблоны для обхода кода для оптимизации.
+  - _Описание_: (Устарело: вместо этого используйте `build.traversePattern`) Шаблоны для обхода кода для оптимизации.
+
 - **excludePattern**:
   - _Тип_: `string | string[]`
   - _По умолчанию_: `['**/node_modules/**']`
-  - _Описание_: Шаблоны для исключения из оптимизации.
-- **outputDir** (Deprecated):
-  - _Тип_: `string`
-  - _По умолчанию_: `'compiler'`
-  - _Описание_: Каталог, в котором будут храниться извлеченные словари.
+  - _Описание_: (Устарело: вместо этого используйте `build.traversePattern`) Шаблоны для исключения из оптимизации.
 
 - **output**:
   - _Тип_: `FilePathPattern`
   - _По умолчанию_: `({ key }) => 'compiler/${key}.content.json'`
-  - _Описание_: Определяет путь к выходным файлам. Заменяет `outputDir`. Поддерживает динамические переменные, такие как `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Может быть задано как строка в формате `'my/{{var}}/path'` или как функция.
-  - _Примечание_: `./**/*` Пути разрешаются относительно компонента. `/**/*` пути разрешаются относительно `baseDir` Intlayer.
+  - _Описание_: Определяет путь к выходным файлам. Заменяет `outputDir`. Поддерживает динамические переменные, такие как `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, и `{{componentFormat}}`. Может быть задано как строка в формате `'my/{{var}}/path'` или как функция.
+  - _Примечание_: Пути `./**/*` разрешаются относительно компонента. Пути `/**/*` разрешаются относительно `baseDir` Intlayer.
+  - _Примечание_: Если язык определен в пути, словари будут генерироваться для каждого языка.
   - _Пример_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
 
 - **noMetadata**:
   - _Тип_: `boolean`
   - _По умолчанию_: `false`
-  - _Описание_: Указывает, должны ли метаданные сохраняться в файле. Если true, компилятор не будет сохранять метаданные словарей (ключ, оболочка содержимого).
+  - _Описание_: Указывает, должны ли метаданные сохраняться в файле. Если true, компилятор не будет сохранять метаданные словарей (ключ, оболочка содержимого). Полезно для вывода JSON i18next или ICU MessageFormat для каждой локали.
   - _Примечание_: Полезно при использовании с плагином `loadJSON`.
-  - _Пример_: Если `true`:
+  - _Пример_:
+    Если `true`:
     ```json
     {
       "key": "value"
@@ -274,3 +285,25 @@ npx intlayer fill         # Заполнить недостающие перев
   - _Тип_: `boolean`
   - _По умолчанию_: `false`
   - _Описание_: Указывает, должны ли компоненты сохраняться после трансформации.
+
+### Заполнить недостающие переводы
+
+Intlayer предоставляет инструмент CLI, который поможет вам заполнить недостающие переводы. Вы можете использовать команду `intlayer` для тестирования и заполнения недостающих переводов в вашем коде.
+
+```bash
+npx intlayer test         # Проверить наличие недостающих переводов
+```
+
+```bash
+npx intlayer fill         # Заполнить недостающие переводы
+```
+
+### Извлечение
+
+Intlayer предоставляет инструмент CLI для извлечения контента из вашего кода. Вы можете использовать команду `intlayer extract`, чтобы извлечь контент из вашего кода.
+
+```bash
+npx intlayer extract
+```
+
+> Для получения более подробной информации обратитесь к [документации CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md)

package/docs/ru/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-11
+updatedAt: 2026-03-12
 title: Конфигурация
 description: Узнайте, как настроить Intlayer для вашего приложения. Поймите различные параметры и опции, доступные для настройки Intlayer под ваши нужды.
 keywords:
@@ -15,7 +15,7 @@ slugs:
   - configuration
 history:
   - version: 8.3.0
-    data: 2026-03-11
+    date: 2026-03-11
     changes: Переместить 'baseDir' из конфигурации 'content' в конфигурацию 'system'
   - version: 8.2.0
     date: 2026-03-10
@@ -92,7 +92,7 @@ Intlayer поддерживает форматы файлов конфигура
 
 ## Пример файла конфигурации
 
-```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
 import { z } from "zod";
@@ -190,7 +190,7 @@ const config: IntlayerConfig = {
      * Options: 'cookie', 'localStorage', 'sessionStorage', 'header', or an array of these.
      * Default: ['cookie', 'header']
      */
-    storage: "cookie",
+    storage: ["cookie", "header"],
 
     /**
      * Base path for the application URLs.
@@ -321,18 +321,16 @@ const config: IntlayerConfig = {
     /**
      * Global context to guide the AI in generating translations.
      */
-    applicationContext: "This is a travel booking application.",
-
-    /**
-     * Base URL for the AI API.
-     */
     baseURL: "http://localhost:3000",
 
     /**
-     * Data serialization format to use for the AI features of Intlayer.
-     * - "json": The industry standard. Highly reliable and structured, but consumes more tokens.
-     * - "toon": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON
-     * Default: "json"
+     * Сериализация данных
+     *
+     * Опции:
+     * - "json": Стандартный, надежный; использует больше токенов.
+     * - "toon": Меньше токенов, менее последователен, чем JSON.
+     *
+     * По умолчанию: "json"
      */
     dataSerialization: "json",
   },
@@ -434,42 +432,70 @@ const config: IntlayerConfig = {
   compiler: {
     /**
      * Указывает, должен ли компилятор быть включен.
+     *
+     * - false : Отключить компилятор.
+     * - true : Включить компилятор.
+     * - "build-only" : Пропустить компилятор во время разработки для ускорения запуска.
+     *
+     * По умолчанию : false
      */
     enabled: true,
 
     /**
-     * Pattern to traverse the code to optimize.
-     */
-    transformPattern: [
-      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
-      "!**/node_modules/**",
-    ],
-
-    /**
-     * Pattern to exclude from the optimization.
+     * Определяет путь к выходным файлам. Заменяет `outputDir`.
+     *
+     * - Пути `./` разрешаются относительно каталога компонента.
+     * - Пути `/` разрешаются относительно корня проекта (`baseDir`).
+     *
+     * - Включение переменной `{{locale}}` в путь приведет к генерации отдельных словарей для каждой локали.
+     *
+     * Пример:
+     * ```ts
+     * {
+     *   // Создавать многоязычные файлы .content.ts рядом с компонентом
+     *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+     *
+     *   // output: './{{fileName}}{{extension}}', // Эквивалент с использованием строки шаблона
+     * }
+     * ```
+     *
+     * ```ts
+     * {
+     *   // Создавать централизованные JSON по локалям в корне проекта
+     *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+     *
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // Эквивалент с использованием строки шаблона
+     * }
+     * ```
+     *
+     * Список переменных:
+     *   - `fileName`: Имя файла.
+     *   - `key`: Ключ контента.
+     *   - `locale`: Локаль контента.
+     *   - `extension`: Расширение файла.
+     *   - `componentFileName`: Имя файла компонента.
+     *   - `componentExtension`: Расширение файла компонента.
+     *   - `format`: Формат словаря.
+     *   - `componentFormat`: Формат словаря компонента.
+     *   - `componentDirPath`: Путь к каталогу компонента.
      */
-    excludePattern: ["**/node_modules/**"],
+    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
 
     /**
-     * Выходной каталог для оптимизированных словарей.
+     * Указывает, должны ли компоненты сохраняться после трансформации.
+     * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
      */
-    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+    saveComponents: false,
 
     /**
-     * Вставьте только содержимое в сгенерированный файл, без ключа.
+     * Вставьте только содержимое в сгенерированный файл. Полезно для вывода JSON i18next или ICU MessageFormat для каждой локали.
      */
     noMetadata: false,
 
     /**
      * Префикс ключа словаря
      */
-    dictionaryKeyPrefix: "", // Remove base prefix
-
-    /**
-     * Указывает, должны ли компоненты сохраняться после трансформации.
-     * Таким образом, компилятор можно запустить только один раз для трансформации приложения, а затем удалить.
-     */
-    saveComponents: false,
+    dictionaryKeyPrefix: "", // Добавьте необязательный префикс для извлеченных ключей словаря
   },
 
   /**
@@ -488,7 +514,7 @@ const config: IntlayerConfig = {
 };
 
 export default config;
-```
+````
 
 ## Справочник по конфигурации
 
@@ -1048,7 +1074,7 @@ Intlayer поддерживает несколько провайдеров ИИ
 
 - **dictionaryKeyPrefix**:
   - _Тип_: `string`
-  - _По умолчанию_: `'comp-'`
+  - _По умолчанию_: `''`
   - _Описание_: Префикс для извлеченных ключей словаря.
   - _Пример_: `'my-key-'`
   - _Примечание_: При извлечении словарей ключ генерируется на основе имени файла. Этот префикс добавляется к сгенерированному ключу для предотвращения конфликтов.
@@ -1072,24 +1098,28 @@ Intlayer поддерживает несколько провайдеров ИИ
   - _Описание_: Шаблоны, определяющие, какие файлы должны быть исключены во время оптимизации.
   - _Пример_: `['**/node_modules/**', '!**/node_modules/react/**']`
 
-- **outputDir**:
-  - _Тип_: `string`
-  - _По умолчанию_: `'compiler'`
-  - _Описание_: Каталог, в котором будут храниться извлеченные словари, относительно базового пути вашего проекта.
-
 - **output**:
   - _Тип_: `FilePathPattern`
-  - _По умолчанию_: `({ key }) => 'compiler/${key}.content.json'`
-  - _Описание_: Определяет путь к выходным файлам. Заменяет `outputDir`. Поддерживает динамические переменные, такие как `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Может быть задано как строка в формате `'my/{{var}}/path'` или как функция.
-  - _Примечание_: `./**/*` Пути разрешаются относительно компонента. `/**/*` пути разрешаются относительно `baseDir` Intlayer.
-  - _Пример_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
+  - _По умолчанию_: `undefined`
+  - _Описание_: Определяет путь к выходным файлам. Заменяет `outputDir`. Поддерживает динамические переменные через шаблоны строк или функцию. Поддерживаемые переменные: `{{fileName}}`, `{{key}}`, `{{locale}}`, `{{extension}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{format}}`, `{{componentFormat}}` и `{{componentDirPath}}`.
+  - _Примечание_: Пути `./` разрешаются относительно каталога компонента. Пути `/` разрешаются относительно корня проекта (`baseDir`).
+  - _Примечание_: Включение переменной `{{locale}}` в путь приведет к генерации отдельных словарей для каждой локали.
+  - _Пример_:
+    - **Мультиязычные файлы рядом с компонентом**:
+    - Строка: `'./{{fileName}}{{extension}}'`
+    - Функция: `({ fileName, extension }) => \`./${fileName}${extension}\``
+
+    - **Централизованный JSON по локалям**:
+    - Строка: `'/locales/{{locale}}/{{key}}.content.json'`
+    - Функция: `({ key, locale }) => \`/locales/${locale}/${key}.content.json\``
 
 - **noMetadata**:
   - _Тип_: `boolean`
   - _По умолчанию_: `false`
-  - _Описание_: Указывает, должны ли метаданные сохраняться в файле. Если true, компилятор не будет сохранять метаданные словарей (ключ, оболочка содержимого).
+  - _Описание_: Указывает, должны ли метаданные сохраняться в файле. Если true, компилятор не будет сохранять метаданные словарей (ключ, оболочка содержимого). Полезно для вывода JSON i18next или ICU MessageFormat для каждой локали.
   - _Примечание_: Полезно при использовании с плагином `loadJSON`.
-  - _Пример_: Если `true`:
+  - _Пример_:
+    Если `true`:
     ```json
     {
       "key": "value"