@intlayer/docs 8.11.2 → 8.12.0-canary.0

package/docs/pl/introduction.md

@@ -2,10 +2,10 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: Wprowadzenie
-description: Odkryj, jak działa Intlayer. Zobacz kroki używane przez Intlayer w Twojej aplikacji. Dowiedz się, co robią różne pakiety.
+description: Dowiedz się, jak działa Intlayer. Zobacz kroki, których używa Intlayer w Twojej aplikacji. Sprawdź, co robią poszczególne pakiety.
 keywords:
   - Wprowadzenie
-  - Pierwsze kroki
+  - Jak zacząć
   - Intlayer
   - Aplikacja
   - Pakiety
@@ -15,20 +15,20 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: "Inicjalizacja historii"
+    changes: "Init history"
 ---
 
 # Dokumentacja Intlayer
 
-Witamy w oficjalnej dokumentacji Intlayer! Znajdziesz tutaj wszystko, czego potrzebujesz, aby zintegrować, skonfigurować i opanować Intlayer dla wszystkich Twoich potrzeb związanych z internacjonalizacją (i18n), niezależnie od tego, czy pracujesz z Next.js, React, Vite, Express czy innym środowiskiem JavaScript.
+Witamy w oficjalnej dokumentacji Intlayer! Tutaj znajdziesz wszystko, czego potrzebujesz, aby zintegrować, skonfigurować i opanować Intlayer dla wszystkich Twoich potrzeb związanych z internacjonalizacją (i18n), niezależnie od tego, czy pracujesz z Next.js, React, Vite, Express, czy w innym środowisku JavaScript.
 
 ## Wprowadzenie
 
 ### Czym jest Intlayer?
 
-**Intlayer** to biblioteka do internacjonalizacji zaprojektowana specjalnie dla programistów JavaScript. Pozwala na deklarowanie Twoich treści w dowolnym miejscu w kodzie. Przekształca deklaracje wielojęzycznych treści w ustrukturyzowane słowniki, które można łatwo zintegrować w Twoim kodzie. Korzystając z TypeScript, **Intlayer** sprawia, że Twój rozwój jest silniejszy i bardziej efektywny.
+**Intlayer** to biblioteka internacjonalizacji zaprojektowana specjalnie dla programistów JavaScript. Pozwala ona na deklarowanie treści w dowolnym miejscu Twojego kodu. Przekształca deklaracje wielojęzycznych treści w ustrukturyzowane słowniki w celu ich łatwej integracji z Twoim kodem. Wykorzystując TypeScript, **Intlayer** sprawia, że Twoje tworzenie oprogramowania jest solidniejsze i bardziej wydajne.
 
-Intlayer oferuje również opcjonalny edytor wizualny, który pozwala łatwo edytować i zarządzać Twoimi treściami. Ten edytor jest szczególnie przydatny dla programistów, którzy wolą wizualny interfejs do zarządzania treścią, lub dla zespołów generujących treści bez konieczności martwienia się o kod.
+Intlayer udostępnia również opcjonalny edytor wizualny, który pozwala w prosty sposób edytować i zarządzać treścią. Ten edytor jest szczególnie przydatny dla programistów, którzy preferują wizualny interfejs do zarządzania treścią, lub dla zespołów generujących treści bez konieczności przejmowania się kodem.
 
 ### Przykład użycia
 
@@ -50,11 +50,12 @@ const componentContent = {
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      pl: "Witaj świecie",
     }),
   },
-} satisfies Dictionary; // spełnia typ Dictionary (słownik)
+} satisfies Dictionary;
 
-export default componentContent; // eksportuje zawartość komponentu
+export default componentContent;
 ```
 
 ```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
@@ -67,7 +68,8 @@ export default componentContent; // eksportuje zawartość komponentu
       "translation": {
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "pl": "Witaj świecie"
       }
     }
   }
@@ -85,51 +87,94 @@ export const MyComponent: FC = () => {
 };
 ```
 
+### Dlaczego Intlayer, a nie alternatywy?
+
+W porównaniu do wiodących rozwiązań takich jak `next-intl` lub `i18next`, Intlayer to rozwiązanie, które ma zintegrowane optymalizacje, takie jak:
+
+<AccordionGroup>
+
+<Accordion header="Rozmiar paczki (Bundle size)">
+
+Zamiast pobierać ogromne pliki JSON do Twoich stron, ładuj tylko niezbędną treść. Intlayer pomaga **zmniejszyć rozmiary Twojego kodu wynikowego oraz stron nawet o 50%**.
+
+</Accordion>
+
+<Accordion header="Łatwość w utrzymaniu (Maintainability)">
+
+Ograniczanie zasięgu (scoping) treści Twojej aplikacji **ułatwia utrzymanie** dużych projektów. Możesz skopiować lub usunąć folder pojedynczej funkcjonalności bez obciążania umysłu koniecznością przeglądania całej bazy kodu treści. Ponadto, Intlayer jest **w pełni zadeklarowany statycznie (fully typed)**, co gwarantuje poprawność Twojej treści.
+
+</Accordion>
+
+<Accordion header="Agent AI">
+
+Wspólne umiejscowienie (co-locating) kodu i treści **zmniejsza kontekst wymagany** przez duże modele językowe (LLM). Intlayer jest również dostarczany z pakietem narzędzi, takim jak **CLI** służącym do testowania pod kątem 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 **[umiejętności agentów (agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**, dzięki czemu środowisko programistyczne (DX) dla agentów AI staje się znacznie wygodniejsze.
+
+</Accordion>
+
+<Accordion header="Automatyzacja">
+
+Skorzystaj z automatyzacji, by tłumaczyć w Twoim potoku CI/CD, używając wybranego modelu LLM zgodnie z kosztem Twojego dostawcy AI. Intlayer oferuje również **kompilator**, aby automatyzować wyciąganie treści, a także [platformę webową](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md), by pomóc **tłumaczyć w tle**.
+
+</Accordion>
+
+<Accordion header="Wydajność (Performance)">
+
+Podłączanie ogromnych plików JSON do komponentów może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje proces ładowania Twojej treści w fazie budowania (build time).
+
+</Accordion>
+
+<Accordion header="Skalowanie bez angażowania programistów (Scaling with non-dev)">
+
+Więcej niż rozwiązanie i18n — Intlayer dostarcza **samodzielnie hostowany [edytor wizualny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md)** oraz **[w pełni wyposażony system CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)**, który pomaga zarządzać Twoimi wielojęzycznymi treściami **w czasie rzeczywistym**, umożliwiając bezproblemową współpracę między tłumaczami, twórcami treści i pozostałymi członkami zespołu. Treść można przechowywać lokalnie i/lub zdalnie.
+
+</Accordion>
+</AccordionGroup>
+
 ## Główne funkcje
 
 Intlayer oferuje szereg funkcji dostosowanych do potrzeb nowoczesnego tworzenia stron internetowych. Poniżej znajdują się kluczowe funkcje wraz z linkami do szczegółowej dokumentacji dla każdej z nich:
 
 - **Wsparcie dla internacjonalizacji**: Zwiększ globalny zasięg swojej aplikacji dzięki wbudowanemu wsparciu dla internacjonalizacji.
-- **Edytor wizualny**: Ulepsz swój proces tworzenia dzięki wtyczkom do edytorów zaprojektowanym dla Intlayer. Sprawdź [Przewodnik po edytorze wizualnym](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md).
-- **Elastyczność konfiguracji**: Dostosuj swoje środowisko za pomocą rozbudowanych opcji konfiguracyjnych opisanych w [Przewodniku po konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
-- **Zaawansowane narzędzia CLI**: Zarządzaj swoimi projektami efektywnie, korzystając z interfejsu wiersza poleceń Intlayer. Poznaj możliwości w [Dokumentacji narzędzi CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/index.md).
+- **Edytor Wizualny**: Usprawnij swój przepływ pracy za pomocą wtyczek edytora zaprojektowanych dla Intlayer. Sprawdź [Przewodnik po Edytorze Wizualnym](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md).
+- **Elastyczność Konfiguracji**: Dostosuj swoją konfigurację za pomocą rozbudowanych opcji konfiguracyjnych, wyszczególnonych w [Przewodniku po konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
+- **Zaawansowane Narzędzia CLI**: Zarządzaj efektywnie swoimi projektami przy użyciu interfejsu wiersza poleceń Intlayer. Odkryj możliwości w [Dokumentacji Narzędzi CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/index.md).
 
-## Podstawowe koncepcje
+## Kluczowe Koncepcje
 
-### Słownik
+### Słownik (Dictionary)
 
-Organizuj swoje wielojęzyczne treści blisko kodu, aby wszystko było spójne i łatwe w utrzymaniu.
+Organizuj swoje wielojęzyczne treści w pobliżu kodu, aby zachować spójność i łatwość w utrzymaniu.
 
-- **[Pierwsze kroki](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md)**  
+- **[Rozpocznij](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/content_file.md)**  
   Poznaj podstawy deklarowania treści w Intlayer.
 
-- **[Tłumaczenie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/translation.md)**  
+- **[Tłumaczenie (Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/translation.md)**  
   Zrozum, jak tłumaczenia są generowane, przechowywane i wykorzystywane w Twojej aplikacji.
 
-- **[Enumeracja](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/enumeration.md)**  
-  Łatwo zarządzaj powtarzającymi się lub stałymi zestawami danych w różnych językach.
+- **[Wyliczenie (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/enumeration.md)**  
+  Łatwo zarządzaj powtarzalnymi lub stałymi zestawami danych w różnych językach.
 
-- **[Warunek](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/condition.md)**  
-  Naucz się, jak używać logiki warunkowej w Intlayer, aby tworzyć dynamiczne treści.
+- **[Warunek (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/condition.md)**  
+  Dowiedz się, jak stosować logikę warunkową w Intlayer, aby tworzyć dynamiczne treści.
 
-- **[Wstawianie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/insertion.md)**  
-  Odkryj, jak wstawiać wartości do ciągu znaków za pomocą symboli zastępczych wstawiania.
+- **[Wstawianie (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/insertion.md)**  
+  Odkryj, jak wstawiać wartości w łańcuch znaków przy użyciu znaczników (placeholders).
 
-- **[Pobieranie funkcji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/function_fetching.md)**  
-  Zobacz, jak dynamicznie pobierać zawartość za pomocą niestandardowej logiki, aby dopasować ją do przepływu pracy Twojego projektu.
+- **[Pobieranie przez Funkcje (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/function_fetching.md)**  
+  Zobacz, jak dynamicznie pobierać treść za pomocą niestandardowej logiki, aby dopasować ją do przepływu pracy Twojego projektu.
 
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/markdown.md)**  
-  Naucz się, jak używać Markdown w Intlayer do tworzenia bogatej zawartości.
+  Dowiedz się, jak używać Markdown w Intlayer, aby tworzyć wzbogacone teksty.
 
-- **[Osadzanie plików](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file.md)**  
-  Odkryj, jak osadzać zewnętrzne pliki w Intlayer, aby używać ich w edytorze treści.
+- **[Osadzanie Plików (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file.md)**  
+  Odkryj, jak osadzać zewnętrzne pliki w Intlayer, aby korzystać z nich w edytorze treści.
 
-- **[Zagnieżdżanie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/nesting.md)**  
-  Zrozum, jak zagnieżdżać zawartość w Intlayer, aby tworzyć złożone struktury.
+- **[Zagnieżdżanie (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/nesting.md)**  
+  Zrozum, jak zagnieżdżać treści w Intlayer, aby budować złożone struktury.
 
-### Środowiska i integracje
+### Środowiska i Integracje
 
-Intlayer został zaprojektowany z myślą o elastyczności, oferując bezproblemową integrację z popularnymi frameworkami i narzędziami do budowania:
+Zbudowaliśmy Intlayer z myślą o elastyczności, oferując płynną integrację w obrębie popularnych frameworków i narzędzi do budowania:
 
 - **[Intlayer z Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nextjs_16.md)**
 - **[Intlayer z Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nextjs_15.md)**
@@ -144,20 +189,17 @@ Intlayer został zaprojektowany z myślą o elastyczności, oferując bezproblem
 - **[Intlayer z Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_vite+preact.md)**
 - **[Intlayer z Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_vite+vue.md)**
 - **[Intlayer z Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nuxt.md)**
+- **[Intlayer z Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_vite+svelte.md)**
+- **[Intlayer z SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_svelte_kit.md)**
 - **[Intlayer z Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_express.md)**
 - **[Intlayer z NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_nestjs.md)**
-- **[Intlayer z Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_angular.md)**
-
-Każdy przewodnik integracyjny zawiera najlepsze praktyki korzystania z funkcji Intlayer, takich jak **renderowanie po stronie serwera**, **dynamiczne routowanie** czy **renderowanie po stronie klienta**, dzięki czemu możesz utrzymać szybką, przyjazną dla SEO i wysoce skalowalną aplikację.
-
-## Współtworzenie i opinie
-
-Cenimy siłę open-source i rozwój oparty na społeczności. Jeśli chcesz zaproponować ulepszenia, dodać nowy przewodnik lub poprawić jakiekolwiek problemy w naszej dokumentacji, śmiało zgłoś Pull Request lub otwórz issue w naszym [repozytorium GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+- **[Intlayer z Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_hono.md)**
+- **[Intlayer z Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_with_angular_21.md)**
 
-Każdy przewodnik integracji zawiera najlepsze praktyki dotyczące korzystania z funkcji Intlayer, takich jak **renderowanie po stronie serwera**, **dynamiczne routowanie** czy **renderowanie po stronie klienta**, dzięki czemu możesz utrzymać szybką, przyjazną dla SEO i wysoce skalowalną aplikację.
+Każdy przewodnik integracyjny zawiera najlepsze praktyki korzystania z funkcji Intlayer, takich jak **renderowanie po stronie serwera (SSR)**, **dynamiczne routowanie**, czy **renderowanie po stronie klienta**, dzięki czemu możesz utrzymać szybką, przyjazną dla SEO i wysoce skalowalną aplikację.
 
-## Współtworzenie i opinie
+## Wnoszenie Wkładu i Opinie
 
-Cenimy siłę open-source i rozwój oparty na społeczności. Jeśli chcesz zaproponować ulepszenia, dodać nowy przewodnik lub poprawić jakiekolwiek błędy w naszej dokumentacji, śmiało zgłoś Pull Request lub otwórz issue w naszym [repozytorium GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+Cenimy siłę open-source i tworzenia oprogramowania opartego o społeczność. Jeśli chciałbyś zaproponować usprawnienia, dodać nowy poradnik lub poprawić błędy w naszych dokumentach, śmiało wyślij Pull Request lub otwórz Issue w naszym [repozytorium GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
 
-**Gotowy, aby tłumaczyć swoją aplikację szybciej i efektywniej?** Zanurz się w naszej dokumentacji i zacznij korzystać z Intlayer już dziś. Doświadcz solidnego, usprawnionego podejścia do internacjonalizacji, które pozwala utrzymać porządek w treściach i zwiększa produktywność Twojego zespołu.
+**Gotowy, aby tłumaczyć swoją aplikację szybciej i wydajniej?** Zanurz się w naszej dokumentacji, aby rozpocząć korzystanie z Intlayer już dziś. Doświadcz solidnego, zoptymalizowanego podejścia do internacjonalizacji, które sprawi, że Twoje treści będą uporządkowane, a Twój zespół bardziej produktywny.

package/docs/pl/lsp.md

@@ -0,0 +1,351 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2026-05-31
+title: Serwer Intlayer LSP
+description: Dowiedz się, jak serwer językowy Intlayer zapewnia funkcję "Przejdź do definicji" i inne funkcje IDE dla useIntlayer, getIntlayer oraz powiązanych wywołań we wszystkich obsługiwanych edytorach.
+keywords:
+  - LSP
+  - Serwer Językowy
+  - Przejdź do definicji
+  - IDE
+  - Intlayer
+  - VS Code
+  - Neovim
+  - TypeScript
+slugs:
+  - doc
+  - lsp
+history:
+  - version: 8.12.0
+    date: 2026-06-01
+    changes: "Release LSP"
+---
+
+# Serwer Intlayer LSP
+
+**Serwer Językowy Intlayer (LSP)** to implementacja protokołu [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/), która wzbogaca Twoje IDE o inteligencję rozumiejącą strukturę Intlayer. Obecnie zapewnia funkcję **Przejdź do definicji (Go to Definition)** dla wywołań kluczy słownika, umożliwiając bezpośrednie przejście od `useIntlayer("my-key")` w komponencie do pliku `.content.ts`, który go deklaruje.
+
+---
+
+## Dlaczego warto używać LSP?
+
+Gdy używasz Intlayer, połączenie między wywołaniem takim jak `useIntlayer("homepage")` a jego deklaracją w `src/homepage.content.ts` jest niejawne. Bez odpowiednich narzędzi musisz szukać tego pliku ręcznie. LSP sprawia, że to powiązanie staje się jawne:
+
+**Świadomość agentów AI**
+
+Agenci kodujący AI (Cursor, Windsurf, GitHub Copilot, Claude Code, Codex) polegają na serwerze językowym w celu rozpoznawania symboli i rozumienia relacji między plikami. Dzięki uruchomionemu Intlayer LSP agenci mogą śledzić wywołanie `useIntlayer("key")` z powrotem do jego deklaracji, co daje im dokładny kontekst dotyczący dostępnych kluczy treści, struktury każdego słownika oraz plików do odczytu lub edycji.
+
+**Przejdź do definicji**
+
+Umieść kursor na dowolnym ciągu klucza słownika wewnątrz obsługiwanego wywołania pobierającego i naciśnij `F12` (lub `Cmd/Ctrl+Kliknięcie`). Edytor otworzy plik deklaracji treści i ustawi kursor w linii `key:`.
+
+**Obsługa scalonych słowników**
+
+Klucz może być podzielony na wiele plików treści (Intlayer scala je). Serwer zwraca jedną lokalizację (`Location`) na plik źródłowy, dzięki czemu możesz przejść do każdej deklaracji.
+
+**Działa wszędzie**
+
+Obsługuje wszystkie pakiety `*-intlayer` (`next-intlayer`, `react-intlayer`, `vue-intlayer`, `svelte-intlayer`, `solid-intlayer`, `preact-intlayer`, `angular-intlayer`, `lit-intlayer`, `express-intlayer`, `hono-intlayer`, `fastify-intlayer`, `adonis-intlayer`, `intlayer`).
+
+### Obsługiwane wywołania pobierające
+
+Serwer wykrywa następujące wywołania funkcji i wyodrębnia pierwszy argument jako klucz słownika:
+
+| Funkcja       | Przykład                      |
+| ------------- | ----------------------------- |
+| `useIntlayer` | `useIntlayer("hero")`         |
+| `getIntlayer` | `getIntlayer("hero", locale)` |
+
+Typy generyczne TypeScript oraz dodatkowe argumenty są ignorowane — liczy się tylko klucz słownika.
+
+> Funkcje `useDictionary` i `getDictionary` przyjmują jako pierwszy argument już zaimportowany obiekt `Dictionary`, a nie klucz tekstowy, dlatego nie korzystają z funkcji Przejdź do definicji i nie są śledzone przez serwer.
+
+---
+
+## Instalacja
+
+Serwer LSP jest dystrybuowany jako część pakietu `@intlayer/lsp`:
+
+```bash packageManager="npm"
+npm install --save-dev @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn add --dev @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev @intlayer/lsp
+```
+
+```bash packageManager="bun"
+bun add --dev @intlayer/lsp
+```
+
+Pakiet udostępnia plik wykonywalny `intlayer-lsp`, którego edytory używają jako serwera.
+
+---
+
+## Konfiguracja jako plugin Claude Code
+
+Serwer Intlayer LSP jest dostępny jako **plugin Claude Code** hostowany bezpośrednio w repozytorium GitHub Intlayer. Jego instalacja daje Claude Code natywną świadomość funkcji Przejdź do definicji dla wszystkich wywołań `useIntlayer` / `getIntlayer`.
+
+### 1. Zainstaluj plik wykonywalny serwera językowego
+
+```bash packageManager="npm"
+npm install -g @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn global add @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add -g @intlayer/lsp
+```
+
+To polecenie umieści plik binarny `intlayer-lsp` w Twojej ścieżce PATH, co jest wywoływane przez wpis `lspServers` w pluginie.
+
+### 2. Zarejestruj rynek Intlayer i zainstaluj plugin
+
+```bash
+claude plugin marketplace add intlayer@github:aymericzip/intlayer
+claude plugin install intlayer-lsp@intlayer
+claude plugin enable intlayer-lsp@intlayer
+```
+
+Claude Code doda `"intlayer-lsp@intlayer": true` do Twoich `enabledPlugins` i automatycznie uruchomi serwer językowy dla obsługiwanych typów plików (`.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`).
+
+### 3. Włącz narzędzie LSP (jeśli nie jest jeszcze aktywne)
+
+Niektóre wersje Claude Code wymagają ustawienia flagi funkcji LSP. Dodaj poniższy wpis do pliku `~/.claude/settings.json`, jeśli funkcja Przejdź do definicji nie działa po instalacji:
+
+```json fileName="~/.claude/settings.json"
+{
+  "env": {
+    "ENABLE_LSP_TOOL": "1"
+  }
+}
+```
+
+Uruchom ponownie Claude Code — od teraz będzie on używał `goToDefinition`, `findReferences` oraz innych operacji LSP podczas nawigacji po kodzie Intlayer zamiast powracać do `grep`.
+
+---
+
+## Konfiguracja w VS Code (przez rozszerzenie — zalecane)
+
+Jeśli masz zainstalowane [rozszerzenie Intlayer dla VS Code](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension), serwer językowy uruchomi się automatycznie. Nie jest wymagana żadna dodatkowa konfiguracja.
+
+> Zobacz [dokumentację rozszerzenia VS Code](https://intlayer.org/doc/vs-code-extension) w celu uzyskania szczegółów instalacji i innych funkcji.
+
+---
+
+## Ręczna konfiguracja w VS Code
+
+Jeśli nie używasz rozszerzenia Intlayer, możesz połączyć serwer językowy ręcznie, korzystając z ogólnego rozszerzenia klienta LSP, takiego jak [**vscode-glspc**](https://marketplace.visualstudio.com/items?itemName=sibiraj-s.vscode-scss-formatter) lub pisząc własne małe rozszerzenie. Zalecanym podejściem jest użycie oficjalnego rozszerzenia Intlayer.
+
+Dla odniesienia, serwer uruchamia się za pomocą pliku binarnego `intlayer-lsp` przez stdio:
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+Rozszerzenie Intlayer odczytuje te ustawienia, aby uruchomić serwer. Jeśli polegasz wyłącznie na rozszerzeniu, konfiguracja ręczna nie jest potrzebna.
+
+---
+
+## Konfiguracja w Cursor
+
+[Cursor](https://www.cursor.com/) to fork VS Code z wbudowanymi funkcjami AI. Korzysta z tego samego ekosystemu rozszerzeń, więc **rozszerzenie Intlayer dla VS Code** działa bez żadnej dodatkowej konfiguracji — zainstaluj je raz, a Cursor wykryje je automatycznie.
+
+Jeśli wolisz ręczną konfigurację, Cursor odczytuje również plik `.vscode/settings.json` z katalogu głównego obszaru roboczego, więc powyższy fragment kodu dla VS Code ma zastosowanie bezpośrednio.
+
+---
+
+## Konfiguracja w Windsurf
+
+[Windsurf](https://windsurf.com/) (stworzony przez Codeium) to kolejny edytor oparty na VS Code. Zainstaluj rozszerzenie Intlayer z VS Code Marketplace, a serwer językowy aktywuje się automatycznie, dokładnie tak samo jak w VS Code i Cursor.
+
+W przypadku ręcznej konfiguracji utwórz plik `.vscode/settings.json` w katalogu głównym projektu:
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+---
+
+## Konfiguracja w Zed
+
+[Zed](https://zed.dev/) posiada natywną obsługę LSP poprzez swoje ustawienia językowe. Dodaj wpis do ustawień użytkownika Zed (`~/.config/zed/settings.json`):
+
+```json fileName="~/.config/zed/settings.json"
+{
+  "lsp": {
+    "intlayer-lsp": {
+      "binary": {
+        "path": "npx",
+        "arguments": ["--yes", "@intlayer/lsp"]
+      }
+    }
+  },
+  "languages": {
+    "TypeScript": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "TSX": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "JavaScript": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "Vue.js": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "Svelte": {
+      "language_servers": ["intlayer-lsp", "..."]
+    }
+  }
+}
+```
+
+Znak zastępczy `"..."` informuje edytor Zed, aby zachował domyślne serwery językowe obok serwera Intlayer.
+
+---
+
+## Konfiguracja dla AI Agent CLI (Claude Code, Codex itp.)
+
+**Claude Code** posiada pierwszorzędną obsługę pluginów LSP — postępuj zgodnie z instrukcjami w sekcji [Konfiguracja jako plugin Claude Code](#konfiguracja-jako-plugin-claude-code) powyżej, aby uzyskać pełną funkcjonalność Przejdź do definicji bezpośrednio w sesjach terminala.
+
+**OpenAI Codex** oraz inne narzędzia konsolowe nie działają jeszcze jako klienci LSP — odczytują i zapisują pliki bezpośrednio, zamiast utrzymywać trwałą sesję serwera językowego. Dla tych narzędzi wartość uruchomionego LSP pojawia się pośrednio: gdy serwer jest aktywny w towarzyszącym edytorze (VS Code, Cursor, Windsurf, ...), bieżący indeks edytora jest dostępny dla każdego agenta AI, który może odpytać go za pomocą dostarczonego przez edytor kontekstu (np. Cursor Composer, Windsurf Cascade, GitHub Copilot Chat).
+
+Jeśli pracujesz wyłącznie w terminalu bez otwartego edytora, możesz uruchomić serwer językowy w tle, aby był gotowy na podłączenie dowolnego edytora do tego samego obszaru roboczego w przyszłości:
+
+```bash
+# Utrzymuj serwer aktywny w tle
+npx @intlayer/lsp &
+```
+
+---
+
+## Ręczna konfiguracja w Neovim
+
+Używając [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig), zarejestruj niestandardową konfigurację serwera:
+
+```lua fileName="~/.config/nvim/init.lua"
+local lspconfig = require('lspconfig')
+local configs = require('lspconfig.configs')
+
+if not configs.intlayer_lsp then
+  configs.intlayer_lsp = {
+    default_config = {
+      -- Uruchom serwer za pomocą npx, aby uniknąć instalacji globalnej
+      cmd = { 'npx', '--yes', '@intlayer/lsp' },
+      filetypes = {
+        'typescript',
+        'typescriptreact',
+        'javascript',
+        'javascriptreact',
+        'vue',
+        'svelte',
+      },
+      root_dir = lspconfig.util.root_pattern(
+        'intlayer.config.ts',
+        'intlayer.config.js',
+        'package.json'
+      ),
+    },
+  }
+end
+
+lspconfig.intlayer_lsp.setup({})
+```
+
+Po ponownym uruchomieniu Neovim, naciśnięcie `gd` nad kluczem Intlayer wywoła funkcję Przejdź do definicji.
+
+---
+
+## Ręczna konfiguracja w innych edytorach
+
+Każdy edytor obsługujący protokół Language Server Protocol może korzystać z `@intlayer/lsp`. Specyfikacja serwera:
+
+- **Transport** – Node.js IPC / stdio (standard)
+- **Plik wykonywalny** – `npx @intlayer/lsp` (lub lokalnie zainstalowany plik binarny `intlayer-lsp`)
+- **Możliwości** – `definitionProvider: true`, `textDocumentSync: Incremental`
+
+Skonsultuj się z dokumentacją LSP swojego edytora, aby uzyskać dokładny format konfiguracji (np. `languageserver.json` dla [coc.nvim](https://github.com/neoclide/coc.nvim) lub ustawienia klienta LSP w [Helix](https://helix-editor.com)).
+
+### Przykład: coc.nvim
+
+```json fileName="~/.config/nvim/coc-settings.json"
+{
+  "languageserver": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["@intlayer/lsp"],
+      "filetypes": [
+        "typescript",
+        "typescriptreact",
+        "javascript",
+        "javascriptreact",
+        "vue",
+        "svelte"
+      ],
+      "rootPatterns": [
+        "intlayer.config.ts",
+        "intlayer.config.js",
+        "package.json"
+      ]
+    }
+  }
+}
+```
+
+### Przykład: Helix
+
+```toml fileName="~/.config/helix/languages.toml"
+[[language]]
+name = "typescript"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[[language]]
+name = "tsx"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[language-server.intlayer-lsp]
+command = "npx"
+args = ["@intlayer/lsp"]
+```
+
+---
+
+## Jak to działa
+
+Gdy serwer się uruchamia, odczytuje konfigurację Intlayer z głównego katalogu obszaru roboczego za pomocą `getConfiguration()`. Daje mu to ścieżki `build` i `system` niezbędne do znalezienia skompilowanych słowników.
+
+Przy każdym żądaniu **Przejdź do definicji**:
+
+1. Serwer odczytuje pełny tekst otwartego dokumentu.
+2. Skanuje w poszukiwaniu wywołań pobierających (`useIntlayer`, `getIntlayer` itp.) za pomocą wyrażenia regularnego.
+3. Sprawdza, czy pozycja kursora znajduje się wewnątrz jednego z tych wywołań.
+4. Jeśli tak, wyodrębnia klucz słownika (grupa przechwytująca 3 wyrażenia regularnego) i wywołuje `getUnmergedDictionaries()`, aby zlokalizować każdy plik treści, który deklaruje ten klucz.
+5. Odczytuje każdy pasujący plik i znajduje dokładną linię zawierającą `key: "<klucz>"`, aby precyzyjnie ustawić kursor.
+6. Zwraca tablicę obiektów `Location` — po jednym na plik źródłowy.
+
+Konfiguracja jest pobierana leniwie (lazy) i buforowana na sesję; resetuje się przy każdym żądaniu `initialize` (np. przy otwarciu nowego folderu obszaru roboczego).
+
+---
+
+## Rozwiązywanie problemów
+
+| Symptom                              | Prawdopodobna przyczyna            | Rozwiązanie                                                                                       |
+| ------------------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------------- |
+| Przejdź do definicji nic nie robi    | Serwer nie działa                  | Sprawdź, czy `@intlayer/lsp` jest zainstalowany i czy edytor go uruchamia                         |
+| Wykryto nieprawidłowy katalog główny | Wiele folderów w obszarze roboczym | Upewnij się, że folder zawierający `intlayer.config.ts` jest pierwszym folderem obszaru roboczego |
+| Nie znaleziono definicji dla klucza  | Konfiguracja nie została wczytana  | Sprawdź, czy `intlayer.config.ts` (lub `.js`) istnieje w katalogu głównym obszaru roboczego       |
+| Serwer ulega awarii przy starcie     | Wersja Node.js jest zbyt stara     | Wymaga Node.js ≥ 14.18                                                                            |

package/docs/pl/releases/v7.md

@@ -66,7 +66,7 @@ Nowy system cache’owania:
 
 - Przechowuje skompilowane deklaracje treści, aby uniknąć zbędnego przetwarzania
 - Wykrywa zmiany i przebudowuje tylko zmodyfikowane pliki
-- Znacząco skraca czas budowania dużych projektów
+- Znacząco skraca czas budowania (build time) dużych projektów
 
 ---
 

package/docs/pl/releases/v8.md

@@ -754,7 +754,7 @@ export default {
 
 ## Walidacja schematów treści
 
-W Intlayer v8 wprowadzono walidację schematów dla słowników. Teraz możesz definiować wielokrotnego użytku schematy walidacji w konfiguracji przy użyciu Zod i stosować je w plikach z zawartością. Dzięki temu Twoja zawartość zawsze będzie zgodna z oczekiwaną strukturą, a błędy zostaną wykryte podczas budowania.
+W Intlayer v8 wprowadzono walidację schematów dla słowników. Teraz możesz definiować wielokrotnego użytku schematy walidacji w konfiguracji przy użyciu Zod i stosować je w plikach z zawartością. Dzięki temu Twoja zawartość zawsze będzie zgodna z oczekiwaną strukturą, a błędy zostaną wykryte podczas budowania (build time).
 
 ### 1. Zdefiniuj schematy
 
@@ -1062,7 +1062,7 @@ Właściwość boolean `live` została oznaczona jako przestarzała na rzecz bar
 
 ### Tryby
 
-- **`static`** (Domyślny): Słownik jest dołączany podczas budowania. Najlepsze dla wydajności.
+- **`static`** (Domyślny): Słownik jest dołączany podczas budowania (build time). Najlepsze dla wydajności.
 - **`dynamic`**: Słownik jest ładowany w czasie wykonywania (np. przez pobranie JSON lub użycie Suspense).
 - **`fetch`**: Słownik jest pobierany z CMS/serwera w czasie wykonywania i synchronizowany.
 

package/docs/pt/agent_skills.md

@@ -72,7 +72,7 @@ npx skills add aymericzip/intlayer-skills
 
 **intlayer-astro**
 
-- Fornece ao agente os conhecimentos necessários para lidar com traduções do lado do servidor e padrões de roteamento localizados exclusivos do ecossistema Astro.
+- Fornece ao agente os conhecimentos necessários para lidar com traduções do lado do servidor e padrões de roteamento por localeizados exclusivos do ecossistema Astro.
 
 **intlayer-content**
 
@@ -80,7 +80,7 @@ npx skills add aymericzip/intlayer-skills
 
 **intlayer-next-js**
 
-- Dá ao agente a profundidade necessária para implementar i18n em componentes Server e Client de Next.js, assegurando a otimização SEO e um roteamento localizado suave.
+- Dá ao agente a profundidade necessária para implementar i18n em componentes Server e Client de Next.js, assegurando a otimização SEO e um roteamento por localeizado suave.
 
 **intlayer-react**
 

package/docs/pt/cli/build.md

@@ -57,7 +57,7 @@ pnpm intlayer build --watch
 bun x intlayer build --watch
 ```
 
-Este comando irá localizar seus arquivos de declaração de conteúdo por padrão em `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. E construir os dicionários no diretório `.intlayer`.
+Este comando irá localizar seus arquivos de declaração de conteúdo por padrão em `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml}`. E construir os dicionários no diretório `.intlayer`.
 
 ## Apelidos:
 

package/docs/pt/cli/index.md

@@ -100,7 +100,7 @@ bun add intlayer-cli -g
 
 O pacote `intlayer-cli` tem como objetivo transpilar as suas [declarações intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/dictionary/content_file.md) em dicionários.
 
-Este pacote transpilará todos os ficheiros intlayer, tais como `src/**/*.content.{ts|js|mjs|cjs|json}`. [Veja como declarar os seus ficheiros de declaração Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+Este pacote transpilará todos os ficheiros intlayer, tais como `src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml}`. [Veja como declarar os seus ficheiros de declaração Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
 Para interpretar os dicionários intlayer pode utilizar interpretadores, como o [react-intlayer](https://www.npmjs.com/package/react-intlayer), ou o [next-intlayer](https://www.npmjs.com/package/next-intlayer)