@intlayer/docs 9.4.4 → 9.5.0

package/docs/pl/migration_from_i18next_to_intlayer.md

@@ -32,7 +32,6 @@ author: aymericzip
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
 
 </Accordion>
-
 <Accordion header="Łatwość utrzymania">
 
 Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Możesz zduplikować lub usunąć jeden folder funkcji bez konieczności przeglądania całej bazy kodu zawartości. Ponadto Intlayer jest **w pełni wpisany** aby zapewnić dokładność zawartości.
@@ -40,25 +39,21 @@ Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Mo
 Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosystemie i18n — problemy są naprawiane szybko, nowe adaptery frameworku pojawiają się regularnie, a podstawowy API jest stale ulepsszany na podstawie opinii z produkcji.
 
 </Accordion>
-
 <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 **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
-
 <Accordion header="Automatyzacja">
 
 Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LLM za koszt dostawcy AI. Intlayer oferuje również **kompilator** do automatycznego wyodrębniania zawartości, a także **platforma internetowa** aby pomóc **tłumaczyć w tle**.
 
 </Accordion>
-
 <Accordion header="Wydajność">
 
 Łączenie dużych plików JSON z komponentami może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje ładowanie zawartości w czasie budowania.
 
 </Accordion>
-
 <Accordion header="Skalowanie wraz z non-dev">
 
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
@@ -66,8 +61,6 @@ Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany *
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Strategie migracji
 
 Istnieją dwie komplementarne strategie migracji z `i18next` do Intlayer:
@@ -78,20 +71,15 @@ Istnieją dwie komplementarne strategie migracji z `i18next` do Intlayer:
 
 Ten przewodnik obejmuje **Strategię 1** najpierw (adapter compat drop-in), a następnie przechodzi przez opcjonalną pełną migrację.
 
----
-
 ## Spis treści
 
 <TOC/>
 
----
-
 ## Szybka migracja
 
 Następujące kroki są minimalne wymagane aby uruchomić istniejącą aplikację `i18next` na Intlayer bez zmian kodu.
 
 <Steps>
-
 <Step number={1} title="Zainstaluj zależności">
 
 Zainstaluj pakiety rdzenia Intlayer i adapter compat:
@@ -135,7 +123,6 @@ 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:
@@ -170,7 +157,6 @@ 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.
@@ -197,14 +183,11 @@ export default defineConfig({
 
 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.
 
 <Steps>
-
 <Step number={4} title="Jawne zmiana nazwy importu (opcjonalnie)" isOptional={true}>
 
 Jeśli wolisz uczynić zależność jawną w swoich plikach źródłowych lub jeśli nie używasz wtyczki bundlera do aliasowania importów, możesz zmienić nazwy importów ręcznie:
@@ -218,7 +201,6 @@ Jeśli wolisz uczynić zależność jawną w swoich plikach źródłowych lub je
 Są to **drop-in replacements** — nie wymagane są żadne zmiany w sygnaturach funkcji, argumentach ani typach zwracanych.
 
 </Step>
-
 <Step number={5} title="Włącz automatyzację tłumaczenia opartą na AI" isOptional={true}>
 
 Gdy Intlayer jest już skonfigurowany, użyj jego CLI do automatycznego wypełnienia brakujących tłumaczeń:
@@ -280,8 +262,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Co możesz usunąć po migracji
 
 Po umieszczeniu adaptera kompatybilności można usunąć poniższe boilerplate'y `i18next`:
@@ -294,8 +274,6 @@ Po umieszczeniu adaptera kompatybilności można usunąć poniższe boilerplate'
 
 Gdy będziesz gotów do dalszych kroków, Intlayer **automatycznie odkrywa wszystkie pliki `.content.ts` i `.content.json` znajdujące się wszędzie w twojej bazie kodu** (domyślnie wszędzie wewnątrz `./src`). Możesz umieścić plik `my-component.content.ts` obok swojej logiki, a Intlayer podejmie go podczas kompilacji bez dodatkowej konfiguracji — bez importów, rejestracji ani scentralizowanego pliku indeksu. To sprawia, że współlokowanie tłumaczeń jest całkowicie bezproblemowe.
 
----
-
 ## Konfiguracja TypeScript
 
 Intlayer wykorzystuje module augmentation, aby zapewnić pełną intellisense TypeScript dla twoich kluczy tłumaczeń. Upewnij się, że twój plik `tsconfig.json` zawiera auto-generowane typy:
@@ -310,8 +288,6 @@ Intlayer wykorzystuje module augmentation, aby zapewnić pełną intellisense Ty
 }
 ```
 
----
-
 ## Konfiguracja Git
 
 Dodaj wygenerowany katalog Intlayer do `.gitignore`:
@@ -321,8 +297,6 @@ Dodaj wygenerowany katalog Intlayer do `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Idź dalej
 
 - **Visual Editor** — Zarządzaj tłumaczeniami wizualnie w przeglądarce: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md)

package/docs/pl/migration_from_next-i18next_to_intlayer.md

@@ -35,7 +35,6 @@ author: aymericzip
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
 
 </Accordion>
-
 <Accordion header="Łatwość utrzymania">
 
 Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Możesz zduplikować lub usunąć jeden folder funkcji bez konieczności przeglądania całej bazy kodu zawartości. Ponadto Intlayer jest **w pełni wpisany** aby zapewnić dokładność zawartości.
@@ -43,25 +42,21 @@ Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Mo
 Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosystemie i18n — problemy są naprawiane szybko, nowe adaptery frameworku pojawiają się regularnie, a podstawowy API jest stale ulepsszany na podstawie opinii z produkcji.
 
 </Accordion>
-
 <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 **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
-
 <Accordion header="Automatyzacja">
 
 Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LLM za koszt dostawcy AI. Intlayer oferuje również **kompilator** do automatycznego wyodrębniania zawartości, a także **platforma internetowa** aby pomóc **tłumaczyć w tle**.
 
 </Accordion>
-
 <Accordion header="Wydajność">
 
 Łączenie dużych plików JSON z komponentami może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje ładowanie zawartości w czasie budowania.
 
 </Accordion>
-
 <Accordion header="Skalowanie wraz z non-dev">
 
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
@@ -69,8 +64,6 @@ Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany *
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Strategie migracji
 
 Ponieważ `next-i18next` opakuje `react-i18next` i `i18next` za kulisami, istnieją dwie komplementarne strategie migracji do Intlayer:
@@ -81,20 +74,15 @@ Ponieważ `next-i18next` opakuje `react-i18next` i `i18next` za kulisami, istnie
 
 Ten przewodnik obejmuje **Strategię 1** najpierw (adapter compat drop-in), a następnie przechodzi przez opcjonalną pełną migrację.
 
----
-
 ## Spis treści
 
 <TOC/>
 
----
-
 ## Szybka migracja
 
 Poniższe kroki są minimalne wymagane, aby uruchomić istniejącą aplikację Next.js Pages Router w Intlayer bez zmian kodu w stronach i komponentach.
 
 <Steps>
-
 <Step number={1} title="Zainstaluj zależności">
 
 Zainstaluj pakiety rdzenia Intlayer i adaptery kompatybilności:
@@ -138,7 +126,6 @@ bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/r
 > Możesz bezpiecznie pozostawić `next-i18next`, `react-i18next` i `i18next` zainstalowane podczas migracji, chociaż usuniesz je po zastosowaniu aliasów.
 
 </Step>
-
 <Step number={2} title="Skonfiguruj Intlayer">
 
 Komenda `intlayer init` tworzy starter `intlayer.config.ts`. Zaktualizuj go, aby pasował do twoich istniejących lokalizacji i skieruj plugin `syncJSON` do twoich plików wiadomości `next-i18next` (zwykle wewnątrz `public/locales`):
@@ -173,7 +160,6 @@ export default config;
 > **`source`** mapuje lokalizację i namespace (`key`) do ścieżki pliku JSON. **`location`** mówi obserwatorowi Intlayer, który folder monitorować pod kątem zmian. Opcja `format: 'i18next'` zapewnia, że placeholdery są poprawnie parsowane dla `next-i18next`.
 
 </Step>
-
 <Step number={3} title="Zaktualizuj konfigurację Next.js">
 
 Opatrz istniejący `next.config.ts` (lub `.js`) funkcją `createNextI18nPlugin` z `@intlayer/next-i18next/plugin`. Ten wrapper komponuje `withIntlayer` **i** wstrzykuje aliasy `next-i18next` / `react-i18next` / `i18next` → `@intlayer/*`, dzięki czemu istniejące wywołania `import { useTranslation } from 'next-i18next'` są transparentnie przekierowane podczas budowania. Nie są wymagane żadne zmiany w plikach źródłowych.
@@ -217,14 +203,11 @@ To wszystko dla szybkiej migracji. Twoja aplikacja Next.js teraz działa na Intl
 > tAbout("counter.label"); // ✓ typizowane
 > ```
 
----
-
 ## Pełna migracja
 
 Poniższe kroki są opcjonalne i można je wykonywać przyrostowo. Odblokowują one pełny zestaw funkcji Intlayer: edytor wizualny, CMS, typed content files, tłumaczenie zasilane sztuczną inteligencją i wiele więcej.
 
 <Steps>
-
 <Step number={4} title="Explicit import renaming (opcjonalnie)" isOptional={true}>
 
 Plugin Intlayer już obsługuje aliasing na poziomie bundlera. Jeśli wolisz uczynić zależność jawną w swoich plikach źródłowych, możesz ręcznie zmienić nazwy importów:
@@ -239,7 +222,6 @@ Plugin Intlayer już obsługuje aliasing na poziomie bundlera. Jeśli wolisz ucz
 Są to **drop-in replacements** — nie są wymagane żadne zmiany w sygnaturach funkcji, argumentach ani zwracanych typach.
 
 </Step>
-
 <Step number={5} title="Enable AI-Powered Translation Automation" isOptional={true}>
 
 Po podłączeniu Intlayer, użyj jego CLI, aby automatycznie uzupełnić brakujące tłumaczenia:
@@ -301,8 +283,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Co możesz usunąć po migracji
 
 Po wdrożeniu adaptera kompatybilności, poniższy boilerplate `next-i18next` można usunąć:
@@ -315,8 +295,6 @@ Po wdrożeniu adaptera kompatybilności, poniższy boilerplate `next-i18next` mo
 
 Gdy będziesz gotowy, aby pójść dalej, Intlayer **automatycznie odkrywa wszystkie pliki `.content.ts` i `.content.json` gdziekolwiek w twoim codebase** (domyślnie, gdziekolwiek wewnątrz `./src`). Możesz umieścić plik `my-component.content.ts` tuż obok `MyComponent.tsx` a Intlayer go włączy podczas budowania bez żadnej dodatkowej konfiguracji — bez importów, rejestracji, bez scentralizowanego pliku indeksu. To sprawia, że umieszczanie tłumaczeń razem ze stronami i komponentami jest całkowicie bezproblemowe.
 
----
-
 ## Konfigurowanie TypeScript
 
 Intlayer uses module augmentation to provide full TypeScript intellisense for your translation keys. Make sure your `tsconfig.json` includes the auto-generated types:
@@ -331,8 +309,6 @@ Intlayer uses module augmentation to provide full TypeScript intellisense for yo
 }
 ```
 
----
-
 ## Konfiguracja Git
 
 Dodaj wygenerowany przez Intlayer katalog do pliku `.gitignore`:
@@ -342,8 +318,6 @@ Dodaj wygenerowany przez Intlayer katalog do pliku `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Idź dalej
 
 - **Visual Editor** — Zarządzaj tłumaczeniami wizualnie w przeglądarce: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md)

package/docs/pl/migration_from_next-intl_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
 
 </Accordion>
-
 <Accordion header="Łatwość utrzymania">
 
 Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Możesz zduplikować lub usunąć jeden folder funkcji bez konieczności przeglądania całej bazy kodu zawartości. Ponadto Intlayer jest **w pełni wpisany** aby zapewnić dokładność zawartości.
@@ -41,25 +40,21 @@ Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Mo
 Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosystemie i18n — problemy są naprawiane szybko, nowe adaptery frameworku pojawiają się regularnie, a podstawowy API jest stale ulepsszany na podstawie opinii z produkcji.
 
 </Accordion>
-
 <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 **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
-
 <Accordion header="Automatyzacja">
 
 Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LLM za koszt dostawcy AI. Intlayer oferuje również **kompilator** do automatycznego wyodrębniania zawartości, a także **platforma internetowa** aby pomóc **tłumaczyć w tle**.
 
 </Accordion>
-
 <Accordion header="Wydajność">
 
 Łączenie dużych plików JSON z komponentami może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje ładowanie zawartości w czasie budowania.
 
 </Accordion>
-
 <Accordion header="Skalowanie wraz z non-dev">
 
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
@@ -67,8 +62,6 @@ Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany *
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Strategia migracji
 
 Rekomendowane podejście dla istniejących aplikacji to **adapter compat**: zainstaluj `@intlayer/next-intl`, który ujawnia **dokładnie ten sam API** co `next-intl`, ale deleguje całą pracę tłumaczenia do Intlayer za kulisami.
@@ -77,20 +70,15 @@ Zachowujesz istniejące `useTranslations`, `getTranslations`, `NextIntlClientPro
 
 Z biegiem czasu możesz opcjonalnie migrować poszczególne pliki do bogatszego formatu `.content.ts` Intlayer aby odblokować edytor wizualny, CMS i ograniczanie zawartości per-komponent — ale ten krok jest całkowicie opcjonalny i może być wykonywany przyrostowo.
 
----
-
 ## Spis treści
 
 <TOC/>
 
----
-
 ## Szybka migracja
 
 Poniższe kroki stanowią minimum wymagane do uruchomienia istniejącej aplikacji `next-intl` na Intlayer bez zmian w kodzie.
 
 <Steps>
-
 <Step number={1} title="Instalacja zależności">
 
 Zainstaluj podstawowe pakiety Intlayer i adapter kompatybilności `@intlayer/next-intl`:
@@ -134,7 +122,6 @@ bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
 > Zachowaj `next-intl` zainstalowany — jest wciąż wymagany do **routingu URL** (`createNavigation`, `createMiddleware`, `Link`, `redirect`, `usePathname`, `useRouter`). Adapter kompatybilności **nie** zastępuje warstwy routingu.
 
 </Step>
-
 <Step number={2} title="Konfiguracja Intlayer">
 
 Polecenie `intlayer init` tworzy starter `intlayer.config.ts`. Zaktualizuj go, aby pasował do istniejących lokalizacji i wskaż plugin `syncJSON` na Twoje pliki wiadomości:
@@ -171,7 +158,6 @@ export default config;
 > Aby zobaczyć pełną listę opcji konfiguracji, zobacz [dokumentację konfiguracji](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md).
 
 </Step>
-
 <Step number={3} title="Dodaj plugin Intlayer do Next.js">
 
 Opakuj istniejącą konfigurację Next.js za pomocą `createNextIntlPlugin` z `@intlayer/next-intl/plugin`. To opakowanie komponuje `withIntlayer` **i** rejestruje aliasy `next-intl` → `@intlayer/next-intl` dla Ciebie:
@@ -212,14 +198,11 @@ To wszystko dla szybkiej migracji. Twoja aplikacja teraz działa na Intlayer, za
 > t("counter.label"); // ✓ typowane
 > ```
 
----
-
 ## Pełna migracja
 
 Poniższe kroki są opcjonalne i można je wykonywać stopniowo. Odblokowują pełny zestaw funkcji Intlayer: edytor wizualny, CMS, typizowane pliki zawartości, automatyczne tłumaczenie oparte na AI i wiele innych.
 
 <Steps>
-
 <Step number={4} title="Jawne zmianę nazwy importu (opcjonalnie)" isOptional={true}>
 
 Wrapper `createNextIntlPlugin()` już obsługuje aliasing `next-intl` → `@intlayer/next-intl` na poziomie bundlera. Jeśli wolisz uczynić zależność jawną w plikach źródłowych (i zamiast tego użyć zwykłego pluginu `withIntlayer`), możesz ręcznie zmienić nazwy importów:
@@ -246,7 +229,6 @@ Wrapper `createNextIntlPlugin()` już obsługuje aliasing `next-intl` → `@intl
 > Alternatywnie możesz użyć `defineRouting` z `@intlayer/next-intl/routing`, które automatycznie scala konfigurację lokalizacji z twojego `intlayer.config.ts`.
 
 </Step>
-
 <Step number={5} title="Włącz automatyzację tłumaczenia opartą na AI" isOptional={true}>
 
 Po podłączeniu Intlayer, możesz użyć jego CLI, aby automatycznie wypełnić brakujące tłumaczenia, korzystając z wybranego przez siebie LLM:
@@ -308,8 +290,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Co można usunąć po migracji
 
 Po wdrożeniu `@intlayer/next-intl` można usunąć następujący boilerplate `next-intl`:
@@ -322,8 +302,6 @@ Po wdrożeniu `@intlayer/next-intl` można usunąć następujący boilerplate `n
 
 Gdy będziesz gotowy, aby pójść dalej, Intlayer **automatycznie odkrywa wszystkie pliki `.content.ts` i `.content.json` gdziekolwiek w twoim codebase** (domyślnie gdziekolwiek wewnątrz `./src`). Możesz umieścić plik `about.content.ts` tuż obok `about/page.tsx` i Intlayer podciągnie go w czasie budowania bez żadnej dodatkowej konfiguracji — bez importów, bez rejestracji, bez scentralizowanego pliku indeksu. Sprawia to, że współlokalizowanie tłumaczeń ze stronami i komponentami jest całkowicie pozbawione tarcia.
 
----
-
 ## Konfiguracja TypeScript
 
 Intlayer używa module augmentation aby zapewnić pełny TypeScript intellisense dla Twoich kluczy tłumaczeń. Upewnij się, że Twój `tsconfig.json` zawiera auto-generowane typy:
@@ -338,8 +316,6 @@ Intlayer używa module augmentation aby zapewnić pełny TypeScript intellisense
 }
 ```
 
----
-
 ## Konfiguracja Git
 
 Dodaj wygenerowany katalog Intlayer do swoją `.gitignore`:
@@ -349,8 +325,6 @@ Dodaj wygenerowany katalog Intlayer do swoją `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Idź dalej
 
 - **Visual Editor** — Zarządzaj tłumaczeniami wizualnie w przeglądarce: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md)

package/docs/pl/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 Zamiast ładować ogromne pliki JSON do stron, ładuj tylko niezbędną zawartość. Intlayer pomaga **zmniejszyć bundle i rozmiary stron nawet o 50%**.
 
 </Accordion>
-
 <Accordion header="Łatwość utrzymania">
 
 Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Możesz zduplikować lub usunąć jeden folder funkcji bez konieczności przeglądania całej bazy kodu zawartości. Ponadto Intlayer jest **w pełni wpisany** aby zapewnić dokładność zawartości.
@@ -42,25 +41,21 @@ Ograniczanie zawartości aplikacji **ułatwia utrzymanie** dużych aplikacji. Mo
 Intlayer jest również rozwiązaniem z **najaktywniejszym rozwojem** w ekosystemie i18n — problemy są naprawiane szybko, nowe adaptery frameworku pojawiają się regularnie, a podstawowy API jest stale ulepsszany na podstawie opinii z produkcji.
 
 </Accordion>
-
 <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 **agent skills**, aby jeszcze bardziej gładka była doświadczenie dla programistów (DX) dla agentów AI.
 
 </Accordion>
-
 <Accordion header="Automatyzacja">
 
 Użyj automatyzacji do tłumaczenia w pipeline CI/CD korzystając z wybranego LLM za koszt dostawcy AI. Intlayer oferuje również **kompilator** do automatycznego wyodrębniania zawartości, a także **platforma internetowa** aby pomóc **tłumaczyć w tle**.
 
 </Accordion>
-
 <Accordion header="Wydajność">
 
 Łączenie dużych plików JSON z komponentami może prowadzić do problemów z wydajnością i reaktywnością. Intlayer optymalizuje ładowanie zawartości w czasie budowania.
 
 </Accordion>
-
 <Accordion header="Skalowanie wraz z non-dev">
 
 Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany **edytor wizualny** i **pełny CMS** aby pomóc ci zarządzać multilingual zawartością w **rzeczywistym czasie**, czyniąc współpracę z tłumaczami, copywriterami i innymi członkami zespołu bezproblemową. Zawartość może być przechowywana lokalnie i/lub zdalnie.
@@ -68,8 +63,6 @@ Więcej niż tylko rozwiązanie i18n, Intlayer zapewnia samodzielnie hostowany *
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Strategie migracji
 
 Ponieważ `@nuxtjs/i18n` jest zasilany przez `vue-i18n` za kulisami, istnieją dwie komplementarne strategie migracji do Intlayer:
@@ -80,20 +73,15 @@ Ponieważ `@nuxtjs/i18n` jest zasilany przez `vue-i18n` za kulisami, istnieją d
 
 Ten przewodnik obejmuje **Strategię 1** najpierw (adapter compat drop-in), a następnie przechodzi przez opcjonalną pełną migrację.
 
----
-
 ## Spis treści
 
 <TOC/>
 
----
-
 ## Szybka migracja
 
 Poniższe kroki to minimum wymagane, aby uruchomić istniejącą aplikację Nuxt w Intlayer bez żadnych zmian kodu w komponentach.
 
 <Steps>
-
 <Step number={1} title="Instalacja zależności">
 
 Zainstaluj główne pakiety Intlayer i adapter kompatybilności:
@@ -137,7 +125,6 @@ bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-js
 > Możesz bezpiecznie utrzymać `@nuxtjs/i18n` zainstalowany podczas migracji, chociaż usuniemy go z konfiguracji Nuxt wkrótce.
 
 </Step>
-
 <Step number={2} title="Konfiguracja Intlayer">
 
 Komenda `intlayer init` tworzy starter `intlayer.config.ts`. Zaktualizuj go, aby pasował do twoich istniejących lokalizacji i wskaż plugin `syncJSON` na pliki wiadomości:
@@ -172,7 +159,6 @@ export default config;
 > **`source`** mapuje lokalizację na ścieżkę pliku JSON. **`location`** mówi obserwatorowi Intlayer, który folder monitorować pod kątem zmian. Opcja `format: 'icu'` zapewnia, że placeholdery są poprawnie analizowane dla `vue-i18n`.
 
 </Step>
-
 <Step number={3} title="Aktualizacja konfiguracji Nuxt">
 
 Zastąp moduł `@nuxtjs/i18n` modułem `nuxt-intlayer` w pliku `nuxt.config.ts`. Plugin Intlayer automatycznie wstrzykuje aliasy modułów, co oznacza, że istniejące wywołania `import { useI18n } from 'vue-i18n'` są transparentnie przekierowywane do `@intlayer/vue-i18n`.
@@ -192,14 +178,11 @@ export default defineNuxtConfig({
 
 To wszystko dla szybkiej migracji. Twoja aplikacja Nuxt działa teraz na Intlayer, zachowując każdy `$t` i `useI18n()` bez zmian.
 
----
-
 ## Pełna migracja
 
 Poniższe kroki są opcjonalne i można je wykonywać przyrostowo. Odblokują one pełny zestaw funkcji Intlayer: edytor wizualny, CMS, typed content files, tłumaczenie wspierane sztuczną inteligencją i wiele więcej.
 
 <Steps>
-
 <Step number={4} title="Explicit import renaming (optional)" isOptional={true}>
 
 Pluginy Intlayer już obsługują aliasing na poziomie bundlera. Jeśli wolisz uczynić zależność jawną w plikach źródłowych, możesz ręcznie zmienić nazwy importów:
@@ -211,7 +194,6 @@ Pluginy Intlayer już obsługują aliasing na poziomie bundlera. Jeśli wolisz u
 To są **drop-in replacements** — nie są wymagane żadne zmiany sygnatur funkcji, argumentów ani typów zwracanych.
 
 </Step>
-
 <Step number={5} title="Enable AI-Powered Translation Automation" isOptional={true}>
 
 Gdy Intlayer jest już skonfigurowany, użyj jego CLI do automatycznego uzupełniania brakujących tłumaczeń:
@@ -273,8 +255,6 @@ export default config;
 
 </Steps>
 
----
-
 ## Co możesz usunąć po migracji
 
 Gdy adapter kompatybilności jest już na miejscu, poniższy boilerplate można usunąć:
@@ -287,8 +267,6 @@ Gdy adapter kompatybilności jest już na miejscu, poniższy boilerplate można
 
 Gdy będziesz gotowy do pójścia dalej, Intlayer **automatycznie odkrywa wszystkie pliki `.content.ts` i `.content.json` w dowolnym miejscu w Twoim codebase** (domyślnie w dowolnym miejscu wewnątrz `./src`). Możesz umieścić plik `my-component.content.ts` obok pliku `MyComponent.vue`, a Intlayer zarejestruje go w czasie budowania bez dodatkowej konfiguracji — bez importów, bez rejestracji, bez scentralizowanego pliku indeksu. To sprawia, że współlokalizacja tłumaczeń ze stronami i komponentami jest całkowicie bezproblemowa.
 
----
-
 ## Konfiguruj TypeScript
 
 Intlayer używa module augmentation, aby zapewnić pełny TypeScript intellisense dla twoich kluczy tłumaczeń. Upewnij się, że twój `tsconfig.json` zawiera auto-generowane typy:
@@ -303,8 +281,6 @@ Intlayer używa module augmentation, aby zapewnić pełny TypeScript intellisens
 }
 ```
 
----
-
 ## Konfiguracja Git
 
 Dodaj wygenerowany przez Intlayer katalog do `.gitignore`:
@@ -314,8 +290,6 @@ Dodaj wygenerowany przez Intlayer katalog do `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Idź dalej
 
 - **Visual Editor** — Zarządzaj tłumaczeniami wizualnie w przeglądarce: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_visual_editor.md)