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

package/docs/pl/packages/vue-intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - vue-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodanie narzędzia usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Ujednolicona dokumentacja dla wszystkich eksportów"
@@ -59,6 +62,7 @@ import "vue-intlayer";
 | `useDictionaryAsync`   | Tak jak `useDictionary`, ale obsługuje asynchroniczne słowniki.                                                                                            | -                                                                                                                     |
 | `useDictionaryDynamic` | Tak jak `useDictionary`, ale obsługuje dynamiczne słowniki.                                                                                                | -                                                                                                                     |
 | `useLocale`            | Zwraca bieżący locale oraz funkcję do jego ustawienia.                                                                                                     | -                                                                                                                     |
+| `usePathname`          | Zwraca bieżący pathname jako `ComputedRef<string>` z usuniętym segmentem locale. Reaguje na zdarzenia `popstate`.                                          | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vue-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Composable po stronie klienta do zarządzania przepisywaniem adresów URL. Automatycznie aktualizuje URL, jeśli istnieje zlokalizowana reguła przepisywania. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vue-intlayer/useRewriteURL.md) |
 | `useIntl`              | Zwraca obiekt Intl dla bieżącej lokalizacji.                                                                                                               | -                                                                                                                     |
 | `useLoadDynamic`       | Composable do ładowania dynamicznych słowników.                                                                                                            | -                                                                                                                     |

package/docs/pl/packages/vue-intlayer/usePathname.md

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Dokumentacja funkcji usePathname | vue-intlayer
+description: Dowiedz się, jak korzystać z funkcji usePathname z pakietu vue-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internacjonalizacja
+  - Dokumentacja
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodanie narzędzia usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inicjalizacja historii"
+author: aymericzip
+---
+
+# Integracja Vue: Dokumentacja `usePathname`
+
+Funkcja `usePathname` zwraca obecny pathname przeglądarki z usuniętym segmentem locale, w postaci `ComputedRef<string>` z Vue. Jest to przydatne do budowy nawigacji uwzględniającej locale — na przykład, aby określić, który element nawigacji jest aktywny — bez konieczności ręcznego usuwania prefiksu locale.
+
+## Importowanie `usePathname` w Vue
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## Przegląd
+
+`usePathname` tworzy Vue computed ref, który odczytuje `window.location.pathname`, usuwa prefiks locale za pomocą `getPathWithoutLocale`, i aktualizuje swoją wartość za każdym razem, gdy przeglądarka wywoła zdarzenie `popstate` (nawigacja wstecz/dalej). Ta wartość może być używana bezpośrednio w Twoich szablonach Vue lub funkcjach setup.
+
+## Użycie
+
+```vue fileName="src/components/NavItem.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const props = defineProps<{
+  href: string;
+  label: string;
+}>();
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
+    {{ label }}
+  </a>
+</template>
+```
+
+## Zwracana Wartość
+
+| Typ                   | Opis                                                                                            |
+| --------------------- | ----------------------------------------------------------------------------------------------- |
+| `ComputedRef<string>` | Obiekt typu Computed Ref z Vue, zawierający obecny pathname z przeglądarki bez prefiksu locale. |
+
+## Zachowanie
+
+- **Usuwanie locale**: Usuwa wiodący segment locale (np. `/pl/dashboard` → `/dashboard`).
+- **Reaktywność**: Aktualizuje wartość przy każdym zdarzeniu `popstate` (nawigacja wstecz / do przodu w przeglądarce).
+- **Bezpieczne dla SSR**: Zwraca `""`, gdy `window` nie jest dostępne.
+- **Czyszczenie (Cleanup)**: Nasłuchiwacz (listener) `popstate` jest dodawany globalnie podczas inicjalizacji i zazwyczaj nie wymaga ręcznego czyszczenia na poziomie komponentu, dzięki temu, jak Vue zarządza cyklem życia.
+
+## Przykład
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Panel" },
+  { href: "/settings", label: "Ustawienia" },
+];
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <nav>
+    <a
+      v-for="link in links"
+      :key="link.href"
+      :href="link.href"
+      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
+    >
+      {{ link.label }}
+    </a>
+  </nav>
+</template>
+```
+
+## Powiązane
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vue-intlayer/useLocale.md) — obecny locale + przełącznik locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getPathWithoutLocale.md) — użyteczność bazowa (utility) wykorzystywana przez ten hook

package/docs/pl/plugins/sync-json.md

@@ -426,65 +426,6 @@ When the same translation key exists in multiple JSON sources:
 2. Źródła o niższym priorytecie są używane jako zapasowe dla brakujących kluczy
 3. Pozwala to na utrzymanie tłumaczeń dziedziczonych podczas stopniowej migracji do nowych struktur
 
-## Integracje
-
-Poniżej znajdują się typowe mapowania. Zachowaj swój runtime bez zmian; dodaj tylko wtyczkę.
-
-### i18next
-
-Typowy układ plików: `./public/locales/{locale}/{namespace}.json` lub `./locales/{locale}/{namespace}.json`.
-
-```ts fileName="intlayer.config.ts"
-import { syncJSON } from "@intlayer/sync-json-plugin";
-
-export default {
-  plugins: [
-    syncJSON({
-      format: "i18next",
-      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
-    }),
-  ],
-};
-```
-
-### next-intl
-
-Wiadomości JSON na locale (często `./messages/{locale}.json`) lub na namespace.
-
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
-  }),
-];
-```
-
-Zobacz także: `docs/pl/intlayer_with_next-intl.md`.
-
-### react-intl
-
-Pojedynczy JSON na locale jest powszechny:
-
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
-```
-
-### vue-i18n
-
-Może to być pojedynczy plik na locale lub na namespace:
-
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,
-  }),
-];
-```
-
 ## CLI
 
 Synchronizowane pliki JSON będą traktowane jak inne pliki `.content`. Oznacza to, że wszystkie polecenia intlayer będą dostępne dla synchronizowanych plików JSON. W tym:

package/docs/pl/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Witamy w Intlayer v6! Ta wersja skupia się na wydajności, doświadczeniu deweloperskim oraz niezawodności. Poniżej znajdują się najważniejsze zmiany wraz z notatkami migracyjnymi i przykładami do kopiowania.
 
+## Spis treści
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Najważniejsze zmiany
 
 - Nowa komenda: `npx intlayer content test` do wykrywania brakujących tłumaczeń

package/docs/pl/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 Witamy w Intlayer v7! To duże wydanie wprowadza znaczące ulepszenia w wydajności, bezpieczeństwie typów oraz doświadczeniu deweloperskim. Poniżej znajdują się najważniejsze zmiany, wraz z notatkami migracyjnymi i praktycznymi przykładami.
 
+## Spis treści
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Najważniejsze zmiany
 
 - Strategia buforowania dla szybszych kompilacji
@@ -260,6 +264,126 @@ Skutkuje to szybszym czasem pobierania i lepszą wydajnością działania Twojej
 
 ---
 
+## Automatyczne formatowanie kodu: konfiguracja formatCommand
+
+v7 wprowadza opcję `formatCommand` w konfiguracji edytora, pozwalającą na automatyczne formatowanie plików zawartości podczas ich zapisywania przez Intlayer. Zapewnia to spójny styl kodu i formatowanie we wszystkich plikach deklaracji zawartości.
+
+Jeśli nie jest ustawiony, Intlayer spróbuje automatycznie wykryć polecenie formatowania. Próbując rozwiązać następujące polecenia: prettier, biome, eslint.
+
+### Konfiguracja
+
+Opcja `formatCommand` akceptuje szablon ciągu znaków, w którym `{{file}}` zostanie zastąpiony rzeczywistą ścieżką pliku:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Obsługiwane formatory
+
+Możesz używać dowolnego formatera kodu, który akceptuje ścieżki plików jako argumenty:
+
+**Używając Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Używając Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Używając ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Używając wbudowanego formatera Bun:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Korzyści
+
+- **Spójne formatowanie**: Wszystkie pliki zawartości są automatycznie formatowane zgodnie z wytycznymi stylu Twojego projektu
+- **Doświadczenie deweloperskie**: Nie ma potrzeby ręcznego formatowania plików po ich wygenerowaniu przez Intlayer
+- **Spójność zespołu**: Zapewnia, że wszyscy członkowie zespołu mają zastosowane to samo formatowanie do plików zawartości
+- **Integracja CI/CD**: Pliki zawartości zachowują spójne formatowanie w zautomatyzowanych przepływach pracy
+
+### Jak to działa
+
+Gdy Intlayer zapisuje lub aktualizuje plik deklaracji zawartości (`.content.ts`, `.content.js`, itp.), automatycznie uruchamia określone polecenie formatowania na pliku. Symbol zastępczy `{{file}}` jest zastępowany rzeczywistą ścieżką pliku, a polecenie jest wykonywane w katalogu bazowym projektu.
+
+---
+
+## Konfiguracja Dictionary: Lepsza organizacja i struktura
+
+v7 wprowadza nową dedykowaną sekcję konfiguracji `dictionary`, która zapewnia lepszą organizację ustawień związanych ze słownikiem i ulepszone zarządzanie zawartością.
+
+### Nowa struktura konfiguracji słownika
+
+Właściwość `fill` została przeniesiona z sekcji `content` do nowej sekcji `dictionary`, zapewniając wyraźniejsze rozdzielenie odpowiedzialności:
+
+**Konfiguracja v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Konfiguracja v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Korzyści nowej struktury
+
+- **Wyraźniejsza organizacja**: Ustawienia specyficzne dla słownika są teraz pogrupowane
+- **Lepsza separacja obaw**: Odkrywanie zawartości a operacje na słowniku są wyraźnie rozdzielone
+- **Ulepszona łatwość utrzymania**: Łatwiej zrozumieć i modyfikować konfiguracje związane ze słownikami
+- **Przyszła rozszerzalność**: Sekcja słownika może zawierać dodatkowe ustawienia specyficzne dla słownika
+- **Kompleksowe zarządzanie słownikami**: Obejmuje właściwości takie jak `title`, `live`, `priority`, `tags`, `version` i `description` do tworzenia i zarządzania nowymi słownikami
+
+### Użycie konfiguracji
+
+Konfiguracja słownika służy dwóm głównym celom:
+
+1. **Wartości domyślne**: Definiowanie wartości domyślnych podczas tworzenia plików deklaracji treści
+2. **Zachowanie fallbacku**: Dostarczanie wartości fallbacku, gdy określone pola nie są zdefiniowane, umożliwiając globalną definicję zachowania operacji słownika
+
+Sekcja słownika zawiera kompleksowe właściwości do zarządzania słownikiem:
+
+- **`fill`**: Zachowanie auto-fill dla generowania treści
+- **`title`**: Domyślny tytuł dla nowych słowników
+- **`live`**: Konfiguracja live sync dla aktualizacji w czasie rzeczywistym
+- **`priority`**: Ustawienia priorytetu dla rozdzielczości słownika
+- **`tags`**: Domyślne tagi do organizacji treści
+- **`version`**: Zarządzanie wersjami dla aktualizacji słownika
+- **`description`**: Domyślny opis dla nowej treści
+
+Aby uzyskać więcej informacji o plikach deklaracji treści i sposobie zastosowania wartości konfiguracji, zobacz [Dokumentację pliku treści](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md).
+
+---
+
 ## Komenda fill: Zaktualizowane zachowanie dla lepszego zarządzania treścią
 
 Wersja 7 wprowadza ulepszone zachowanie komendy `fill`, zapewniając bardziej przewidywalne i elastyczne zarządzanie treścią:
@@ -407,6 +531,10 @@ System automatycznie:
 - **`middleware.prefixDefault`**: Zastąpione przez `routing.mode`
 - **`middleware.noPrefix`**: Zastąpione przez `routing.mode`
 
+### Nowe konfiguracje
+
+- **`editor.formatCommand`**: Nowa opcja do automatycznego formatowania kodu plików zawartości
+
 ### Mapowanie migracji
 
 #### Mapowanie konfiguracji

package/docs/pl/releases/v9.md

@@ -216,6 +216,42 @@ W czasie budowania (build time), `@intlayer/swc` oraz `@intlayer/babel` skanują
 
 ---
 
+## Vite Plugin: Bundled Compiler & Proxy
+
+Plugin Vite `intlayer()` teraz łączy **kompilator** i **proxy do routingu locale'ów** bezpośrednio, więc większość projektów potrzebuje tylko jednej wtyczki w `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: Aktywuje się automatycznie, gdy `compiler.enabled` jest ustawione i skonfigurowana jest ścieżka `compiler.output`. Nie musisz już rejestrować `intlayerCompiler()` osobno.
+- **Proxy**: Aktywuje się automatycznie w oparciu o nową opcję `routing.enableProxy` (domyślnie `true`). Podłącza middleware do wykrywania locale'ów / przekierowywania / przepisywania w developmencie, preview i produkcyjnym SSR. Nie musisz już rejestrować `intlayerProxy()` osobno.
+
+### Opcja `routing.enableProxy`
+
+Nowa opcja `routing.enableProxy` kontroluje, czy proxy routingu lokalizacji jest podłączony. Domyślnie ma wartość `true`. Wyłącz to, jeśli chcesz samodzielnie obsługiwać routing lokalizacji:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Domyślnie: true
+  },
+};
+
+export default config;
+```
+
+Autonomiczne pluginy `intlayerCompiler()` i `intlayerProxy()` pozostają eksportowane dla zaawansowanych konfiguracji. Rejestrowanie ich razem z `intlayer()` jest bezpieczne — każdy plugin deduplikuje się i uruchamia się tylko raz.
+
+---
+
 ## Uwagi dotyczące migracji z wersji v8
 
 Jeśli aktualizujesz aplikację z wersji v8, pamiętaj, że wersja v9 nie zawiera zmian wprowadzających niekompatybilność wsteczną (breaking changes). Oto jednak kluczowe zmiany:

package/docs/pl/roadmap.md

@@ -328,22 +328,6 @@ Intlayer obsługuje **TypeScript** (również JavaScript) oraz **JSON** do dekla
 
 ### 4. Ulepszenia SEO
 
-- Narzędzia do **analizy słów kluczowych**, intencji wyszukiwania użytkowników oraz pojawiających się trendów.
-- Sugestie ulepszonej treści dla lepszych pozycji w rankingach oraz monitorowanie długoterminowej wydajności.
-
-### 5. Zgodność z większą liczbą frameworków
-
-- Trwają prace nad wsparciem dla **Solid, Svelte, Angular** i innych.
-- Celem jest uczynienie Intlayer kompatybilnym z **dowolną aplikacją opartą na JavaScript**.
-
----
-
-## Podsumowanie
-
-- System generowałby tłumaczenia w tle, a następnie prosiłby Cię o ich zatwierdzenie lub edycję.
-
-### 4. Ulepszenia SEO
-
 - Narzędzia do **analizy słów kluczowych**, intencji wyszukiwania użytkowników oraz pojawiających się trendów.
 - Sugestie ulepszonej treści dla lepszych pozycji w rankingach oraz śledzenie długoterminowej wydajności.
 

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
   },