@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.20

package/docs/pl/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: "Samodzielne hostowanie Intlayer"
+description: "Uruchom kompletną instancję Intlayer na własnej infrastrukturze za pomocą jednego polecenia. Konto Intlayer Cloud nie jest wymagane."
+keywords:
+  - Samodzielne hostowanie
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Instalacja
+  - Infrastruktura
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Samodzielne hostowanie Intlayer
+
+Intlayer może działać w całości na Twojej własnej infrastrukturze — konto Intlayer Cloud nie jest wymagane. Jedno polecenie uruchamia gotowy do produkcji stos:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Instalator pobiera plik `docker-compose.yml` oraz `.env`, automatycznie generuje wymagane sekrety i uruchamia wszystkie kontenery za pomocą `docker compose up -d`.
+
+## Spis treści
+
+<TOC/>
+
+---
+
+## Architektura
+
+```
+                ┌─────────────────────────────┐
+ przeglądarka ──────▶ │  aplikacja  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (RS z 1 węzłem)             (API S3)     (SMTP)        (w obrazie)
+                             minio:9001   mailpit:8025
+                             (konsola)    (interfejs webowy)
+```
+
+Chromium (używany do generowania zrzutów ekranu przez Puppeteer) jest dołączony do obrazu backendu — nie jest potrzebny oddzielny kontener.
+
+---
+
+## Wymagania wstępne
+
+- **Docker** ≥ 24 i **Docker Compose** ≥ v2. Jeśli którykolwiek z nich jest brakujący, instalator wyświetli link do instalacji i zakończy działanie.
+- Porty `3000`, `3100`, `8025`, `9000` i `9001` dostępne na hoście.
+- Host Linux lub macOS (lub WSL2 na Windows).
+
+---
+
+## Szybki start
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Co robi instalator:
+
+1.  Sprawdza, czy `docker` i `docker compose` są obecne.
+2.  Pobiera `docker-compose.yml` i `.env.example` do `./intlayer/`.
+3.  Jeśli plik `.env` nie istnieje, kopiuje przykład i generuje losowe sekrety dla `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` i `S3_SECRET_ACCESS_KEY` za pomocą `openssl rand`.
+4.  Uruchamia `docker compose pull` + `docker compose up -d`.
+5.  Wyświetla adresy URL: pulpit nawigacyjny `:3000`, API `:3100`, interfejs e-mail `:8025`, konsola MinIO `:9001`.
+
+Po uruchomieniu stosu, otwórz **http://localhost:3000** i utwórz swoje pierwsze konto.
+
+---
+
+## Usługi
+
+| Usługa        | Obraz                                 | Port(y) hosta                            | Cel                                                               |
+| :------------ | :------------------------------------ | :--------------------------------------- | :---------------------------------------------------------------- |
+| **aplikacja** | zbudowana z `apps/app/Dockerfile`     | `3000`                                   | Pulpit nawigacyjny TanStack Start (interfejs użytkownika CMS)     |
+| **backend**   | zbudowany z `apps/backend/Dockerfile` | `3100`                                   | Fastify REST API (punkt końcowy `/health`)                        |
+| **mongo**     | `mongo:7`                             | wewnętrzny                               | Zestaw replikacji z jednym węzłem (`rs0`)                         |
+| **redis**     | `redis:7-alpine`                      | wewnętrzny                               | Kolejki zadań (BullMQ) i buforowanie (ioredis)                    |
+| **minio**     | `minio/minio`                         | `9000` (S3), `9001` (konsola)            | Przechowywanie obiektów zgodne z S3 dla awatarów i zrzutów ekranu |
+| **mailpit**   | `axllent/mailpit`                     | `1025` (SMTP), `8025` (interfejs webowy) | Lokalny odbiornik transakcyjnych wiadomości e-mail                |
+
+Wewnętrzne porty (mongo, redis) nie są domyślnie udostępniane na hoście.
+
+> Port MinIO `9000` musi być osiągalny przez przeglądarkę, ponieważ przesłane zasoby (awatary, zrzuty ekranu) są ładowane bezpośrednio z `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Zmienne środowiskowe
+
+Instalator generuje gotowy do użycia plik `.env`. Poniższa tabela opisuje każdą zmienną.
+
+### Wymagane (generowane automatycznie lub monitowane)
+
+| Zmienna                | Przykład                                        | Opis                                                            |
+| :--------------------- | :---------------------------------------------- | :-------------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Środowisko uruchomieniowe                                       |
+| `PORT`                 | `3100`                                          | Port nasłuchiwania backendu                                     |
+| `BACKEND_URL`          | `http://localhost:3100`                         | Publiczny URL API backendu                                      |
+| `APP_URL`              | `http://localhost:3000`                         | Publiczny URL pulpitu nawigacyjnego                             |
+| `DOMAIN`               | `localhost`                                     | Domena plików cookie                                            |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | Pełny URI połączenia z MongoDB                                  |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL połączenia z Redis                                          |
+| `BETTER_AUTH_SECRET`   | _(generated)_                                   | 32-bajtowy sekret do podpisywania sesji                         |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transport poczty: `smtp` lub `resend`                           |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nazwa hosta SMTP (nazwa kontenera Mailpit)                      |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Port SMTP                                                       |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Adres nadawcy                                                   |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Punkt końcowy zgodny z S3                                       |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | Publiczny URL do ładowania zasobów przez przeglądarkę           |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nazwa zasobnika (bucket)                                        |
+| `S3_ACCESS_KEY_ID`     | _(generated)_                                   | Klucz dostępu MinIO                                             |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                                   | Tajny klucz MinIO                                               |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL backendu wbudowany w pulpit nawigacyjny w czasie kompilacji |
+| `VITE_DOMAIN`          | `localhost`                                     | Domena wbudowana w pulpit nawigacyjny w czasie kompilacji       |
+
+### Opcjonalne (funkcje działają z ograniczoną funkcjonalnością, gdy ich brakuje)
+
+| Zmienna                                                  | Funkcja                                                                                         |
+| :------------------------------------------------------- | :---------------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Tłumaczenie wspomagane AI i audyt treści                                                        |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Zarządzanie płatnościami i subskrypcjami                                                        |
+| `RESEND_API_KEY`                                         | Transakcyjne wiadomości e-mail za pośrednictwem Resend (przesłania Mailpit, gdy jest ustawione) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Logowanie GitHub OAuth                                                                          |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Logowanie Google OAuth                                                                          |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Logowanie GitLab OAuth                                                                          |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Logowanie Microsoft OAuth                                                                       |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Logowanie LinkedIn OAuth                                                                        |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Logowanie Atlassian OAuth                                                                       |
+
+---
+
+## Łączenie Twojego projektu Intlayer
+
+Po uruchomieniu stosu, skieruj swój projekt na samodzielnie hostowany backend i pulpit nawigacyjny zamiast na `intlayer.org`.
+
+### Konfiguracja projektu
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL samodzielnie hostowanego pulpitu nawigacyjnego CMS.
+     * Domyślnie: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // np. http://localhost:3000
+
+    /**
+     * URL samodzielnie hostowanego API backendu.
+     * Domyślnie: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // np. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Ustaw zmienne środowiskowe w pliku `.env` Twojego projektu:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Utwórz dane uwierzytelniające dostęp w swoim samodzielnie hostowanym pulpicie nawigacyjnym w sekcji **Projects → Access keys** pod adresem `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Używając SDK `@intlayer/api` programowo, przekaż `backendURL` jawnie:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Aktualizacja
+
+Ponowne uruchomienie instalatora na istniejącym wdrożeniu wykonuje aktualizację krokową:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Spowoduje to pobranie najnowszych obrazów i ponowne uruchomienie kontenerów za pomocą `docker compose pull && docker compose up -d`. Istniejące woluminy (`mongo-data`, `redis-data`, `minio-data`) zostaną zachowane — brak utraty danych.
+
+Aby ręcznie zaktualizować z poziomu katalogu `./intlayer/`:
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Kopia zapasowa i przywracanie
+
+Wszystkie trwałe dane znajdują się w trzech nazwach woluminów Docker.
+
+### Kopia zapasowa
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Przywracanie
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Powtórz dla redis-data i minio-data
+```
+
+---
+
+## Używanie reverse proxy (Nginx / Caddy)
+
+W przypadku wdrożeń produkcyjnych, umieść reverse proxy przed kontenerami aplikacji i backendu, zamiast udostępniać je bezpośrednio.
+
+### Przykład Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Zaktualizuj poniższe zmienne `.env`, aby odpowiadały Twoim publicznym domenom:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Zmienne `VITE_*` są wbudowywane w obraz pulpitu nawigacyjnego podczas kompilacji. Jeśli zmienisz je po zbudowaniu obrazu, musisz ponownie zbudować obraz `app` (`docker compose build app`) lub użyć wstrzykiwania konfiguracji w czasie uruchomienia.
+
+---
+
+## Rozwiązywanie problemów
+
+### Backend w pętli awarii przy pierwszym uruchomieniu
+
+MongoDB i Redis muszą być sprawne przed uruchomieniem backendu. Plik compose używa `depends_on` z `condition: service_healthy`. Jeśli widzisz powtarzające się restarty backendu, sprawdź, czy testy kondycji `mongo` i `redis` przechodzą pomyślnie:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Pulpit nawigacyjny nie może dotrzeć do API
+
+Sprawdź, czy `VITE_BACKEND_URL` odpowiada adresowi URL, pod którym backend jest osiągalny z **przeglądarki** (nie z sieci Docker). Jeśli zmieniłeś port backendu lub dodałeś reverse proxy, ponownie zbuduj obraz pulpitu nawigacyjnego:
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### E-mail nie jest wysyłany
+
+Domyślnie wszystkie wychodzące wiadomości e-mail są przechwytywane przez Mailpit. Otwórz `http://localhost:8025`, aby zobaczyć wysłane wiadomości. Aby wysyłać prawdziwe wiadomości e-mail, ustaw `MAIL_PROVIDER=resend` i `RESEND_API_KEY=<your-key>` w `.env`, a następnie zrestartuj backend:
+
+```sh
+docker compose restart backend
+```
+
+### Brak zasobnika MinIO
+
+Jeśli jednorazowa usługa `minio-init` nie uruchomiła się (lub uruchomiła się, zanim MinIO było gotowe), utwórz zasobnik ręcznie:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Przydatne linki
+
+- [Dokumentacja Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)
+- [Referencje konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md)
+- [SDK CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/pt/CI_CD.md

@@ -26,6 +26,10 @@ author: aymericzip
 
 O Intlayer permite a geração automática de traduções para seus arquivos de declaração de conteúdo. Existem várias maneiras de realizar isso dependendo do seu fluxo de trabalho.
 
+## Índice
+
+<TOC/>
+
 ## Usando o CMS
 
 Com o Intlayer, você pode adotar um fluxo de trabalho onde apenas um único idioma é declarado localmente, enquanto todas as traduções são gerenciadas remotamente através do CMS. Isso permite que o conteúdo e as traduções fiquem completamente desacoplados da base de código, oferecendo mais flexibilidade para os editores de conteúdo e possibilitando o recarregamento dinâmico do conteúdo (sem necessidade de reconstruir a aplicação para aplicar as alterações).

package/docs/pt/autoFill.md

@@ -16,6 +16,9 @@ slugs:
   - concept
   - auto-fill
 history:
+  - version: 7.0.0
+    date: 2025-10-23
+    changes: "Renomear `fill` para `fill` e atualizar comportamento"
   - version: 6.0.0
     date: 2025-09-20
     changes: "Adicionada configuração global"
@@ -28,11 +31,77 @@ history:
 author: aymericzip
 ---
 
-# Traduções de Arquivos de Declaração de Conteúdo com Preenchimento Automático
+# Traduzir Traduções de Arquivo de Declaração de Conteúdo
 
 **Arquivos de declaração de conteúdo com preenchimento automático** são uma forma de acelerar seu fluxo de trabalho de desenvolvimento.
 
-O mecanismo de preenchimento automático funciona através de uma relação _mestre-escravo_ entre arquivos de declaração de conteúdo. Quando o arquivo principal (mestre) é atualizado, o Intlayer aplicará automaticamente essas alterações aos arquivos de declaração derivados (preenchidos automaticamente).
+## Entender o comportamento
+
+O comando `fill` inclui dois modos:
+
+- **Completo**: Preenche automaticamente todo o conteúdo faltante para cada localidade e edita o arquivo atual ou outro arquivo se especificado. Ou seja, o modo completo irá pular a tradução do conteúdo existente, se já foi traduzido.
+- **Revisão**: Preenche automaticamente **todo** o conteúdo para cada localidade e gera para um arquivo específico ou outro arquivo se especificado.
+
+O comando fill irá processar todos os seus arquivos de declaração de conteúdo de localidade. Ou seja, não irá processar seu conteúdo remoto do CMS. O CMS inclui seu próprio gerenciamento de traduções.
+Se você usar plugins como `@intlayer/sync-json-plugin`, o Intlayer transformará os arquivos JSON em arquivos de declaração de conteúdo por localidade. Ou seja, eles serão processados pelo comando `fill`.
+
+Os novos arquivos gerados incluem uma instrução `filled` como metadados do dicionário. Esta instrução será usada pelo Intlayer para saber se o arquivo foi preenchido automaticamente ou não e pular este arquivo de ser traduzido novamente se presente.
+
+O Intlayer também considerará a seguinte instrução para preenchimento automático:
+
+- Do seu `.content.{ts|js|json}` → instrução `fill`
+- Do seu arquivo de configuração `.intlayer.config.ts` → instrução `dictionary.fill`
+- Será definido como `true` por padrão caso contrário
+
+Para arquivos de declaração de conteúdo por localidade, a instrução `true` será substituída por `./{{fileName}}.fill.content.json`. Isto é porque um arquivo de declaração de conteúdo por localidade não pode receber conteúdo localizado adicional. Portanto, irá gerar um novo arquivo para não sobrescrever o arquivo existente.
+
+## Comportamento Padrão
+
+Por padrão, `fill` é definido como `true` globalmente, o que significa que o Intlayer irá preencher automaticamente todos os arquivos de conteúdo e editar o arquivo em si. Este comportamento pode ser customizado de várias formas:
+
+### Opções de Configuração Global
+
+1. **`fill: true` (padrão)** - Preenche automaticamente todas as localidades e edita o arquivo atual
+2. **`fill: false`** - Desabilita preenchimento automático para este arquivo de conteúdo
+3. **`fill: "./relative/path/to/file"`** - Cria/atualiza o arquivo especificado sem editar o arquivo atual apontando para um caminho relativo resolvido com base na localização do arquivo atual
+4. **`fill: "/absolute/path/to/file"`** - Cria/atualiza o arquivo especificado sem editar o arquivo atual apontando para um caminho relativo resolvido com base na localização do diretório base (campo `baseDir` no arquivo de configuração `.intlayer.config.ts`)
+5. **`fill: "C:\\absolute\path\to\file"`** - Cria/atualiza o arquivo especificado sem editar o arquivo atual apontando para um caminho absoluto resolvido com base no seu sistema operacional
+6. **`fill: { [key in Locales]?: string }`** - Cria/atualiza o arquivo especificado para cada localidade
+
+### Mudanças de Comportamento v7
+
+Na v7, o comportamento do comando `fill` foi atualizado:
+
+- **`fill: true`** - Reescreve o arquivo atual com conteúdo preenchido para todas as localidades
+- **`fill: "path/to/file"`** - Preenche o arquivo especificado sem modificar o arquivo atual
+- **`fill: false`** - Desabilita preenchimento automático completamente
+
+Ao usar uma opção de caminho para escrever em outro arquivo, o mecanismo de preenchimento funciona através de uma relação _mestre-escravo_ entre arquivos de declaração de conteúdo. O arquivo principal (mestre) serve como fonte da verdade e, quando é atualizado, o Intlayer aplicará automaticamente essas alterações aos arquivos de declaração derivados (preenchidos) especificados pelo caminho.
+
+### Customização Por Localidade
+
+Você também pode customizar o comportamento para cada localidade usando um objeto:
+
+```ts fileName="intlayer.config.ts"
+const config: IntlayerConfig = {
+  content: {
+    internationalization: {
+      locales: [Locales.ENGLISH, Locales.FRENCH, Locales.POLISH],
+      defaultLocale: Locales.ENGLISH,
+      requiredLocales: [Locales.ENGLISH], // Recomendado para evitar a propriedade 'pl' está faltando no tipo '{ en: string; xxx } na sua função t
+    },
+  },
+  dictionary: {
+    fill: {
+      en: true, // Preenche e edita o arquivo atual para Inglês
+      fr: "./translations/fr.json", // Cria arquivo separado para Francês
+      es: false, // Desabilita preenchimento para Espanhol
+    },
+  },
+};
+```
+
+Isto permite que você tenha comportamentos de preenchimento diferentes para diferentes localidades dentro do mesmo projeto.
 
 ```ts fileName="src/components/example/example.content.ts"
 import { Locales, type Dictionary } from "intlayer";
@@ -40,7 +109,7 @@ import { Locales, type Dictionary } from "intlayer";
 const exampleContent = {
   key: "example",
   locale: Locales.ENGLISH,
-  autoFill: "./example.content.json",
+  fill: "./example.content.json",
   content: {
     contentExample: "Este é um exemplo de conteúdo",
   },
@@ -50,7 +119,7 @@ const exampleContent = {
 export default exampleContent;
 ```
 
-Aqui está um [arquivo de declaração de conteúdo por localidade](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/per_locale_file.md) usando a instrução `autoFill`.
+Aqui está um [arquivo de declaração de conteúdo por localidade](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/per_locale_file.md) usando a instrução `fill`.
 
 Então, quando você executar o seguinte comando:
 
@@ -89,6 +158,40 @@ O Intlayer irá gerar automaticamente o arquivo de declaração derivado em `src
 
 Posteriormente, ambos os arquivos de declaração serão mesclados em um único dicionário, acessível usando o hook padrão `useIntlayer("example")` (react) / composable (vue).
 
+## Configuração Global
+
+Você pode configurar a configuração de preenchimento automático global no arquivo `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: {
+    // Gera automaticamente traduções faltantes para todos os dicionários
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // gera automaticamente traduções faltantes para todos os dicionários como usando "./{{fileName}}.content.json"
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+Você ainda pode ajustar melhor por dicionário usando o campo `fill` em arquivos de conteúdo. O Intlayer irá primeiro considerar a configuração por dicionário e então voltar para a configuração global.
+
 ## Formato do Arquivo Preenchido Automaticamente
 
 O formato recomendado para arquivos de declaração preenchidos automaticamente é **JSON**, que ajuda a evitar restrições de formatação. No entanto, o Intlayer também suporta `.ts`, `.js`, `.mjs`, `.cjs` e outros formatos.
@@ -96,7 +199,7 @@ O formato recomendado para arquivos de declaração preenchidos automaticamente
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "./example.filled.content.ts",
+  fill: "./example.filled.content.ts",
   content: {
     // Seu conteúdo
   },
@@ -116,12 +219,12 @@ src/components/example/example.filled.content.ts
 
 ## Caminhos Absolutos
 
-O campo `autoFill` também suporta caminhos absolutos.
+O campo `fill` também suporta caminhos absolutos.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "/messages/example.content.json",
+  fill: "/messages/example.content.json",
   content: {
     // Seu conteúdo
   },
@@ -136,12 +239,12 @@ Isso irá gerar o arquivo em:
 
 ## Geração Automática de Arquivos de Declaração de Conteúdo Por Localidade
 
-O campo `autoFill` também suporta a geração de arquivos de declaração de conteúdo **por localidade**.
+O campo `fill` também suporta a geração de arquivos de declaração de conteúdo **por localidade**.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: {
+  fill: {
     fr: "./example.fr.content.json",
     es: "./example.es.content.json",
   },
@@ -160,12 +263,12 @@ Isso irá gerar dois arquivos separados:
 
 ## Filtrar Autofill para Localidade Específica
 
-Usar um objeto para o campo `autoFill` permite aplicar filtros e gerar apenas arquivos de localidades específicas.
+Usar um objeto para o campo `fill` permite aplicar filtros e gerar apenas arquivos de localidades específicas.
 
 ```ts fileName="src/components/example/example.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: {
+  fill: {
     fr: "./example.fr.content.json",
   },
   content: {
@@ -178,7 +281,7 @@ Isso irá gerar apenas o arquivo de tradução em francês.
 
 ## Variáveis de Caminho
 
-Você pode usar variáveis dentro do caminho `autoFill` para resolver dinamicamente os caminhos de destino para os arquivos gerados.
+Você pode usar variáveis dentro do caminho `fill` para resolver dinamicamente os caminhos de destino para os arquivos gerados.
 
 **Variáveis disponíveis:**
 
@@ -189,7 +292,7 @@ Você pode usar variáveis dentro do caminho `autoFill` para resolver dinamicame
 ```ts fileName="src/components/example/index.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "/messages/{{locale}}/{{key}}.content.json",
+  fill: "/messages/{{locale}}/{{key}}.content.json",
   content: {
     // Seu conteúdo
   },
@@ -204,7 +307,7 @@ Isso irá gerar:
 ```ts fileName="src/components/example/index.content.ts"
 const exampleContent = {
   key: "example",
-  autoFill: "./{{fileName}}.content.json",
+  fill: "./{{fileName}}.content.json",
   content: {
     // Seu conteúdo
   },

package/docs/pt/benchmark/index.md

@@ -26,8 +26,8 @@ O Benchmark Bloom é uma suíte de benchmarks de desempenho que mede o impacto r
 
 Abaixo estão os relatórios detalhados e a documentação técnica de cada framework:
 
-- [**Next.js Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/nextjs.md)
-- [**TanStack Start Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/tanstack.md)
-- [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
-- [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
-- [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)
+- [**Next.js Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/nextjs.md)
+- [**TanStack Start Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/tanstack.md)
+- [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/vue.md)
+- [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/solid.md)
+- [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/benchmark/svelte.md)

package/docs/pt/benchmark/solid.md

@@ -118,6 +118,28 @@ Comparamos **quatro estratégias de carregamento**:
 - **Scoped static**: Mantém o código organizado (separação lógica) sem requisições de rede extras complexas.
 - **Scoped dynamic**: Melhor abordagem para _code splitting_ e desempenho. Minimiza a memória carregando apenas o que a view atual e o local ativo precisam.
 
+### O que medi:
+
+Executei o mesmo aplicativo multilíngue em um navegador real para cada stack e anotei o que realmente aparecia na rede e quanto tempo levava. Os tamanhos são relatados **após compressão web normal**, porque isso se aproxima mais do que as pessoas fazem download do que contagens de código-fonte bruto.
+
+- **Tamanho da biblioteca de internacionalização**: Após bundling, tree-shaking e minificação, o tamanho da biblioteca i18n é o tamanho dos providers + código de hooks/primitives em um componente vazio. Não inclui o carregamento de arquivos de tradução. Responde o quão caro é a biblioteca antes de seu conteúdo entrar na história.
+
+- **JavaScript por página**: Para cada rota de benchmark, quanto script o navegador extrai para essa visita, em média nas páginas do conjunto (e entre idiomas onde o relatório os agrega). Páginas pesadas são páginas lentas.
+
+- **Vazamento de outros idiomas**: É o conteúdo da mesma página mas em outro idioma que seria carregado por engano na página auditada. Este conteúdo é desnecessário e deve ser evitado. (ex. conteúdo da página `/fr/about` no bundle da página `/en/about`)
+
+- **Vazamento de outras rotas**: A mesma ideia para **outras telas** no aplicativo: se sua cópia está viajando junto quando você abriu apenas uma página. (ex. conteúdo da página `/en/about` no bundle da página `/en/contact`). Uma pontuação alta sugere divisão fraca ou bundles muito amplos.
+
+- **Tamanho médio do bundle do componente**: Peças de UI comuns são medidas **uma de cada vez** em vez de se esconder dentro de um número gigante de aplicativo. Mostra se a internacionalização silenciosamente infla componentes cotidianos. Por exemplo, se seu componente é renderizado novamente, ele carregará todos esses dados da memória. Anexar um JSON gigante a qualquer componente é como conectar um grande armazenamento de dados não utilizados que desacelerará o desempenho de seus componentes.
+
+- **Responsividade da troca de idioma**: Mudo o idioma usando o controle do próprio aplicativo e cronometro quanto tempo leva até a página ter claramente trocado, o que um visitante notaria, não um micro-passo de laboratório.
+
+- **Trabalho de renderização após uma mudança de idioma**: Um acompanhamento mais estreito: quanto esforço a interface levou para redesenhar o novo idioma uma vez que a troca está em andamento. Útil quando o tempo "sentido" e o custo do framework divergem.
+
+- **Tempo de carregamento da página inicial**: Da navegação até o navegador considerar a página totalmente carregada para os cenários que testei. Bom para comparar inícios frios.
+
+- **Tempo de hidratação**: Quando o aplicativo o expõe, quanto tempo o cliente gasta transformando HTML do servidor em algo que você pode realmente clicar. Um travessão nas tabelas significa que a implementação não forneceu uma figura de hidratação confiável neste benchmark.
+
 ## Estrelas do GitHub
 
 As estrelas do GitHub são um forte indicador da popularidade de um projeto, da confiança da comunidade e da relevância a longo prazo. Embora não sejam uma medida direta da qualidade técnica, elas refletem quantos desenvolvedores consideram o projeto útil, acompanham seu progresso e têm probabilidade de adotá-lo. Para estimar o valor de um projeto, as estrelas ajudam a comparar a tração entre as alternativas e fornecem insights sobre o crescimento do ecossistema.