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

package/docs/pl/packages/intlayer/getMultilingualUrls.md

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## Opis
 
+Funkcja `getMultilingualUrls` generuje mapowanie wielojęzycznych adresów URL poprzez dodanie prefiksu dla każdej obsługiwanej lokalizacji. Może obsługiwać zarówno bezwzględne jak i względne adresy URL, stosując odpowiedni prefiks lokalizacji na podstawie podanej konfiguracji lub wartości domyślnych.
+
+**Kluczowe cechy:**
+
+- Wymagany jest tylko 1 parametr: `url`
+- Opcjonalny obiekt `options` z `locales`, `defaultLocale` i `mode`
+- Wykorzystuje konfigurację internacjonalizacji Twojego projektu jako wartości domyślne
+- Obsługuje wiele trybów routingu: `prefix-no-default`, `prefix-all`, `no-prefix` i `search-params`
+- Zwraca obiekt mapowania ze wszystkimi lokalizacjami jako kluczami i odpowiadającymi im adresami URL jako wartościami
+
+---
+
+## Opis
+
 Funkcja `getMultilingualUrls` generuje mapowanie wielojęzycznych URL-i, poprzedzając podany URL każdym obsługiwanym językiem (locale). Może obsługiwać zarówno URL-e bezwzględne, jak i względne, stosując odpowiedni prefiks językowy na podstawie dostarczonej konfiguracji lub wartości domyślnych.
 
 ---
 
 ## Parametry
 
+## Parametry
+
 - `url: string`
   - **Opis**: Oryginalny ciąg URL, który ma zostać poprzedzony prefiksami językowymi.
   - **Typ**: `string`
@@ -54,6 +70,33 @@ Funkcja `getMultilingualUrls` generuje mapowanie wielojęzycznych URL-i, poprzed
   - **Typ**: `boolean`
   - **Domyślnie**: `prefixDefaultDefault`
 
+### Parametry opcjonalne
+
+- `options?: object`
+  - **Description**: Obiekt konfiguracyjny dla zachowania lokalizacji URL.
+  - **Type**: `object`
+  - **Required**: No (opcjonalnie)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Tablica obsługiwanych locale'i. Jeśli nie zostanie podana, używa skonfigurowanych locale'i z konfiguracji projektu.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: Domyślny locale dla aplikacji. Jeśli nie zostanie podany, używa skonfigurowanego domyślnego locale'a z konfiguracji projektu.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: Tryb routingu URL dla obsługi locale'i. Jeśli nie zostanie podany, używa skonfigurowanego trybu z konfiguracji projektu.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Brak prefiksu dla domyślnego locale'a, prefiks dla wszystkich innych
+      - `prefix-all`: Prefiks dla wszystkich locale'i włącznie z domyślnym
+      - `no-prefix`: Brak prefiksu locale'a w URL
+      - `search-params`: Użyj parametrów zapytania dla locale'a (np. `?locale=fr`)
+
 ### Zwracana wartość
 
 - **Typ**: `IConfigLocales<string>`
@@ -63,6 +106,20 @@ Funkcja `getMultilingualUrls` generuje mapowanie wielojęzycznych URL-i, poprzed
 
 ## Przykład użycia
 
+### Podstawowe użycie (Uses Project Configuration)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// Używa konfiguracji projektu dla locales, defaultLocale i mode
+getMultilingualUrls("/dashboard");
+// Output (assuming project config has en, fr with mode 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### URL-e względne
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### Różne tryby routingu
+
+```typescript
+// prefix-no-default: Brak prefiksu dla locale'a domyślnego
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Wynik: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: Prefiks dla wszystkich locale'ów
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// Wynik: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: Brak prefiksu locale'a w URL-ach
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// Wynik: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: Locale jako parametr zapytania
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// Wynik: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## Przypadki brzegowe
 
 - **Brak segmentu językowego:**

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

@@ -24,102 +24,6 @@ history:
 author: aymericzip
 ---
 
-# Integracja z React: Dokumentacja hooka `useDictionary`
-
-Ta sekcja zawiera szczegółowe wskazówki dotyczące użycia hooka `useDictionary` w aplikacjach React, umożliwiając efektywne zarządzanie lokalizowanymi treściami bez wizualnego edytora.
-
-## Importowanie `useDictionary` w React
-
-Hook `useDictionary` można zintegrować z aplikacjami React, importując go w zależności od kontekstu:
-
-- **Komponent Klienta:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer"; // Używane w komponentach React po stronie klienta
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer"; // Używane w komponentach React po stronie klienta
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer"); // Używane w komponentach React po stronie klienta
-  ```
-
-- **Komponent Serwera:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer/server"; // Używane w komponentach React po stronie serwera
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer/server"; // Używane w komponentach React po stronie serwera
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer/server"); // Używane w komponentach React po stronie serwera
-  ```
-
-## Parametry
-
-Hook przyjmuje dwa parametry:
-
-1. **`dictionary`**: Zadeklarowany obiekt słownika zawierający zlokalizowane treści dla określonych kluczy.
-2. **`locale`** (opcjonalny): Żądany locale. Domyślnie używany jest locale z bieżącego kontekstu, jeśli nie zostanie podany.
-
-## Słownik
-
-Wszystkie obiekty słowników powinny być deklarowane w uporządkowanych plikach zawartości, aby zapewnić bezpieczeństwo typów i zapobiec błędom w czasie wykonywania. Instrukcje konfiguracji można znaleźć [tutaj](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md). Oto przykład deklaracji zawartości:
-
-```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": "Ejemplo de componente cliente",
-        "pl": "Przykład komponentu klienta"
-      }
-    },
-    "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",
-        "pl": "To jest zawartość przykładu komponentu klienta"
-      }
-    }
-  }
-}
-```
-
 ## Przykład użycia w React
 
 Poniżej znajduje się przykład, jak użyć hooka `useDictionary` w komponencie React:
@@ -162,14 +66,6 @@ const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
 };
 ```
 
-## Uwagi dotyczące atrybutów
-
-W przeciwieństwie do integracji wykorzystujących edytory wizualne, atrybuty takie jak `buttonTitle.value` nie mają tutaj zastosowania. Zamiast tego bezpośrednio odwołuj się do lokalizowanych ciągów znaków zadeklarowanych w Twojej zawartości.
-
-```jsx
-<button title={content.title}>{content.content}</button>
-```
-
 ## Dodatkowe wskazówki
 
 - **Bezpieczeństwo typów**: Zawsze używaj `Dictionary` do definiowania swoich słowników, aby zapewnić bezpieczeństwo typów.

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

@@ -29,49 +29,6 @@ author: aymericzip
 
 Ta sekcja zawiera szczegółowe wskazówki dotyczące używania hooka `useIntlayer` w aplikacjach React, umożliwiając efektywną lokalizację treści.
 
-## Importowanie `useIntlayer` w React
-
-Hook `useIntlayer` można zintegrować z aplikacjami React, importując go w zależności od kontekstu:
-
-- **Komponent Klienta:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Używane w komponentach React po stronie klienta
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Używane w komponentach React po stronie klienta
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Używane w komponentach React po stronie klienta
-  ```
-
-- **Komponent Serwera:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Używane w komponentach React po stronie serwera
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Używane w komponentach React po stronie serwera
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Używane w komponentach React po stronie serwera
-  ```
-
-## Parametry
-
-Hook przyjmuje dwa parametry:
-
-1. **`key`**: Klucz słownika do pobrania zlokalizowanej zawartości.
-2. **`locale`** (opcjonalny): Żądany locale. Domyślnie używany jest locale z kontekstu, jeśli nie zostanie podany.
-
-## Słownik
-
-Wszystkie klucze słownika muszą być zadeklarowane w plikach deklaracji zawartości, aby zwiększyć bezpieczeństwo typów i uniknąć błędów. Instrukcje konfiguracji znajdziesz [tutaj](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md).
-
 ## Przykład użycia w React
 
 Demonstracja hooka `useIntlayer` w komponencie React:
@@ -131,14 +88,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Obsługa Atrybutów
-
-Podczas lokalizowania atrybutów, odpowiednio uzyskuj dostęp do wartości zawartości:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Dodatkowe Zasoby
 
 - **Intlayer Visual Editor**: Dla bardziej intuicyjnego zarządzania treścią, zapoznaj się z dokumentacją edytora wizualnego [tutaj](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md).

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).