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

package/docs/pt/packages/react-intlayer/useDictionary.md

@@ -28,98 +28,6 @@ author: aymericzip
 
 Esta seção fornece orientações detalhadas sobre o uso do hook `useDictionary` em aplicações React, permitindo a manipulação eficiente de conteúdo localizado sem um editor visual.
 
-## Importando `useDictionary` no React
-
-O hook `useDictionary` pode ser integrado em aplicações React importando-o conforme o contexto:
-
-- **Componente Cliente:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer"; // Usado em componentes React no lado do cliente
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer"; // Usado em componentes React no lado do cliente
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer"); // Usado em componentes React no lado do cliente
-  ```
-
-- **Componente Servidor:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer/server"; // Usado em componentes React no lado do servidor
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer/server"; // Usado em componentes React no lado do servidor
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer/server"); // Usado em componentes React no lado do servidor
-  ```
-
-## Parâmetros
-
-O hook aceita dois parâmetros:
-
-1. **`dictionary`**: Um objeto dicionário declarado contendo conteúdo localizado para chaves específicas.
-2. **`locale`** (opcional): O locale desejado. Por padrão, usa o locale do contexto atual se não for especificado.
-
-## Dicionário
-
-Todos os objetos dicionário devem ser declarados em arquivos de conteúdo estruturado para garantir a segurança de tipos e evitar erros em tempo de execução. Você pode encontrar as [instruções de configuração aqui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md). Aqui está um exemplo de declaração de conteúdo:
-
-```typescript fileName="./component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-const componentContent = {
-  key: "component-example",
-  content: {
-    title: t({
-      en: "Client Component Example",
-      fr: "Exemple de composant client",
-      es: "Ejemplo de componente cliente",
-    }),
-    content: t({
-      en: "This is the content of a client component example",
-      fr: "Ceci est le contenu d'un exemple de composant client",
-      es: "Este es el contenido de un ejemplo de componente cliente",
-    }),
-  },
-} satisfies Dictionary;
-
-export default componentContent;
-```
-
-```json fileName="./component.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "component-example",
-  "content": {
-    "title": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Client Component Example",
-        "fr": "Exemple de composant client",
-        "es": "Exemplo de componente cliente",
-        "pt": "Exemplo de Componente Cliente"
-      }
-    },
-    "content": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "This is the content of a client component example",
-        "fr": "Ceci est le contenu d'un exemple de composant client",
-        "es": "Este es el contenido de un ejemplo de componente cliente",
-        "pt": "Este é o conteúdo de um exemplo de componente cliente"
-      }
-    }
-  }
-}
-```
-
 ## Exemplo de Uso no React
 
 Abaixo está um exemplo de como usar o hook `useDictionary` em um componente React:
@@ -141,35 +49,6 @@ const ComponentExample: FC = () => {
 };
 ```
 
-## Integração com Servidor
-
-Se estiver usando o hook `useDictionary` fora do `IntlayerProvider`, o locale deve ser fornecido explicitamente como parâmetro ao renderizar o componente:
-
-```tsx fileName="./ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useDictionary } from "react-intlayer/server";
-import clientComponentExampleContent from "./component.content";
-
-const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
-  const { content } = useDictionary(clientComponentExampleContent, locale);
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.content}</p>
-    </div>
-  );
-};
-```
-
-## Notas sobre Atributos
-
-Ao contrário das integrações que utilizam editores visuais, atributos como `buttonTitle.value` não se aplicam aqui. Em vez disso, acesse diretamente as strings localizadas conforme declaradas no seu conteúdo.
-
-```jsx
-<button title={content.title}>{content.content}</button>
-```
-
 ## Dicas Adicionais
 
 - **Segurança de Tipo**: Sempre use `Dictionary` para definir seus dicionários para garantir segurança de tipo.

package/docs/pt/packages/react-intlayer/useIntlayer.md

@@ -29,49 +29,6 @@ author: aymericzip
 
 Esta seção fornece orientações detalhadas sobre o uso do hook `useIntlayer` em aplicações React, permitindo uma localização eficiente de conteúdo.
 
-## Importando `useIntlayer` no React
-
-O hook `useIntlayer` pode ser integrado em aplicações React importando-o conforme o contexto:
-
-- **Componente Cliente:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Usado em componentes React no lado do cliente
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Usado em componentes React no lado do cliente
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Usado em componentes React no lado do cliente
-  ```
-
-- **Componente Servidor:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Usado em componentes React no lado do servidor
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Usado em componentes React no lado do servidor
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Usado em componentes React no lado do servidor
-  ```
-
-## Parâmetros
-
-O hook aceita dois parâmetros:
-
-1. **`key`**: A chave do dicionário para recuperar o conteúdo localizado.
-2. **`locale`** (opcional): A localidade desejada. Por padrão, utiliza a localidade do contexto se não especificada.
-
-## Dicionário
-
-Todas as chaves do dicionário devem ser declaradas dentro dos arquivos de declaração de conteúdo para aumentar a segurança de tipos e evitar erros. Você pode encontrar as [instruções de configuração aqui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md).
-
 ## Exemplo de Uso em React
 
 Demonstrando o hook `useIntlayer` dentro de um componente React:
@@ -131,14 +88,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Manipulação de Atributos
-
-Ao localizar atributos, acesse os valores do conteúdo de forma apropriada:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Recursos Adicionais
 
 - **Editor Visual Intlayer**: Para uma experiência de gerenciamento de conteúdo mais intuitiva, consulte a documentação do editor visual [aqui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md).

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 - это сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямым показателем технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его прогрессом и, вероятно, будут его использовать. Для оценки ценности проекта звезды помогают сравнивать популярность альтернатив и дают представление о росте экосистемы.