@intlayer/docs 8.3.0 → 8.3.2

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.
@@ -1063,8 +1219,8 @@ Certifique-se de que sua configuração do TypeScript inclua os tipos gerados au
 
 Para isso, você pode adicionar as seguintes instruções ao seu arquivo `.gitignore`:
 
-```plaintext
-# Ignorar os arquivos gerados pelo Intlayer
+```bash
+#  Ignorar os arquivos gerados pelo Intlayer
 .intlayer
 ```
 

package/docs/pt/vs_code_extension.md

@@ -120,7 +120,7 @@ A extensão pode carregar variáveis de ambiente do seu espaço de trabalho para
 
 #### Selecionando o ambiente ativo
 
-- **Paleta de Comandos**: abra a paleta e execute `Intlayer: Select Environment`, depois escolha o ambiente (por exemplo, `development`, `staging`, `production`). A extensão tentará carregar o primeiro arquivo disponível na lista de prioridade acima e mostrará uma notificação como “Loaded env from .env.<env>.local”.
+- **Paleta de Comandos**: abra a paleta e execute `Intlayer: Select Environment`, depois escolha o ambiente (por exemplo, `development`, `staging`, `production`). A extensão tentará carregar o primeiro arquivo disponível na lista de prioridade acima e mostrará uma notificação como “Loaded env from `.env.<env>.local`”.
 - **Configurações**: vá para `Settings → Extensions → Intlayer` e defina:
   - **Environment**: o nome do ambiente usado para resolver arquivos `.env.<env>*`.
   - (Opcional) **Env File**: um caminho explícito para um arquivo `.env`. Quando fornecido, ele tem precedência sobre a lista inferida.

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)