@intlayer/docs 9.4.3 → 9.5.0

package/docs/pl/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Pliki konfiguracyjne Intlayer pozwalają na dostosowanie różnych aspektów wtyczki, takich jak internacjonalizacja (i18n), middleware i zarządzanie treścią. Ten dokument zawiera szczegółowy opis każdej właściwości w konfiguracji.
 
----
-
 ## Spis treści
 
 <TOC/>
 
----
-
 ## Obsługa plików konfiguracyjnych
 
 Intlayer akceptuje formaty plików konfiguracyjnych JSON, JS, MJS i TS:
@@ -143,8 +139,6 @@ Intlayer akceptuje formaty plików konfiguracyjnych JSON, JS, MJS i TS:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Przykładowy plik konfiguracyjny
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -695,14 +689,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Odniesienia do konfiguracji
 
 Poniższe sekcje szczegółowo opisują różne właściwości konfiguracji dostępne w Intlayer.
 
----
-
 ### Konfiguracja internacjonalizacji (Internationalization)
 
 Definiuje ustawienia związane z internacjonalizacją, w tym dostępne locale i domyślne locale.
@@ -714,8 +704,6 @@ Definiuje ustawienia związane z internacjonalizacją, w tym dostępne locale i
 | `strictMode`      | Zapewnia silną implementację zinternacjonalizowanej treści za pomocą TypeScript.  | `string`   | `'inclusive'`       |                      | • Jeśli `"strict"`: Każde zadeklarowane locale musi być zdefiniowane dla funkcji `t` - błąd w przypadku braku lub niezadeklarowanego locale.<br/>• Jeśli `"inclusive"`: Ostrzeżenie dla brakujących lokali, ale pozwala na użycie istniejących niezadeklarowanych lokali.<br/>• Jeśli `"loose"`: Akceptuje każde istniejące locale. |
 | `defaultLocale`   | Domyślne locale używane jako zapasowe, gdy żądane locale nie zostanie znalezione. | `string`   | `Locales.ENGLISH`   | `'en'`               | Używane do określenia locale, jeśli żadne nie jest określone w URL, plikach cookie lub nagłówku.                                                                                                                                                                                                                                    |
 
----
-
 ### Konfiguracja edytora (Editor)
 
 Definiuje ustawienia edytora wizualnego, w tym port serwera i status aktywacji.
@@ -747,8 +735,6 @@ Analityka działa na zasadzie opt-out: jest włączona domyślnie i zaczyna zbie
 | `flushInterval` | Milisekundy między automatycznymi zbiorczymi wysyłkami do backendu.                       | `number`  | `20000`   | `10000`  |                                                                                                                                                                                                      |
 | `sampleRate`    | Ułamek sesji do rejestrowania, od `0` (brak) do `1` (wszystkie).                          | `number`  | `1`       | `0.5`    | Próbkowanie jest deterministyczne dla sesji, więc zarejestrowana sesja raportuje wszystkie swoje zdarzenia (bez częściowych lejków).                                                                 |
 
----
-
 ### Konfiguracja routingu (Routing)
 
 Ustawienia kontrolujące zachowanie routingu, w tym strukturę URL, przechowywanie locale i obsługę middleware.
@@ -950,8 +936,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### Konfiguracja treści (Content)
 
 Ustawienia do zarządzania treścią w aplikacji, w tym nazwy katalogów, rozszerzenia plików i pochodne konfiguracje.
@@ -965,8 +949,6 @@ Ustawienia do zarządzania treścią w aplikacji, w tym nazwy katalogów, rozsze
 | `excludedPath`   | Katalogi, które należy wykluczyć ze skanowania treści.                                                   | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Obecnie nieużywane; zaplanowane na przyszłość.                                                                                                            |
 | `formatCommand`  | Polecenie do formatowania plików treści, gdy Intlayer zapisuje je lokalnie.                              | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` zostanie zastąpione ścieżką do pliku.<br/>• Jeśli niezdefiniowane, Intlayer spróbuje automatycznie wykryć (testuje prettier, biome, eslint). |
 
----
-
 ### 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.
@@ -1021,8 +1003,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Konfiguracja loggera (Log)
 
 Ustawienia dostosowywania wyjścia logów Intlayer.
@@ -1093,8 +1073,6 @@ Ustawienia budowania mają zastosowanie do wtyczek `@intlayer/babel` i `@intlaye
 | `outputFormat`        | Kontroluje format wyjściowy słowników.                                                                                           | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
 | `traversePattern`     | Wzorzec dla plików, które mają być skanowane podczas optymalizacji.                                                              | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Poprawia wydajność budowania poprzez ograniczenie optymalizacji do odpowiednich plików.<br/>• Ignorowane, jeśli `optimize` jest wyłączone.<br/>• Używa wzorców glob.                                                                                                                                                                                                                                                                                                                                                                                           |
 
----
-
 ### Konfiguracja kompilatora (Compiler)
 
 Kontroluje ustawienia kompilatora Intlayer, który kolekcjonuje słowniki bezpośrednio z Twoich komponentów.
@@ -1114,8 +1092,6 @@ Kontroluje ustawienia kompilatora Intlayer, który kolekcjonuje słowniki bezpo
 | --------- | ------------------------------------------------------------------------ | --------------------------- |
 | `schemas` | Pozwala definiować schematy Zod do walidacji struktury Twoich słowników. | `Record<string, ZodSchema>` |
 
----
-
 ### Wtyczki (Plugins)
 
 | Pole      | Opis                                              | Typ                |
@@ -1131,25 +1107,21 @@ Kontroluje ustawienia kompilatora Intlayer, który kolekcjonuje słowniki bezpo
 W katalogu głównym projektu, obok `package.json`. Intlayer przeszukuje katalog roboczy i jego katalogi nadrzędne w poszukiwaniu `intlayer.config.ts`, `intlayer.config.js`, `intlayer.config.mjs` lub `intlayer.config.cjs`. Możesz również wskazać niestandardową ścieżkę za pomocą flagi `--config` w poleceniach CLI.
 
 </Question>
-
 <Question title="O ile i18n zwiększa rozmiar mojego bundle'a?">
 
 Znacznie mniej niż rozwiązania oparte na przestrzeniach nazw, ponieważ strona nigdy nie pobiera katalogu, którego nie renderuje. Znaczniki renderowane po stronie serwera rozwiązują treść na serwerze, a kompilator czasu budowy zastępuje wywołania `useIntlayer` dokładnymi wpisami, których używa komponent, dzięki czemu nieużywane klucze i nieużywane języki są usuwane. [Słowniki dynamiczne](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md) dzielą resztę na poszczególne języki. W porównaniu z typowymi alternatywami, Intlayer zmniejsza rozmiar bundle'a i strony nawet o 50%. Zobacz [optymalizację bundle'a](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) oraz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
 
 </Question>
-
 <Question title="Czy mogę zmigrować z i18next, next-intl lub react-i18next bez przepisywania moich komponentów?">
 
 Tak, i są dwie drogi. Możesz migrować treść stopniowo za pomocą [przewodnika migracji z i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_i18next_to_intlayer.md) lub [przewodnika migracji z next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_next-intl_to_intlayer.md). Możesz także zachować obecne API w całości: [adaptery kompatybilności](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compat/index.md) udostępniają dokładnie to samo API co `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` i `Lingui`, ale zasilane słownikami Intlayer, więc zmieniają się importy, a kod komponentów pozostaje nienaruszony.
 
 </Question>
-
 <Question title="Czy mogę zachować moje istniejące pliki tłumaczeń JSON?">
 
 Tak. Wtyczka [sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-json.md) utrzymuje Twoje pliki `/messages/{locale}/{namespace}.json` jako źródło prawdy i generuje z nich słowniki Intlayer w obu kierunkach. Wtyczka [sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-po.md) robi to samo dla katalogów gettext, a [pliki per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/per_locale_file.md) pozwalają rozdzielić zawartość według języka zamiast grupować lokalizacje w jednym pliku.
 
 </Question>
-
 <Question title="Czy muszę przenosić moją zawartość klucz po kluczu?">
 
 Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe, wyodrębni ciągi widoczne dla użytkownika i utworzy plik `.content` obok każdego z nich, dzięki czemu przeglądasz diff zamiast ręcznie kopiować ciągi do katalogu pojedynczo. Zobacz [polecenie extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md).
@@ -1157,7 +1129,6 @@ Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe,
 W przypadku w pełni zautomatyzowanego procesu [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) robi to samo w czasie budowania w kodzie JSX, TSX, Vue i Svelte, generując słowniki przy każdej zmianie, dzięki czemu nie ma potrzeby ręcznego zarządzania kluczami. Działa on w oparciu o analizę statyczną, więc ciągi istniejące tylko w czasie wykonywania pozostają poza jego zasięgiem i wymaga kilku adnotacji do odróżnienia tekstu dla użytkownika od logiki aplikacji.
 
 </Question>
-
 <Question title="Jakie narzędzia dla edytora i agentów AI są dostępne?">
 
 Pięć narzędzi, wszystkie opcjonalne:
@@ -1169,49 +1140,41 @@ Pięć narzędzi, wszystkie opcjonalne:
 - **[Wtyczka ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/eslint.md)**: reguła `no-raw-text` oznacza zakodowane na stałe ciągi tekstowe, z dodatkowymi regułami dla statycznych kluczy słownika i nieużywanej zawartości.
 
 </Question>
-
 <Question title="Jak dodać nowy język do mojej aplikacji?">
 
 Dodaj kod języka do tablicy `internationalization.locales`, a następnie uruchom `npx intlayer fill`, aby przetłumaczyć na niego istniejącą treść za pomocą AI. Kompilator automatycznie uwzględni nowy język przy następnym uruchomieniu.
 
 </Question>
-
 <Question title="Jak usunąć prefiks języka z moich adresów URL?">
 
 Ustaw `routing.mode`. Wartość `"no-prefix"` usuwa prefiks języka dla wszystkich lokalizacji, określając aktywny język na podstawie ciasteczka, nagłówka lub domeny. Wartość `"prefix-no-default"` (domyślna) usuwa prefiks tylko dla języka domyślnego, zachowując go dla pozostałych.
 
 </Question>
-
 <Question title="Czy mogę serwować każdy język z jego własnej domeny?">
 
 Tak. Opcja `routing.domains` mapuje każdą lokalizację na nazwę hosta, na przykład `{ pl: 'example.pl', en: 'example.com' }`. Identyfikacja domeny ma pierwszeństwo przed prefiksami ścieżek, a `getMultilingualUrls` generuje pełne adresy URL w metadanych `hreflang`.
 
 </Question>
-
 <Question title="W jaki sposób wykrywany jest język użytkownika?">
 
 Poprzez `routing.storage`, które określa źródła w kolejności ważności: zazwyczaj najpierw URL, potem ciasteczko, a następnie nagłówek `Accept-Language`, powracając do domyślnego języka.
 
 </Question>
-
 <Question title="Co robi opcja routing.enableProxy?">
 
 Kontroluje proxy routingu językowego: middleware, który obsługuje prefiksy i przekierowania. Pozostawiona pusta automatycznie uruchamia proxy w trybie deweloperskim i produkcyjnym. Ustawienie `false` wyłącza je całkowicie, jeśli samodzielnie zarządzasz trasowaniem.
 
 </Question>
-
 <Question title="Jaka jest różnica między importMode static, dynamic i fetch?">
 
 Wartość `"static"` (domyślna) importuje słowniki statycznie, więc są one pakowane do bundle'a i odczytywane synchronicznie. Wartość `"dynamic"` importuje słowniki asynchronicznie per język, redukując początkowy rozmiar bundle'a. Wartość `"fetch"` pobiera słowniki z serwera lub CMS w czasie działania.
 
 </Question>
-
 <Question title="Gdzie ustawić dostawcę AI i klucz API dla automatycznego tłumaczenia?">
 
 W pliku konfiguracyjnym w sekcji `ai` lub w wierszu poleceń za pomocą flag `--provider`, `--model` i `--api-key`. Klucz pozostaje po Twojej stronie i nigdy nie opuszcza Twojego środowiska. Zobacz [dokumentację konfiguracji AI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
 
 </Question>
-
 <Question title="Czy muszę restartować serwer deweloperski po zmianie konfiguracji?">
 
 Zazwyczaj nie. Watcher Intlayer obserwuje plik `intlayer.config.ts`: po zapisaniu przeładowuje konfigurację i przygotowuje słowniki w tle.

package/docs/pl/dictionary/html.md

@@ -122,8 +122,6 @@ const myContent = html(
 
 Podczas korzystania z metody `.use()` na węźle HTML, dostarczone komponenty zostaną sprawdzone pod kątem definicji podanej w funkcji `html()` (jeśli jest dostępna).
 
----
-
 ## Renderowanie HTML
 
 Renderowaniem można zająć się automatycznie za pomocą systemu treści Intlayer lub ręcznie przy użyciu specjalistycznych narzędzi.
@@ -477,8 +475,6 @@ Możesz skonfigurować renderowanie HTML globalnie dla całej aplikacji. To idea
   </Tab>
 </Tabs>
 
----
-
 ### Ręczne renderowanie i zaawansowane narzędzia
 
 Jeśli musisz renderować surowe łańcuchy HTML lub potrzebujesz większej kontroli nad mapowaniem komponentów, użyj poniższych narzędzi.
@@ -651,8 +647,6 @@ Jeśli musisz renderować surowe łańcuchy HTML lub potrzebujesz większej kont
   </Tab>
 </Tabs>
 
----
-
 ## Referencja opcji
 
 Te opcje mogą być przekazane do `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` i `renderHTML`.

package/docs/pl/dictionary/markdown.md

@@ -1171,8 +1171,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Renderowanie po stronie serwera (SSR) i hydratacja
 
 W porównaniu do innych parserów Markdown, takich jak remark / rehype, Intlayer Markdown jest pozbawiony zależności i działa zarówno po stronie klienta, jak i serwera.

package/docs/pl/how_works_intlayer.md

@@ -265,25 +265,21 @@ Pakiet `@intlayer/backend` eksportuje typy backendowe i w przyszłości zaoferuj
 W czasie budowy. Wtyczka Intlayer skanuje pliki `.content.ts`, kompiluje je w zoptymalizowane słowniki i zapisuje do folderu `.intlayer`. W środowisku deweloperskim proces ten powtarza się przy każdym zapisie pliku, dzięki czemu HMR natychmiast odzwierciedla zmiany.
 
 </Question>
-
 <Question title="O ile i18n zwiększa rozmiar mojego bundle'a?">
 
 Znacznie mniej niż rozwiązania oparte na przestrzeniach nazw, ponieważ strona nigdy nie pobiera katalogu, którego nie renderuje. Znaczniki renderowane po stronie serwera rozwiązują treść na serwerze, a kompilator czasu budowy zastępuje wywołania `useIntlayer` dokładnymi wpisami, których używa komponent, dzięki czemu nieużywane klucze i nieużywane języki są usuwane. [Słowniki dynamiczne](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md) dzielą resztę na poszczególne języki. W porównaniu z typowymi alternatywami, Intlayer zmniejsza rozmiar bundle'a i strony nawet o 50%. Zobacz [optymalizację bundle'a](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) oraz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
 
 </Question>
-
 <Question title="Czy mogę zmigrować z i18next, next-intl lub react-i18next bez przepisywania moich komponentów?">
 
 Tak, i są dwie drogi. Możesz migrować treść stopniowo za pomocą [przewodnika migracji z i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_i18next_to_intlayer.md) lub [przewodnika migracji z next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_next-intl_to_intlayer.md). Możesz także zachować obecne API w całości: [adaptery kompatybilności](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compat/index.md) udostępniają dokładnie to samo API co `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` i `Lingui`, ale zasilane słownikami Intlayer, więc zmieniają się importy, a kod komponentów pozostaje nienaruszony.
 
 </Question>
-
 <Question title="Czy mogę zachować moje istniejące pliki tłumaczeń JSON?">
 
 Tak. Wtyczka [sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-json.md) utrzymuje Twoje pliki `/messages/{locale}/{namespace}.json` jako źródło prawdy i generuje z nich słowniki Intlayer w obu kierunkach. Wtyczka [sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-po.md) robi to samo dla katalogów gettext, a [pliki per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/per_locale_file.md) pozwalają rozdzielić zawartość według języka zamiast grupować lokalizacje w jednym pliku.
 
 </Question>
-
 <Question title="Czy muszę przenosić moją zawartość klucz po kluczu?">
 
 Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe, wyodrębni ciągi widoczne dla użytkownika i utworzy plik `.content` obok każdego z nich, dzięki czemu przeglądasz diff zamiast ręcznie kopiować ciągi do katalogu pojedynczo. Zobacz [polecenie extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md).
@@ -291,7 +287,6 @@ Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe,
 W przypadku w pełni zautomatyzowanego procesu [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) robi to samo w czasie budowania w kodzie JSX, TSX, Vue i Svelte, generując słowniki przy każdej zmianie, dzięki czemu nie ma potrzeby ręcznego zarządzania kluczami. Działa on w oparciu o analizę statyczną, więc ciągi istniejące tylko w czasie wykonywania pozostają poza jego zasięgiem i wymaga kilku adnotacji do odróżnienia tekstu dla użytkownika od logiki aplikacji.
 
 </Question>
-
 <Question title="Jakie narzędzia dla edytora i agentów AI są dostępne?">
 
 Pięć narzędzi, wszystkie opcjonalne:
@@ -303,43 +298,36 @@ Pięć narzędzi, wszystkie opcjonalne:
 - **[Wtyczka ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/eslint.md)**: reguła `no-raw-text` oznacza zakodowane na stałe ciągi tekstowe, z dodatkowymi regułami dla statycznych kluczy słownika i nieużywanej zawartości.
 
 </Question>
-
 <Question title="Czym jest folder .intlayer i czy powinienem go zatwierdzać w gicie?">
 
 Jest to wygenerowany wynik: skompilowane słowniki i wygenerowane typy TypeScript. Powstaje on na podstawie Twoich plików treści, więc powinien być zignorowany w `.gitignore` i generowany na nowo w procesie CI/CD za pomocą polecenia `intlayer build`.
 
 </Question>
-
 <Question title="W jaki sposób określana jest aktywna lokalizacja?">
 
 Ze źródeł wymienionych w `routing.storage`, w kolejności: prefiks adresu URL, ciasteczko, nagłówek `Accept-Language`, a w ostateczności domyślny język zdefiniowany w konfiguracji.
 
 </Question>
-
 <Question title="Jaka jest różnica między słownikami lokalnymi a zdalnymi?">
 
 Słownik lokalny jest deklarowany w bazie kodu i kompilowany z aplikacją. Słownik zdalny jest zarządzany w CMS i pobierany przez API, dzięki czemu edytorzy mogą publikować zmiany tekstów bez konieczności ponownego wdrażania aplikacji.
 
 </Question>
-
 <Question title="Czy Intlayer działa bez TypeScriptu?">
 
 Tak. Pliki zawartości można tworzyć w TypeScript, JavaScript, ESM, CommonJS lub JSON. TypeScript zapewnia jednak automatyczne typowanie i autouzupełnianie kluczy, co stanowi jedną z kluczowych zalet Intlayer.
 
 </Question>
-
 <Question title="Jak renderowanie po stronie serwera i po stronie klienta współdzielą tę samą treść?">
 
 Serwer bezpośrednio rozwiązuje treść komponentów renderowanych na serwerze, więc żaden słownik nie jest dla nich przesyłany do klienta. Komponenty klienckie otrzymują wyłącznie słowniki dla tych elementów, które wymagają interaktywności w przeglądarce.
 
 </Question>
-
 <Question title="W jaki sposób Intlayer unika błędów hydratacji (hydration mismatch) związanych z językiem?">
 
 Lokalizacja jest ustalana jednokrotnie na serwerze i przekazywana do providera kontekstu klienta, zamiast ponownego jej wykrywania w przeglądarce, co gwarantuje identyczny stan HTML serwera i klienta.
 
 </Question>
-
 <Question title="Czy muszę przebudowywać aplikację po dodaniu tłumaczenia?">
 
 W środowisku deweloperskim nie: wtyczka obserwuje pliki zawartości i aktualizuje słowniki w locie. Na produkcji tak: słowniki lokalne są kompilowane do wynikowych plików aplikacji podczas etapu budowy.

package/docs/pl/interest_of_intlayer.md

@@ -44,43 +44,36 @@ W porównaniu do głównych rozwiązań, takich jak `next-intl` czy `i18next`, I
 Zamiast ładować ogromne pliki JSON na swoje strony, ładuj tylko niezbędną treść. Intlayer pomaga **zmniejszyć rozmiar paczki i stron nawet o 50%**.
 
 </Accordion>
-
 <Accordion header="Łatwość konserwacji">
 
 Ograniczenie zakresu treści aplikacji do poziomu komponentów **ułatwia konserwację** w przypadku aplikacji na dużą skalę. Możesz zduplikować lub usunąć pojedynczy folder z funkcjonalnością bez obciążenia psychicznego związanego z przeglądaniem całego kodu treści. Dodatkowo Intlayer jest **w pełni typowany**, aby zapewnić dokładność Twoich treści.
 
 </Accordion>
-
 <Accordion header="Agent AI">
 
 Umieszczenie treści bezpośrednio przy komponentach (co-location) **zmniejsza kontekst** wymagany przez duże modele językowe (LLM). Intlayer jest również wyposażony w zestaw narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)** oraz **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**, aby uczynić środowisko programistyczne (DX) jeszcze bardziej płynnym dla agentów AI.
 
 </Accordion>
-
 <Accordion header="Funkcje">
 
 Intlayer oferuje szereg dodatkowych funkcji, których inne rozwiązania i18n nie posiadają, takich jak [obsługa Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/markdown.md), [pobieranie treści zewnętrznych](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/function_fetching.md), [ładowanie treści z plików](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file.md), [aktualizacja treści na żywo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/live.md), [wizualny edytor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) i wiele więcej.
 
 </Accordion>
-
 <Accordion header="Automatyzacja">
 
 Skorzystaj z automatyzacji tłumaczeń w swoim rurociągu CI/CD, używając wybranego modelu LLM po kosztach bezpośrednich u Twojego dostawcy AI. Intlayer oferuje również **kompilator** do automatycznego wyodrębniania treści, a także [platformę internetową](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md) wspierającą **tłumaczenie w tle**.
 
 </Accordion>
-
 <Accordion header="Wydajność">
 
 Podłączanie potężnych plików JSON do komponentów może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje ładowanie treści już na etapie budowania (build).
 
 </Accordion>
-
 <Accordion header="Współpraca z osobami nietechnicznymi">
 
 Intlayer to coś więcej niż tylko rozwiązanie i18n — udostępnia on **[wizualny edytor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) z możliwością własnego hostowania** oraz **[pełny CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)**, który ułatwia zarządzanie wielojęzyczną treścią w **czasie rzeczywistym**. Dzięki temu współpraca z tłumaczami, copywriterami i innymi członkami zespołu jest bezproblemowa. Treści mogą być przechowywane lokalnie i/lub zdalnie.
 
 </Accordion>
-
 <Accordion header="Architektura wieloframeworkowa">
 
 Jeśli używasz różnych frameworków dla różnych części swojej aplikacji (np. React, React-native, Vue, Angular, Svelte itp.), Intlayer zapewnia sposób na **stosowanie wspólnej składni i implementacji we wszystkich głównych frameworkach frontendowych**. Będziesz także mógł udostępniać swoje deklaracje treści w swoim design systemie, aplikacjach, backendzie itd.
@@ -282,8 +275,6 @@ Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania sp
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
----
-
 ## Interoperacyjność
 
 `intlayer` może również pomóc w zarządzaniu przestrzeniami nazw `react-intl`, `react-i18next`, `next-intl`, `next-i18next` i `vue-i18n`.
@@ -305,25 +296,21 @@ Współistnieją trzy generacje:
 - **Biblioteki z warstwą treści (Content layer)**: `Intlayer`. Treść deklarowana obok komponentu, tree-shaking, typowanie TypeScript, tłumaczenie AI i edytor wizualny.
 
 </Question>
-
 <Question title="O ile i18n zwiększa rozmiar mojego bundle'a?">
 
 Znacznie mniej niż rozwiązania oparte na przestrzeniach nazw, ponieważ strona nigdy nie pobiera katalogu, którego nie renderuje. Znaczniki renderowane po stronie serwera rozwiązują treść na serwerze, a kompilator czasu budowy zastępuje wywołania `useIntlayer` dokładnymi wpisami, których używa komponent, dzięki czemu nieużywane klucze i nieużywane języki są usuwane. [Słowniki dynamiczne](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md) dzielą resztę na poszczególne języki. W porównaniu z typowymi alternatywami, Intlayer zmniejsza rozmiar bundle'a i strony nawet o 50%. Zobacz [optymalizację bundle'a](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) oraz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
 
 </Question>
-
 <Question title="Czy mogę zmigrować z i18next, next-intl lub react-i18next bez przepisywania moich komponentów?">
 
 Tak, i są dwie drogi. Możesz migrować treść stopniowo za pomocą [przewodnika migracji z i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_i18next_to_intlayer.md) lub [przewodnika migracji z next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_next-intl_to_intlayer.md). Możesz także zachować obecne API w całości: [adaptery kompatybilności](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compat/index.md) udostępniają dokładnie to samo API co `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` i `Lingui`, ale zasilane słownikami Intlayer, więc zmieniają się importy, a kod komponentów pozostaje nienaruszony.
 
 </Question>
-
 <Question title="Czy mogę zachować moje istniejące pliki tłumaczeń JSON?">
 
 Tak. Wtyczka [sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-json.md) utrzymuje Twoje pliki `/messages/{locale}/{namespace}.json` jako źródło prawdy i generuje z nich słowniki Intlayer w obu kierunkach. Wtyczka [sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-po.md) robi to samo dla katalogów gettext, a [pliki per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/per_locale_file.md) pozwalają rozdzielić zawartość według języka zamiast grupować lokalizacje w jednym pliku.
 
 </Question>
-
 <Question title="Czy muszę przenosić moją zawartość klucz po kluczu?">
 
 Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe, wyodrębni ciągi widoczne dla użytkownika i utworzy plik `.content` obok każdego z nich, dzięki czemu przeglądasz diff zamiast ręcznie kopiować ciągi do katalogu pojedynczo. Zobacz [polecenie extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md).
@@ -331,7 +318,6 @@ Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe,
 W przypadku w pełni zautomatyzowanego procesu [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) robi to samo w czasie budowania w kodzie JSX, TSX, Vue i Svelte, generując słowniki przy każdej zmianie, dzięki czemu nie ma potrzeby ręcznego zarządzania kluczami. Działa on w oparciu o analizę statyczną, więc ciągi istniejące tylko w czasie wykonywania pozostają poza jego zasięgiem i wymaga kilku adnotacji do odróżnienia tekstu dla użytkownika od logiki aplikacji.
 
 </Question>
-
 <Question title="Jakie narzędzia dla edytora i agentów AI są dostępne?">
 
 Pięć narzędzi, wszystkie opcjonalne:
@@ -343,43 +329,36 @@ Pięć narzędzi, wszystkie opcjonalne:
 - **[Wtyczka ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/eslint.md)**: reguła `no-raw-text` oznacza zakodowane na stałe ciągi tekstowe, z dodatkowymi regułami dla statycznych kluczy słownika i nieużywanej zawartości.
 
 </Question>
-
 <Question title="Czym Intlayer różni się od next-intl?">
 
 `next-intl` to warstwa wiadomości dla Next.js oparta na plikach JSON na język. Intlayer deklaruje treść obok każdego komponentu, usuwa nieużywane wpisy w czasie budowy, generuje precyzyjne typy TypeScript dla każdego słownika i integruje tłumaczenie AI oraz edytor wizualny.
 
 </Question>
-
 <Question title="Czym Intlayer różni się od i18next i react-i18next?">
 
 `i18next` rozwiązuje klucze tekstowe w czasie działania aplikacji, co oznacza, że błędna nazwa klucza skutkuje pustym tekstem w runtime. Intlayer sprawdza klucze statycznie w czasie kompilacji, usuwa nieużywane języki z bundle'a i automatyzuje tłumaczenia.
 
 </Question>
-
 <Question title="Czy Intlayer jest szybszy lub lżejszy od alternatyw?">
 
 W kwestii rozmiaru bundle'a i strony tak: brak konieczności pobierania niesformatowanych katalogów JSON redukuje wagę bundle'a nawet o 50%. W kwestii czasu wykonania kompilacja z wyprzedzeniem eliminuje parsowanie w runtime. Zobacz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
 
 </Question>
-
 <Question title="Czy warto migrować istniejącą aplikację?">
 
 To zależy od aktualnych wyzwań. Jeśli problemem jest duży rozmiar bundle'a, ciche błędy brakujących tłumaczeń lub trudności osób nietechnicznych w edycji tekstów, Intlayer rozwiązuje te problemy, a adaptery kompatybilności pozwalają na stopniową migrację bez przepisywania kodu.
 
 </Question>
-
 <Question title="Co oferuje Intlayer, czego nie mają inne biblioteki i18n?">
 
 Wsparcie dla [treści Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/markdown.md), pobieranie treści z CMS, wbudowany edytor wizualny, zautomatyzowane tłumaczenie AI z flagą `--git-diff` oraz autouzupełnianie TypeScript oparte na analizie komponentów.
 
 </Question>
-
 <Question title="Czy mogę używać Intlayer tylko jako menedżera tłumaczeń i zachować obecną bibliotekę?">
 
 Tak. Intlayer może generować przestrzenie nazw w formacie i lokalizacji oczekiwanej przez Twoją obecną bibliotekę (np. `/messages/{locale}/{namespace}.json`), dzięki czemu korzystasz z CLI i edytora Intlayer bez zmiany kodu aplikacji.
 
 </Question>
-
 <Question title="Czy Intlayer jest darmowy i open source?">
 
 Tak, na licencji Apache 2.0, włączając zastosowania komercyjne. Hostowany CMS to opcjonalna usługa, którą można również [hostować samodzielnie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/self_hosting.md).

package/docs/pl/intlayer_CMS.md

@@ -50,8 +50,6 @@ W tym celu Intlayer wprowadza koncepcję „zdalnych słowników”.
 
 <TOC/>
 
----
-
 ## Zrozumienie zdalnych słowników
 
 Intlayer rozróżnia „lokalne” i „zdalne” słowniki.
@@ -415,8 +413,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Pełny przewodnik konfiguracji, dokumentację zmiennych środowiskowych, instrukcje aktualizacji oraz procedury tworzenia kopii zapasowych i przywracania znajdziesz w [Przewodniku po samodzielnym hostowaniu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/self_hosting.md).
 
----
-
 ## Debug
 
 Jeśli napotkasz jakiekolwiek problemy z CMS, sprawdź następujące kwestie:
@@ -441,25 +437,21 @@ Jeśli napotkasz jakiekolwiek problemy z CMS, sprawdź następujące kwestie:
 [Edytor wizualny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md) edytuje lokalne pliki słowników w Twojej bazie kodu. CMS zarządza treścią zdalnie na serwerze, umożliwiając zmianę tekstów bez konieczności ponownego wdrażania aplikacji.
 
 </Question>
-
 <Question title="O ile i18n zwiększa rozmiar mojego bundle'a?">
 
 Znacznie mniej niż rozwiązania oparte na przestrzeniach nazw, ponieważ strona nigdy nie pobiera katalogu, którego nie renderuje. Znaczniki renderowane po stronie serwera rozwiązują treść na serwerze, a kompilator czasu budowy zastępuje wywołania `useIntlayer` dokładnymi wpisami, których używa komponent, dzięki czemu nieużywane klucze i nieużywane języki są usuwane. [Słowniki dynamiczne](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md) dzielą resztę na poszczególne języki. W porównaniu z typowymi alternatywami, Intlayer zmniejsza rozmiar bundle'a i strony nawet o 50%. Zobacz [optymalizację bundle'a](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) oraz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
 
 </Question>
-
 <Question title="Czy mogę zmigrować z i18next, next-intl lub react-i18next bez przepisywania moich komponentów?">
 
 Tak, i są dwie drogi. Możesz migrować treść stopniowo za pomocą [przewodnika migracji z i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_i18next_to_intlayer.md) lub [przewodnika migracji z next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_next-intl_to_intlayer.md). Możesz także zachować obecne API w całości: [adaptery kompatybilności](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compat/index.md) udostępniają dokładnie to samo API co `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` i `Lingui`, ale zasilane słownikami Intlayer, więc zmieniają się importy, a kod komponentów pozostaje nienaruszony.
 
 </Question>
-
 <Question title="Czy mogę zachować moje istniejące pliki tłumaczeń JSON?">
 
 Tak. Wtyczka [sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-json.md) utrzymuje Twoje pliki `/messages/{locale}/{namespace}.json` jako źródło prawdy i generuje z nich słowniki Intlayer w obu kierunkach. Wtyczka [sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-po.md) robi to samo dla katalogów gettext, a [pliki per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/per_locale_file.md) pozwalają rozdzielić zawartość według języka zamiast grupować lokalizacje w jednym pliku.
 
 </Question>
-
 <Question title="Czy muszę przenosić moją zawartość klucz po kluczu?">
 
 Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe, wyodrębni ciągi widoczne dla użytkownika i utworzy plik `.content` obok każdego z nich, dzięki czemu przeglądasz diff zamiast ręcznie kopiować ciągi do katalogu pojedynczo. Zobacz [polecenie extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md).
@@ -467,7 +459,6 @@ Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe,
 W przypadku w pełni zautomatyzowanego procesu [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) robi to samo w czasie budowania w kodzie JSX, TSX, Vue i Svelte, generując słowniki przy każdej zmianie, dzięki czemu nie ma potrzeby ręcznego zarządzania kluczami. Działa on w oparciu o analizę statyczną, więc ciągi istniejące tylko w czasie wykonywania pozostają poza jego zasięgiem i wymaga kilku adnotacji do odróżnienia tekstu dla użytkownika od logiki aplikacji.
 
 </Question>
-
 <Question title="Jakie narzędzia dla edytora i agentów AI są dostępne?">
 
 Pięć narzędzi, wszystkie opcjonalne:
@@ -479,43 +470,36 @@ Pięć narzędzi, wszystkie opcjonalne:
 - **[Wtyczka ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/eslint.md)**: reguła `no-raw-text` oznacza zakodowane na stałe ciągi tekstowe, z dodatkowymi regułami dla statycznych kluczy słownika i nieużywanej zawartości.
 
 </Question>
-
 <Question title="Które treści powinny trafić do CMS?">
 
 Treści, które często się zmieniają i nie są ściśle powiązane z cyklem wydań kodu: teksty na landing page'ach, cenniki, ogłoszenia, banery promocyjne oraz artykuły blogowe.
 
 </Question>
-
 <Question title="Co się stanie, jeśli CMS będzie nieosiągalny?">
 
 Aplikacja automatycznie powraca do lokalnej deklaracji słownika w bazie kodu, dzięki czemu awaria sieci lub serwera CMS nie powoduje wyświetlenia pustej strony użytkownikowi.
 
 </Question>
-
 <Question title="Czy mogę hostować CMS samodzielnie?">
 
 Tak. CMS może działać na Twojej własnej infrastrukturze, co jest idealnym rozwiązaniem, gdy dane nie mogą opuszczać Twojej sieci. Zobacz [przewodnik po self-hostingu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/self_hosting.md).
 
 </Question>
-
 <Question title="Czy edytorzy treści potrzebują programisty do publikacji zmian?">
 
 Nie. Taki jest cel zdalnych słowników: edytor zmienia tekst w CMS, a witryna natychmiast odzwierciedla zmiany za pośrednictwem mechanizmu synchronizacji na żywo (live sync).
 
 </Question>
-
 <Question title="Czy mogę zautomatyzować CMS zamiast korzystać z interfejsu?">
 
 Tak. Pakiet `@intlayer/api` SDK udostępnia te same punkty końcowe co interfejs, umożliwiając pobieranie projektów, odczytywanie słowników i automatyzację publikacji z poziomu skryptów.
 
 </Question>
-
 <Question title="Czy CMS obsługuje testy A/B tłumaczeń?">
 
 Tak. Zdalne słowniki obsługują [warianty treści](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md), co pozwala na testowanie różnych wersji tekstów dla różnych grup odbiorców.
 
 </Question>
-
 <Question title="Czy CMS jest darmowy?">
 
 Biblioteka Intlayer, CLI, kompilator i edytor wizualny są bezpłatne i open source na licencji Apache 2.0. Hostowany CMS to płatna usługa chmurowa, ale wersję CMS można również uruchomić na własnym serwerze bez opłat.

package/docs/pl/intlayer_visual_editor.md

@@ -230,25 +230,21 @@ Jeśli napotkasz jakiekolwiek problemy z edytorem wizualnym, sprawdź następuj
 Edytor wizualny edytuje lokalne słowniki i zapisuje zmiany bezpośrednio w plikach kodu źródłowego, dzięki czemu przechodzą one przez normalny proces kontroli wersji Git. CMS zapisuje treść na serwerze zdalnym, umożliwiając natychmiastową publikację bez wdrażania kodu.
 
 </Question>
-
 <Question title="O ile i18n zwiększa rozmiar mojego bundle'a?">
 
 Znacznie mniej niż rozwiązania oparte na przestrzeniach nazw, ponieważ strona nigdy nie pobiera katalogu, którego nie renderuje. Znaczniki renderowane po stronie serwera rozwiązują treść na serwerze, a kompilator czasu budowy zastępuje wywołania `useIntlayer` dokładnymi wpisami, których używa komponent, dzięki czemu nieużywane klucze i nieużywane języki są usuwane. [Słowniki dynamiczne](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dynamic_dictionaries/index.md) dzielą resztę na poszczególne języki. W porównaniu z typowymi alternatywami, Intlayer zmniejsza rozmiar bundle'a i strony nawet o 50%. Zobacz [optymalizację bundle'a](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/bundle_optimization.md) oraz [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/benchmark/index.md).
 
 </Question>
-
 <Question title="Czy mogę zmigrować z i18next, next-intl lub react-i18next bez przepisywania moich komponentów?">
 
 Tak, i są dwie drogi. Możesz migrować treść stopniowo za pomocą [przewodnika migracji z i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_i18next_to_intlayer.md) lub [przewodnika migracji z next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/migration_from_next-intl_to_intlayer.md). Możesz także zachować obecne API w całości: [adaptery kompatybilności](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compat/index.md) udostępniają dokładnie to samo API co `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` i `Lingui`, ale zasilane słownikami Intlayer, więc zmieniają się importy, a kod komponentów pozostaje nienaruszony.
 
 </Question>
-
 <Question title="Czy mogę zachować moje istniejące pliki tłumaczeń JSON?">
 
 Tak. Wtyczka [sync JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-json.md) utrzymuje Twoje pliki `/messages/{locale}/{namespace}.json` jako źródło prawdy i generuje z nich słowniki Intlayer w obu kierunkach. Wtyczka [sync PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/plugins/sync-po.md) robi to samo dla katalogów gettext, a [pliki per locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/per_locale_file.md) pozwalają rozdzielić zawartość według języka zamiast grupować lokalizacje w jednym pliku.
 
 </Question>
-
 <Question title="Czy muszę przenosić moją zawartość klucz po kluczu?">
 
 Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe, wyodrębni ciągi widoczne dla użytkownika i utworzy plik `.content` obok każdego z nich, dzięki czemu przeglądasz diff zamiast ręcznie kopiować ciągi do katalogu pojedynczo. Zobacz [polecenie extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md).
@@ -256,7 +252,6 @@ Nie. Uruchom `npx intlayer extract`, a Intlayer odczyta Twoje pliki źródłowe,
 W przypadku w pełni zautomatyzowanego procesu [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) robi to samo w czasie budowania w kodzie JSX, TSX, Vue i Svelte, generując słowniki przy każdej zmianie, dzięki czemu nie ma potrzeby ręcznego zarządzania kluczami. Działa on w oparciu o analizę statyczną, więc ciągi istniejące tylko w czasie wykonywania pozostają poza jego zasięgiem i wymaga kilku adnotacji do odróżnienia tekstu dla użytkownika od logiki aplikacji.
 
 </Question>
-
 <Question title="Jakie narzędzia dla edytora i agentów AI są dostępne?">
 
 Pięć narzędzi, wszystkie opcjonalne:
@@ -268,37 +263,31 @@ Pięć narzędzi, wszystkie opcjonalne:
 - **[Wtyczka ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/eslint.md)**: reguła `no-raw-text` oznacza zakodowane na stałe ciągi tekstowe, z dodatkowymi regułami dla statycznych kluczy słownika i nieużywanej zawartości.
 
 </Question>
-
 <Question title="Gdzie działa edytor wizualny?">
 
 Na Twojej własnej infrastrukturze. Ładuje Twoją aplikację w elemencie iframe i komunikuje się z lokalnym serwerem edytora, więc treść nigdy nie opuszcza Twojego komputera.
 
 </Question>
-
 <Question title="Czy edytorzy muszą umieć programować?">
 
 Nie. Otwierają stronę, klikają bezpośrednio w element tekstowy i edytują go w miejscu. Edytor sam lokalizuje powiązany wpis w pliku słownika.
 
 </Question>
-
 <Question title="Czy edycja przez edytor wizualny zmienia moje pliki źródłowe?">
 
 Tak, taki jest cel. Zmiana jest zapisywana w pliku deklaracji treści w Twojej bazie kodu, pojawiając się jako zwykła modyfikacja w diffie gita.
 
 </Question>
-
 <Question title="Edytor wyświetla pustą stronę lub odmawia załadowania witryny. Co sprawdzić?">
 
 Edytor wyświetla aplikację w iframe, więc Twoja Polityka Bezpieczeństwa Treści (CSP) musi zezwalać na adres edytora w dyrektywie `frame-ancestors`. Upewnij się również, że serwer aplikacji i serwer edytora działają.
 
 </Question>
-
 <Question title="Czy mogę używać edytora wizualnego na produkcji?">
 
 Jest on zaprojektowany dla środowisk deweloperskich i stagingowych, gdzie przebudowanie po edycji jest akceptowalne. Do edycji treści na działającej stronie produkcyjnej zalecany jest [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md).
 
 </Question>
-
 <Question title="Czy edytor wizualny jest bezpłatny?">
 
 Tak. Edytor wizualny jest częścią projektu open source na licencji Apache 2.0, włączając zastosowania komercyjne.