@intlayer/docs 9.3.3 → 9.4.0

package/docs/pl/intlayer_with_vite+vue.md

@@ -40,21 +40,31 @@ author: aymericzip
 
 W porównaniu do głównych rozwiązań, takich jak `vue-i18n` czy `i18next`, Intlayer jest rozwiązaniem wyposażonym w zintegrowane optymalizacje, takie jak:
 
+<AccordionGroup>
+
 **Pełne pokrycie Vue**
 
 Intlayer jest zoptymalizowany do doskonałej współpracy z Vue, oferując **zakres treści na poziomie komponentu**, **tłumaczenia reaktywne** i wszystkie funkcje potrzebne do skalowania internacjonalizacji (i18n).
 
 **Rozmiar bundle'a**
 
+<Accordion header="Rozmiar pakietu">
+
 Zamiast ładować ogromne pliki JSON na swoje strony, ładuj tylko niezbędną treść. Intlayer pomaga **zmniejszyć rozmiary bundle'a i stron nawet o 50%**.
 
+</Accordion>
+
 **Łatwość konserwacji**
 
 Określanie zakresu zawartości aplikacji **ułatwia konserwację** aplikacji na dużą skalę. Możesz powielić lub usunąć pojedynczy folder funkcji bez obciążania psychicznego koniecznością przeglądania całej bazy kodu zawartości. Dodatkowo Inlayer jest **w pełni napisany**, aby zapewnić dokładność treści.
 
 **Agent AI**
 
-Wspólna lokalizacja treści **zmniejsza potrzebny kontekst** dzięki modelom dużego języka (LLM). Intlayer zawiera także zestaw narzędzi, taki jak **CLI** do sprawdzania brakujących tłumaczeń**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** i **[umiejętności agenta](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**, aby praca programisty (DX) była jeszcze płynniejsza dla agentów AI.
+<Accordion header="AI Agent">
+
+Wspólna lokalizacja treści **zmniejsza potrzebny kontekst** dzięki modelom dużego języka (LLM). Intlayer zawiera także zestaw narzędzi, taki jak **CLI** do sprawdzania brakujących tłumaczeń**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** i **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/agent_skills.md)**, aby praca programisty (DX) była jeszcze płynniejsza dla agentów AI.
+
+</Accordion>
 
 **Automatyzacja**
 
@@ -62,12 +72,19 @@ Korzystaj z automatyzacji, aby tłumaczyć w swoim potoku CI/CD przy użyciu wyb
 
 **Wydajność**
 
+<Accordion header="Wydajność">
+
 Łączenie ogromnych plików JSON z komponentami może prowadzić do problemów z wydajnością i reaktywnością. Inlayer optymalizuje ładowanie treści w czasie kompilacji.
 
+</Accordion>
+
 **Skalowanie bez użycia dewelopera**
 
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia **samodzielny [edytor wizualny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** i **[pełny CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)**, który pomoże Ci zarządzać wielojęzyczną treścią w **w czasie rzeczywistym**, dzięki czemu współpraca z tłumaczami, copywriterami i innymi członkami zespołu będzie płynna. Treść może być przechowywana lokalnie i/lub zdalnie.
 
+</Accordion>
+</AccordionGroup>
+
 ---
 
 ## Przewodnik krok po kroku, jak skonfigurować Intlayer w aplikacji Vite i Vue
@@ -361,6 +378,8 @@ app.mount("#app");
 
 Uzyskaj dostęp do swoich słowników treści w całej aplikacji, tworząc główny komponent Vue i używając kompozycji `useIntlayer`:
 
+Uzyskaj dostęp do swoich słowników zawartości w całej aplikacji, tworząc główny komponent Vue i używając composables `useIntlayer`:
+
 ```vue fileName="src/HelloWord.vue"
 <script setup lang="ts">
 import { ref } from "vue";
@@ -412,6 +431,8 @@ const countRef = ref(0);
 </template>
 ```
 
+> Jeśli Twoja aplikacja już istnieje, możesz użyć [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md), a także [polecenia extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md), aby przekształcić tysiące komponentów w sekundę.
+
 #### Dostęp do treści w Intlayer
 
 Intlayer oferuje różne API do dostępu do Twojej treści:
@@ -430,8 +451,6 @@ Intlayer oferuje różne API do dostępu do Twojej treści:
   - Użyj `const content = useIntlayer("myContent");` oraz `{{ content.myContent }}` / `<content.myContent />`.
   - Lub użyj `const { myContent } = useIntlayer(\"myContent\");` oraz `{{ myContent }}` / `<myContent/>`, aby destrukturyzować zawartość.
 
-> Jeśli Twoja aplikacja już istnieje, możesz użyć [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) w połączeniu z [poleceniem extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md), aby przekonwertować tysiące komponentów w jedną sekundę.
-
 </Step>
 
 <Step number={6} title="Zmień język swojej zawartości" isOptional={true}>
@@ -621,6 +640,8 @@ Równolegle możesz również użyć `intlayerProxy`, aby dodać routowanie po s
 
 > Zauważ, że aby używać `intlayerProxy` w produkcji, musisz przenieść pakiet `vite-intlayer` z `devDependencies` do `dependencies`.
 
+> Od wersji Intlayer v9, `intlayerProxy()` jest dołączony bezpośrednio do wtyczki `intlayer()` i domyślnie włączony przez opcję `routing.enableProxy` (`true` domyślnie). Rejestrowanie go osobno, jak pokazano poniżej, jest teraz opcjonalne — jest utrzymywane dla kompatybilności wstecznej i dla konfiguracji, które muszą kontrolować kolejność wtyczek. Ustaw `routing.enableProxy: false`, aby zrezygnować. Przeczytaj [notatki wydania v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
@@ -898,56 +919,6 @@ import RouterLink from "@components/RouterLink.vue";
 
 <Step number={11} title="Renderowanie Markdown" isOptional={true}>
 
-Intlayer obsługuje renderowanie zawartości Markdown bezpośrednio w Twojej aplikacji Vue. Domyślnie Markdown jest traktowany jako zwykły tekst. Aby przekształcić Markdown w bogaty HTML, możesz zintegrować [markdown-it](https://github.com/markdown-it/markdown-it), parser Markdown.
-
-Jest to szczególnie przydatne, gdy Twoje tłumaczenia zawierają sformatowaną zawartość, taką jak listy, linki czy wyróżnienia.
-
-Domyślnie Intlayer renderuje markdown jako ciąg znaków. Jednak Intlayer oferuje również sposób na renderowanie markdown do HTML za pomocą funkcji `installIntlayerMarkdown`.
-
-> Aby zobaczyć, jak deklarować zawartość markdown za pomocą pakietu `intlayer`, zobacz [dokumentację markdown](https://github.com/aymericzip/intlayer/tree/main/docs/pl/dictionary/markdown.md).
-
-```ts fileName="main.ts"
-import MarkdownIt from "markdown-it";
-import { createApp, h } from "vue";
-import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";
-
-const app = createApp(App);
-
-app.use(intlayer);
-
-const md = new MarkdownIt({
-  html: true, // zezwól na tagi HTML
-  linkify: true, // automatyczne linkowanie URL
-  typographer: true, // włącz inteligentne cudzysłowy, myślniki itp.
-});
-
-// Powiedz Intlayer, aby używał md.render() za każdym razem, gdy musi przekształcić markdown na HTML
-installIntlayerMarkdown(app, (markdown) => {
-  const html = md.render(markdown);
-  return h("div", { innerHTML: html });
-});
-```
-
-Po zarejestrowaniu możesz używać składni opartej na komponentach, aby bezpośrednio wyświetlać zawartość Markdown:
-
-```vue
-<template>
-  <div>
-    <myMarkdownContent />
-  </div>
-</template>
-
-<script setup lang="ts">
-import { useIntlayer } from "vue-intlayer";
-
-const { myMarkdownContent } = useIntlayer("my-component");
-</script>
-```
-
-</Step>
-
-<Step number={12} title="Wyodrębnij zawartość swoich komponentów" isOptional={true}>
-
 Jeśli masz istniejącą bazę kodu, transformacja tysięcy plików może być czasochłonna.
 
 Aby ułatwić ten proces, Intlayer proponuje [kompilator](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/compiler.md) / [ekstraktor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/extract.md), aby przetransformować komponenty i wyodrębnić zawartość.

package/docs/pl/introduction.md

@@ -108,7 +108,7 @@ Ograniczanie zasięgu (scoping) treści Twojej aplikacji **ułatwia utrzymanie**
 
 <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.
+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 **[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>
 

package/docs/pl/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-03-03
+updatedAt: 2026-08-21
 title: Dokumentacja Serwera MCP
 description: Poznaj funkcje i konfigurację Serwera MCP, aby zoptymalizować zarządzanie i działanie serwera.
 keywords:
@@ -15,6 +15,9 @@ slugs:
   - doc
   - mcp-server
 history:
+  - version: 9.3.3
+    date: 2026-08-21
+    changes: "Group the platform setup sections into tabs"
   - version: 5.5.12
     date: 2025-07-11
     changes: "Dodano konfigurację ChatGPT"
@@ -113,13 +116,18 @@ To polecenie:
 
 ---
 
-## Konfiguracja w Cursor
+## Konfiguracja ręczna
+
+<Tabs defaultTab="cursor">
+  <Tab label="Cursor" value="cursor">
+
+### Konfiguracja w Cursor
 
 Postępuj zgodnie z [oficjalną dokumentacją](https://docs.cursor.com/context/mcp), aby skonfigurować serwer MCP w Cursor.
 
 W katalogu głównym projektu dodaj następujący plik konfiguracyjny `.cursor/mcp.json`:
 
-### Lokalny serwer (stdio) (zalecany)
+#### Lokalny serwer (stdio) (zalecany)
 
 ```json fileName=".cursor/mcp.json"
 {
@@ -132,7 +140,7 @@ W katalogu głównym projektu dodaj następujący plik konfiguracyjny `.cursor/m
 }
 ```
 
-### Serwer zdalny (Streamable HTTP)
+#### Serwer zdalny (Streamable HTTP)
 
 Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (Streamable HTTP), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
 
@@ -149,15 +157,16 @@ Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Eve
 
 To polecenie informuje Twoje IDE, aby uruchomiło serwer Intlayer MCP za pomocą `npx`, zapewniając, że zawsze używana jest najnowsza dostępna wersja, chyba że ją przypniesz.
 
----
+  </Tab>
+  <Tab label="VS Code" value="vscode">
 
-## Konfiguracja w VS Code
+### Konfiguracja w VS Code
 
 Postępuj zgodnie z [oficjalną dokumentacją](https://code.visualstudio.com/docs/copilot/chat/mcp-servers), aby skonfigurować serwer MCP w VS Code.
 
 Aby korzystać z serwera Intlayer MCP w VS Code, musisz go skonfigurować w ustawieniach workspace lub użytkownika.
 
-### Lokalny serwer (stdio) (zalecane)
+#### Lokalny serwer (stdio) (zalecane)
 
 Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:
 
@@ -173,7 +182,7 @@ Utwórz plik `.vscode/mcp.json` w katalogu głównym projektu:
 }
 ```
 
-### Serwer zdalny (Streamable HTTP)
+#### Serwer zdalny (Streamable HTTP)
 
 Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Events (Streamable HTTP), możesz skonfigurować swojego klienta MCP do łączenia się z usługą hostowaną.
 
@@ -188,11 +197,12 @@ Aby połączyć się ze zdalnym serwerem Intlayer MCP za pomocą Server-Sent Eve
 }
 ```
 
----
+  </Tab>
+  <Tab label="ChatGPT" value="chatgpt">
 
-## Konfiguracja w ChatGPT
+### Konfiguracja w ChatGPT
 
-### Serwer zdalny (Streamable HTTP)
+#### Serwer zdalny (Streamable HTTP)
 
 Postępuj zgodnie z [oficjalną dokumentacją](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server), aby skonfigurować serwer MCP w ChatGPT.
 
@@ -209,9 +219,10 @@ Postępuj zgodnie z [oficjalną dokumentacją](https://platform.openai.com/docs/
 
 7. Kliknij `Save`
 
----
+  </Tab>
+  <Tab label="Claude Desktop" value="claude-desktop">
 
-## Konfiguracja w Claude Desktop
+### Konfiguracja w Claude Desktop
 
 Postępuj zgodnie z [oficjalną dokumentacją](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server), aby skonfigurować serwer MCP w Claude Desktop.
 
@@ -220,7 +231,7 @@ Postępuj zgodnie z [oficjalną dokumentacją](https://modelcontextprotocol.io/q
 - macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-### Lokalny serwer (stdio) (zalecane)
+#### Lokalny serwer (stdio) (zalecane)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -233,7 +244,7 @@ Postępuj zgodnie z [oficjalną dokumentacją](https://modelcontextprotocol.io/q
 }
 ```
 
-### Serwer zdalny (Streamable HTTP)
+#### Serwer zdalny (Streamable HTTP)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -246,13 +257,14 @@ Postępuj zgodnie z [oficjalną dokumentacją](https://modelcontextprotocol.io/q
 }
 ```
 
----
+  </Tab>
+  <Tab label="Claude Code (CLI)" value="claude-code">
 
-## Konfiguracja w Claude Code (CLI)
+### Konfiguracja w Claude Code (CLI)
 
 Postępuj zgodnie z [oficjalną dokumentacją](https://modelcontextprotocol.io/quickstart/user), aby skonfigurować serwer MCP w Claude Code.
 
-### Lokalny serwer (stdio) (rekomendowany)
+#### Lokalny serwer (stdio) (rekomendowany)
 
 Aby połączyć serwer Intlayer MCP z Claude Code za pomocą stdio:
 
@@ -260,7 +272,7 @@ Aby połączyć serwer Intlayer MCP z Claude Code za pomocą stdio:
 claude mcp add intlayer npx -y @intlayer/mcp
 ```
 
-### Serwer zdalny (Streamable HTTP)
+#### Serwer zdalny (Streamable HTTP)
 
 Aby połączyć serwer Intlayer MCP z Claude Code przy użyciu Streamable HTTP (SSE):
 
@@ -268,6 +280,9 @@ Aby połączyć serwer Intlayer MCP z Claude Code przy użyciu Streamable HTTP (
 claude mcp add intlayer https://mcp.intlayer.org -t http
 ```
 
+  </Tab>
+</Tabs>
+
 ---
 
 ## Korzystanie z serwera MCP przez CLI
@@ -281,5 +296,3 @@ npm install -g @intlayer/mcp
 # Lub użycie bezpośrednio przez npx (zalecane)
 npx @intlayer/mcp
 ```
-
----

package/docs/pl/migration_from_i18next_to_intlayer.md

@@ -44,7 +44,7 @@ Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosyste
 
 <Accordion header="Agent AI">
 
-Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **umiejętności agenta**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
+Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
 
@@ -98,10 +98,109 @@ Następujące kroki są minimalne wymagane aby uruchomić istniejącą aplikacj
 
 Zainstaluj pakiety rdzenia Intlayer i adapter compat:
 
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer @intlayer/i18next @intlayer/sync-json-plugin
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer @intlayer/i18next @intlayer/sync-json-plugin
+```
+
+```bash packageManager="yarn"
+yarn add intlayer @intlayer/i18next @intlayer/sync-json-plugin
+```
+
+```bash packageManager="bun"
+bun add intlayer @intlayer/i18next @intlayer/sync-json-plugin
+```
+
+> Możesz zachować zainstalowany `i18next` — adapter kompatybilności używa go jako `devDependency` / `peerDependency` dla typów TypeScript.
+
+</Step>
+
+<Step number={2} title="Skonfiguruj Intlayer">
+
+Polecenie `intlayer init` tworzy starter `intlayer.config.ts`. Zaktualizuj go, aby odpowiadał Twoim istniejącym lokalizacjom i wskaż wtyczkę `syncJSON` na Twoje pliki komunikatów:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH,
+      // Dodaj tutaj wszystkie istniejące lokalizacje
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      // pasuje do składni placeholdera i18next: {{name}}
+      format: "i18next",
+      source: ({ locale }) => `./src/locales/${locale}.json`,
+      location: "src/locales",
+    }),
+  ],
+};
+
+export default config;
+```
+
+> **`source`** mapuje locale na ścieżkę pliku JSON. **`location`** informuje watcher Intlayera, który folder monitorować pod kątem zmian. Opcja `format: 'i18next'` zapewnia, że placeholdery takie jak `{{name}}` są poprawnie parsowane.
+
+</Step>
+
+<Step number={3} title="Zaktualizuj aliasy bundlera (opcjonalnie)">
+
+Jeśli używasz bundlera (Vite, Webpack, esbuild), możesz wstrzyknąć alias modułu, aby `import ... from 'i18next'` automatycznie rozpoznawał `@intlayer/i18next`. To eliminuje potrzebę ręcznej zmiany jakichkolwiek importów w Twoim codebase.
+
+**Dla Vite:**
+
+```typescript fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { defineConfig } from "vite";
+import i18nextVitePlugin from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+> `i18nextVitePlugin()` opakowuje plugin `intlayer()` z `vite-intlayer` i dodaje
+> alias `i18next` → `@intlayer/i18next` dla Ciebie. Użycie zwykłego pluginu `intlayer()`
+> z `vite-intlayer` kompiluje słowniki, ale **nie** dodaje tego aliasu — musisz wtedy
+> ręcznie zmienić nazwy importów na `@intlayer/i18next` (zobacz następny krok).
+
 </Step>
 
 </Steps>
 
+To jest szybka migracja. Twoja aplikacja teraz działa na Intlayer, zachowując wszystkie `i18next` importy i API w niezmienionej formie.
+
+---
+
 ## Pełna migracja
 
 Poniższe kroki są opcjonalne i można je wykonywać stopniowo. Odblokowują one pełny zestaw funkcji Intlayer: edytor wizualny, CMS, pliki zawartości z typami, automatyczne tłumaczenie oparte na AI i wiele więcej.

package/docs/pl/migration_from_next-i18next_to_intlayer.md

@@ -47,7 +47,7 @@ Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosyste
 
 <Accordion header="Agent AI">
 
-Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **umiejętności agenta**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
+Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
 

package/docs/pl/migration_from_next-intl_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosyste
 
 <Accordion header="Agent AI">
 
-Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **umiejętności agenta**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
+Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
 
@@ -312,8 +312,6 @@ export default config;
 
 ---
 
-Zainstaluj pakiety rdzenia Intlayer i adapter compat `@intlayer/next-intl`:
-
 ## Co można usunąć po migracji
 
 Po wdrożeniu `@intlayer/next-intl` można usunąć następujący boilerplate `next-intl`:

package/docs/pl/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosyste
 
 <Accordion header="Agent AI">
 
-Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **umiejętności agenta**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
+Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
 

package/docs/pl/migration_from_react-i18next_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosyste
 
 <Accordion header="Agent AI">
 
-Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **umiejętności agenta**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
+Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
 

package/docs/pl/migration_from_vue-i18n_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosyste
 
 <Accordion header="Agent AI">
 
-Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **umiejętności agenta**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
+Umieszczanie zawartości razem **zmniejsza kontekst potrzebny** przez Duże Modele Języka (LLM). Intlayer zawiera również pakiet narzędzi, takich jak **CLI** do testowania brakujących tłumaczeń, **LSP**, **MCP** i **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
 
@@ -99,10 +99,133 @@ Następujące kroki są minimalne wymagane aby uruchomić istniejącą aplikacj
 
 Zainstaluj pakiety rdzenia Intlayer i adapter compat:
 
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive
+```
+
+> flaga `--interactive` jest opcjonalna. Użyj `intlayer-cli init`, jeśli jesteś agentem AI.
+
+> To polecenie wykryje Twoje środowisko i zainstaluje wymagane pakiety. Na przykład:
+
+```bash packageManager="npm"
+npm install intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="yarn"
+yarn add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="bun"
+bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+> Możesz zachować `vue-i18n` zainstalowany — adapter kompatybilności używa go jako `devDependency` / `peerDependency` dla typów TypeScript.
+
+</Step>
+
+<Step number={2} title="Konfiguruj Intlayer">
+
+Polecenie `intlayer init` tworzy plik startowy `intlayer.config.ts`. Zaktualizuj go, aby pasował do twoich istniejących lokalizacji i wskaż wtyczkę `syncJSON` na twoje pliki wiadomości:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH,
+      // Dodaj wszystkie istniejące lokale tutaj
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      // pasuje do składni placeholdera vue-i18n: {name}
+      format: "icu",
+      source: ({ locale }) => `./src/locales/${locale}.json`,
+      location: "src/locales",
+    }),
+  ],
+};
+
+export default config;
+```
+
+> **`source`** mapuje ustawienie regionalne na ścieżkę pliku JSON. **`location`** informuje obserwatora Intlayer, które foldery monitorować w poszukiwaniu zmian. Opcja `format: 'icu'` zapewnia, że symbole zastępcze są analizowane poprawnie dla `vue-i18n`.
+
+</Step>
+
+<Step number={3} title="Dodaj wtyczkę Intlayer do swojego bundlera">
+
+Zawiń istniejącą konfigurację bundlera za pomocą wtyczki compat. Komponuje core'owy plugin Intlayer, podłącza obserwację zawartości i — co krytyczne — **wstrzykuje alias modułu** tak aby istniejące wywołania `import … from 'vue-i18n'` były transparentnie przekierowywane do `@intlayer/vue-i18n` w czasie budowania. Nie są wymagane żadne zmiany plików źródłowych.
+
+**Dla Vite:**
+
+```typescript fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import { vueI18nVitePlugin } from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+> `vueI18nVitePlugin()` otacza plugin `intlayer()` z `vite-intlayer` i dodaje alias `vue-i18n`. Używając zwykłego pluginu `intlayer()` z `vite-intlayer`, kompiluje słowniki, ale **nie** dodaje aliasu — wtedy musisz ręcznie zmienić nazwy importów na `@intlayer/vue-i18n` (patrz Krok 4).
+
+**Dla Nuxt:**
+
+Jeśli używasz `@nuxtjs/i18n` (integracja Nuxt), zainstaluj `nuxt-intlayer` i dodaj go do swojego `nuxt.config.ts`:
+
+```bash packageManager="npm"
+npm install nuxt-intlayer
+```
+
+```typescript fileName="nuxt.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+export default defineNuxtConfig({
+  modules: ["nuxt-intlayer"],
+  // Możesz bezpiecznie usunąć @nuxtjs/i18n ze swoich modułów
+});
+```
+
+> **Nie potrzebujesz już `createI18n()` ani ręcznego inicjowania providera.** Intlayer kompiluje wszystkie słowniki w **czasie buildowania**, więc nie ma kroku ładowania w runtime. Aliasowany provider obsługuje inicjalizację za Ciebie.
+
 </Step>
 
 </Steps>
 
+To koniec szybkiej migracji. Twoja aplikacja działa teraz na Intlayer, zachowując każdy import `vue-i18n` i API bez zmian.
+
+> **Wpisane klucze tłumaczeń — automatycznie.** Po skompilowaniu słowników przez Intlayer, `useI18n` jest typizowany względem rzeczywistej zawartości, gdy przekażesz opcję `namespace`. Klucze są autocompleted w twoim IDE, a nieprawidłowe ścieżki powodują błędy TypeScript w czasie budowania — nie jest wymagana żadna dodatkowa konfiguracja.
+>
+> ```ts
+> // 'about' to zarejestrowany klucz słownika
+> const { t } = useI18n({ namespace: "about" });
+> t("counter.label"); // ✓ autocompleted
+> t("does.not.exist"); // ✗ TypeScript error
+> ```
+
+---
+
 ## Pełna migracja
 
 Poniższe kroki są opcjonalne i mogą być wykonywane stopniowo. Odblokowują pełny zestaw funkcji Intlayer: edytor wizualny, CMS, pliki zawartości z typami, tłumaczenie wspierane przez AI i wiele więcej.