@intlayer/docs 8.1.7 → 8.1.8

package/docs/pl/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2026-02-25
 title: Intlayer Compiler | Zautomatyzowane wydobywanie treści dla i18n
 description: Zautomatyzuj proces internacjonalizacji za pomocą Intlayer Compiler. Wydobywaj treści bezpośrednio z komponentów dla szybszego i bardziej efektywnego i18n w Vite, Next.js i innych.
 keywords:
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Aktualizacja opcji kompilatora
   - version: 7.3.1
     date: 2025-11-27
     changes: Wydanie kompilatora
@@ -144,6 +147,55 @@ See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymer
 
  </Tab>
 
+### Własna konfiguracja
+
+Aby dostosować zachowanie kompilatora, możesz zaktualizować plik `intlayer.config.ts` w katalogu głównym swojego projektu.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    /**
+     * Wskazuje, czy kompilator powinien być włączony.
+     * Ustaw na 'build-only', aby pominąć kompilator podczas programowania i przyspieszyć czas uruchamiania.
+     */
+    enabled: true,
+
+    /**
+     * Wzór do przeszukiwania kodu w celu optymalizacji.
+     */
+    transformPattern: [
+      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
+      "!**/node_modules/**",
+    ],
+
+    /**
+     * Wzór do wykluczenia z optymalizacji.
+     */
+    excludePattern: ["**/node_modules/**"],
+
+    /**
+     * Katalog wyjściowy dla zoptymalizowanych słowników.
+     */
+    outputDir: "i18n",
+
+    /**
+     * Prefiks klucza słownika
+     */
+    dictionaryKeyPrefix: "", // Usuń podstawowy prefiks
+
+    /**
+     * Wskazuje, czy komponenty powinny zostać zapisane po przekształceniu.
+     * W ten sposób kompilator może zostać uruchomiony tylko raz w celu przekształcenia aplikacji, a następnie można go usunąć.
+     */
+    saveComponents: false,
+  },
+};
+
+export default config;
+```
+
 ### Uzupełnij brakujące tłumaczenia
 
 Intlayer udostępnia narzędzie CLI, które pomaga uzupełnić brakujące tłumaczenia. Możesz użyć polecenia `intlayer`, aby przetestować i uzupełnić brakujące tłumaczenia w swoim kodzie.

package/docs/pl/component_i18n.md

@@ -78,7 +78,7 @@ Obsługiwany jest również format JSON, jeśli wolisz pliki konfiguracyjne.
 
 ## 2) Pobierz swoją treść
 
-### Przypadek A — aplikacja React (Vite/SPA)
+### Przypadek A, aplikacja React (Vite/SPA)
 
 Domyślne podejście: użyj `useIntlayer`, aby pobrać treść po kluczu. Pozwala to utrzymać komponenty lekkie i typowane.
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### Przypadek B — Next.js (App Router)
+### Przypadek B. Next.js (App Router)
 
 Preferuj komponenty serwerowe dla bezpieczeństwa danych i wydajności. Używaj `useIntlayer` z `next-intlayer/server` w plikach serwerowych oraz `useIntlayer` z `next-intlayer` w komponentach klienckich.
 

package/docs/pl/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: Konfiguracja
 description: Dowiedz się, jak skonfigurować Intlayer dla swojej aplikacji. Zrozum różne ustawienia i opcje dostępne do dostosowania Intlayer do Twoich potrzeb.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Aktualizacja opcji kompilatora
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -452,6 +455,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -1091,3 +1105,49 @@ Opcje budowania dotyczą wtyczek `@intlayer/babel` oraz `@intlayer/swc`.
   - _Uwaga_: Użyj tego, aby ograniczyć optymalizację do istotnych plików kodu i poprawić wydajność budowania.
   - _Uwaga_: Ta opcja zostanie zignorowana, jeśli `optimize` jest wyłączone.
   - _Uwaga_: Używaj wzorców glob.
+
+---
+
+### Konfiguracja Kompilatora
+
+Ustawienia kontrolujące kompilator Intlayer, który wyodrębnia słowniki bezpośrednio z Twoich komponentów.
+
+#### Właściwości
+
+- **enabled**:
+  - _Typ_: `boolean | 'build-only'`
+  - _Domyślnie_: `true`
+  - _Opis_: Wskazuje, czy kompilator powinien być włączony w celu wyodrębniania słowników.
+  - _Przykład_: `'build-only'`
+  - _Uwaga_: Ustawienie go na `'build-only'` spowoduje pominięcie kompilatora w trybie deweloperskim, co przyspieszy czas uruchamiania. Będzie on uruchamiany tylko przy poleceniach budowania.
+
+- **dictionaryKeyPrefix**:
+  - _Typ_: `string`
+  - _Domyślnie_: `'comp-'`
+  - _Opis_: Prefiks dla wyodrębnionych kluczy słownika.
+  - _Przykład_: `'my-key-'`
+  - _Uwaga_: Podczas wyodrębniania słowników klucz jest generowany na podstawie nazwy pliku. Ten prefiks jest dodawany do wygenerowanego klucza, aby zapobiec konfliktom.
+
+- **saveComponents**:
+  - _Typ_: `boolean`
+  - _Domyślnie_: `false`
+  - _Opis_: Wskazuje, czy komponenty powinny zostać zapisane po ich przekształceniu.
+  - _Uwaga_: Jeśli ustawiono na true, kompilator zastąpi oryginalne pliki plikami przekształconymi. W ten sposób kompilator można uruchomić tylko raz, aby przekształcić aplikację, a następnie można go usunąć.
+
+- **transformPattern**:
+  - _Typ_: `string | string[]`
+  - _Domyślnie_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _Opis_: Wzorce określające, które pliki powinny być przeszukiwane podczas optymalizacji.
+  - _Przykład_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Uwaga_: Użyj tego, aby ograniczyć optymalizację do istotnych plików kodu i poprawić wydajność budowania.
+
+- **excludePattern**:
+  - _Typ_: `string | string[]`
+  - _Domyślnie_: `['**/node_modules/**']`
+  - _Opis_: Wzorce określające, które pliki powinny być wykluczone podczas optymalizacji.
+  - _Przykład_: `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _Typ_: `string`
+  - _Domyślnie_: `'compiler'`
+  - _Opis_: Katalog, w którym będą przechowywane wyodrębnione słowniki, względem ścieżki bazowej projektu.

package/docs/pl/dictionary/content_file.md

@@ -493,7 +493,7 @@ Wskazuje lokalizację słownika i kontroluje sposób synchronizacji z CMS:
 
 - `'local'`: Słownik jest zarządzany tylko lokalnie. Nie zostanie wysłany do zdalnego CMS. Użyj tego dla treści, które powinny pozostać w twojej bazie kodu.
 - `'remote'`: Słownik jest zarządzany tylko zdalnie. Po wysłaniu do CMS zostanie odłączony od pliku lokalnego. W momencie ładowania treści zdalny słownik zostanie pobrany z CMS. Plik `.content` z lokalizacją `remote` zostanie zignorowany po początkowym wysłaniu.
-- `'hybrid'`: Słownik jest zarządzany zarówno lokalnie, jak i zdalnie. Po wysłaniu do CMS pozostanie zsynchronizowany—zmiany z pliku lokalnego są wysyłane do CMS, a zmiany zdalne mogą być pobrane z powrotem do pliku lokalnego.
+- `'hybrid'`: Słownik jest zarządzany zarówno lokalnie, jak i zdalnie. Po wysłaniu do CMS pozostanie zsynchronizowany, zmiany z pliku lokalnego są wysyłane do CMS, a zmiany zdalne mogą być pobrane z powrotem do pliku lokalnego.
 - `string` (np. `'plugin'`): Słownik jest zarządzany przez wtyczkę lub niestandardowe źródło. Gdy spróbujesz go wysłać, system zapyta cię, co zrobić.
 
 **Przykład:**

package/docs/pl/index.md

@@ -64,7 +64,7 @@ Organizuj swoje wielojęzyczne treści blisko kodu, aby wszystko było spójne i
 - **[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.
 
-- **[Warunek](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/conditional.md)**  
+- **[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.
 
 - **[Rodzaj gramatyczny](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/gender.md)**  
@@ -80,7 +80,7 @@ Odkryj, jak wstawiać wartości w ciągu znaków za pomocą symboli zastępczych
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/markdown.md)**  
   Naucz się, jak używać Markdown w Intlayer do tworzenia bogatych treści.
 
-- **[Osadzanie plików](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file_embeddings.md)**  
+- **[Osadzanie plików](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/file.md)**  
   Dowiedz się, jak osadzać zewnętrzne pliki w Intlayer, aby używać ich w edytorze treści.
 
 - **[Zagnieżdżanie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/nesting.md)**

package/docs/pl/intlayer_CMS.md

@@ -464,7 +464,7 @@ Przykład użycia Vite:
 
 Serwer Live Sync otacza Twoją aplikację i automatycznie stosuje zaktualizowaną zawartość w momencie jej pojawienia się.
 
-Aby otrzymywać powiadomienia o zmianach z CMS, serwer Live Sync utrzymuje połączenie SSE z backendem. Gdy zawartość w CMS ulega zmianie, backend przekazuje aktualizację do serwera Live Sync, który zapisuje nowe słowniki. Twoja aplikacja odzwierciedli aktualizację przy następnej nawigacji lub przeładowaniu przeglądarki — nie jest wymagane ponowne budowanie.
+Aby otrzymywać powiadomienia o zmianach z CMS, serwer Live Sync utrzymuje połączenie SSE z backendem. Gdy zawartość w CMS ulega zmianie, backend przekazuje aktualizację do serwera Live Sync, który zapisuje nowe słowniki. Twoja aplikacja odzwierciedli aktualizację przy następnej nawigacji lub przeładowaniu przeglądarki, nie jest wymagane ponowne budowanie.
 
 Schemat przepływu (CMS/Backend -> Serwer Live Sync -> Serwer aplikacji -> Frontend):
 

package/docs/pl/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - Jak przetłumaczyć aplikację AdonisJS – przewodnik 2026
+title: AdonisJS i18n - Jak przetłumaczyć aplikację AdonisJS w 2026
 description: Dowiedz się, jak uczynić swój backend AdonisJS wielojęzycznym. Postępuj zgodnie z dokumentacją, aby go umiędzynarodowić (i18n) i przetłumaczyć.
 keywords:
   - Międzynarodowienie

package/docs/pl/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - Jak przetłumaczyć swoją aplikację Analog – przewodnik 2026
+title: Analog i18n - Jak przetłumaczyć aplikację Analog w 2026
 description: Dowiedz się, jak uczynić swoją aplikację Analog wielojęzyczną. Postępuj zgodnie z dokumentacją, aby przeprowadzić internacjonalizację (i18n) i tłumaczenie.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - Jak przetłumaczyć aplikację Angular – przewodnik 2026
+title: Angular i18n - Jak przetłumaczyć aplikację Angular w 2026
 description: Dowiedz się, jak uczynić swoją stronę Angular wielojęzyczną. Postępuj zgodnie z dokumentacją, aby ją umiędzynarodowić (i18n) i przetłumaczyć.
 keywords:
   - Umiędzynarodowienie

package/docs/pl/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - Jak przetłumaczyć swoją aplikację Astro – przewodnik 2026
+title: Astro i18n - Jak przetłumaczyć aplikację Astro w 2026
 description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej strony Astro za pomocą Intlayer. Postępuj zgodnie z tym przewodnikiem, aby uczynić swoją stronę wielojęzyczną.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: Create React App i18n - Jak przetłumaczyć swoją aplikację React – przewodnik 2026
+title: Create React App i18n - Jak przetłumaczyć aplikację React w 2026
 description: Dowiedz się, jak uczynić swoją stronę Create React App (CRA) wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zrealizować internacjonalizację (i18n) i tłumaczenie.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: Express i18n - Jak przetłumaczyć swoją aplikację Express – przewodnik 2026
+title: Express i18n - Jak przetłumaczyć aplikację Express w 2026
 description: Dowiedz się, jak uczynić swój backend Express wielojęzycznym. Postępuj zgodnie z dokumentacją, aby internacjonalizować (i18n) i tłumaczyć.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - Jak przetłumaczyć swoją aplikację Fastify – przewodnik 2026
+title: Fastify i18n - Jak przetłumaczyć aplikację Fastify w 2026
 description: "Dowiedz się, jak uczynić backend Fastify wielojęzycznym. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć go."
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: i18n Hono - Jak przetłumaczyć aplikację Hono – przewodnik 2026
+title: i18n Hono - Jak przetłumaczyć aplikację Hono w 2026
 description: Dowiedz się, jak sprawić, by Twój backend Hono był wielojęzyczny. Postępuj zgodnie z dokumentacją, aby go zainternacjonalizować (i18n) i przetłumaczyć.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx i React i18n - Jak przetłumaczyć swoją aplikację Lynx – przewodnik 2026
+title: Lynx + React i18n - Jak przetłumaczyć aplikację Lynx w 2026
 description: Dowiedz się, jak uczynić swoją aplikację mobilną Lynx i React wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć aplikację.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - Jak przetłumaczyć swoją aplikację NestJS – przewodnik 2026
+title: NestJS i18n - Jak przetłumaczyć aplikację NestJS w 2026
 description: Dowiedz się, jak uczynić swój backend NestJS wielojęzycznym. Postępuj zgodnie z dokumentacją, aby internacjonalizować (i18n) i tłumaczyć.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js i next-i18next i18n - Jak przetłumaczyć swoją aplikację Next.js – przewodnik 2026
+title: next-i18next - Jak przetłumaczyć aplikację Next.js (i18n) w 2026 roku
 description: Praktyczny, gotowy do produkcji przewodnik po internacjonalizacji aplikacji Next.js 15 App Router z użyciem i18next/next-i18next oraz jej rozszerzeniu za pomocą Intlayer.
 keywords:
   - Internacjonalizacja
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - Integracja Intlayer do automatyzacji procesów tłumaczeniowych (testy, uzupełnianie AI, synchronizacja JSON)
 
 > Uwaga: next-i18next jest zbudowany na bazie i18next. Ten przewodnik korzysta z prymitywów i18next kompatybilnych z next-i18next w App Router, jednocześnie utrzymując architekturę prostą i gotową do produkcji.
-> Dla szerszego porównania zobacz [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pl/next-i18next_vs_next-i18next_vs_intlayer.md).
+> Dla szerszego porównania zobacz [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pl/next-i18next_vs_next-intl_vs_intlayer.md).
 
 ---
 

package/docs/pl/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js i next-intl i18n - Jak przetłumaczyć swoją aplikację Next.js – przewodnik 2026
+title: next-intl - Jak przetłumaczyć aplikację Next.js (i18n) w 2026 roku
 description: Dowiedz się, jak uczynić swoją stronę Next.js 15 App Router wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zrealizować internacjonalizację (i18n) i tłumaczenie.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Jak przetłumaczyć swoją aplikację Next.js 14 – przewodnik 2026
+title: Next.js i18n - Jak przetłumaczyć aplikację Next.js 14 w 2026
 description: Dowiedz się, jak uczynić swoją stronę Next.js 14 App Router wielojęzyczną. Postępuj zgodnie z dokumentacją, aby ją internacjonalizować (i18n) i tłumaczyć.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-25
 updatedAt: 2025-12-30
-title: Next.js i18n - Jak przetłumaczyć swoją aplikację Next.js 15 – przewodnik 2026
+title: Next.js i18n - Jak przetłumaczyć aplikację Next.js 15 w 2026
 description: Dowiedz się, jak uczynić swoją stronę Next.js 15 wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć ją.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Jak przetłumaczyć swoją aplikację Next.js 16 – przewodnik 2026
+title: Next.js i18n - Jak przetłumaczyć aplikację Next.js 16 w 2026
 description: Odkryj, jak uczynić swoją stronę Next.js 16 wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć ją.
 keywords:
   - Internacjonalizacja
@@ -708,6 +708,8 @@ const ServerComponentExample = () => {
 
 > Aby dowiedzieć się więcej o hooku `useIntlayer`, zapoznaj się z [dokumentacją](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/next-intlayer/useIntlayer.md).
 
+> 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ę.
+
 ### (Opcjonalny) Krok 7: Konfiguracja proxy do wykrywania lokalizacji
 
 Skonfiguruj proxy, aby wykrywać preferowaną lokalizację użytkownika:

package/docs/pl/intlayer_with_nextjs_compiler.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-01-10
 updatedAt: 2026-01-10
-title: Next.js i18n - Przekształć istniejącą aplikację Next.js w aplikację wielojęzyczną (przewodnik i18n 2026)
+title: Next.js i18n - Przekształć istniejącą aplikację Next.js w aplikację wielojęzyczną w 2026
 description: Dowiedz się, jak uczynić swoją istniejącą aplikację Next.js wielojęzyczną za pomocą Kompilatora Intlayer. Postępuj zgodnie z dokumentacją, aby umiędzynarodowić (i18n) i przetłumaczyć swoją aplikację przy użyciu AI.
 keywords:
   - Umiędzynarodowienie
@@ -14,9 +14,9 @@ keywords:
   - AI
 slugs:
   - doc
-  - srodowisko
+  - environment
   - nextjs
-  - kompilator
+  - compiler
 applicationTemplate: https://github.com/aymericzip/intlayer-next-no-lolale-path-template
 youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 history:
@@ -54,7 +54,7 @@ Zobacz [Szablon Aplikacji](https://github.com/aymericzip/intlayer-next-no-lolale
 
 ## Dlaczego umiędzynarodowienie istniejącej aplikacji jest trudne?
 
-Jeśli kiedykolwiek próbowałeś dodać wiele języków do aplikacji, która była budowana tylko dla jednego języka, to znasz ten ból. To nie jest tylko „trudne” — to żmudne. Musisz przejrzeć każdy plik, znaleźć każdy ciąg tekstowy i przenieść je do oddzielnych plików słownikowych.
+Jeśli kiedykolwiek próbowałeś dodać wiele języków do aplikacji, która była budowana tylko dla jednego języka, to znasz ten ból. To nie jest tylko „trudne”, to żmudne. Musisz przejrzeć każdy plik, znaleźć każdy ciąg tekstowy i przenieść je do oddzielnych plików słownikowych.
 
 Potem nadchodzi ryzykowna część: zastąpienie całego tego tekstu wywołaniami do kodu (hookami) bez psucia układu czy logiki. To ten rodzaj pracy, który wstrzymuje rozwój nowych funkcji na tygodnie i wydaje się być niekończącym się refaktoringiem.
 
@@ -127,9 +127,26 @@ const config: IntlayerConfig = {
     mode: "search-params",
   },
   compiler: {
-    enabled: true, // Można ustawić na 'build-only', aby ograniczyć wpływ w trybie dev
-    outputDir: "i18n",
-    dictionaryKeyPrefix: "", // Brak prefiksu, domyślnie "comp-"
+    /**
+     * Określa, czy kompilator powinien być włączony.
+     */
+    enabled: true,
+
+    /**
+     * Katalog wyjściowy dla zoptymalizowanych słowników.
+     */
+    outputDir: "compiler",
+
+    /**
+     * Prefiks klucza słownika
+     */
+    dictionaryKeyPrefix: "", // Usuń prefiks bazowy
+
+    /**
+     * Określa, czy komponenty powinny zostać zapisane po transformacji.
+     * W ten sposób kompilator można uruchomić tylko raz, aby przekształcić aplikację, a następnie można go usunąć.
+     */
+    saveComponents: false,
   },
   ai: {
     provider: "openai",

package/docs/pl/intlayer_with_nextjs_no_locale_path.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-01-10
 updatedAt: 2026-01-10
-title: Next.js i18n - Jak przetłumaczyć swoją aplikację Next.js 16 (bez [locale] w ścieżce strony) – przewodnik 2026
+title: Next.js i18n - Jak przetłumaczyć aplikację Next.js 16 (bez [locale] w ścieżce strony) w 2026
 description: Dowiedz się, jak uczynić swoją stronę Next.js 16 wielojęzyczną bez [locale] w ścieżce strony. Postępuj zgodnie z dokumentacją, aby przeprowadzić internacjonalizację (i18n) i przetłumaczyć ją.
 keywords:
   - Internacjonalizacja
@@ -415,7 +415,7 @@ const metadataContent = {
 export default metadataContent;
 ```
 
-```tsx fileName="src/app/metadata.content.mjs" contentDeclarationFormat="typescript"
+```tsx fileName="src/app/metadata.content.mjs" contentDeclarationFormat="esm"
 import { t, type Dictionary } from "intlayer";
 
 /** @type {import('intlayer').Dictionary<import('next').Metadata>} */
@@ -894,19 +894,19 @@ export const LocaleSwitcher: FC = () => {
             onClick={() => setLocale(localeItem)}
           >
             <span>
-              {/* Skrót lokalizacji — np. FR */}
+              {/* Skrót lokalizacji, np. FR */}
               {localeItem}
             </span>
             <span>
-              {/* Nazwa języka w jego własnym locale — np. Français */}
+              {/* Nazwa języka w jego własnym locale, np. Français */}
               {getLocaleName(localeItem, locale)}
             </span>
             <span dir={getHTMLTextDir(localeItem)} lang={localeItem}>
-              {/* Nazwa języka w bieżącym locale — np. "Francés" jeśli bieżące locale to Locales.SPANISH */}
+              {/* Nazwa języka w bieżącym locale, np. "Francés" jeśli bieżące locale to Locales.SPANISH */}
               {getLocaleName(localeItem)}
             </span>
             <span dir="ltr" lang={Locales.ENGLISH}>
-              {/* Język w wersji angielskiej — np. French */}
+              {/* Język w wersji angielskiej, np. French */}
               {getLocaleName(localeItem, Locales.ENGLISH)}
             </span>
           </button>

package/docs/pl/intlayer_with_nextjs_page_router.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-07
 updatedAt: 2025-12-30
-title: Next.js Page Router i18n - Jak przetłumaczyć swoją aplikację Next.js – przewodnik 2026
+title: Next.js Page Router i18n - Jak przetłumaczyć aplikację Next.js w 2026
 description: Dowiedz się, jak uczynić swoją stronę Next.js korzystającą z Page Router wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zrealizować internacjonalizację (i18n) i tłumaczenie.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_nuxt.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-06-18
 updatedAt: 2025-12-07
-title: Nuxt i18n - Jak przetłumaczyć swoją aplikację Nuxt – przewodnik 2026
+title: Nuxt i18n - Jak przetłumaczyć aplikację Nuxt w 2026
 description: Dowiedz się, jak uczynić swoją stronę Nuxt i Vue wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć ją.
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_react_native+expo.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-06-18
 updatedAt: 2025-12-30
-title: React Native i Expo i18n - Jak przetłumaczyć swoją aplikację React Native – przewodnik 2026
-description: Dowiedz się, jak uczynić swoją stronę React Native i Expo wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć ją.
+title: Expo + React Native i18n - Jak przetłumaczyć aplikację React Native w 2026
+description: Dowiedz się, jak uczynić swoją stronę Expo i React Native wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć ją.
 keywords:
   - Internacjonalizacja
   - Dokumentacja
@@ -27,7 +27,7 @@ history:
     changes: Inicjalizacja historii
 ---
 
-# Przetłumacz swoją stronę React Native i Expo za pomocą Intlayer | Internacjonalizacja (i18n)
+# Przetłumacz swoją aplikację Expo i React Native | Internacjonalizacja (i18n)
 
 ## Spis treści
 
@@ -477,6 +477,8 @@ module.exports = HomeScreen;
 
 > Kiedy używasz `content.someKey` w właściwościach opartych na łańcuchach znaków (np. `title` przycisku lub `children` komponentu `Text`), **wywołaj `content.someKey.value`**, aby uzyskać właściwy łańcuch znaków.
 
+> 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ę.
+
 ---
 
 ## (Opcjonalny) Krok 5: Zmiana lokalizacji aplikacji

package/docs/pl/intlayer_with_react_router_v7.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-04
 updatedAt: 2025-12-30
-title: React Router v7 i18n - Jak przetłumaczyć swoją aplikację React Router v7 – przewodnik 2026
+title: React Router v7 i18n - Jak przetłumaczyć aplikację React Router v7 w 2026
 description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej aplikacji React Router v7 za pomocą Intlayer. Postępuj zgodnie z tym kompleksowym przewodnikiem, aby uczynić swoją aplikację wielojęzyczną z routingiem uwzględniającym lokalizację.
 keywords:
   - Internacjonalizacja
@@ -113,7 +113,7 @@ bunx intlayer init
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
   
-<iframe title="How to translate your React Router v7 app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="How to translate an React Router v7 app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
   <Tab label="Code" value="code">
@@ -395,6 +395,8 @@ export default function Page() {
 
 > Aby dowiedzieć się więcej o hooku `useIntlayer`, zapoznaj się z [dokumentacją](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/react-intlayer/useIntlayer.md).
 
+> 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ę.
+
 ### Krok 9: Utwórz komponent przełącznika języka
 
 Utwórz komponent, który pozwoli użytkownikom zmieniać języki:

package/docs/pl/intlayer_with_react_router_v7_fs_routes.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-07
 updatedAt: 2025-12-30
-title: React Router v7 i18n - Jak przetłumaczyć swoją aplikację React Router v7 – przewodnik 2026
+title: React Router v7 i18n - Jak przetłumaczyć aplikację React Router v7 w 2026
 description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej aplikacji React Router v7 za pomocą Intlayer z routingiem opartym na systemie plików. Postępuj zgodnie z tym kompleksowym przewodnikiem, aby uczynić swoją aplikację wielojęzyczną z routingiem uwzględniającym lokalizację.
 keywords:
   - Internacjonalizacja
@@ -61,7 +61,7 @@ Dzięki Intlayer możesz:
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
   
-<iframe title="How to translate your React Router v7 (File-System Routes) app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="How to translate an React Router v7 (File-System Routes) app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
   <Tab label="Code" value="code">
@@ -121,7 +121,7 @@ bunx intlayer init
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
   
-<iframe title="How to translate your React Router v7 (File-System Routes) app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="How to translate an React Router v7 (File-System Routes) app using Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
   <Tab label="Code" value="code">
@@ -391,6 +391,8 @@ export default function AboutPage() {
 }
 ```
 
+> 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ę.
+
 ### Krok 6: Zadeklaruj swoją zawartość
 
 Utwórz i zarządzaj deklaracjami zawartości, aby przechowywać tłumaczenia. Umieść pliki zawartości obok plików tras:

package/docs/pl/intlayer_with_svelte_kit.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-11-20
 updatedAt: 2025-12-30
-title: SvelteKit i18n - Jak przetłumaczyć swoją aplikację SvelteKit – przewodnik 2026
+title: SvelteKit i18n - Jak przetłumaczyć aplikację SvelteKit w 2026
 description: Dowiedz się, jak uczynić swoją stronę SvelteKit wielojęzyczną. Postępuj zgodnie z dokumentacją, aby zinternacjonalizować (i18n) i przetłumaczyć ją za pomocą Server-Side Rendering (SSR).
 keywords:
   - Internacjonalizacja

package/docs/pl/intlayer_with_tanstack.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: Tanstack Start i18n - Jak przetłumaczyć swoją aplikację Tanstack Start – przewodnik 2026
+title: Tanstack Start i18n - Jak przetłumaczyć aplikację Tanstack Start w 2026
 description: Dowiedz się, jak dodać internacjonalizację (i18n) do swojej aplikacji Tanstack Start za pomocą Intlayer. Postępuj zgodnie z tym kompleksowym przewodnikiem, aby uczynić swoją aplikację wielojęzyczną z routingiem uwzględniającym lokalizację.
 keywords:
   - Internacjonalizacja