@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/pl/benchmark/___solid.md

@@ -0,0 +1,36 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Najlepsze rozwiązanie i18n dla Solid w 2026 - Raport benchmarku
+description: Porównaj biblioteki internacjonalizacji Solid. Szczegółowy raport wydajności dotyczący rozmiaru bundle, wycieków i reaktywności.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - solid
+  - wydajność
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - solid
+author:
+  name: Aymeric PINEAU
+  github: aymericzip
+history:
+  - version: 8.7.5
+    date: 2026-01-06
+    changes: "Init benchmark"
+---
+
+# Raport benchmarku bibliotek i18n dla Solid w 2026
+
+Ta strona jest raportem benchmarku dla rozwiązań i18n dla Solid.
+
+## Interaktywny benchmark
+
+<I18nBenchmark framework="solid" 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-solid.md)

package/docs/pl/benchmark/___svelte.md

@@ -0,0 +1,36 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Najlepsze rozwiązanie i18n dla Svelte w 2026 - Raport benchmarku
+description: Porównaj biblioteki internacjonalizacji Svelte. Szczegółowy raport wydajności dotyczący rozmiaru bundle, wycieków i reaktywności.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - svelte
+  - wydajność
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - svelte
+author:
+  name: Aymeric PINEAU
+  github: aymericzip
+history:
+  - version: 8.7.5
+    date: 2026-01-06
+    changes: "Init benchmark"
+---
+
+# Raport benchmarku bibliotek i18n dla Svelte w 2026
+
+Ta strona jest raportem benchmarku dla rozwiązań i18n dla Svelte.
+
+## Interaktywny benchmark
+
+<I18nBenchmark framework="svelte" 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-svelte.md)

package/docs/pl/benchmark/___tanstack.md

@@ -0,0 +1,36 @@
+---
+createdAt: 2026-04-20
+updatedAt: 2026-04-21
+title: Najlepsze rozwiązanie i18n dla TanStack Start w 2026 - Raport benchmarku
+description: Porównaj biblioteki internacjonalizacji TanStack Start takie jak react-i18next, use-intl i Intlayer. Szczegółowy raport wydajności dotyczący rozmiaru bundle, wycieków i reaktywności.
+keywords:
+  - benchmark
+  - i18n
+  - intl
+  - tanstack
+  - wydajność
+  - intlayer
+slugs:
+  - doc
+  - benchmark
+  - tanstack
+author:
+  name: Aymeric PINEAU
+  github: aymericzip
+history:
+  - version: 8.7.5
+    date: 2026-01-06
+    changes: "Init benchmark"
+---
+
+# Raport benchmarku bibliotek i18n dla TanStack Start w 2026
+
+Ta strona jest raportem benchmarku dla rozwiązań i18n dla TanStack Start.
+
+## Interaktywny benchmark
+
+<I18nBenchmark framework="tanstack" 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-tanstack.md)

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/index.md

@@ -17,6 +17,7 @@ history:
   - version: 8.7.5
     date: 2026-01-06
     changes: "Inicjalizacja benchmarka"
+author: aymericzip
 ---
 
 # Benchmark - Raport

package/docs/pl/benchmark/nextjs.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - nextjs
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
   - version: 8.9.8

package/docs/pl/benchmark/solid.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - solid
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
 history:
   - version: 8.9.8
@@ -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

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - svelte
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
   - version: 8.9.8
@@ -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

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - tanstack
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
   - version: 8.9.8
@@ -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/benchmark/vue.md

@@ -14,7 +14,7 @@ slugs:
   - doc
   - benchmark
   - vue
-author: Aymeric PINEAU
+author: aymericzip
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
   - version: 8.9.8

package/docs/pl/bundle_optimization.md

@@ -22,6 +22,7 @@ history:
   - version: 8.7.0
     date: 2026-04-08
     changes: "Dodano opcje `minify` i `purge` do konfiguracji budowania"
+author: aymericzip
 ---
 
 # Optymalizacja Rozmiaru Paczki i Wydajności i18n
@@ -396,11 +397,11 @@ export default config;
 
 ### Opcje Budowania
 
-| Właściwość     | Typ                    | Domyślnie   | Opis                                                                                                                                                                                                      |
-| :------------- | :--------------------- | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`optimize`** | `boolean \| undefined` | `undefined` | Włącza przepisanie zajawek importowych. `undefined` = aktywne tylko w trybie produkcyjnym. Tryb `false` obali równomiernie opcje z flagi purge i minify.                                                  |
-| **`minify`**   | `boolean`              | `false`     | Ucina klucze pól w zawartych strukturach opartych o plik w formatach JSON ze zwinnym przepisywaniem kodu o te same elementy alfabetyczne. Zyskuje na znaczeniu, kiedy opcja `optimize` gra swoją rolę.    |
-| **`purge`**    | `boolean`              | `false`     | Eliminuje statyczne, niespotykane powiązania we wnętrzu w pełni poddanych analizie kodów źródłowych (eliminując fragmentację plików JSON). Zostaje odrzucone w wypadku, w którym `optimize` jest `false`. |
+| Właściwość     | Typ                   | Domyślnie   | Opis                                                                                                                                                                                                      |
+| :------------- | :-------------------- | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`optimize`** | `boolean / undefined` | `undefined` | Włącza przepisanie zajawek importowych. `undefined` = aktywne tylko w trybie produkcyjnym. Tryb `false` obali równomiernie opcje z flagi purge i minify.                                                  |
+| **`minify`**   | `boolean`             | `false`     | Ucina klucze pól w zawartych strukturach opartych o plik w formatach JSON ze zwinnym przepisywaniem kodu o te same elementy alfabetyczne. Zyskuje na znaczeniu, kiedy opcja `optimize` gra swoją rolę.    |
+| **`purge`**    | `boolean`             | `false`     | Eliminuje statyczne, niespotykane powiązania we wnętrzu w pełni poddanych analizie kodów źródłowych (eliminując fragmentację plików JSON). Zostaje odrzucone w wypadku, w którym `optimize` jest `false`. |
 
 ### Minifikacja (Zmienianie Nazw Kluczy)
 

package/docs/pl/cli/build.md

@@ -17,6 +17,7 @@ history:
   - version: 8.1.5
     date: 2026-02-23
     changes: "Dodaj opcję checkTypes"
+author: aymericzip
 ---
 
 # Budowanie słowników

package/docs/pl/cli/ci.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.11
     date: 2026-01-06
     changes: "Dodaj polecenie CI"
+author: aymericzip
 ---
 
 # Polecenie CI
@@ -139,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/configuration.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - configuration
+author: aymericzip
 ---
 
 # Zarządzanie konfiguracją

package/docs/pl/cli/debug.md

@@ -13,6 +13,7 @@ slugs:
   - concept
   - cli
   - debug
+author: aymericzip
 ---
 
 # Debugowanie polecenia intlayer

package/docs/pl/cli/doc-review.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-06-17
 title: Przegląd dokumentu
 description: Dowiedz się, jak przeglądać pliki dokumentacji pod kątem jakości, spójności i kompletności w różnych lokalizacjach.
 keywords:
@@ -15,6 +15,11 @@ slugs:
   - concept
   - cli
   - doc-review
+history:
+  - version: 9.0.0
+    date: 2026-06-17
+    changes: "Dodaj opcję --log"
+author: aymericzip
 ---
 
 # Przegląd dokumentu
@@ -54,8 +59,110 @@ W większości przypadków,
 
 ## Argumenty:
 
-Polecenie `doc review` akceptuje te same argumenty co `doc translate`, co pozwala na przeglądanie konkretnych plików dokumentacji i stosowanie kontroli jakości.
+**Opcje listy plików:**
 
-Jeśli aktywowałeś jedną z opcji git, polecenie przejrzy tylko te części plików, które uległy zmianie. Skrypt podzieli plik na fragmenty i przejrzy każdy z nich. Jeśli w danym fragmencie nie ma zmian, skrypt go pominie, aby przyspieszyć proces przeglądu i ograniczyć koszty korzystania z API dostawcy AI.
+- **`--doc-pattern [docPattern...]`**: Wzorce glob do dopasowania plików dokumentacji do przeglądu.
 
-- Pełną listę argumentów znajdziesz w dokumentacji polecenia [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/doc-translate.md).
+  > Przykład: `npx intlayer doc review --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Wzorce glob do wykluczenia z przeglądu.
+
+  > Przykład: `npx intlayer doc review --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Pomiń plik, jeśli został zmodyfikowany przed podanym czasem.
+  - Może to być czas absolutny, np. "2025-12-05" (string lub Date)
+  - Może to być czas względny w ms `1 * 60 * 60 * 1000` (1 godzina)
+  - Ta opcja sprawdza czas aktualizacji pliku za pomocą metody `fs.stat`. Może więc być wpływana przez Git lub inne narzędzia modyfikujące plik.
+
+  > Przykład: `npx intlayer doc review --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Pomiń plik, jeśli został zmodyfikowany w podanym czasie.
+  - Może to być czas absolutny, np. "2025-12-05" (string lub Date)
+  - Może to być czas względny w ms `1 * 60 * 60 * 1000` (1 godzina)
+  - Ta opcja sprawdza czas aktualizacji pliku za pomocą metody `fs.stat`. Może więc być wpływana przez Git lub inne narzędzia modyfikujące plik.
+
+  > Przykład: `npx intlayer doc review --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Pomiń plik, jeśli już istnieje.
+
+  > Przykład: `npx intlayer doc review --skip-if-exists`
+
+**Opcje trybu przeglądu:**
+
+- **`--log`**: Tryb tylko logowania. Nie tłumaczy za pomocą AI; zamiast tego loguje bloki wymagające uwagi (wraz z numerami linii i zawartością) dla bazowych i docelowych lokalizacji, aby pomóc innemu agentowi w wygenerowaniu tłumaczeń.
+
+  > Przykład: `npx intlayer doc review --log`
+
+**Opcje wyjścia wpisu:**
+
+- **`--locales [locales...]`**: Docelowe lokalizacje, dla których ma być przejrzana dokumentacja.
+
+  > Przykład: `npx intlayer doc review --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Źródłowa lokalizacja (bazowy dokument), z którą należy porównać.
+
+  > Przykład: `npx intlayer doc review --base-locale en`
+
+**Opcje przetwarzania plików:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Liczba plików przetwarzanych jednocześnie podczas przeglądu.
+
+  > Przykład: `npx intlayer doc review --nb-simultaneous-file-processed 5`
+
+**Opcje AI:**
+
+- **`--model [model]`**: Model AI używany do przeglądu (np. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Dostawca AI używany do przeglądu.
+- **`--temperature [temperature]`**: Ustawienie temperatury dla modelu AI.
+- **`--api-key [apiKey]`**: Podaj własny klucz API dla usługi AI.
+- **`--application-context [applicationContext]`**: Podaj dodatkowy kontekst dla przeglądu AI.
+- **`--data-serialization [dataSerialization]`**: Format serializacji danych dla funkcji AI w Intlayer. Opcje: `json` (standardowy, niezawodny), `toon` (mniej tokenów, mniej spójny).
+- **`--custom-prompt [prompt]`**: Dostosuj podstawowy prompt używany do przeglądu. (Uwaga: W większości przypadków zaleca się użycie opcji `--custom-instructions`, ponieważ zapewnia lepszą kontrolę.)
+
+  > Przykład: `npx intlayer doc review --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Moja aplikacja to sklep z kotami"`
+
+**Opcje zmiennych środowiskowych:**
+
+- **`--env`**: Określ środowisko (np. `development`, `production`).
+- **`--env-file [envFile]`**: Podaj niestandardowy plik środowiskowy do załadowania zmiennych.
+- **`--base-dir`**: Określ katalog bazowy projektu.
+- **`--no-cache`**: Wyłącz pamięć podręczną.
+
+  > Przykład: `npx intlayer doc review --base-dir ./docs --env-file .env.production.local`
+
+**Opcje logowania:**
+
+- **`--verbose`**: Włącz szczegółowe logowanie do debugowania. (domyślnie true przy użyciu CLI)
+
+  > Przykład: `npx intlayer doc review --verbose`
+
+**Opcje niestandardowych instrukcji:**
+
+- **`--custom-instructions [customInstructions]`**: Niestandardowe instrukcje dodane do promptu. Przydatne do stosowania specyficznych reguł dotyczących formatowania, tłumaczenia URL itp.
+
+  > Przykład: `npx intlayer doc review --custom-instructions "Unikaj tłumaczenia URL-i i zachowaj format markdown"`
+
+  > Przykład: `npx intlayer doc review --custom-instructions "$(cat ./instructions.md)"`
+
+**Opcje Git:**
+
+- **`--git-diff`**: Uruchom tylko na plikach, które zawierają zmiany od bazy (domyślnie `origin/main`) do bieżącej gałęzi (domyślnie `HEAD`).
+- **`--git-diff-base`**: Określ bazowe odniesienie dla git diff (domyślnie `origin/main`).
+- **`--git-diff-current`**: Określ bieżące odniesienie dla git diff (domyślnie `HEAD`).
+- **`--uncommitted`**: Uwzględnij niezacommitowane zmiany.
+- **`--unpushed`**: Uwzględnij niepushowane zmiany.
+- **`--untracked`**: Uwzględnij nieśledzone pliki.
+
+  > Przykład: `npx intlayer doc review --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Przykład: `npx intlayer doc review --uncommitted --unpushed --untracked`
+
+> Zauważ, że ścieżka pliku wyjściowego zostanie określona przez zastąpienie następujących wzorców:
+>
+> - `/{{baseLocale}}/` na `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` na `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` na `_{{locale}}.`
+> - `{{baseLocale}}_` na `{{locale}}_`
+> - `.{{baseLocaleName}}.` na `.{{localeName}}.`
+>
+> Jeśli wzorzec nie zostanie znaleziony, plik wyjściowy doda `.{{locale}}` do rozszerzenia pliku. `./my/file.md` zostanie przejrzany i zaktualizowany do `./my/file.fr.md` dla lokalizacji francuskiej.

package/docs/pl/cli/doc-translate.md

@@ -15,6 +15,7 @@ slugs:
   - concept
   - cli
   - doc-translate
+author: aymericzip
 ---
 
 # Tłumaczenie dokumentu

package/docs/pl/cli/editor.md

@@ -13,6 +13,7 @@ slugs:
   - concept
   - cli
   - editor
+author: aymericzip
 ---
 
 # Polecenia edytora

package/docs/pl/cli/extract.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - extract
+author: aymericzip
 ---
 
 # Wyodrębnianie stringów

package/docs/pl/cli/fill.md

@@ -16,6 +16,7 @@ slugs:
   - concept
   - cli
   - fill
+author: aymericzip
 ---
 
 # Wypełnianie / audyt / tłumaczenie słowników
@@ -46,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/index.md

@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 9.0.0
+    date: 2026-06-11
+    changes: "Dodano polecenie scan"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Dodano polecenie standalone"
@@ -62,6 +65,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Inicjalizacja historii"
+author: aymericzip
 ---
 
 # Intlayer CLI - Wszystkie polecenia Intlayer CLI dla Twojej wielojęzycznej strony
@@ -162,6 +166,10 @@ Aby dowiedzieć się, jak skonfigurować dostępne języki lub inne parametry, z
 
 - **[Polecenie CI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/ci.md)** - Wykonuj polecenia Intlayer z automatycznie wstrzykniętymi danymi uwierzytelniającymi dla potoków CI/CD
 
+### Audyt i Diagnostyka
+
+- **[Skanuj stronę internetową](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/scan.md)** - Zmierz rozmiar strony i przeprowadź audyt zdrowia i18n/SEO dowolnego publicznego adresu URL
+
 ### Narzędzia Deweloperskie
 
 - **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/sdk.md)** - Używaj Intlayer CLI SDK we własnym kodzie
@@ -184,7 +192,8 @@ Aby dowiedzieć się, jak skonfigurować dostępne języki lub inne parametry, z
   "intlayer:extract": "npx intlayer extract",
   "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
-  "intlayer:doc:review": "npx intlayer doc review"
+  "intlayer:doc:review": "npx intlayer doc review",
+  "intlayer:scan": "npx intlayer scan https://example.com"
 }
 ```
 

package/docs/pl/cli/init.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.9
     date: 2025-12-30
     changes: "Dodano polecenie init"
+author: aymericzip
 ---
 
 # Inicjalizacja Intlayer

package/docs/pl/cli/list.md

@@ -20,6 +20,7 @@ history:
   - version: 7.5.11
     date: 2026-01-06
     changes: "Dodano opcję wyjścia JSON do polecenia list"
+author: aymericzip
 ---
 
 # Lista plików deklaracji zawartości

package/docs/pl/cli/list_projects.md

@@ -18,6 +18,7 @@ history:
   - version: 7.5.12
     date: 2026-01-06
     changes: "Dodaj opcję wyjścia bezwzględnego do polecenia list projects"
+author: aymericzip
 ---
 
 # Lista projektów Intlayer

package/docs/pl/cli/live.md

@@ -14,6 +14,7 @@ slugs:
   - concept
   - cli
   - live
+author: aymericzip
 ---
 
 # Polecenia Live Sync