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

package/docs/pl/benchmark/___vue.md

@@ -0,0 +1,36 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Najlepsze rozwiązanie i18n dla Vue w 2026 - Raport benchmarku
+description: Porównaj biblioteki internacjonalizacji Vue. Szczegółowy raport wydajności dotyczący rozmiaru bundle, wycieków i reaktywności.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - vue
+  - wydajność
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - vue
+author:
+  name: Aymeric PINEAU
+  github: aymericzip
+history:
+  - version: 8.7.5
+    date: 2026-01-06
+    changes: "Init benchmark"
+---
+
+# Raport benchmarku bibliotek i18n dla Vue w 2026
+
+Ta strona jest raportem benchmarku dla rozwiązań i18n dla Vue.
+
+## Interaktywny benchmark
+
+<I18nBenchmark framework="vue" vertical/>
+
+## Referencja wyników
+
+> [Patrz kompletne dane benchmarku](https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-vue.md)

package/docs/pl/benchmark/solid.md

@@ -118,6 +118,28 @@ Porównaliśmy **cztery strategie ładowania**:
 - **Scoped static**: Utrzymuje porządek w kodzie (logiczna separacja) bez skomplikowanych dodatkowych zapytań sieciowych.
 - **Scoped dynamic**: Najlepsze podejście dla _code splittingu_ i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
 
+### Co mierzyłem:
+
+Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla każdego stosu, a następnie zapisałem, co faktycznie pojawiło się na sieci i jak długo to trwało. Rozmiary są podawane **po normalnej kompresji internetowej**, ponieważ jest to bliższe temu, co ludzie pobierają, niż surowe liczby źródła.
+
+- **Rozmiar biblioteki internacjonalizacji**: Po bundlingu, tree-shakingu i minifikacji, rozmiar biblioteki i18n to rozmiar providerów + kodu hooks/primitives w pustym komponencie. Nie obejmuje ładowania plików tłumaczeń. Odpowiada na pytanie, jak kosztowna jest biblioteka zanim twoja zawartość wejdzie do gry.
+
+- **JavaScript na stronę**: Dla każdej trasy benchmarku, ile skryptu przeglądarka pobiera dla tej wizyty, uśrednione na stronach w zestawie (i na lokalizacjach, gdzie raport je łączy). Ciężkie strony to wolne strony.
+
+- **Wyciek z innych lokalizacji**: To zawartość tej samej strony, ale w innym języku, która byłaby załadowana przez pomyłkę na audytowanej stronie. Ta zawartość jest zbędna i powinna być unikana. (np. zawartość strony `/fr/about` w bundlu strony `/en/about`)
+
+- **Wyciek z innych tras**: Ten sam pomysł dla **innych ekranów** w aplikacji: czy ich kopia jedzie razem, gdy otworzysz tylko jedną stronę. (np. zawartość strony `/en/about` w bundlu strony `/en/contact`). Wysoki wynik sugeruje słabe dzielenie lub zbyt szerokie bundle'i.
+
+- **Średni rozmiar bundle'u komponentu**: Typowe elementy UI są mierzone **jeden po drugim** zamiast ukrywania się wewnątrz jednej gigantycznej liczby aplikacji. Pokazuje, czy internacjonalizacja po cichu rozszerza zwykłe komponenty. Na przykład, jeśli twój komponent zostanie ponownie renderowany, załaduje wszystkie te dane z pamięci. Przywiązanie gigantycznego JSON'a do dowolnego komponentu jest jak podłączenie dużego magazynu nieużywanych danych, który spowolni wydajność twoich komponentów.
+
+- **Responsywność przełącznika języka**: Przełączam język przy użyciu kontrolki aplikacji i mierzę, jak długo trwa, zanim strona wyraźnie się zmieni, co odwiedzający zauważy, a nie laboratoryjny mikrokrok.
+
+- **Praca renderowania po zmianie języka**: Węższe uzupełnienie: ile wysiłku interfejsowi zajęło przepainting dla nowego języka po tym, jak przełączenie jest w locie. Przydatne, gdy „odczuty" czas i koszt framework'u się rozchodzą.
+
+- **Czas początkowego załadowania strony**: Od nawigacji do przeglądarki traktującej stronę jako całkowicie załadowaną dla scenariuszy, które testowałem. Dobry do porównywania zimnych startów.
+
+- **Czas hydratacji**: Gdy aplikacja to ujawnia, jak długo klient spędza na zamienianiu HTML serwera na coś, na co możesz faktycznie kliknąć. Kreska w tabelach oznacza, że implementacja nie dostarczyła wiarygodnej liczby hydratacji w tym benchmarku.
+
 ## Gwiazdki na GitHubie
 
 Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.

package/docs/pl/benchmark/svelte.md

@@ -116,6 +116,28 @@ Porównaliśmy **cztery strategie ładowania**:
 - **Scoped static**: Utrzymuje porządek w kodzie (logiczna separacja) bez skomplikowanych dodatkowych zapytań sieciowych.
 - **Scoped dynamic**: Najlepsze podejście dla _code splittingu_ i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
 
+### Co mierzyłem:
+
+Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla każdego stosu, a następnie zapisałem, co faktycznie pojawiło się na sieci i ile czasu to zajęło. Rozmiary są podawane **po normalnej kompresji internetowej**, ponieważ jest to bliższe temu, co ludzie pobierają, niż surowe liczby źródłowe.
+
+- **Rozmiar biblioteki internacjonalizacji**: Po bundlingu, tree-shakingu i minifikacji rozmiar biblioteki i18n to rozmiar kodu dostawców + magazynów w pustym komponencie. Nie obejmuje wczytywania plików tłumaczeń. Odpowiada na pytanie, jak kosztowna jest biblioteka, zanim Twoja zawartość wejdzie na scenę.
+
+- **JavaScript na stronie**: Dla każdej trasy benchmarku, ile skryptu przeglądarka pobiera dla tej wizyty, uśrednione dla stron w zestawie (i dla lokalizacji, gdzie raport je łączy). Ciężkie strony są wolnymi stronami.
+
+- **Wyciek z innych lokalizacji**: To zawartość tej samej strony, ale w innym języku, która byłaby załadowana przez pomyłkę na auditowanej stronie. Ta zawartość jest niepotrzebna i powinna być unikana. (np. zawartość strony `/fr/about` w pakiecie strony `/en/about`)
+
+- **Wyciek z innych tras**: Ten sam pomysł dla **innych ekranów** w aplikacji: czy ich tekst towarzyszy ci, gdy otwierasz tylko jedną stronę. (np. zawartość strony `/en/about` w pakiecie strony `/en/contact`). Wysoki wynik sugeruje słabe dzielenie lub zbyt szerokie pakiety.
+
+- **Średni rozmiar pakietu komponentu**: Popularne elementy interfejsu użytkownika są mierzone **jeden na raz** zamiast ukrywania się wewnątrz jednej gigantycznej liczby aplikacji. Pokazuje, czy internacjonalizacja po cichu inflacyjnie wpływa na codzienne komponenty. Na przykład, jeśli twój komponent się renderuje, załaduje wszystkie te dane z pamięci. Dołączenie gigantycznego JSON-a do dowolnego komponentu to jak podłączenie dużego magazynu nieużywanych danych, który spowolni wydajność twoich komponentów.
+
+- **Responsywność przełącznika języka**: Przełączam język za pomocą własnej kontroli aplikacji i mierzę, ile czasu upłynie, zanim strona wyraźnie się przełączy, co odwiedzający by zauważył, a nie laboratoryjny mikro-krok.
+
+- **Praca renderowania po zmianie języka**: Bardziej zawężone uzupełnienie: ile wysiłku interfejs podjął, aby przemalować dla nowego języka, gdy przełącznik jest w locie. Przydatne, gdy „odczuwany" czas i koszt frameworka się rozbiegają.
+
+- **Czas ładowania początkowej strony**: Od nawigacji do przeglądarki uznającej stronę za w pełni załadowaną dla testowanych scenariuszy. Dobry dla porównywania zimnych startów.
+
+- **Czas hydratacji**: Kiedy aplikacja go ujawnia, jak długo klient spędza na zamienianiu HTML-a serwera w coś, na co faktycznie można kliknąć. Kreska w tabelach oznacza, że ta implementacja nie dostarczyła wiarygodnej liczby hydratacji w tym benchmarku.
+
 ## Gwiazdki na GitHubie
 
 Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.

package/docs/pl/benchmark/tanstack.md

@@ -124,6 +124,28 @@ Porównaliśmy **cztery strategie ładowania**:
 - **Scoped static**: Utrzymuje porządek w kodzie (separacja logiczna) bez skomplikowanych dodatkowych żądań sieciowych.
 - **Scoped dynamic**: Najlepsze podejście pod kątem dzielenia kodu (code splitting) i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
 
+### Co mierzyłem:
+
+Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla każdego stacku, a następnie zapisałem, co dokładnie pojawiło się na przewodzie i jak długo to trwało. Rozmiary są podawane **po normalnej kompresji sieci web**, ponieważ jest to bliższe temu, co ludzie pobierają, niż surowe liczby źródłowe.
+
+- **Rozmiar biblioteki internationalization**: Po bundlingu, tree-shakingu i minifikacji, rozmiar biblioteki i18n to rozmiar providerów (np. `NextIntlClientProvider`) + kod hooks'ów (np. `useTranslations`) w pustym komponencie. Nie obejmuje to ładowania plików tłumaczeń. Odpowiada na pytanie, jak kosztowna jest biblioteka, zanim Twoja zawartość pojawi się w grze.
+
+- **JavaScript na stronę**: Dla każdej trasy benchmarku, ile skryptu przeglądarka pobiera w tej wizycie, uśrednione na stronach w zestawie (i na locales, gdzie raport je łączy). Ciężkie strony to wolne strony.
+
+- **Wyciek z innych locale'ów**: To zawartość tej samej strony, ale w innym języku, która zostałaby załadowana przez pomyłkę na audytowanej stronie. Ta zawartość jest niepotrzebna i powinna być unikana. (np. zawartość strony `/fr/about` w bundlu strony `/en/about`)
+
+- **Wyciek z innych tras**: Ten sam pomysł dla **innych ekranów** w aplikacji: czy ich zawartość się pojawia, gdy otworzysz tylko jedną stronę. (np. zawartość strony `/en/about` w bundlu strony `/en/contact`). Wysoki wynik wskazuje na słabe splitting'owanie lub zbyt szerokie bundle'e.
+
+- **Średni rozmiar bundle'u komponentu**: Typowe elementy UI są mierzone **pojedynczo** zamiast być ukryte wewnątrz jednej gigantycznej liczby aplikacji. Pokazuje, czy internationalization po cichu nie powiększa codziennych komponentów. Na przykład, jeśli Twój komponent się ponownie renderuje, załaduje wszystkie dane z pamięci. Przyłączenie gigantskiego JSONa do dowolnego komponentu to jak podłączenie dużego magazynu nieużywanych danych, które spowolnią wydajność Twoich komponentów.
+
+- **Responsywność przełączania języka**: Przełączam język za pomocą kontrolki aplikacji i mierzę, jak długo trwa, zanim strona wyraźnie się zmieni, co zauważy odwiedzający, a nie mikro-krok z laboratorium.
+
+- **Praca renderowania po zmianie języka**: Węższe uzupełnienie: ile wysiłku zajęło interfejsowi przerysowanie nowego języka, gdy przełącznik jest w drodze. Przydatne, gdy "odczuwany" czas i koszt frameworka różnią się.
+
+- **Czas ładowania strony początkowej**: Od nawigacji do przeglądarki, która uważa stronę za w pełni załadowaną dla testowanych scenariuszy. Dobry do porównywania zimnych startów.
+
+- **Czas nawodnień (hydration)**: Gdy aplikacja to ujawnia, jak długo klient spędza na zamianie serwera HTML na coś, w co można faktycznie kliknąć. Kreska w tabelach oznacza, że implementacja nie dostarczyła wiarygodnej liczby nawodnienia w tym benchmarku.
+
 ## Gwiazdki na GitHubie
 
 Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.

package/docs/pl/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## Wygenerowane GitHub Actions
+
+Gdy uruchomisz `intlayer init`, Intlayer wykrywa Twój package manager (npm, yarn, pnpm lub bun) i generuje dwa przepływy pracy GitHub Actions w `.github/workflows/`, z poleceniami odpowiadającymi tego package managera:
+
+- **`intlayer-fill.yml`** — Na każde pull request, buduje słowniki i uruchamia `intlayer fill --git-diff --mode complete` aby wygenerować brakujące tłumaczenia dla zmienonych słowników, następnie zatwierdza wynik z powrotem do gałęzi PR.
+- **`intlayer-test.yml`** — Na każde pull request, buduje słowniki i uruchamia `intlayer test`, nie powodując sprawdzenia, gdy brakuje wymaganych lokalizacji tłumaczenia.
+
+Istniejące pliki przepływu pracy nigdy nie są zastępowane. Aby całkowicie pominąć scaffolding, uruchom:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### Zapewnianie dostępu do AI w workflow fill
+
+Scaffold `intlayer-fill.yml` wymaga dostępu do AI. Dostępne są dwie opcje (skonfigurowane w bloku `env` workflow):
+
+1. **Twój własny klucz dostawcy AI** — Dodaj secret `AI_API_KEY` w ustawieniach repozytorium (Settings → Secrets and variables → Actions). Workflow przekazuje go poprzez `--provider`, `--model` i `--api-key`.
+2. **Klucze dostępu do Intlayer CMS** — Dodaj secrety `INTLAYER_CLIENT_ID` i `INTLAYER_CLIENT_SECRET` i powiąż je z sekcją `editor` w `intlayer.config`. Klucze dostępu do CMS zapewniają dostęp do AI poprzez backend Intlayer.
+
+Workflow `intlayer-test.yml` nie wymaga żadnego dostępu do AI.
+
 ## Obsługa błędów
 
 - Jeśli `INTLAYER_PROJECT_CREDENTIALS` nie jest ustawiona, polecenie zakończy się błędem.

package/docs/pl/cli/fill.md

@@ -47,6 +47,14 @@ Kluczowe punkty:
 - Zachowuje istniejące tłumaczenia, nie nadpisując ich.
 - Przetwarza pliki, fragmenty i lokalizacje równolegle przy użyciu systemu kolejkowego, aby zwiększyć prędkość.
 
+## Kluczowe punkty:
+
+- Dzieli duże pliki JSON na fragmenty, aby pozostać w granicach kontekstu modelu AI.
+- Ponawia tłumaczenie, jeśli format wyjściowy jest nieprawidłowy.
+- Zawiera kontekst specyficzny dla aplikacji i pliku, aby poprawić dokładność tłumaczenia.
+- Zachowuje istniejące tłumaczenia, nie zastępując ich.
+- Przetwarza pliki, fragmenty i lokalizacje równolegle przy użyciu systemu kolejki, aby zwiększyć szybkość.
+
 ## Alias:
 
 - `npx intlayer dictionaries fill`

package/docs/pl/cli/login.md

@@ -76,42 +76,6 @@ pnpm intlayer login --cms-url https://intlayer.org
 bun x intlayer login --cms-url https://intlayer.org
 ```
 
-### Opcje konfiguracji
-
-Możesz także użyć standardowych opcji konfiguracji:
-
-- `--env-file <path>`: Ścieżka do pliku środowiskowego
-- `-e, --env <env>`: Środowisko wykonawcze
-- `--base-dir <dir>`: Katalog bazowy projektu
-- `--verbose`: Włącz szczegółowe logowanie (domyślnie: true)
-- `--prefix <prefix>`: Prefiks dla logów
-
-## Jak to działa
-
-1. **Uruchomienie serwera lokalnego**: Polecenie uruchamia lokalny serwer HTTP na losowym porcie, aby odebrać poświadczenia z CMS
-
-Określ URL Intlayer CMS, z którym należy się połączyć w celu uwierzytelnienia.
-
-- **Typ**: `string`
-- **Domyślna wartość**: Wartość skonfigurowana w `intlayer.config.*` lub `https://intlayer.org`
-- **Przykład**:
-
-```bash packageManager="npm"
-npx intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="yarn"
-yarn intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="pnpm"
-pnpm intlayer login --cms-url https://intlayer.org
-```
-
-```bash packageManager="bun"
-bun x intlayer login --cms-url https://intlayer.org
-```
-
 ### Opcje konfiguracyjne
 
 Możesz również użyć ogólnych opcji konfiguracyjnych:

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

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z i18n-js do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji z i18n-js do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - i18n-js
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z i18n-js do Intlayer
+
+Przejście z biblioteki `i18n-js` do Intlayer to wysoce zoptymalizowana migracja zaprojektowana aby przenieść duże konfiguracje tłumaczeń do strukturalnego systemu rozwiązywania plików Intlayer.
+
+## Co zrobić
+
+Wykonaj następujące polecenie konfiguracyjne w swoim repozytorium:
+
+```bash
+npx intlayer init
+```
+
+Po przygotowaniu pliku `intlayer.config.ts`, możesz dodać alias Intlayer do konfiguracji twojego bundlera, aby wszelkie importy `i18n-js` wskazywały na pakiet compat `@intlayer/i18n-js`.
+
+## Co się dzieje za kulisami
+
+`i18n-js` uzyskuje dostęp do przestrzeni nazw poprzez wyrażenia takie jak `i18n.t('scope.key', {name})` wraz z rezerwowymi ustawieniami lokali i specjalnymi mapowaniami liczby mnogiej.
+
+Za kulisami:
+
+- **Interpolacja:** Adapter compat z łatwością parsuje mapowania `%{name}` na wartość słownika czasu wykonywania docelowego.
+- **Liczba mnoga:** Zastępuje podklucze `one/other` i mapuje je względem potężnych bazowych mechanizmów liczby mnogiej Intlayer (`Intl.PluralRules`), abstrakcyjnie oddzielając ręczne mapowania.
+- **Lokale:** Zamiast ładować monolityczne payload języka przy inicjalizacji, słowniki są serwowane optymalnie na podstawie obecnej konfiguracji kontekstu poprzez natywną konfigurację Intlayer.

package/docs/pl/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z i18next do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Vanilla JS/TS z i18next do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z i18next do Intlayer
+
+Aby zapoznać się z szczegółowym samouczkiem krok po kroku, zapraszamy do naszego pełnego [Przewodnika migracji z i18next](../migration_from_i18next_to_intlayer.md).
+
+Intlayer doskonale replikuje podstawowe charakterystyki czasu wykonywania `i18next`. Wykorzystując pakiet compat, twoje aplikacje Vanilla lub moduły wewnętrzne mogą nadal korzystać ze znanej składni.
+
+## Co zrobić
+
+Aby rozpocząć, zainicjuj Intlayer w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+Jeśli używasz Vite, dołącz plugin Intlayer aby przekierować importy do `@intlayer/i18next`:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## Co się dzieje za kulisami
+
+Plugin `i18nextVitePlugin` aliasuje importy `i18next` do `@intlayer/i18next`, unikając obciążenia bundle z włączeniami plików JSON.
+
+Za kulisami:
+
+- **Konfiguracja instancji:** `createInstance` poprawnie parsuje i stosuje rezerwowe ustawienia przestrzeni nazw, korzystając z rurociągu kompilacji Intlayer dla pobierania słownika.
+- **Interpolacja:** Natywna obsługa zamian `{{name}}` i zagnieżdżania `$t(key)` rekursywnie.
+- **Kontekst i liczba mnoga:** Identyfikuje i rozwiązuje formaty sufiksów takie jak `key_male` i `key_one`/`key_other`, obliczając względem standardu `Intl.PluralRules`.
+- **Zwracanie obiektów:** Tryb `returnObjects: true` bezpiecznie wyodrębnia drzewa ze słowników Intlayer.

package/docs/pl/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Adaptery kompatybilności Intlayer"
+description: "Migruj istniejące rozwiązanie i18n do Intlayer bez tarcia za pomocą adapterów kompatybilności."
+keywords:
+  - compat
+  - migracja
+  - internationalization
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Adaptery kompatybilności Intlayer
+
+Migracja dużej aplikacji do nowej biblioteki internacjonalizacji może być zniechęcająca. Aby ułatwić to przejście, Intlayer zapewnia **adaptery kompatybilności** dla najpopularniejszych bibliotek i18n w ekosystemie.
+
+Te pakiety adapterów ujawniają **dokładnie taki sam publiczny API** co istniejące biblioteki i18n, ale delegują całą pracę tłumaczenia do Intlayer w czasie wykonywania.
+
+## Jak to działa
+
+Kiedy używasz adaptera compat, nie musisz przepisywać importów aplikacji ani zmieniać sposobu korzystania z hoków i komponentów tłumaczenia. Zamiast tego, wtyczki bundlera Intlayer automatycznie aliasują istniejące importy do pakietów compat Intlayer.
+
+Na przykład, deweloper zastępuje `import { useTranslation } from 'react-i18next'` przez `import { useTranslation } from '@intlayer/react-i18next'` (wykonane automatycznie poprzez wtyczkę bundlera), a aplikacja kontynuuje pracę z tłumaczeniami serwowanymi z słowników Intlayer. Klucze są również wpisane względem twoich słowników Intlayer!
+
+## Dostępne adaptery kompatybilności
+
+Wybierz istniejącą bibliotekę poniżej, aby zobaczyć jak bezproblemowo przeprowadzić migrację:
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/pl/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z Lingui do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji z Lingui do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - lingui
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z Lingui do Intlayer
+
+Jeśli twój projekt opiera się na kompilacji opartej na makrach Lingui, przejście na Intlayer pozwala ci utrzymać potężne przepływy pracy makr, wspierając je natywnie strategią kompilacji JSON Intlayer.
+
+## Co zrobić
+
+Aby rozpocząć, zainicjuj Intlayer w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+To tworzy twój `intlayer.config.ts`. Upewnij się, że zachowujesz `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` w kroku budowania, aby działał _przed_ kompilator Intlayer. Następnie, użyj aliasu wtyczki bundlera aby przekierować `@lingui/core` i `@lingui/react` do `@intlayer/lingui`.
+
+## Co się dzieje za kulisami
+
+Lingui wykorzystuje makra (takie jak `` t`Hello ${name}` `` i `<Trans>`) które są kompilowane w wywołania czasu wykonywania takie jak `i18n._(id, values)`.
+
+Za kulisami:
+
+- **Makra:** Kompilują się dokładnie jak wcześniej, zapewniając brak przerwy w składni źródła.
+- **Tłumaczenie czasu wykonywania:** Alias `i18n._()` korzysta ze słowników Intlayer. Zarówno jawnie nazwane identyfikatory jak i zahaszowane identyfikatory są w pełni mapowane używając wtyczek synchronizacji Intlayer `.po` aby agregować i usuwać klucze bezpiecznie.
+- **Możliwości ICU:** Obsługa pluralizacji, selekcji i wariantów ICU pozostaje solidna dzięki ujednoliconemu parserowi ICU Intlayer, zapewniając identyczne wyniki renderowania.

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

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z next-i18next do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Next.js z next-i18next do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z next-i18next do Intlayer
+
+Aby zapoznać się z kompletnym i szczegółowym samouczkiem krok po kroku, zapraszamy do naszego pełnego [Przewodnika migracji z next-i18next](../migration_from_next-i18next_to_intlayer.md).
+
+Intlayer obsługuje wszystkie implementacje Next.js Pages Router i App Router transparentnie. Korzystając z adaptera możesz przeprowadzić migrację swojej implementacji `next-i18next` bez przepisywania kodu.
+
+## Co zrobić
+
+Aby rozpocząć, uruchom:
+
+```bash
+npx intlayer init
+```
+
+To tworzy wymagany plik konfiguracji Intlayer. Aby przełączyć się na Intlayer za kulisami, zaktualizuj swój `next.config.ts`:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Co się dzieje za kulisami
+
+Plugin `createNextI18nPlugin` komponuje natywne zachowanie Next.js wraz z podstawową wtyczką `next-intlayer`, wstrzykując wszystkie wymagane aliasy Webpack/Turbopack dla `next-i18next`, `react-i18next` i `i18next`.
+
+Za kulisami:
+
+- **`serverSideTranslations` & `appWithTranslation`:** Teraz funkcjonują jako opakowania dla wewnętrznych zaladowników Intlayer, omijając dużą statyczną iniekcję JSON.
+- **Hooki klienckie:** Delegują natychmiast do `@intlayer/react-i18next` zachowując wszystkie funkcje formatowania, liczby mnogiej i zagnieżdżone przestrzenie nazw.

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

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z next-intl do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Next.js z next-intl do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z next-intl do Intlayer
+
+Aby zapoznać się z kompletnym i szczegółowym samouczkiem krok po kroku, zapraszamy do naszego pełnego [Przewodnika migracji z next-intl](../migration_from_next-intl_to_intlayer.md).
+
+Migracja z `next-intl` do Intlayer pozwala ci utrzymać routing aplikacji i składnię całkowicie niezakłócone.
+
+## Co zrobić
+
+Wykonaj następujące polecenie w swoim repozytorium:
+
+```bash
+npx intlayer init
+```
+
+To będzie tworzyć `intlayer.config.ts`. W swoim `next.config.ts`, użyj opakowania wtyczki aby bezproblemowo wstrzyknąć aliasy `next-intl` do `@intlayer/next-intl`.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## Co się dzieje za kulisami
+
+Opakowywacz bundlera zastępuje tłumaczenia, ale **pozostawia funkcje `next-intl/navigation` nienaruszone** (np. `Link`, `redirect`, `usePathname`).
+
+Za kulisami:
+
+- **Runtime ICU:** Liczby mnoga (`=0`, `one`, `other`), select/selectordinal, argumenty `#` i sformatowane argumenty (`{ts, date, long}`) działają poprawnie używając wspólnego `resolveMessage(..., 'icu')` resolver.
+- **`useTranslations()` & `getTranslations()`:** Wywołania zakresu bare wyodrębniają pierwszy segment klucza jako prawidłowy identyfikator słownika. Zagnieżdżone przestrzenie nazw łagodnie dzielą się na ścieżki słownika i prefiksy.
+- **Formatowanie bogate:** Zarówno `t.rich()` jak i `t.markup()` są w pełni natywnie implementowane, konwertując węzły podobne do HTML na wyrenderowane fragmenty React.
+- **`useFormatter`:** `relativeTime`, `list`, `dateTimeRange` i nazwane formaty z konfiguracji mostu do podstawowych natywnych `Intl` formatów.

package/docs/pl/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z Next Translate do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Next.js z next-translate do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z Next Translate do Intlayer
+
+Migracja z `next-translate` do Intlayer to prawie drop-in replacement, który zachowuje istniejącą składnię i tagi.
+
+## Co zrobić
+
+Zainicjuj Intlayer w swoim projekcie:
+
+```bash
+npx intlayer init
+```
+
+CLI będzie budować twoją konfigurację. Możesz następnie zastosować wtyczkę Intlayer w swoim `next.config.ts`, która wstrzykuje aliasy ścieżki czasu budowania mapujące `next-translate/useTranslation` do `@intlayer/next-translate`.
+
+## Co się dzieje za kulisami
+
+`next-translate` zapewnia hooki takie jak `useTranslation('ns')`, `t('ns:key.path')` i komponent `<Trans>`.
+
+Za kulisami:
+
+- **Interpolacja i liczba mnoga:** Opiera się ściśle na zachowaniu adaptera `react-i18next`. Dynamicznie obsługiwane są symbole zastępcze `{{var}}` i pluralizacja mapowana z sufiksów takich jak `key_0`, `key_one` i `key_other`.
+- **Komponent `<Trans>`:** Bezpośrednio obsługiwany do parsowania tagów podobnych do HTML wraz z prop `components` na podstawie tablic.
+- **Przestrzenie nazw:** Aliasing ścieżki podrzędnej zapewnia, że twoje referencje `useTranslation` odwołują się do prawidłowych wewnętrznych słowników przestrzeni nazw bez ręcznej modyfikacji.

package/docs/pl/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migracja z NGX-Translate do Intlayer"
+description: "Dowiedz się, jak przeprowadzić migrację aplikacji Angular z ngx-translate do Intlayer za pomocą adaptera kompatybilności."
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - migracja
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Init history"
+author: aymericzip
+---
+
+# Migracja z NGX-Translate do Intlayer
+
+Migracja aplikacji Angular z `ngx-translate` do Intlayer jest łatwa za pomocą adaptera compat, pozwalając pominąć potrzebę przepisywania wszystkich szablonów.
+
+## Co zrobić
+
+Rozpocznij uruchamiając:
+
+```bash
+npx intlayer init
+```
+
+To ustawia `intlayer.config.ts`. Zastąp konfiguracje `TranslateModule.forRoot()` i aliasy importu odpowiednio aby wskazywały na `@intlayer/ngx-translate`.
+
+## Co się dzieje za kulisami
+
+`ngx-translate` wykorzystuje `TranslateService` (`instant`, `get`, `stream`) wraz z piperem `{{ 'KEY' | translate:params }}` i dyrektywą `[translate]`.
+
+Za kulisami:
+
+- **Serwisy:** `TranslateService` opakuje `getIntlayer` i obserwowalne lokali, zapewniając dokładnie te same metody.
+- **Pipy i dyrektywy:** Ponownie wdrożone aby rozwiązywać względem słowników Intlayer bezpośrednio.
+- **Zaladowniki:** Konfiguracje `TranslateHttpLoader` są konwertowane na zadania ostrzeżeń, ponieważ Intlayer natywnie rozwiązuje i powiązuje twoje słowniki w czasie budowania (lub poprzez standardowe importy dynamiczne), całkowicie eliminując potrzebę zaladowników HTTP.