@intlayer/docs 9.4.1 → 9.4.2

package/docs/pl/configuration.md

@@ -1121,3 +1121,101 @@ Kontroluje ustawienia kompilatora Intlayer, który kolekcjonuje słowniki bezpo
 | Pole      | Opis                                              | Typ                |
 | --------- | ------------------------------------------------- | ------------------ |
 | `plugins` | Lista wtyczek Intlayer, które mają być dołączone. | `IntlayerPlugin[]` |
+
+## Często Zadawane Pytania
+
+<FAQ>
+
+<Question title="Gdzie powinien znajdować się plik intlayer.config.ts?">
+
+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).
+
+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:
+
+- **[Rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)**: przejście od klucza `useIntlayer` do pliku treści, który go deklaruje, wyodrębnianie treści z komponentu oraz uruchamianie build, fill, test, push i pull z palety poleceń lub dedykowanej karty Intlayer.
+- **[Serwer LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**: taka sama świadomość w dowolnym edytorze obsługującym LSP, z funkcjami przejdź do definicji (go to definition), znajdź wszystkie referencje, podglądem przetłumaczonej wartości po najechaniu kursorem, autouzupełnianiem kluczy i pól oraz ostrzeżeniem, gdy klucz nie jest nigdzie zadeklarowany. Rozpoznaje również wywołania `i18next`, `react-i18next`, `next-intl` i `use-intl`, co ułatwia migrację.
+- **[Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)**: udostępnia dokumentację i CLI Intlayer dla Cursor, VS Code, Claude Desktop, Claude Code i ChatGPT, dzięki czemu asystent odpowiada na podstawie aktualnej dokumentacji zamiast zgadywać i może samodzielnie wykonywać polecenia, takie jak `intlayer fill`.
+- **[Umiejętności agenta (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**: wyspecjalizowane umiejętności, takie jak `intlayer-config`, `intlayer-cli` i `intlayer-content`, oraz po jednej dla każdego frameworka, które uczą agenta konfiguracji routingu i typów węzłów treści.
+- **[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.
+
+</Question>
+
+</FAQ>

package/docs/pl/dictionary/content_file.md

@@ -366,15 +366,15 @@ Przekształca słownik w słownik per-lokalizacyjny, gdzie każde pole zadeklaro
 
 **Przykład:**
 
-```json
+```jsonc
 // Słownik per-locale
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // To staje się węzłem tłumaczenia dla 'en'
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -444,7 +444,7 @@ Instrukcje dotyczące automatycznego wypełniania zawartości słownika z zewnę
 
 **Przykłady:**
 
-```json
+```jsonc
 // Wyłącz wypełnianie
 {
   "fill": false

package/docs/pl/dictionary/markdown.md

@@ -51,6 +51,7 @@ Możesz zadeklarować treść Markdown używając funkcji `md` lub po prostu jak
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     Począwszy od wersji `8.10.0`, możesz deklarować treść Markdown bezpośrednio w plikach `.content.md`. Intlayer automatycznie wykryje i przetworzy treść Markdown.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ Możesz zadeklarować treść Markdown używając funkcji `md` lub po prostu jak
     ```
 
   </Tab>
+
   <Tab label="Pliki zewnętrzne" value="external-files">
     Importuj pliki `.md` bezpośrednio za pomocą funkcji `file`.
 
@@ -129,6 +131,7 @@ Możesz zadeklarować treść Markdown używając funkcji `md` lub po prostu jak
     ```
 
   </Tab>
+
 </Tabs>
 
 ## Renderowanie Markdown

package/docs/pl/dictionary/plurial.md

@@ -35,9 +35,12 @@ W przeciwieństwie do [`enu`](https://github.com/aymericzip/intlayer/blob/main/d
 
 ## Kiedy używać `plural` vs `enu`
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Przypadek użycia                                                              | Pomocnik |
+| ----------------------------------------------------------------------------- | -------- |
+| Gramatyczne formy liczby mnogiej zależne od języka (jabłko / jabłka / jabłek) | `plural` |
+| Niestandardowe zakresy liczbowe (`<5`, `>=10`) lub kategorie spoza CLDR       | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Jeśli tworzysz aplikację tylko po angielsku (gdzie występuje tylko `one` / `other`), oba rozwiązania zadziałają. W przypadku języków z rozróżnieniem `few` / `many` / `two`, preferuj `plural`.
 
 ## Konfigurowanie treści w liczbie mnogiej
 

package/docs/pl/how_works_intlayer.md

@@ -255,3 +255,95 @@ Pakiet `@intlayer/backend` eksportuje typy backendowe i w przyszłości zaoferuj
 ## Rozmowa z naszą inteligentną dokumentacją
 
 - [Zadaj pytania naszej inteligentnej dokumentacji](https://intlayer.org/doc/chat)
+
+## Często Zadawane Pytania
+
+<FAQ>
+
+<Question title="Kiedy budowane są słowniki, w czasie budowy czy w czasie działania?">
+
+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).
+
+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:
+
+- **[Rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)**: przejście od klucza `useIntlayer` do pliku treści, który go deklaruje, wyodrębnianie treści z komponentu oraz uruchamianie build, fill, test, push i pull z palety poleceń lub dedykowanej karty Intlayer.
+- **[Serwer LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**: taka sama świadomość w dowolnym edytorze obsługującym LSP, z funkcjami przejdź do definicji (go to definition), znajdź wszystkie referencje, podglądem przetłumaczonej wartości po najechaniu kursorem, autouzupełnianiem kluczy i pól oraz ostrzeżeniem, gdy klucz nie jest nigdzie zadeklarowany. Rozpoznaje również wywołania `i18next`, `react-i18next`, `next-intl` i `use-intl`, co ułatwia migrację.
+- **[Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)**: udostępnia dokumentację i CLI Intlayer dla Cursor, VS Code, Claude Desktop, Claude Code i ChatGPT, dzięki czemu asystent odpowiada na podstawie aktualnej dokumentacji zamiast zgadywać i może samodzielnie wykonywać polecenia, takie jak `intlayer fill`.
+- **[Umiejętności agenta (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**: wyspecjalizowane umiejętności, takie jak `intlayer-config`, `intlayer-cli` i `intlayer-content`, oraz po jednej dla każdego frameworka, które uczą agenta konfiguracji routingu i typów węzłów treści.
+- **[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.
+
+</Question>
+
+</FAQ>

package/docs/pl/interest_of_intlayer.md

@@ -39,7 +39,6 @@ author: aymericzip
 W porównaniu do głównych rozwiązań, takich jak `next-intl` czy `i18next`, Intlayer jest rozwiązaniem, które oferuje wbudowane optymalizacje, takie jak:
 
 <AccordionGroup>
-
 <Accordion header="Rozmiar paczki (Bundle size)">
 
 Zamiast ładować ogromne pliki JSON na swoje strony, ładuj tylko niezbędną treść. Intlayer pomaga **zmniejszyć rozmiar paczki i stron nawet o 50%**.
@@ -292,3 +291,99 @@ Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania sp
 Używając `intlayer`, możesz zadeklarować treść w formacie swojej ulubionej biblioteki i18n, a intlayer wygeneruje przestrzenie nazw w wybranej przez Ciebie lokalizacji (przykład: `/messages/{{locale}}/{{namespace}}.json`).
 
 Jeśli chcesz nadal korzystać z API swojej obecnej biblioteki i18n, `intlayer` udostępnia również **adaptery kompatybilności (compat adapters)**: pakiety wystawiające dokładnie to samo API co `react-i18next`, `next-intl`, `react-intl`, `vue-i18n` i inne, ale zasilane słownikami Intlayer. Dzięki temu możesz migrować stopniowo, bez przepisywania kodu. Zobacz [dokumentację adapterów kompatybilności](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md).
+
+## Często Zadawane Pytania
+
+<FAQ>
+
+<Question title="Jakie są różne rozwiązania dostępne do internacjonalizacji aplikacji JavaScript?">
+
+Współistnieją trzy generacje:
+
+- **Biblioteki katalogów w czasie działania (runtime)**: `i18next`, `react-i18next`, `next-i18next`, `vue-i18n`, `ngx-translate`. Wiadomości znajdują się w przestrzeniach nazw JSON ładowanych w runtime.
+- **Biblioteki wiadomości w czasie kompilacji**: `Lingui`, `Paraglide`, `react-intl` oraz `next-intl` z etapem ekstrakcji.
+- **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).
+
+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:
+
+- **[Rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)**: przejście od klucza `useIntlayer` do pliku treści, który go deklaruje, wyodrębnianie treści z komponentu oraz uruchamianie build, fill, test, push i pull z palety poleceń lub dedykowanej karty Intlayer.
+- **[Serwer LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**: taka sama świadomość w dowolnym edytorze obsługującym LSP, z funkcjami przejdź do definicji (go to definition), znajdź wszystkie referencje, podglądem przetłumaczonej wartości po najechaniu kursorem, autouzupełnianiem kluczy i pól oraz ostrzeżeniem, gdy klucz nie jest nigdzie zadeklarowany. Rozpoznaje również wywołania `i18next`, `react-i18next`, `next-intl` i `use-intl`, co ułatwia migrację.
+- **[Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)**: udostępnia dokumentację i CLI Intlayer dla Cursor, VS Code, Claude Desktop, Claude Code i ChatGPT, dzięki czemu asystent odpowiada na podstawie aktualnej dokumentacji zamiast zgadywać i może samodzielnie wykonywać polecenia, takie jak `intlayer fill`.
+- **[Umiejętności agenta (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**: wyspecjalizowane umiejętności, takie jak `intlayer-config`, `intlayer-cli` i `intlayer-content`, oraz po jednej dla każdego frameworka, które uczą agenta konfiguracji routingu i typów węzłów treści.
+- **[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).
+
+</Question>
+
+</FAQ>

package/docs/pl/intlayer_CMS.md

@@ -431,3 +431,95 @@ Jeśli napotkasz jakiekolwiek problemy z CMS, sprawdź następujące kwestie:
 - Upewnij się, że konfiguracja projektu została przesłana do Intlayer CMS.
 
 - Edytor wizualny używa iframe do wyświetlania Twojej strony internetowej. Upewnij się, że Polityka Bezpieczeństwa Treści (CSP) Twojej strony pozwala na URL CMS jako `frame-ancestors` (domyślnie 'https://intlayer.org'). Sprawdź konsolę edytora pod kątem błędów.
+
+## Często Zadawane Pytania
+
+<FAQ>
+
+<Question title="Jaka jest różnica między Intlayer CMS a edytorem wizualnym?">
+
+[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).
+
+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:
+
+- **[Rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)**: przejście od klucza `useIntlayer` do pliku treści, który go deklaruje, wyodrębnianie treści z komponentu oraz uruchamianie build, fill, test, push i pull z palety poleceń lub dedykowanej karty Intlayer.
+- **[Serwer LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**: taka sama świadomość w dowolnym edytorze obsługującym LSP, z funkcjami przejdź do definicji (go to definition), znajdź wszystkie referencje, podglądem przetłumaczonej wartości po najechaniu kursorem, autouzupełnianiem kluczy i pól oraz ostrzeżeniem, gdy klucz nie jest nigdzie zadeklarowany. Rozpoznaje również wywołania `i18next`, `react-i18next`, `next-intl` i `use-intl`, co ułatwia migrację.
+- **[Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)**: udostępnia dokumentację i CLI Intlayer dla Cursor, VS Code, Claude Desktop, Claude Code i ChatGPT, dzięki czemu asystent odpowiada na podstawie aktualnej dokumentacji zamiast zgadywać i może samodzielnie wykonywać polecenia, takie jak `intlayer fill`.
+- **[Umiejętności agenta (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**: wyspecjalizowane umiejętności, takie jak `intlayer-config`, `intlayer-cli` i `intlayer-content`, oraz po jednej dla każdego frameworka, które uczą agenta konfiguracji routingu i typów węzłów treści.
+- **[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.
+
+</Question>
+
+</FAQ>

package/docs/pl/intlayer_visual_editor.md

@@ -219,4 +219,90 @@ Jeśli napotkasz jakiekolwiek problemy z edytorem wizualnym, sprawdź następuj
   - Wymagane pola:
 - URL aplikacji powinien odpowiadać temu, który ustawiłeś w konfiguracji edytora (`applicationURL`).
 
-- Edytor wizualny używa iframe do wyświetlania Twojej strony internetowej. Upewnij się, że Polityka Bezpieczeństwa Treści (CSP) Twojej strony pozwala na adres URL CMS jako `frame-ancestors` (domyślnie 'http://localhost:8000'). Sprawdź konsolę edytora pod kątem błędów.
+- Edytor wizualny używa iframe do wyświetlania Twojej strony internetowej. Upewnij się, że Polityka Bezpieczeństwa Treści (CSP) Twojej strony pozwala na adres URL CMS jako `frame-ancestors` (domyślnie `http://localhost:8000`). Sprawdź konsolę edytora pod kątem błędów.
+
+## Często Zadawane Pytania
+
+<FAQ>
+
+<Question title="Jaka jest różnica między edytorem wizualnym a CMS?">
+
+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).
+
+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:
+
+- **[Rozszerzenie VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/vs_code_extension.md)**: przejście od klucza `useIntlayer` do pliku treści, który go deklaruje, wyodrębnianie treści z komponentu oraz uruchamianie build, fill, test, push i pull z palety poleceń lub dedykowanej karty Intlayer.
+- **[Serwer LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/lsp.md)**: taka sama świadomość w dowolnym edytorze obsługującym LSP, z funkcjami przejdź do definicji (go to definition), znajdź wszystkie referencje, podglądem przetłumaczonej wartości po najechaniu kursorem, autouzupełnianiem kluczy i pól oraz ostrzeżeniem, gdy klucz nie jest nigdzie zadeklarowany. Rozpoznaje również wywołania `i18next`, `react-i18next`, `next-intl` i `use-intl`, co ułatwia migrację.
+- **[Serwer MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/mcp_server.md)**: udostępnia dokumentację i CLI Intlayer dla Cursor, VS Code, Claude Desktop, Claude Code i ChatGPT, dzięki czemu asystent odpowiada na podstawie aktualnej dokumentacji zamiast zgadywać i może samodzielnie wykonywać polecenia, takie jak `intlayer fill`.
+- **[Umiejętności agenta (Agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**: wyspecjalizowane umiejętności, takie jak `intlayer-config`, `intlayer-cli` i `intlayer-content`, oraz po jednej dla każdego frameworka, które uczą agenta konfiguracji routingu i typów węzłów treści.
+- **[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.
+
+</Question>
+
+</FAQ>