@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/pl/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z NuxtJS I18n do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Nuxt.js z @nuxtjs/i18n do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z NuxtJS I18n do Intlayer
+
+Migracja aplikacji Nuxt z `@nuxtjs/i18n` do Intlayer jest bezproblemową operacją za pomocą modułu adaptera Nuxt.
+
+## Co zrobić
+
+Aby zainicjować projekt, uruchom:
+
+```bash
+npx intlayer init
+```
+
+To będzie ustawiać `intlayer.config.ts`. Następnie, dodaj moduł Intlayer Nuxt (np. `@intlayer/nuxt-i18n`) w tablicy modułów `nuxt.config.ts`. To automatycznie stosuje konfigurację compat dla twojej aplikacji.
+
+## Co się dzieje za kulisami
+
+`@nuxtjs/i18n` opakuje `vue-i18n` przy jednoczesnym zapewnieniu composables specyficznych dla Nuxt (`useLocalePath`, `useSwitchLocalePath`, `<NuxtLinkLocale>`).
+
+Za kulisami:
+
+- **Tłumaczenia:** Opiera się natywnie na warstwie compat `@intlayer/vue-i18n` dla wszystkich zadań tłumaczenia ciągu (w pełni obsługujące formaty `vue-i18n`, pipe liczby mnogiej i reaktywność).
+- **Routing:** Odzwierciedla composables routingu używając pomocników URL zlokalizowanych przez Intlayer.
+- **Konfiguracja:** Czyta `availableLocales` i ustawienia domyślne bezpośrednio z twojego `intlayer.config.ts` aby koordynować strony Nuxt automatycznie.

package/docs/pl/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z Polyglot.js do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację z Polyglot.js do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z Polyglot.js do Intlayer
+
+Jeśli używasz Airbnb Polyglot.js, migracja do Intlayer jest niezwykle prosta za pomocą warstwy compat.
+
+## Co zrobić
+
+Po prostu uruchom polecenie inicjalizacji w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+To generuje `intlayer.config.ts`. Możesz następnie wykorzystać alias wtyczki bundlera aby transparentnie przekierować importy Polyglot do `@intlayer/polyglot`.
+
+## Co się dzieje za kulisami
+
+Składnia Polyglot.js zazwyczaj opiera się na `polyglot.t('key', {name})` z interpolacjami `%{name}` i liczby mnogiej `smart_count` rozdzielonymi przez `"singular |||| plural"`.
+
+Za kulisami:
+
+- **Interpolacja:** Warstwa compat obsługuje symbole zastępcze `%{var}` natywnie.
+- **Liczba mnoga:** Ciąg jest dzielony w `||||` i obliczany względem natywnego `Intl.PluralRules` zgodnie z aktywną lokalą, odzwierciedlając własny porządek zasobnika Polyglot na lokalę.
+- **Słowniki:** Omijasz potrzebę dostarczania ogromnych konfiguracji JSON do `new Polyglot()` – Intlayer obsługuje słowniki dynamicznie i automatycznie je oczyści.

package/docs/pl/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z react-i18next do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji React z react-i18next do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z react-i18next do Intlayer
+
+Aby zapoznać się z kompletnym i szczegółowym samouczkiem krok po kroku, zapraszamy do naszego pełnego [Przewodnika migracji z react-i18next](../migration_from_react-i18next_to_intlayer.md).
+
+Korzystając z adaptera compat Intlayer możesz przeprowadzić migrację z `react-i18next` bez żadnych zmian importów kodu źródłowego.
+
+## Co zrobić
+
+Aby zainicjować projekt, uruchom:
+
+```bash
+npx intlayer init
+```
+
+Podczas inicjalizacji, Intlayer zainstaluje `@intlayer/react-i18next` i stworzy `intlayer.config.ts`. W swoim bundlerze (takim jak Vite), zastosuj wtyczkę Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## Co się dzieje za kulisami
+
+Plugin `reactI18nextVitePlugin` opakuje podstawową wtyczkę `vite-intlayer` i wstrzykuje aliasy rozwiązania dla `react-i18next` i `i18next`, przekierowując je do `@intlayer/react-i18next` i `@intlayer/i18next`.
+
+Za kulisami:
+
+- **`useTranslation` & `withTranslation`:** Przepisane aby korzystać z natywnych hoków Intlayer, dając ci automatyczne uzupełnianie TypeScript dla kluczy słownika. Bezproblemowo obsługuje przestrzenie nazw (np. `t('namespace:key')`).
+- **Liczba mnoga i kontekst:** Obsługuje sufiks-bazowaną pluralizację i18next (`key_one`, `key_other`) używając natywnego `Intl.PluralRules` i sufiksów kontekstu (`key_male`).
+- **Komponent `<Trans>`:** Ponownie wdrożony aby obsługiwać prop `components`, formy obiektu i tablic, i numerowane tagi `<1>...</1>` bezpośrednio mapujące do węzłów React.
+- **Instancja `i18n`:** Rozwiązuje klucze bezpośrednio ze słowników Intlayer bez pobierania dużych plików JSON, powodując znacznie mniejsze rozmiary bundle.

package/docs/pl/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z React Intl do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji React z react-intl do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z React Intl do Intlayer
+
+Jeśli aplikacja React używa `react-intl` (FormatJS), przejście do Intlayer jest proste. Nasza warstwa compat bezproblemowo obsługuje ICU MessageFormat i wszystkie istniejące komponenty `Formatted*`.
+
+## Co zrobić
+
+Zacznij uruchamiając polecenie inicjalizacji w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+Następnie, ustaw wtyczkę Vite lub Next.js Intlayer w konfiguracji. Ta wtyczka wstrzykuje aliasy czasu budowania aby przekierować importy `react-intl` do `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## Co się dzieje za kulisami
+
+Wtyczka bundlera aliasuje `react-intl` do `@intlayer/react-intl`. Zamiast ręcznego parsowania dużych plików JSON i opakowywania aplikacji w `IntlProvider`, wtyczka Intlayer statycznie wyodrębnia klucze i używa słowników Intlayer w czasie wykonywania.
+
+Za kulisami:
+
+- **ICU MessageFormat:** Intlayer używa `resolveMessage(..., 'icu')` resolver, który w pełni obsługuje pluralizację ICU, selekcję, formatowanie daty/liczb i tagi bogatego tekstu natywnie.
+- **Metoda i wywoływane JSX:** `intl.formatMessage({ id: 'a.b' })` i `<FormattedMessage id="a.b">` są identyfikowane przez wtyczki kompilera Intlayer (`@intlayer/babel` / `@intlayer/swc`), konwertując płaskie klucze punktowe tak aby pierwszy segment prawidłowo rozwiązywał klucz słownika Intlayer.
+- **Formatery:** `<FormattedNumber>`, `<FormattedDate>` itd., stanowią most do natywnego `core/formatters` używając `Intl`.

package/docs/pl/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z Svelte I18n do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Svelte z svelte-i18n do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z Svelte I18n do Intlayer
+
+Przeniesienie aplikacji Svelte z `svelte-i18n` do Intlayer trwa zaledwie chwilę, korzystając z adaptera compat.
+
+## Co zrobić
+
+Po prostu uruchom polecenie inicjalizacji w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+To generuje `intlayer.config.ts`. Upewnij się, że twoje wtyczki SvelteKit / Vite są opakowane wtyczką aliasu Intlayer aby bezproblemowo mapować `svelte-i18n` do `@intlayer/svelte-i18n`.
+
+## Co się dzieje za kulisami
+
+Svelte-i18n opiera się na intensywnie używanych sklepach (`$_`, `$t`, `$format`, itd.) i ICU MessageFormat.
+
+Za kulisami:
+
+- **Sklepy:** Intlayer pośredniczy sklepy `svelte-i18n`. `$_` staje się wyprowadzonym sklepem aktualnej lokali zwracającym resolver Intlayer.
+- **Klucze:** Twoje płaskie klucze (np. `$_('home.title')`) są obliczane tak aby pierwszy segment ścieżki reprezentuje słownik Intlayer.
+- **Składnia ICU:** W pełni obsługiwana przez wspólny resolver ICU (parsowanie równoważne `intl-messageformat`).
+- **Formatery:** Wywołania `$date`, `$time`, `$number` bezpiecznie przekierowują do natywnych formatów rdzenia Intlayer.
+- **Analiza Babel/SWC:** Analizator Intlayer czyta wywoływaczy sklepy Svelte (`$_`) wewnątrz plików źródłowych `.svelte` przed kompilacją aby automatycznie zbudować odpowiednie fragmenty słownika.

package/docs/pl/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z Transloco do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Angular z Transloco do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z Transloco do Intlayer
+
+Jeśli aplikacja Angular aktualnie używa `@jsverse/transloco`, możesz przeprowadzić migrację do Intlayer używając naszego adaptera compat. To przejście pozwala ci zachować istniejącą składnię szablonu przy jednoczesnym wykorzystaniu potężnej struktury słownika Intlayer.
+
+## Co zrobić
+
+Po prostu uruchom polecenie inicjalizacji w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+To będzie generować wymaganą konfigurację `intlayer.config.ts`. Następnie zastąpisz importy Transloco modułami `@intlayer/transloco` lub polegaj na aliasach budowania.
+
+## Co się dzieje za kulisami
+
+Transloco używa zakresów i `TranslocoService` (`translate`, `selectTranslate`), wraz z dyrektywami strukturalnymi (`*transloco="let t"`) i piperem (`| transloco`).
+
+Za kulisami:
+
+- **Zakresy:** Naturalnie mapują się na klucze słownika Intlayer, zapewniając wspaniałą historię czyszczenia dla optymalizacji rozmiaru bundle.
+- **Serwis i dyrektywy:** Adapter Intlayer Angular bezproblemowo zastępuje dostawców, pozwalając istniejącym piperom i dyrektywom szablonu rozwiązywać ciągi względem słowników Intlayer.
+- **Parsowanie czasu budowania:** Analizator TypeScript rozpoznaje wywołania `instant/get`, a rezerwowe czyszczenie zapewnia poprawność, nawet gdy użycie szablonu nie jest statycznie śledzone.

package/docs/pl/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z Vue I18n do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Vue z vue-i18n do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z Vue I18n do Intlayer
+
+Jeśli aplikacja Vue aktualnie używa `vue-i18n`, możesz przeprowadzić migrację do Intlayer bez przepisywania komponentów ani tłumaczenia hoków. Intlayer zapewnia adapter compat, który doskonale odzwierciedla API `vue-i18n` przy jednoczesnym wykorzystaniu potężnych funkcji Intlayer za kulisami.
+
+## Co zrobić
+
+Aby rozpocząć, po prostu uruchom polecenie inicjalizacji w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+Podczas inicjalizacji, Intlayer będzie ustawiać plik konfiguracji (`intlayer.config.ts`) i przygotowywać twój projekt do migracji. Będziesz musiał dodać wtyczkę Intlayer do konfiguracji Vite, aby automatycznie aliasować importy `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Co się dzieje za kulisami
+
+Plugin `vueI18nVitePlugin` wstrzykuje alias modułu do bundlera. Każdy import `vue-i18n` w twoim kodzie będzie transparentnie przekierowany do `@intlayer/vue-i18n`.
+
+**Za kulisami, adapter obsługuje złożoną składnię `vue-i18n` natywnie:**
+
+- **Interpolacja i liczba mnoga:** Rozwiązuje interpolacje `{name}` i listy `{0}`. Liczby mnoga pipe (`"car | cars"`) są konwertowane do węzłów wyliczenia/liczby mnogiej Intlayer na podstawie semantyki pozycjonalnej.
+- **Formaty:** Funkcje takie jak `d()` i `n()` opakują `Intl` za kulisami, honorując `datetimeFormats` i `numberFormats` zdefiniowane w opcjach.
+- **Stan globalny i lokalny:** `global.locale` jest mapowany na `WritableComputedRef` wspieraną przez klienta Intlayer, tak aby reaktywność zachowywała się dokładnie jak oczekiwana (np. `locale.value = 'fr'`).
+- **Dyrektywy:** Dyrektywa `v-t` jest rejestrowana i funkcjonuje normalnie.
+
+Twoja aplikacja kontynuuje renderowanie dokładnie jak wcześniej, ale zawartość jest zasilana twoimi słownikami Intlayer, dając ci bezpieczeństwo typów, lepszą optymalizację bundle i bezproblemową integrację CMS.

package/docs/pl/compiler.md

@@ -29,6 +29,7 @@ history:
   - version: 7.3.1
     date: 2025-11-27
     changes: "Wydanie kompilatora"
+author: aymericzip
 ---
 
 # Intlayer Compiler | Zautomatyzowane wydobywanie treści dla i18n
@@ -78,12 +79,15 @@ Zaktualizuj swój plik `vite.config.ts`, aby dołączyć wtyczkę `intlayerCompi
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Dodaje wtyczkę kompilatora
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/pl/component_i18n.md

@@ -16,6 +16,7 @@ slugs:
   - i18n
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
+author: aymericzip
 ---
 
 # Jak uczynić komponent wielojęzycznym (i18n) za pomocą Intlayer

package/docs/pl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-05-12
+updatedAt: 2026-06-17
 title: Konfiguracja
 description: Dowiedz się, jak skonfigurować Intlayer dla swojej aplikacji. Zrozum różne ustawienia i opcje dostępne do dostosowania Intlayer do Twoich potrzeb.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.10.0
+    date: 2026-06-17
+    changes: "Dodano opcję `format` do konfiguracji słownika"
   - version: 8.9.4
     date: 2026-05-12
     changes: "Dodano obsługę dostawcy LM Studio"
@@ -98,6 +101,7 @@ history:
   - version: 5.5.11
     date: 2025-06-29
     changes: "Dodano komendy `docs`"
+author: aymericzip
 ---
 
 # Dokumentacja konfiguracji Intlayer
@@ -134,6 +138,7 @@ Intlayer akceptuje formaty plików konfiguracyjnych JSON, JS, MJS i TS:
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import { Locales, type IntlayerConfig } from "intlayer";
 import { nextjsRewrite } from "intlayer/routing";
+import { syncJSON } from "@intlayer/sync-json-plugin";
 import { z } from "zod";
 
 /**
@@ -581,10 +586,38 @@ const config: IntlayerConfig = {
     }),
   },
 
+  /**
+   * Konfiguracja słownika.
+   */
+  dictionary: {
+    /**
+     * Kontroluje sposób importowania słowników.
+     * - "static": Importowane statycznie podczas budowania.
+     * - "dynamic": Importowane dynamicznie przy użyciu Suspense.
+     * - "fetch": Pobierane dynamicznie przez API synchronizacji na żywo.
+     */
+    importMode: "static",
+
+    /**
+     * Domyślny format komunikatów dla wszystkich słowników w projekcie.
+     * - 'intlayer': Natywny format intlayer (domyślny).
+     * - 'icu': Format komunikatów ICU.
+     * - 'i18next': Format i18next.
+     * - 'vue-i18n': Format Vue I18n.
+     * - 'po': Format GNU Gettext PO.
+     */
+    format: "icu",
+  },
+
   /**
    * Konfiguracja wtyczek.
    */
-  plugins: [],
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./messages/${locale}.json`,
+    }),
+  ],
 };
 
 export default config;
@@ -849,6 +882,21 @@ Ustawienia do zarządzania treścią w aplikacji, w tym nazwy katalogów, rozsze
 
 ---
 
+### Konfiguracja systemu
+
+Ustawienia związane ze ścieżkami wewnętrznymi i wynikami wyjściowymi Intlayer. Te ustawienia są zazwyczaj wewnętrzne i nie powinny być modyfikowane przez użytkownika.
+
+| Field                     | Description                                                                              | Type     | Default                           | Example              | Note                                                                 |
+| ------------------------- | ---------------------------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | -------------------------------------------------------------------- |
+| `baseDir`                 | Katalog bazowy dla projektu.                                                             | `string` | `process.cwd()`                   | `'/path/to/project'` | Używany do rozwiązywania wszystkich katalogów związanych z Intlayer. |
+| `dictionariesDir`         | Ścieżka katalogu do przechowywania słowników lokalizacyjnych.                            | `string` | `'.intlayer/dictionary'`          |                      |                                                                      |
+| `moduleAugmentationDir`   | Katalog dla rozszerzenia modułów, umożliwiający lepsze sugestie IDE i sprawdzanie typów. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | Upewnij się, że jest to uwzględnione w `tsconfig.json`.              |
+| `unmergedDictionariesDir` | Katalog do przechowywania niescalonych słowników.                                        | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                                      |
+| `typesDir`                | Katalog do przechowywania typów słowników.                                               | `string` | `'.intlayer/types'`               |                      |                                                                      |
+| `mainDir`                 | Katalog, w którym przechowywane są główne pliki aplikacji.                               | `string` | `'.intlayer/main'`                |                      |                                                                      |
+| `configDir`               | Katalog, w którym przechowywane są pliki konfiguracyjne.                                 | `string` | `'.intlayer/config'`              |                      |                                                                      |
+| `cacheDir`                | Katalog, w którym przechowywane są pliki cache'u.                                        | `string` | `'.intlayer/cache'`               |                      |                                                                      |
+
 ### Konfiguracja słownika (Dictionary)
 
 Opcje kontrolujące operacje na słownikach, w tym zachowanie automatycznego uzupełniania i generowanie treści.
@@ -861,6 +909,7 @@ Opcje kontrolujące operacje na słownikach, w tym zachowanie automatycznego uzu
 | `contentAutoTransformation` | Czy automatycznie przekształcać ciągi znaków treści w typowane węzły (Markdown, HTML lub wstawki).                                                                                  | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')` .<br/>• HTML : `<div>Title</div>` → `html('<div>Title</div>')` .<br/>• Wstawki : `Hello {{name}}` → `insert('Hello {{name}}')` .                                                                                                                                                                                                                                               |
 | `location`                  | Wskazuje na lokalizację przechowywania plików słowników oraz sposób ich synchronizacji z CMS.                                                                                       | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: Tylko lokalne zarządzanie.<br/>• `'remote'`: Tylko zdalne zarządzanie (CMS).<br/>• `'hybrid'`: Zarządzanie zarówno lokalne, jak i zdalne.<br/>• `'plugin'` lub własne ciągi: Zarządzanie przez wtyczkę lub własne źródło.                                                                                                                                                                                      |
 | `importMode`                | Kontroluje sposób importowania słowników.                                                                                                                                           | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: Statyczny import.<br/>• `'dynamic'`: Dynamiczny import przez Suspense.<br/>• `'fetch'`: Pobieranie przez API Live Sync; rezerwowa opcja `'dynamic'` w razie błędu.<br/>• Wymagane wtyczki `@intlayer/babel` i `@intlayer/swc`.<br/>• Klucze muszą być zadeklarowane statycznie.<br/>• Ignorowane, jeśli `optimize` jest wyłączone.<br/>• Nie wpływa na `getIntlayer`, `getDictionary` itp.                    |
+| `format`                    | Domyślny format komunikatów dla wszystkich słowników w projekcie.                                                                                                                   | `'intlayer'` &#124; <br/> `'icu'` &#124; <br/> `'i18next'` &#124; <br/> `'vue-i18n'` &#124; <br/> `'po'`        | `'intlayer'` | `'icu'`                                                                                     | • `'intlayer'`: Natywny format intlayer.<br/>• `'icu'`: Format komunikatów ICU.<br/>• `'i18next'`: Format i18next.<br/>• `'vue-i18n'`: Format Vue I18n.<br/>• `'po'`: Format GNU Gettext PO.                                                                                                                                                                                                                                |
 | `priority`                  | Priorytet słownika. Przy rozwiązywaniu konfliktów między słownikami wyższa wartość ma pierwszeństwo przed niższą.                                                                   | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `live`                      | ZDEPRECJONOWANE - używaj `importMode: 'fetch'`. Wcześniej wskazywało, czy należy pobierać treść słownika dynamicznie przez API Live Sync.                                           | `boolean`                                                                                                       | `undefined`  |                                                                                             | Przemianowano na `importMode: 'fetch'` w v8.0.0.                                                                                                                                                                                                                                                                                                                                                                            |
 | `schema`                    | Generowane automatycznie przez Intlayer do walidacji schematu JSON.                                                                                                                 | `'https://intlayer.org/schema.json'`                                                                            | Automatyczne |                                                                                             | Nie edytuj ręcznie.                                                                                                                                                                                                                                                                                                                                                                                                         |
@@ -956,22 +1005,6 @@ Ustawienia budowania mają zastosowanie do wtyczek `@intlayer/babel` i `@intlaye
 
 ---
 
-### Konfiguracja systemowa (System)
-
-Te ustawienia są przeznaczone dla zaawansowanych użytkowników i wewnętrznej konfiguracji Intlayer.
-
-| Pole                      | Opis                                            | Typ      | Domyślnie                         | Przykład | Uwagi |
-| ------------------------- | ----------------------------------------------- | -------- | --------------------------------- | -------- | ----- |
-| `dictionariesDir`         | Katalog dla skompilowanych słowników.           | `string` | `'.intlayer/dictionary'`          |          |       |
-| `moduleAugmentationDir`   | Katalog dla module augmentation TypeScript.     | `string` | `'.intlayer/types'`               |          |       |
-| `unmergedDictionariesDir` | Katalog dla niepołączonych słowników.           | `string` | `'.intlayer/unmerged_dictionary'` |          |       |
-| `typesDir`                | Katalog dla wygenerowanych typów.               | `string` | `'.intlayer/types'`               |          |       |
-| `mainDir`                 | Katalog głównych plików Intlayer.               | `string` | `'.intlayer/main'`                |          |       |
-| `configDir`               | Katalog skompilowanych plików konfiguracyjnych. | `string` | `'.intlayer/config'`              |          |       |
-| `cacheDir`                | Katalog plików cache.                           | `string` | `'.intlayer/cache'`               |          |       |
-
----
-
 ### Konfiguracja kompilatora (Compiler)
 
 Kontroluje ustawienia kompilatora Intlayer, który kolekcjonuje słowniki bezpośrednio z Twoich komponentów.

package/docs/pl/custom_domains.md

@@ -17,6 +17,7 @@ history:
   - version: 8.5.0
     date: 2026-04-02
     changes: "Dodano routing lokalizacji oparty na domenach poprzez konfigurację routing.domains."
+author: aymericzip
 ---
 
 # Własne domeny
@@ -171,10 +172,16 @@ Plugin Vite `intlayerProxy` stosuje tę samą logikę podczas programowania:
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/pl/custom_url_rewrites.md

@@ -16,6 +16,7 @@ history:
   - version: 8.0.0
     date: 2026-01-25
     changes: "Implement centralized URL rewrites with framework-specific formatters and the useRewriteURL hook."
+author: aymericzip
 ---
 
 # Implementacja niestandardowego przepisywania URL
@@ -341,10 +342,16 @@ Dla SolidJS, Vue i Svelte wtyczka Vite `intlayerProxy` zarządza przepisywaniami
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```