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

package/docs/pt/plugins/sync-po.md

@@ -319,7 +319,7 @@ Os arquivos PO sincronizados serão considerados como outros arquivos `.content`
 - `intlayer content push` para enviar os arquivos PO sincronizados
 - `intlayer content pull` para baixar os arquivos PO sincronizados
 
-Consulte o [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) para mais detalhes.
+Consulte o [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/index.md) para mais detalhes.
 
 ## Limitações (atuais)
 

package/docs/pt/readme.md

@@ -244,9 +244,9 @@ Explore a nossa documentação completa para começar com o Intlayer e aprender
 <ul>
   <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/nextjs.md" rel=''>Next.js</a></li>
   <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/tanstack.md" rel=''>TanStack Start</a></li>
-  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md" rel=''>Vue</a></li>
-  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md" rel=''>Solid</a></li>
-  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md" rel=''>Svelte</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/vue.md" rel=''>Vue</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/solid.md" rel=''>Solid</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/svelte.md" rel=''>Svelte</a></li>
 </ul>
 </details>
 

package/docs/pt/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Bem-vindo ao Intlayer v6! Esta versão foca em desempenho, experiência do desenvolvedor e confiabilidade. Abaixo estão os destaques, com notas de migração e exemplos prontos para copiar e colar.
 
+## Índice
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Destaques
 
 - Novo comando: `npx intlayer content test` para detectar traduções faltantes
@@ -294,6 +298,24 @@ Consulte [CMS e Sincronização ao Vivo](https://github.com/aymericzip/intlayer/
 
 ---
 
+## Processo paralelo para monitorar arquivos no turbopack
+
+Ao usar Turbopack no Next.js 14 e superior como seu servidor de desenvolvimento com o comando `next dev --turbopack`, as mudanças no dicionário não serão detectadas automaticamente por padrão.
+
+Esta limitação ocorre porque o Turbopack não consegue executar plugins do webpack em paralelo para monitorar mudanças em seus arquivos de conteúdo.
+
+Para contornar isso, usamos o comando `intlayer watch`, usando a opção `--with` para executar simultaneamente tanto o servidor de desenvolvimento quanto o watcher de build do Intlayer.
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
 ## Notas de migração
 
 - Removido: `dictionaryOutput` (anteriormente `i18next` ou `next-intl`). Isso voltará como adaptadores plugáveis em versões futuras. Remova o campo da sua configuração.
@@ -312,6 +334,12 @@ Consulte [CMS e Sincronização ao Vivo](https://github.com/aymericzip/intlayer/
 
 ---
 
+## Notas de migração de v6 para v7
+
+Verifique as [notas de migração de v6 para v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/releases/v7.md) para mais informações.
+
+---
+
 ## Links úteis
 
 - [Referência CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/index.md)

package/docs/pt/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Bem-vindo à Intlayer v7! Esta grande versão traz melhorias significativas em desempenho, segurança de tipos e experiência do desenvolvedor. Abaixo estão os destaques, com notas de migração e exemplos práticos.
 
+## Índice
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Destaques
 
 - Estratégia de cache para builds mais rápidos
@@ -260,6 +264,126 @@ Isso resulta em tempos de download mais rápidos e melhor desempenho em tempo de
 
 ---
 
+## Formatação Automática de Código: configuração formatCommand
+
+v7 introduz a opção `formatCommand` na configuração do editor, permitindo que você formate automaticamente os arquivos de conteúdo quando forem escritos pelo Intlayer. Isso garante um estilo de código e formatação consistentes em seus arquivos de declaração de conteúdo.
+
+Se não definido, Intlayer tentará detectar o comando de formatação automaticamente. Tentando resolver os seguintes comandos: prettier, biome, eslint.
+
+### Configuração
+
+A opção `formatCommand` aceita um template de string onde `{{file}}` será substituído pelo caminho do arquivo real:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Formatadores suportados
+
+Você pode usar qualquer formatador de código que aceite caminhos de arquivo como argumentos:
+
+**Usando Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Usando Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Usando ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Usando o formatador integrado do Bun:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Benefícios
+
+- **Formatação consistente**: Todos os arquivos de conteúdo são automaticamente formatados de acordo com as diretrizes de estilo do seu projeto
+- **Experiência do desenvolvedor**: Sem necessidade de formatar manualmente arquivos após o Intlayer escrevê-los
+- **Consistência da equipe**: Garante que todos os membros da equipe tenham a mesma formatação aplicada aos arquivos de conteúdo
+- **Integração CI/CD**: Arquivos de conteúdo mantêm formatação consistente em fluxos de trabalho automatizados
+
+### Como funciona
+
+When Intlayer writes or updates a content declaration file (`.content.ts`, `.content.js`, etc.), it automatically runs the specified format command on the file. The `{{file}}` placeholder is replaced with the actual file path, and the command is executed in the project's base directory.
+
+---
+
+## Configuração de Dicionário: Melhor organização e estrutura
+
+v7 introduz uma nova seção de configuração `dictionary` dedicada que oferece melhor organização para configurações relacionadas a dicionários e gerenciamento de conteúdo aprimorado.
+
+### Nova estrutura de configuração de dicionário
+
+A propriedade `fill` foi movida da seção `content` para uma nova seção `dictionary`, proporcionando uma separação de responsabilidades mais clara:
+
+**Configuração v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Configuração v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Benefícios da nova estrutura
+
+- **Organização mais clara**: As configurações específicas do dicionário agora estão agrupadas
+- **Melhor separação de responsabilidades**: A descoberta de conteúdo versus operações de dicionário estão claramente separadas
+- **Manutenibilidade aprimorada**: Mais fácil entender e modificar as configurações relacionadas ao dicionário
+- **Extensibilidade futura**: A seção de dicionário pode acomodar configurações adicionais específicas do dicionário
+- **Gerenciamento abrangente de dicionário**: Inclui propriedades como `title`, `live`, `priority`, `tags`, `version` e `description` para criar e gerenciar novos dicionários
+
+### Uso da configuração
+
+A configuração do dicionário serve dois propósitos principais:
+
+1. **Valores padrão**: Definir valores padrão ao criar ficheiros de declaração de conteúdo
+2. **Comportamento de fallback**: Fornecer valores de fallback quando campos específicos não estão definidos, permitindo-lhe definir o comportamento da operação do dicionário globalmente
+
+A seção do dicionário inclui propriedades abrangentes para gerenciamento de dicionário:
+
+- **`fill`**: Comportamento de preenchimento automático para geração de conteúdo
+- **`title`**: Título padrão para novos dicionários
+- **`live`**: Configuração de sincronização em tempo real para atualizações em tempo real
+- **`priority`**: Configurações de prioridade para resolução de dicionário
+- **`tags`**: Tags padrão para organização de conteúdo
+- **`version`**: Gerenciamento de versão para atualizações de dicionário
+- **`description`**: Descrição padrão para novo conteúdo
+
+Para mais informações sobre ficheiros de declaração de conteúdo e como os valores de configuração são aplicados, consulte a [Documentação de Ficheiros de Conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md).
+
+---
+
 ## Comando fill: comportamento atualizado para melhor gerenciamento de conteúdo
 
 A versão 7 introduz um comportamento aprimorado para o comando `fill`, proporcionando um gerenciamento de conteúdo mais previsível e flexível:
@@ -407,6 +531,10 @@ O sistema automaticamente:
 - **`middleware.prefixDefault`**: Substituído por `routing.mode`
 - **`middleware.noPrefix`**: Substituído por `routing.mode`
 
+### Novas configurações
+
+- **`editor.formatCommand`**: Nova opção para formatação automática de código em arquivos de conteúdo
+
 ### Mapeamento de migração
 
 #### Mapeamento de configuração

package/docs/pt/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Novo Intlayer v9 - O que há de novo?
 description: Descubra o que há de novo no Intlayer v9. Apresentando pacotes de compatibilidade drop-in para bibliotecas i18n populares e suporte para Collections, Variants e Dynamic Records.
 keywords:
@@ -216,6 +216,42 @@ Em tempo de build, o `@intlayer/swc` e o `@intlayer/babel` escaneiam seus arquiv
 
 ---
 
+## Vite Plugin: Compilador Agrupado & Proxy
+
+O plugin Vite `intlayer()` agora agrupa o **compilador** e o **proxy de roteamento de localidade** diretamente, então a maioria dos projetos precisa apenas de um único plugin em `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compilador**: Ativa automaticamente quando `compiler.enabled` é definido e um caminho `compiler.output` é configurado. Você não precisa mais registrar `intlayerCompiler()` separadamente.
+- **Proxy**: Ativa automaticamente com base na nova opção `routing.enableProxy` (`true` por padrão). Ele conecta o middleware de detecção de localidade / redirecionamento / reescrita em desenvolvimento, visualização e SSR de produção. Você não precisa mais registrar `intlayerProxy()` separadamente.
+
+### Opção `routing.enableProxy`
+
+Uma nova opção `routing.enableProxy` controla se o proxy de roteamento de locale está conectado. O padrão é `true`. Desative-o quando quiser lidar com o roteamento de locale você mesmo:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Padrão: true
+  },
+};
+
+export default config;
+```
+
+Os plugins standalone `intlayerCompiler()` e `intlayerProxy()` permanecem exportados para configurações avançadas. Registrá-los junto com `intlayer()` é seguro — cada plugin se deduplica e é executado apenas uma vez.
+
+---
+
 ## Notas de migração da v8
 
 Se você estiver atualizando da v8, observe que a v9 não inclui breaking changes. Mas aqui estão as principais mudanças:

package/docs/pt/roadmap.md

@@ -29,6 +29,12 @@ Intlayer é uma solução de gestão de conteúdo e internacionalização projet
 
 ---
 
+## Índice
+
+<TOC/>
+
+---
+
 ## Recursos Atuais
 
 ### 1. Declaração de Conteúdo

package/docs/ru/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 Intlayer позволяет автоматически генерировать переводы для ваших файлов декларации контента. Существует несколько способов достичь этого в зависимости от вашего рабочего процесса.
 
+## Содержание
+
+<TOC/>
+
 ## Использование CMS
 
 С Intlayer вы можете использовать рабочий процесс, при котором локально объявляется только одна локаль, а все переводы управляются удаленно через CMS. Это позволяет полностью отделить контент и переводы от кодовой базы, обеспечивая большую гибкость для редакторов контента и позволяя горячую перезагрузку контента (нет необходимости пересобирать приложение для применения изменений).

package/docs/ru/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# Автоматическое заполнение файлов объявления контента переводов
+
+**Автоматическое заполнение файлов объявления контента** в вашей CI — это способ ускорить рабочий процесс разработки.
+
+## Понимание поведения
+
+Команда `fill` включает два режима:
+
+- **Complete**: Автоматически заполняет все недостающее содержимое для каждой локали и редактирует текущий файл или другой файл, если он указан. То есть режим complete пропустит перевод существующего содержимого, если оно уже переведено.
+- **Review**: Автоматически заполняет **все** содержимое для каждой локали и генерирует для конкретного файла или другого файла, если он указан.
+
+Команда fill будет обрабатывать все ваши файлы объявления содержимого локали. То есть она не будет обрабатывать ваше удаленное содержимое из CMS. CMS включает собственное управление переводами.
+Если вы используете плагины, такие как `@intlayer/sync-json-plugin`, Intlayer преобразует файлы JSON в файлы объявления содержимого локали. То есть они будут обработаны командой `fill`.
+
+Новые сгенерированные файлы включают инструкцию `filled` в качестве метаданных словаря. Эта инструкция будет использоваться Intlayer для определения того, был ли файл автоматически заполнен или нет, и пропустит этот файл от повторного перевода, если она присутствует.
+
+Intlayer также будет учитывать следующую инструкцию для автоматического заполнения:
+
+- Из вашего `.content.{ts|js|json}` → инструкция `fill`
+- Из вашего файла конфигурации `.intlayer.config.ts` → инструкция `dictionary.fill`
+- По умолчанию будет установлено значение `true`
+
+Для файлов объявления содержимого для каждой локали инструкция `true` будет заменена на `./{{fileName}}.fill.content.json`. Это потому, что файл объявления содержимого для каждой локали не может получать дополнительное локализованное содержимое. Поэтому он будет генерировать новый файл, чтобы не перезаписать существующий файл.
+
+## Поведение по умолчанию
+
+По умолчанию `fill` установлено в `true` глобально, что означает, что Intlayer будет автоматически заполнять все файлы контента и редактировать сам файл. Это поведение можно настроить несколькими способами:
+
+### Глобальные параметры конфигурации
+
+1. **`fill: true` (по умолчанию)** - Автоматически заполнить все локали и отредактировать текущий файл
+2. **`fill: false`** - Отключить автоматическое заполнение для этого файла контента
+3. **`fill: "./relative/path/to/file"`** - Создать/обновить указанный файл без редактирования текущего, указав относительный путь, разрешенный на основе расположения текущего файла
+4. **`fill: "/absolute/path/to/file"`** - Создать/обновить указанный файл без редактирования текущего, указав относительный путь, разрешенный на основе расположения базовой директории (поле `baseDir` в файле конфигурации `.intlayer.config.ts`)
+5. **`fill: "C:\\absolute\path\to\file"`** - Создать/обновить указанный файл без редактирования текущего, указав абсолютный путь, разрешенный на основе вашей операционной системы
+6. **`fill: { [key in Locales]?: string }`** - Создать/обновить указанный файл для каждой локали
+
+### Изменения поведения в v7
+
+В v7 поведение команды `fill` было обновлено:
+
+- **`fill: true`** - Перезаписывает текущий файл с заполненным содержимым для всех локалей
+- **`fill: "path/to/file"`** - Заполняет указанный файл без изменения текущего файла
+- **`fill: false`** - Полностью отключает автоматическое заполнение
+
+При использовании опции пути для записи в другой файл механизм заполнения работает через отношение _master-slave_ между файлами объявления содержимого. Основной файл (master) служит источником истины, и при его обновлении Intlayer автоматически применит эти изменения к производным (заполненным) файлам объявления, указанным в пути.
+
 # Переводы файлов декларации автозаполнения контента
 
 **Файлы декларации автозаполнения контента**, это способ ускорить ваш процесс разработки.
@@ -88,6 +135,40 @@ Intlayer автоматически сгенерирует производны
 
 После этого оба файла деклараций будут объединены в один словарь, доступный через стандартный хук `useIntlayer("example")` (react) / композицию (vue).
 
+## Глобальная конфигурация
+
+Вы можете настроить глобальную конфигурацию автозаполнения в файле `intlayer.config.ts`.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // Автогенерация отсутствующих переводов для всех словарей
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // автогенерация отсутствующих переводов для всех словарей, как при использовании "./{{fileName}}.content.json"
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+Вы по-прежнему можете настраивать каждый словарь отдельно, используя поле `fill` в файлах содержимого. Intlayer сначала рассмотрит конфигурацию каждого словаря, а затем вернётся к глобальной конфигурации.
+
 ## Формат автозаполненного файла
 
 Рекомендуемый формат для автоматически заполняемых файлов деклараций, **JSON**, который помогает избежать ограничений форматирования. Однако Intlayer также поддерживает форматы `.ts`, `.js`, `.mjs`, `.cjs` и другие.

package/docs/ru/benchmark/solid.md

@@ -117,6 +117,28 @@ history:
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что фактически появилось в сети и сколько времени это заняло. Размеры указаны **после обычного сжатия веб-контента**, поскольку это ближе к тому, что люди загружают, чем к подсчету необработанного исходного кода.
+
+- **Размер библиотеки интернационализации**: После объединения, удаления неиспользуемого кода и минификации размер библиотеки i18n — это размер поставщиков + код hooks/primitives в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорогостоящей является библиотека до того, как ваш контент вступит в игру.
+
+- **JavaScript на странице**: Для каждого маршрута бенчмарка — сколько скрипта браузер загружает при посещении, усредненное по страницам в наборе (и по языкам, где отчет их объединяет). Тяжелые страницы — медленные страницы.
+
+- **Утечка из других языков**: Это контент той же страницы, но на другом языке, который может быть случайно загружен на проверяемую страницу. Этот контент является ненужным и должен быть избегнут. (например, содержимое страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: То же самое для **других экранов** приложения: загружается ли их контент вместе с ними при открытии только одной страницы. (например, содержимое страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разделение или слишком широкие пакеты.
+
+- **Средний размер пакета компонента**: Общие элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного огромного числа приложения. Это показывает, незаметно ли интернационализация увеличивает повседневные компоненты. Например, если ваш компонент перерисовывается, он загружает все эти данные из памяти. Присоединение большого JSON к любому компоненту похоже на подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Отзывчивость переключения языка**: Я переключаю язык с помощью элемента управления приложением и отсчитываю время до четкого переключения страницы, что заметит посетитель, а не микрошаг в лаборатории.
+
+- **Работа отрисовки после смены языка**: Более узкое продолжение: сколько усилий потребовалось интерфейсу на перерисовку для нового языка после инициирования переключения. Полезно, когда "субъективное" время и затраты фреймворка расходятся.
+
+- **Время начальной загрузки страницы**: От навигации до того, как браузер считает страницу полностью загруженной для проверенных сценариев. Хорошо подходит для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это раскрывает, сколько времени клиент тратит на преобразование HTML сервера в то, на что вы фактически можете щелкнуть. Прочерк в таблицах означает, что эта реализация не предоставила надежное значение гидратации в этом бенчмарке.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/benchmark/svelte.md

@@ -116,6 +116,28 @@ style="border:none;"
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что действительно появилось на сети и сколько времени это заняло. Размеры указаны **после обычного веб-сжатия**, поскольку это ближе к тому, что люди загружают, чем к подсчёту исходного кода.
+
+- **Размер библиотеки интернационализации**: После объединения, встряхивания дерева и минификации размер библиотеки i18n — это размер кода провайдеров и хранилищ в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорога библиотека до того, как ваше содержимое попадёт в картину.
+
+- **JavaScript на странице**: Для каждого маршрута тестирования, сколько скриптов браузер подгружает при этом посещении, усреднённое по страницам в наборе (и по локалям, где отчёт их объединяет). Тяжёлые страницы — это медленные страницы.
+
+- **Утечка из других локалей**: Это содержимое той же страницы, но на другом языке, которое может быть загружено по ошибке в проверяемую страницу. Это содержимое не нужно и его следует избегать. (например, содержимое страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: Та же идея для **других экранов** в приложении: загружается ли их копия, когда вы открыли только одну страницу. (например, содержимое страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разделение или чрезмерно широкие пакеты.
+
+- **Средний размер пакета компонента**: Общие элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного гигантского числа приложения. Это показывает, скрытно ли интернационализация увеличивает повседневные компоненты. Например, если ваш компонент перерисовывается, он загружает все эти данные из памяти. Присоединение большого JSON к любому компоненту похоже на подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Отзывчивость переключения языка**: Я переключаю язык с помощью собственного элемента управления приложения и измеряю, сколько времени проходит, пока страница явно не переключится, что заметил бы посетитель, а не лабораторный микрошаг.
+
+- **Работа рендеринга после изменения языка**: Более узкое продолжение: сколько усилий потребовалось интерфейсу, чтобы перерисовать новый язык, когда переключение уже в пути. Полезно, когда «субъективное» время и стоимость фреймворка расходятся.
+
+- **Время начальной загрузки страницы**: От навигации до того, как браузер считает страницу полностью загруженной для протестированных сценариев. Хорошо для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это раскрывает, сколько времени клиент тратит на превращение HTML-кода сервера во что-то, на что можно действительно щёлкнуть. Тире в таблицах означает, что эта реализация не предоставила надёжную цифру гидратации в этом тесте.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/benchmark/tanstack.md

@@ -124,6 +124,28 @@ history:
 - **Локальная статическая (Scoped static)**: Позволяет организовать код (логическое разделение) без сложных дополнительных сетевых запросов.
 - **Локальная динамическая (Scoped dynamic)**: Лучший подход для _разделения кода_ и производительности. Минимизирует использование памяти, загружая только то, что нужно для текущего представления и активной локали.
 
+### Что я измерял:
+
+Я запустил одно и то же многоязычное приложение в реальном браузере для каждого стека, а затем записал, что фактически показалось в сети и сколько времени это заняло. Размеры указаны **после стандартного веб-сжатия**, потому что это ближе к тому, что люди скачивают, чем к подсчёту исходного кода.
+
+- **Размер библиотеки интернационализации**: После bundling, tree-shaking и minification размер библиотеки i18n — это размер поставщиков (например `NextIntlClientProvider`) + код hooks (например `useTranslations`) в пустом компоненте. Это не включает загрузку файлов переводов. Это показывает, насколько дорогой является библиотека, прежде чем в игру вступит ваш контент.
+
+- **JavaScript на странице**: Для каждого маршрута тестирования, сколько скрипта браузер загружает при каждом посещении, усреднённые по страницам в наборе (и по локалям, где отчёт их объединяет). Тяжёлые страницы — медленные страницы.
+
+- **Утечка из других локалей**: Это контент той же страницы, но на другом языке, который по ошибке загружается на проверяемую страницу. Этот контент не нужен и его следует избегать. (например, контент страницы `/fr/about` в пакете страницы `/en/about`)
+
+- **Утечка из других маршрутов**: То же самое для **других экранов** приложения: загружается ли их копия вместе с тем, когда вы открыли только одну страницу. (например, контент страницы `/en/about` в пакете страницы `/en/contact`). Высокий результат указывает на слабое разбиение или слишком широкие пакеты.
+
+- **Средний размер пакета компонента**: Обычные элементы пользовательского интерфейса измеряются **по одному** вместо того, чтобы скрываться внутри одного гигантского числа приложения. Это показывает, скрывает ли интернационализация незаметно раздуванием обычные компоненты. Например, если ваш компонент переуходит, он загружает все эти данные из памяти. Привязка большого JSON к любому компоненту — это как подключение большого хранилища неиспользуемых данных, которое замедлит производительность ваших компонентов.
+
+- **Скорость переключения языка**: Я переключаю язык с помощью собственного элемента управления приложения и замеряю, сколько времени проходит до того, как страница явно переключится, что заметит посетитель, а не лабораторный микро-шаг.
+
+- **Работа по рендерингу после смены языка**: Более узкое продолжение: сколько усилий затратил интерфейс на перерисовку нового языка после того, как переключение началось. Полезно, когда "ощущаемое" время и стоимость framework расходятся.
+
+- **Время первоначальной загрузки страницы**: От навигации до того момента, когда браузер считает страницу полностью загруженной для тестируемых сценариев. Хорошо подходит для сравнения холодных запусков.
+
+- **Время гидратации**: Когда приложение это предоставляет, как долго клиент потратит на превращение серверного HTML во что-то, на что вы действительно можете нажать. Прочерк в таблицах означает, что эта реализация не предоставила надежный показатель гидратации в этом тесте.
+
 ## Звезды на GitHub
 
 Звезды на GitHub - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.

package/docs/ru/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Строительные блоки GitHub Actions
+
+При запуске `intlayer init`, Intlayer определяет ваш package manager (npm, yarn, pnpm или bun) и создает два workflow'а GitHub Actions в папке `.github/workflows/`, с командами, соответствующими вашему package manager'у:
+
+- **`intlayer-fill.yml`** — При каждом pull request'е собирает словари и запускает `intlayer fill --git-diff --mode complete` для генерации недостающих переводов в измененных словарях, а затем коммитит результат обратно в ветку PR.
+- **`intlayer-test.yml`** — При каждом pull request'е собирает словари и запускает `intlayer test`, не пропуская проверку, когда требуемым локалям не хватает переводов.
+
+Существующие файлы workflow никогда не перезаписываются. Чтобы полностью пропустить создание строительных блоков, запустите:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Предоставление доступа к ИИ для рабочего процесса fill
+
+Созданный файл `intlayer-fill.yml` требует доступа к ИИ. Доступны два варианта (настраиваются в блоке `env` рабочего процесса):
+
+1. **Ваш собственный ключ поставщика ИИ** — добавьте секрет `AI_API_KEY` в настройки репозитория (Settings → Secrets and variables → Actions). Рабочий процесс передает его через `--provider`, `--model` и `--api-key`.
+2. **Ключи доступа Intlayer CMS** — добавьте секреты `INTLAYER_CLIENT_ID` и `INTLAYER_CLIENT_SECRET` и свяжите их с разделом `editor` в вашем `intlayer.config`. Ключи доступа CMS предоставляют доступ к ИИ через backend Intlayer.
+
+Рабочий процесс `intlayer-test.yml` не требует доступа к ИИ.
+
 ## Обработка ошибок
 
 - Если `INTLAYER_PROJECT_CREDENTIALS` не установлена, команда завершится с ошибкой.

package/docs/ru/cli/fill.md

@@ -47,6 +47,14 @@ bun x intlayer fill
 - Сохраняет существующие переводы, не перезаписывая их.
 - Обрабатывает файлы, части и локали параллельно с использованием системы очередей для увеличения скорости.
 
+## Ключевые моменты:
+
+- Разделяет большие JSON файлы на chunks, чтобы оставаться в пределах контекстного окна AI модели.
+- Повторяет перевод, если формат вывода некорректен.
+- Включает контекст приложения и файла для улучшенной точности перевода.
+- Сохраняет существующие переводы, не перезаписывая их.
+- Обрабатывает файлы, chunks и locales параллельно, используя систему очередей для увеличения скорости.
+
 ## Псевдонимы:
 
 - `npx intlayer dictionaries fill`

package/docs/ru/cli/login.md

@@ -80,42 +80,6 @@ bun x intlayer login --cms-url https://intlayer.org
 
 Вы также можете использовать общие параметры конфигурации:
 
-- `--env-file <path>`: Путь к файлу окружения
-- `-e, --env <env>`: Среда выполнения
-- `--base-dir <dir>`: Базовый каталог проекта
-- `--verbose`: Включить подробный вывод (по умолчанию: true)
-- `--prefix <prefix>`: Префикс для логов
-
-## Как это работает
-
-1. **Запуск локального сервера**: команда запускает локальный HTTP-сервер на случайном порту, чтобы получить учетные данные от CMS
-
-Укажите URL Intlayer CMS, к которой нужно подключиться для аутентификации.
-
-- **Тип**: `string`
-- **По умолчанию**: Значение, настроенное в `intlayer.config.*` или `https://intlayer.org`
-- **Пример**:
-
-```bash packageManager="npm"
-npx intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="yarn"
-yarn intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="bun"
-bun x intlayer login --cms-url https://intlayer.org
-```
-
-### Параметры конфигурации
-
-Вы также можете использовать общие параметры конфигурации:
-
 - `--env-file <path>`: Путь к файлу окружения
 - `-e, --env <env>`: Среда выполнения
 - `--base-dir <dir>`: Базовая директория проекта