@intlayer/docs 8.11.2 → 8.11.3

package/docs/nl/introduction.md

@@ -2,7 +2,7 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: Introductie
-description: Ontdek hoe Intlayer werkt. Bekijk de stappen die Intlayer gebruikt in uw applicatie. Bekijk wat de verschillende pakketten doen.
+description: Ontdek hoe Intlayer werkt. Bekijk de stappen die Intlayer in uw applicatie gebruikt. Ontdek wat de verschillende pakketten doen.
 keywords:
   - Introductie
   - Aan de slag
@@ -15,20 +15,20 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: "Geschiedenis geïnitialiseerd"
+    changes: "Init history"
 ---
 
 # Intlayer Documentatie
 
-Welkom bij de officiële Intlayer-documentatie! Hier vindt u alles wat u nodig hebt om Intlayer te integreren, configureren en beheersen voor al uw internationaliseringsbehoeften (i18n), of u nu werkt met Next.js, React, Vite, Express of een andere JavaScript-omgeving.
+Welkom bij de officiële Intlayer-documentatie! Hier vindt u alles wat u nodig hebt om Intlayer te integreren, configureren en te beheersen voor al uw behoeften op het gebied van internationalisering (i18n), of u nu werkt met Next.js, React, Vite, Express of een andere JavaScript-omgeving.
 
 ## Introductie
 
 ### Wat is Intlayer?
 
-**Intlayer** is een internationaliseringsbibliotheek die speciaal is ontworpen voor JavaScript-ontwikkelaars. Hiermee kunt u uw inhoud overal in uw code declareren. Het zet declaraties van meertalige inhoud om in gestructureerde woordenboeken die eenvoudig in uw code te integreren zijn. Door gebruik te maken van TypeScript maakt **Intlayer** uw ontwikkeling krachtiger en efficiënter.
+**Intlayer** is een bibliotheek voor internationalisering die speciaal is ontworpen voor JavaScript-ontwikkelaars. Het maakt de declaratie van uw content overal in uw code mogelijk. Het zet de declaratie van meertalige content om in gestructureerde woordenboeken om deze eenvoudig in uw code te integreren. Door TypeScript te gebruiken, maakt **Intlayer** uw ontwikkeling robuuster en efficiënter.
 
-Intlayer biedt ook een optionele visuele editor waarmee u uw inhoud eenvoudig kunt bewerken en beheren. Deze editor is vooral handig voor ontwikkelaars die de voorkeur geven aan een visuele interface voor inhoudsbeheer, of voor teams die inhoud genereren zonder zich zorgen te hoeven maken over code.
+Intlayer biedt ook een optionele visuele editor waarmee u uw content eenvoudig kunt bewerken en beheren. Deze editor is met name handig voor ontwikkelaars die de voorkeur geven aan een visuele interface voor contentbeheer, of voor teams die content genereren zonder zich zorgen te hoeven maken over code.
 
 ### Gebruiksvoorbeeld
 
@@ -50,6 +50,7 @@ const componentContent = {
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      nl: "Hallo Wereld",
     }),
   },
 } satisfies Dictionary;
@@ -67,7 +68,8 @@ export default componentContent;
       "translation": {
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "nl": "Hallo Wereld"
       }
     }
   }
@@ -85,58 +87,60 @@ export const MyComponent: FC = () => {
 };
 ```
 
-## Belangrijkste kenmerken
+## Belangrijkste Kenmerken
 
 Intlayer biedt een verscheidenheid aan functies die zijn afgestemd op de behoeften van moderne webontwikkeling. Hieronder staan de belangrijkste functies, met links naar gedetailleerde documentatie voor elk:
 
 - **Internationaliseringsondersteuning**: Vergroot het wereldwijde bereik van uw applicatie met ingebouwde ondersteuning voor internationalisering.
-- **Visuele editor**: Verbeter uw ontwikkelingsworkflow met editor-plugins die zijn ontworpen voor Intlayer. Bekijk de [Gids voor de visuele editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_visual_editor.md).
-- **Flexibiliteit in configuratie**: Pas uw installatie aan met uitgebreide configuratie-opties die worden beschreven in de [Configuratiegids](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/configuration.md).
-- **Geavanceerde CLI-tools**: Beheer uw projecten efficiënt met de opdrachtregelinterface van Intlayer. Verken de mogelijkheden in de [Documentatie voor CLI-tools](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/cli/index.md).
+- **Visuele Editor**: Verbeter uw ontwikkelingsworkflow met editor-plugins die zijn ontworpen voor Intlayer. Bekijk de [Visuele Editor Gids](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_visual_editor.md).
+- **Configuratieflexibiliteit**: Pas uw setup aan met uitgebreide configuratieopties, beschreven in de [Configuratiegids](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/configuration.md).
+- **Geavanceerde CLI Tools**: Beheer uw projecten efficiënt met de command-line interface van Intlayer. Ontdek de mogelijkheden in de [CLI Tools Documentatie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/cli/index.md).
 
-## Kernbegrippen
+## Kernconcepten
 
 ### Woordenboek (Dictionary)
 
-Organiseer uw meertalige inhoud dicht bij uw code om alles consistent en onderhoudbaar te houden.
+Organiseer uw meertalige content dicht bij uw code om alles consistent en onderhoudbaar te houden.
 
 - **[Aan de slag](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/content_file.md)**  
-  Leer de basisprincipes van het declareren van uw inhoud in Intlayer.
+  Leer de basisprincipes van het declareren van uw content in Intlayer.
 
-- **[Vertaling](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/translation.md)**  
+- **[Vertaling (Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/translation.md)**  
   Begrijp hoe vertalingen worden gegenereerd, opgeslagen en gebruikt in uw applicatie.
 
 - **[Opsomming (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/enumeration.md)**  
-  Beheer eenvoudig herhaalde of vaste sets gegevens in verschillende talen.
+  Beheer eenvoudig herhalende of vaste datasets in verschillende talen.
 
-- **[Voorwaarde (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/condition.md)**  
-  Leer hoe u voorwaardelijke logica in Intlayer gebruikt om dynamische inhoud te maken.
+- **[Conditie (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/condition.md)**  
+  Leer hoe u voorwaardelijke logica in Intlayer kunt gebruiken om dynamische content te creëren.
 
-- **[Invoeging (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/insertion.md)**
-  Ontdek hoe u waarden in een string kunt invoegen met behulp van plaatshouders.
+- **[Invoegen (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/insertion.md)**  
+  Ontdek hoe u waarden in een string kunt invoegen met behulp van invoeg-placeholders.
 
-- **[Functie ophalen (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/function_fetching.md)**  
-  Zie hoe u dynamisch inhoud kunt ophalen met aangepaste logica die past bij de workflow van uw project.
+- **[Functies Ophalen (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/function_fetching.md)**  
+  Bekijk hoe u dynamisch content kunt ophalen met aangepaste logica die past bij de workflow van uw project.
 
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/markdown.md)**  
-  Leer hoe u Markdown in Intlayer gebruikt om rijke inhoud te maken.
+  Leer hoe u Markdown in Intlayer kunt gebruiken om rijke content te creëren.
 
-- **[Bestand-embeddings (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/file.md)**  
-  Ontdek hoe u externe bestanden in Intlayer kunt insluiten voor gebruik in de inhoudseditor.
+- **[Bestandsinsluitingen (File Embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/file.md)**  
+  Ontdek hoe u externe bestanden in Intlayer kunt insluiten voor gebruik in de content-editor.
 
-- **[Nesting](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/nesting.md)**  
-  Begrijp hoe u inhoud in Intlayer kunt nesten om complexe structuren te creëren.
+- **[Nesten (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/dictionary/nesting.md)**  
+  Begrijp hoe u content in Intlayer kunt nesten om complexe structuren te creëren.
 
-### Omgevingen en integraties
+### Omgevingen & Integraties
 
-We hebben Intlayer gebouwd met flexibiliteit in het achterhoofd, en bieden naadloze integratie met populaire frameworks en buildtools:
+We hebben Intlayer gebouwd met flexibiliteit in gedachten, en bieden een naadloze integratie met populaire frameworks en build-tools:
 
 - **[Intlayer met Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_nextjs_16.md)**
 - **[Intlayer met Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_nextjs_15.md)**
 - **[Intlayer met Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_nextjs_14.md)**
 - **[Intlayer met Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_nextjs_page_router.md)**
 - **[Intlayer met React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_create_react_app.md)**
-- **[Intlayer met Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_tanstack.md)**
+- **[Intlayer met Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_vite+react.md)**
+- **[Intlayer met React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_react_router_v7.md)**
+- **[Intlayer met Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_tanstack.md)**
 - **[Intlayer met React Native en Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_react_native+expo.md)**
 - **[Intlayer met Lynx en React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_lynx+react.md)**
 - **[Intlayer met Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_vite+preact.md)**
@@ -147,12 +151,40 @@ We hebben Intlayer gebouwd met flexibiliteit in het achterhoofd, en bieden naadl
 - **[Intlayer met Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_express.md)**
 - **[Intlayer met NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_nestjs.md)**
 - **[Intlayer met Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_hono.md)**
-- **[Intlayer met Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_angular.md)**
+- **[Intlayer met Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_with_angular_21.md)**
 
-Elke integratiegids bevat best practices voor het gebruik van de functies van Intlayer, zoals **server-side rendering**, **dynamische routering** of **client-side rendering**, zodat u een snelle, SEO-vriendelijke en zeer schaalbare applicatie kunt onderhouden.
+Elke integratiegids bevat best practices voor het gebruik van de functies van Intlayer, zoals **server-side rendering (SSR)**, **dynamische routering** of **client-side rendering**, zodat u een snelle, SEO-vriendelijke en zeer schaalbare applicatie kunt behouden.
 
-## Bijdragen en feedback
+## Bijdragen & Feedback
 
-We waarderen de kracht van open-source en community-gedreven ontwikkeling. Als u verbeteringen wilt voorstellen, een nieuwe gids wilt toevoegen of problemen in onze documentatie wilt corrigeren, stuur dan gerust een Pull Request of open een issue op onze [GitHub-repository](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+We waarderen de kracht van open-source en community-gedreven ontwikkeling. Als u verbeteringen wilt voorstellen, een nieuwe gids wilt toevoegen of problemen in onze documenten wilt corrigeren, stuur dan gerust een Pull Request in of open een Issue op onze [GitHub repository](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
 
-**Klaar om uw applicatie sneller en efficiënter te vertalen?** Duik in onze documentatie om Intlayer vandaag nog te gaan gebruiken. Ervaar een robuuste, gestroomlijnde aanpak van internationalisering die uw inhoud georganiseerd houdt en uw team productiever maakt.
+**Klaar om uw applicatie sneller en efficiënter te vertalen?** Duik in onze documentatie om vandaag nog met Intlayer te beginnen. Ervaar een robuuste, gestroomlijnde benadering van internationalisering die uw content georganiseerd houdt en uw team productiever maakt.
+
+### Waarom Intlayer boven alternatieven?
+
+Vergeleken met grote oplossingen zoals `next-intl` of `i18next`, is Intlayer een oplossing met geïntegreerde optimalisaties zoals:
+
+**Bundelgrootte (Bundle size)**
+
+Laad in plaats van enorme JSON-bestanden naar uw pagina's alleen de benodigde content. Intlayer helpt **uw bundel- en paginagroottes met wel 50% te verkleinen**.
+
+**Onderhoudbaarheid (Maintainability)**
+
+Het afbakenen (scoping) van de content van uw applicatie **vergemakkelijkt het onderhoud** voor grootschalige applicaties. U kunt een enkele feature-map dupliceren of verwijderen zonder de mentale last om uw hele content-codebase te moeten doorzoeken. Bovendien is Intlayer **volledig getypeerd (fully typed)** om de nauwkeurigheid van uw content te garanderen.
+
+**AI Agent**
+
+Co-locatie van content **vermindert de benodigde context** door grote taalmodellen (LLM's). Intlayer wordt ook geleverd met een reeks tools, zoals een **CLI** om te testen op ontbrekende vertalingen, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/mcp_server.md)** en **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/agent_skills.md)**, om de ontwikkelaarservaring (DX) voor AI-agenten nog soepeler te maken.
+
+**Automatisering**
+
+Gebruik automatisering om te vertalen in uw CI/CD-pijplijn met behulp van de LLM van uw keuze, ten koste van uw AI-provider. Intlayer biedt ook een **compiler** om contentextractie te automatiseren, evenals een [webplatform](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_CMS.md) om u te helpen **op de achtergrond te vertalen**.
+
+**Prestaties (Performance)**
+
+Het verbinden van enorme JSON-bestanden aan componenten kan leiden tot prestatie- en reactiviteitsproblemen. Intlayer optimaliseert het laden van uw content op bouwtijd (build time).
+
+**Schalen zonder ontwikkelaars (Scaling with non-dev)**
+
+Intlayer is veel meer dan alleen een i18n-oplossing en biedt een **[zelf-gehoste visuele editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_visual_editor.md)** en een **[volledig CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/nl/intlayer_CMS.md)** om u te helpen uw meertalige content in **real-time** te beheren. Dit maakt de samenwerking met vertalers, tekstschrijvers en andere teamleden naadloos. Content kan lokaal en/of op afstand worden opgeslagen.

package/docs/pl/benchmark/nextjs.md

@@ -54,7 +54,7 @@ Zobacz pełne repozytorium benchmarka [tutaj](https://github.com/intlayer-org/be
 
 Biblioteki internacjonalizacji mają ogromny wpływ na Twoją aplikację. Głównym ryzykiem jest ładowanie treści dla każdej strony i każdego języka, gdy użytkownik odwiedza tylko jedną stronę.
 
-W miarę rozwoju aplikacji rozmiar pakietu może rosnąć wykładniczo, co może zauważalnie obniżyć wydajność.
+W miarę rozwoju aplikacji rozmiar bundle'a może rosnąć wykładniczo, co może zauważalnie obniżyć wydajność.
 
 Jako przykład: w najgorszych przypadkach, po internacjonalizacji Twoja strona może stać się niemal 4 razy większa.
 
@@ -79,7 +79,7 @@ Aby ujawnić te problemy, zbudowałem darmowy skaner, który możesz wypróbowa
 
 ## Problem
 
-Istnieją dwa główne sposoby na ograniczenie wpływu aplikacji wielojęzycznej na rozmiar pakietu:
+Istnieją dwa główne sposoby na ograniczenie wpływu aplikacji wielojęzycznej na rozmiar bundle'a:
 
 - Podział plików JSON (lub treści) na pliki / zmienne / przestrzenie nazw (namespaces), aby bundler mógł usunąć (tree-shake) nieużywaną treść dla danej strony.
 - Dynamiczne ładowanie treści strony tylko w języku użytkownika.
@@ -134,7 +134,7 @@ Porównałem **cztery strategie ładowania**:
 
 ## Podsumowanie strategii
 
-- **Static**: Prosta; brak opóźnień sieciowych po początkowym załadowaniu. Minus: duży rozmiar pakietu.
+- **Static**: Prosta; brak opóźnień sieciowych po początkowym załadowaniu. Minus: duży rozmiar bundle'a.
 - **Dynamic**: Redukuje początkową wagę (lazy-loading). Idealna w przypadku wielu lokalizacji.
 - **Scoped static**: Utrzymuje porządek w kodzie (separacja logiczna) bez skomplikowanych dodatkowych żądań sieciowych.
 - **Scoped dynamic**: Najlepsze podejście pod kątem dzielenia kodu (code splitting) i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
@@ -151,7 +151,7 @@ Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla
 
 - **Wyciek z innych ścieżek**: Ta sama idea dla **innych ekranów** w aplikacji: czy ich teksty są dołączone, gdy otworzyłeś tylko jedną stronę (np. treść strony `/en/about` w pakiecie strony `/en/contact`). Wysoki wynik sugeruje słaby podział lub zbyt szerokie pakiety.
 
-- **Średni rozmiar pakietu komponentu**: Typowe elementy interfejsu są mierzone **pojedynczo**, zamiast ukrywać się wewnątrz jednej gigantycznej liczby dla aplikacji. Pokazuje to, czy internacjonalizacja po cichu „pompuje” codzienne komponenty. Na przykład, jeśli Twój komponent renderuje się ponownie, załaduje wszystkie te dane z pamięci. Dołączanie gigantycznego pliku JSON do dowolnego komponentu jest jak podłączanie wielkiego magazynu nieużywanych danych, który spowolni wydajność Twoich komponentów.
+- **Średni rozmiar bundle'a komponentu**: Typowe elementy interfejsu są mierzone **pojedynczo**, zamiast ukrywać się wewnątrz jednej gigantycznej liczby dla aplikacji. Pokazuje to, czy internacjonalizacja po cichu „pompuje” codzienne komponenty. Na przykład, jeśli Twój komponent renderuje się ponownie, załaduje wszystkie te dane z pamięci. Dołączanie gigantycznego pliku JSON do dowolnego komponentu jest jak podłączanie wielkiego magazynu nieużywanych danych, który spowolni wydajność Twoich komponentów.
 
 - **Responsywność zmiany języka**: Przełączam język za pomocą własnego mechanizmu aplikacji i mierzę czas, aż strona wyraźnie się przełączy - to, co zauważyłby użytkownik, a nie mikrokrok laboratoryjny.
 
@@ -188,7 +188,7 @@ Napotkane problemy:
 - Przekroczenie limitu AI, co całkowicie blokuje budowanie - nie można zatem wdrożyć aplikacji na produkcję bez płacenia.
 - Kompilator pomijał niemal 40% przetłumaczonej treści. Musiałem przepisać wszystkie struktury `.map` na płaskie bloki komponentów, aby go uruchomić.
 - Ich CLI jest zabugowane i miało tendencję do resetowania pliku konfiguracyjnego bez powodu.
-- Podczas budowania całkowicie wymazywało wygenerowane pliki JSON, gdy dodawana była nowa treść. W rezultacie kilka kluczy mogło wymazać ponad 300 istniejących kluczy.
+- Podczas budowania (build time) całkowicie wymazywało wygenerowane pliki JSON, gdy dodawana była nowa treść. W rezultacie kilka kluczy mogło wymazać ponad 300 istniejących kluczy.
 
 ### 2 - Rozwiązania eksperymentalne
 
@@ -222,7 +222,7 @@ Różnią się również formaty komunikatów: `next-intl` używa ICU MessageFor
 
 **(Next International)** (`next-international@1.3.1`):
 
-`next-international` również radzi sobie z powyższymi problemami, ale nie różni się zbytnio od `next-intl` czy `next-i18next`. Zawiera on funkcję `scopedT()` dla tłumaczeń specyficznych dla przestrzeni nazw, ale jej użycie nie ma praktycznie żadnego wpływu na rozmiar pakietu.
+`next-international` również radzi sobie z powyższymi problemami, ale nie różni się zbytnio od `next-intl` czy `next-i18next`. Zawiera on funkcję `scopedT()` dla tłumaczeń specyficznych dla przestrzeni nazw, ale jej użycie nie ma praktycznie żadnego wpływu na rozmiar bundle'a.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
 

package/docs/pl/benchmark/svelte.md

@@ -138,7 +138,7 @@ Workflow i DX są również bardziej złożone niż w przypadku innych opcji.
 Osobiście nie jestem fanem konieczności regeneracji plików JS przed każdym pushem, co stwarza ciągłe ryzyko konfliktów przy mergowaniu poprzez PR-y. Narzędzie wydaje się również bardziej skoncentrowane na Vite niż na Next.js.
 Wreszcie, w porównaniu z innymi rozwiązaniami, Paraglide nie używa store'a (np. Svelte store) do pobierania aktualnej lokalizacji w celu renderowania treści. Dla każdego sparsowanego węzła będzie żądać lokalizacji z localStorage / cookie itp. Prowadzi to do wykonywania niepotrzebnej logiki, która wpływa na reaktywność komponentu.
 
-> Uwaga na temat paraglide: rozwiązanie to wstrzykuje kod do Twojej bazy kodu w celu importu; w rezultacie metryka „lib size” w raporcie z benchmarku wynosi prawie 0. Generowanie kodu jest dobrą rzeczą, ponieważ użyta funkcja będzie zawierać tylko niezbędną logikę (prefiks wszędzie vs brak prefiksu, cookie vs storage itp.). Dla porównania, Intlayer wykonuje to filtrowanie poprzez wstrzykiwanie zmiennych środowiskowych podczas budowania, aby wymusić na bundlerze tree-shaking treści w zależności od logiki. Dzięki temu paraglide i intlayer okazują się być od 6 do 10 razy lżejszymi rozwiązaniami niż i18next czy next-intl.
+> Uwaga na temat paraglide: rozwiązanie to wstrzykuje kod do Twojej bazy kodu w celu importu; w rezultacie metryka „lib size” w raporcie z benchmarku wynosi prawie 0. Generowanie kodu jest dobrą rzeczą, ponieważ użyta funkcja będzie zawierać tylko niezbędną logikę (prefiks wszędzie vs brak prefiksu, cookie vs storage itp.). Dla porównania, Intlayer wykonuje to filtrowanie poprzez wstrzykiwanie zmiennych środowiskowych podczas budowania (build time), aby wymusić na bundlerze tree-shaking treści w zależności od logiki. Dzięki temu paraglide i intlayer okazują się być od 6 do 10 razy lżejszymi rozwiązaniami niż i18next czy next-intl.
 
 **(svelte-i18n)** (`svelte-i18n@3.4.0`):
 

package/docs/pl/benchmark/tanstack.md

@@ -62,7 +62,7 @@ Inny wpływ dotyczy doświadczenia programisty (DX): sposobu deklarowania treśc
 
 ## TL;DR
 
-- **Intlayer**: Zapewnia najlepszą wydajność i najmniejszy rozmiar pakietu (v8.7.12) dla TanStack Start.
+- **Intlayer**: Zapewnia najlepszą wydajność i najmniejszy rozmiar bundle'a (v8.7.12) dla TanStack Start.
 - **react-i18next** & **use-intl**: Dojrzałe alternatywy z dużymi ekosystemami, ale znacznie cięższe i bardziej złożone w optymalizacji.
 - **Paraglide**: Innowacyjny pomysł na tree-shaking, który nie działa w praktyce. Skomplikowane DX i narzut reaktywności w TanStack Start.
 - **Unikaj**: **General Translation (GT)** i **Lingo.dev** ze względu na poważne problemy z wydajnością, limity AI i uzależnienie od dostawcy (vendor lock-in).
@@ -119,7 +119,7 @@ Porównaliśmy **cztery strategie ładowania**:
 
 ## Podsumowanie strategii
 
-- **Static**: Prosta; brak opóźnień sieciowych po początkowym załadowaniu. Minus: duży rozmiar pakietu.
+- **Static**: Prosta; brak opóźnień sieciowych po początkowym załadowaniu. Minus: duży rozmiar bundle'a.
 - **Dynamic**: Redukuje początkową wagę (lazy-loading). Idealna w przypadku wielu lokalizacji.
 - **Scoped static**: Utrzymuje porządek w kodzie (separacja logiczna) bez skomplikowanych dodatkowych żądań sieciowych.
 - **Scoped dynamic**: Najlepsze podejście pod kątem dzielenia kodu (code splitting) i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
@@ -151,7 +151,7 @@ Napotkane problemy:
 - Przekroczenie limitu AI (lub blokująca zależność serwerowa), co sprawia, że budowanie / produkcja są ryzykowne bez płacenia.
 - Kompilator pomijał niemal 40% przetłumaczonej treści. Musiałem przepisać wszystkie struktury `.map` na płaskie bloki komponentów, aby go uruchomić.
 - Ich CLI jest zabugowane i miało tendencję do resetowania pliku konfiguracyjnego bez powodu.
-- Podczas budowania całkowicie wymazywało wygenerowane pliki JSON, gdy dodawana była nowa treść. W rezultacie kilka kluczy mogło wymazać setki istniejących kluczy.
+- Podczas budowania (build time) całkowicie wymazywało wygenerowane pliki JSON, gdy dodawana była nowa treść. W rezultacie kilka kluczy mogło wymazać setki istniejących kluczy.
 - Napotkałem problemy z reaktywnością biblioteki w TanStack Start: przy zmianie lokalizacji musiałem wymusić ponowne renderowanie dostawcy, aby działała.
 
 ### 2 - Rozwiązania eksperymentalne

package/docs/pl/bundle_optimization.md

@@ -92,7 +92,7 @@ bun next experimental-analyze
 
 ### Next.js (Webpack)
 
-Jeśli używasz domyślnego bundlera Webpack w Next.js, skorzystaj z oficjalnego analizatora bundle'a. Uruchom go, ustawiając zmienną środowiskową podczas budowania.
+Jeśli używasz domyślnego bundlera Webpack w Next.js, skorzystaj z oficjalnego analizatora bundle'a. Uruchom go, ustawiając zmienną środowiskową podczas budowania (build time).
 
 ```bash packageManager='npm'
 npm install -D @next/bundle-analyzer

package/docs/pl/compiler.md

@@ -42,7 +42,7 @@ history:
 - **Automatyzacja**: Eliminuje ręczne kopiowanie i wklejanie treści do słowników.
 - **Szybkość**: Optymalizowane wydobywanie treści zapewnia szybki proces budowania.
 - **Doświadczenie programisty**: Zachowaj deklaracje treści dokładnie tam, gdzie są używane, co poprawia utrzymanie kodu.
-- **Aktualizacje na żywo**: Obsługuje Hot Module Replacement (HMR) dla natychmiastowej informacji zwrotnej podczas tworzenia aplikacji.
+- **Aktualizacje na żywo**: Obsługuje Hot Module Replacement (HMR) dla natychmiastowej informacji zwrotnej podczas budowania (build time) (build time) aplikacji.
 
 Zobacz wpis na blogu [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/pl/compiler_vs_declarative_i18n.md) dla głębszego porównania.
 

package/docs/pl/component_i18n.md

@@ -170,7 +170,7 @@ Wskazówka: Dla metadanych strony i SEO możesz również pobierać zawartość
 - **Kolokacja**: Deklaracje treści znajdują się blisko komponentów, co zmniejsza rozbieżności i poprawia ponowne wykorzystanie w systemach projektowych.
 - **Bezpieczeństwo typów**: Klucze i struktury są silnie typowane; brakujące tłumaczenia ujawniają się podczas kompilacji, a nie w czasie wykonywania.
 - **Server-first**: Działa natywnie w komponentach serwerowych dla lepszego bezpieczeństwa i wydajności; hooki klienta pozostają ergonomiczne.
-- **Tree-shaking**: Do bundla trafia tylko zawartość używana przez komponent, co utrzymuje rozmiar pakietu mały w dużych aplikacjach.
+- **Tree-shaking**: Do bundla trafia tylko zawartość używana przez komponent, co utrzymuje rozmiar bundle'a mały w dużych aplikacjach.
 - **DX i narzędzia**: Wbudowane middleware, pomocniki SEO oraz opcjonalny Visual Editor/tłumaczenia AI usprawniają codzienną pracę.
 
 Zobacz porównania i wzorce w przeglądzie skupionym na Next.js: https://intlayer.org/blog/next-i18next-vs-next-intl-vs-intlayer

package/docs/pl/configuration.md

@@ -396,7 +396,7 @@ const config: IntlayerConfig = {
   build: {
     /**
      * Tryb wykonywania budowania.
-     * - "auto": Automatyczne budowanie podczas budowania aplikacji.
+     * - "auto": Automatyczne budowanie podczas budowania (build time) aplikacji.
      * - "manual": Wymaga jawnego polecenia budowania.
      * Domyślnie: "auto"
      */
@@ -409,7 +409,7 @@ const config: IntlayerConfig = {
     optimize: true,
 
     /**
-     * Minimalizuj słowniki, aby zmniejszyć rozmiar pakietu.
+     * Minimalizuj słowniki, aby zmniejszyć rozmiar bundle'a.
      * Domyślnie: false
      *
      * Uwaga:
@@ -434,7 +434,7 @@ const config: IntlayerConfig = {
     outputFormat: ["cjs", "esm"],
 
     /**
-     * Czy przeprowadzać sprawdzanie typów TypeScript podczas budowania.
+     * Czy przeprowadzać sprawdzanie typów TypeScript podczas budowania (build time).
      * Domyślnie: false
      */
     checkTypes: false,
@@ -943,15 +943,15 @@ Ustawienia budowania mają zastosowanie do wtyczek `@intlayer/babel` i `@intlaye
 
 > Podczas optymalizacji Intlayer zastępuje wywołania słowników optymalizacją dzielenia kodu (chunking), aby wynikowy pakiet importował tylko te słowniki, które są faktycznie używane.
 
-| Pole              | Opis                                                                       | Typ                              | Domyślnie                                                                                                                                                                         | Przykład                                                                      | Uwagi                                                                                                                                                                                                                                                                                                                                 |
-| ----------------- | -------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | Kontroluje tryb wykonywania budowania.                                     | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Budowanie jest automatycznie wyzwalane podczas budowania aplikacji.<br/>• `'manual'`: Uruchamiane tylko poprzez jawne polecenie budowania.<br/>• Może być użyte do zapobiegania budowaniu słowników (np. aby uniknąć uruchamiania w środowisku Node.js).                                                                  |
-| `optimize`        | Kontroluje, czy optymalizacja budowania jest wykonywana.                   | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Jeśli niezdefiniowane, optymalizacja jest wyzwalana podczas budowania frameworka (Vite/Next.js).<br/>• `true` wymusza optymalizację nawet w trybie deweloperskim.<br/>• `false` wyłącza ją.<br/>• Jeśli włączone, zastępuje wywołania słowników optymalizacją chunking.<br/>• Wymagane wtyczki `@intlayer/babel` i `@intlayer/swc`. |
-| `minify`          | Minimalizuj słowniki, aby zmniejszyć rozmiar pakietu.                      | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Określa, czy pakiet ma zostać zminimalizowany.<br/>• Domyślnie: `true` w produkcji.<br/>• Ta opcja zostanie zignorowana, jeśli `optimize` jest wyłączone.<br/>• Ta opcja zostanie zignorowana, jeśli `editor.enabled` jest prawdziwe.                                                                                               |
-| `purge`           | Usuń nieużywane klucze w słownikach.                                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Określa, czy pakiet ma zostać wyczyszczony.<br/>• Domyślnie: `true` w produkcji.<br/>• Ta opcja zostanie zignorowana, jeśli `optimize` jest wyłączone.                                                                                                                                                                              |
-| `checkTypes`      | Wskazuje, czy budowanie powinno sprawdzać typy TypeScript i logować błędy. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Może spowolnić proces budowania.                                                                                                                                                                                                                                                                                                      |
-| `outputFormat`    | Kontroluje format wyjściowy słowników.                                     | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                       |
-| `traversePattern` | Wzorzec dla plików, które mają być skanowane podczas optymalizacji.        | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Poprawia wydajność budowania poprzez ograniczenie optymalizacji do odpowiednich plików.<br/>• Ignorowane, jeśli `optimize` jest wyłączone.<br/>• Używa wzorców glob.                                                                                                                                                                |
+| Pole              | Opis                                                                       | Typ                              | Domyślnie                                                                                                                                                                         | Przykład                                                                      | Uwagi                                                                                                                                                                                                                                                                                                                                              |
+| ----------------- | -------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`            | Kontroluje tryb wykonywania budowania.                                     | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: Budowanie jest automatycznie wyzwalane podczas budowania (build time) aplikacji.<br/>• `'manual'`: Uruchamiane tylko poprzez jawne polecenie budowania.<br/>• Może być użyte do zapobiegania budowaniu słowników (np. aby uniknąć uruchamiania w środowisku Node.js).                                                                  |
+| `optimize`        | Kontroluje, czy optymalizacja budowania jest wykonywana.                   | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • Jeśli niezdefiniowane, optymalizacja jest wyzwalana podczas budowania (build time) frameworka (Vite/Next.js).<br/>• `true` wymusza optymalizację nawet w trybie deweloperskim.<br/>• `false` wyłącza ją.<br/>• Jeśli włączone, zastępuje wywołania słowników optymalizacją chunking.<br/>• Wymagane wtyczki `@intlayer/babel` i `@intlayer/swc`. |
+| `minify`          | Minimalizuj słowniki, aby zmniejszyć rozmiar bundle'a.                     | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Określa, czy pakiet ma zostać zminimalizowany.<br/>• Domyślnie: `true` w produkcji.<br/>• Ta opcja zostanie zignorowana, jeśli `optimize` jest wyłączone.<br/>• Ta opcja zostanie zignorowana, jeśli `editor.enabled` jest prawdziwe.                                                                                                            |
+| `purge`           | Usuń nieużywane klucze w słownikach.                                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Określa, czy pakiet ma zostać wyczyszczony.<br/>• Domyślnie: `true` w produkcji.<br/>• Ta opcja zostanie zignorowana, jeśli `optimize` jest wyłączone.                                                                                                                                                                                           |
+| `checkTypes`      | Wskazuje, czy budowanie powinno sprawdzać typy TypeScript i logować błędy. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Może spowolnić proces budowania.                                                                                                                                                                                                                                                                                                                   |
+| `outputFormat`    | Kontroluje format wyjściowy słowników.                                     | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                    |
+| `traversePattern` | Wzorzec dla plików, które mają być skanowane podczas optymalizacji.        | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Poprawia wydajność budowania poprzez ograniczenie optymalizacji do odpowiednich plików.<br/>• Ignorowane, jeśli `optimize` jest wyłączone.<br/>• Używa wzorców glob.                                                                                                                                                                             |
 
 ---
 

package/docs/pl/dictionary/content_file.md

@@ -1130,4 +1130,4 @@ export default {
 3. **Wydajność**:
    - Dostosuj konfigurację treści, aby ograniczyć zakres obserwowanych plików
    - Używaj słowników na żywo tylko wtedy, gdy są potrzebne aktualizacje w czasie rzeczywistym (np. testy A/B itp.)
-   - Upewnij się, że wtyczka transformacji podczas budowania (`@intlayer/swc` lub `@intlayer/babel`) jest włączona, aby zoptymalizować słownik podczas kompilacji
+   - Upewnij się, że wtyczka transformacji podczas budowania (build time) (`@intlayer/swc` lub `@intlayer/babel`) jest włączona, aby zoptymalizować słownik podczas kompilacji

package/docs/pl/dictionary/function_fetching.md

@@ -24,7 +24,7 @@ history:
 
 # Pobieranie funkcji
 
-Intlayer pozwala na deklarowanie funkcji zawartości w Twoich modułach zawartości, które mogą być zarówno synchroniczne, jak i asynchroniczne. Podczas budowania aplikacji Intlayer wykonuje te funkcje, aby uzyskać wynik funkcji. Wartość zwracana musi być obiektem JSON lub prostą wartością, taką jak string lub liczba.
+Intlayer pozwala na deklarowanie funkcji zawartości w Twoich modułach zawartości, które mogą być zarówno synchroniczne, jak i asynchroniczne. Podczas budowania (build time) aplikacji Intlayer wykonuje te funkcje, aby uzyskać wynik funkcji. Wartość zwracana musi być obiektem JSON lub prostą wartością, taką jak string lub liczba.
 
 > Uwaga: pobieranie funkcji jest obecnie niedostępne w deklaracjach zawartości JSON oraz w plikach zdalnych deklaracji zawartości.
 

package/docs/pl/how_works_intlayer.md

@@ -108,7 +108,7 @@ Po stronie edytora, edytor nasłuchuje tych wiadomości i symuluje rzeczywistą
 
 Aby zoptymalizować rozmiar paczki Twojej aplikacji, Intlayer dostarcza dwa wtyczki do optymalizacji budowania aplikacji: wtyczki `@intlayer/babel` oraz `@intlayer/swc`.
 
-Wtyczki Babel i SWC działają poprzez analizę Abstrakcyjnego Drzewa Składni (AST) Twojej aplikacji, aby zastąpić wywołania funkcji Intlayer zoptymalizowanym kodem. Proces ten sprawia, że ostateczny pakiet jest lżejszy w produkcji, zapewniając importowanie tylko tych słowników, które są faktycznie używane, optymalizując podział na części i zmniejszając rozmiar pakietu.
+Wtyczki Babel i SWC działają poprzez analizę Abstrakcyjnego Drzewa Składni (AST) Twojej aplikacji, aby zastąpić wywołania funkcji Intlayer zoptymalizowanym kodem. Proces ten sprawia, że ostateczny pakiet jest lżejszy w produkcji, zapewniając importowanie tylko tych słowników, które są faktycznie używane, optymalizując podział na części i zmniejszając rozmiar bundle'a.
 
 W trybie deweloperskim Intlayer używa scentralizowanego statycznego importu słowników, aby uprościć proces tworzenia aplikacji.