@intlayer/docs 8.9.8 → 8.10.0-canary.0

package/docs/nl/custom_domains.md

@@ -34,8 +34,8 @@ De `domains`-map in `routing` koppelt elke locale aan een hostname. Intlayer geb
 
 Het belangrijkste onderscheid is **exclusiviteit**:
 
-- **Exclusief domein** — er is slechts één locale aan die hostname gekoppeld (bijv. `zh → intlayer.zh`). Het domein zelf identificeert de locale, dus er wordt geen locale-prefix aan het pad toegevoegd. `https://intlayer.zh/about` bedient Chinese inhoud.
-- **Gedeeld domein** — er zijn meerdere locales aan dezelfde hostname gekoppeld (bijv. zowel `en` als `fr` zijn gekoppeld aan `intlayer.org`). Normale prefixgebaseerde routing is van toepassing. `intlayer.org/fr/about` bedient Franse inhoud.
+- **Exclusief domein** - er is slechts één locale aan die hostname gekoppeld (bijv. `zh → intlayer.zh`). Het domein zelf identificeert de locale, dus er wordt geen locale-prefix aan het pad toegevoegd. `https://intlayer.zh/about` bedient Chinese inhoud.
+- **Gedeeld domein** - er zijn meerdere locales aan dezelfde hostname gekoppeld (bijv. zowel `en` als `fr` zijn gekoppeld aan `intlayer.org`). Normale prefixgebaseerde routing is van toepassing. `intlayer.org/fr/about` bedient Franse inhoud.
 
 ## Configuratie
 
@@ -55,9 +55,9 @@ const config: IntlayerConfig = {
   routing: {
     mode: "prefix-no-default",
     domains: {
-      // Gedeeld domein — en en fr gebruiken prefix-routing op intlayer.org
+      // Gedeeld domein - en en fr gebruiken prefix-routing op intlayer.org
       en: "intlayer.org",
-      // Exclusief domein — zh heeft een eigen hostname, geen /zh/-prefix nodig
+      // Exclusief domein - zh heeft een eigen hostname, geen /zh/-prefix nodig
       zh: "intlayer.zh",
     },
   },
@@ -96,7 +96,7 @@ getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.org" });
 ```ts
 // Huidige pagina: intlayer.zh/about
 getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.zh" });
-// → "/about"  (al op het juiste domein — relatieve URL)
+// → "/about"  (al op het juiste domein - relatieve URL)
 
 getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 // → "https://intlayer.org/fr/about"  (domeinoverschrijdende link terug naar intlayer.org)
@@ -108,14 +108,14 @@ getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 
 1. De hostname van een absolute input-URL (bijv. `https://intlayer.org/about` → `intlayer.org`).
 2. `window.location.hostname` in browseromgevingen.
-3. Als geen van beide beschikbaar is (SSR zonder expliciete optie), wordt een relatieve URL geretourneerd voor locales op hetzelfde domein en wordt er geen absolute URL gegenereerd — dit is de veilige fallback.
+3. Als geen van beide beschikbaar is (SSR zonder expliciete optie), wordt een relatieve URL geretourneerd voor locales op hetzelfde domein en wordt er geen absolute URL gegenereerd - dit is de veilige fallback.
 
 ```ts
-// Browser — window.location.hostname === 'intlayer.org'
+// Browser - window.location.hostname === 'intlayer.org'
 getLocalizedUrl("/about", "zh");
 // → "https://intlayer.zh/about"  (automatisch gedetecteerd door window)
 
-// Vanaf een absolute URL — domein automatisch gedetecteerd
+// Vanaf een absolute URL - domein automatisch gedetecteerd
 getLocalizedUrl("https://intlayer.org/about", "zh");
 // → "https://intlayer.zh/about"
 ```
@@ -151,14 +151,14 @@ export const config = {
 };
 ```
 
-**Redirect** — verzoek komt binnen op het verkeerde domein voor een gegeven locale-prefix:
+**Redirect** - verzoek komt binnen op het verkeerde domein voor een gegeven locale-prefix:
 
 ```
 GET intlayer.org/zh/about
 → 301 https://intlayer.zh/about
 ```
 
-**Rewrite** — verzoek komt binnen op het exclusieve domein van de locale zonder prefix:
+**Rewrite** - verzoek komt binnen op het exclusieve domein van de locale zonder prefix:
 
 ```
 GET intlayer.zh/about
@@ -209,7 +209,7 @@ export const LocaleSwitcher = () => {
 };
 ```
 
-Er is geen extra configuratie vereist — `useLocale` detecteert intern `window.location.hostname` en beslist tussen `router.replace` (hetzelfde domein) en `window.location.href` (ander domein).
+Er is geen extra configuratie vereist - `useLocale` detecteert intern `window.location.hostname` en beslist tussen `router.replace` (hetzelfde domein) en `window.location.href` (ander domein).
 
 ## SEO: `hreflang` alternatieve links
 

package/docs/nl/intlayer_with_storybook.md

@@ -2,7 +2,7 @@
 createdAt: 2026-03-20
 updatedAt: 2026-05-06
 title: Intlayer instellen met Storybook
-description: Leer hoe u uw designsysteem meertalig kunt maken met Intlayer en Storybook — compileer inhoudsdeclaraties, voeg een taalschakelaar toe en bekijk uw componenten in elke gewenste taal.
+description: Leer hoe u uw designsysteem meertalig kunt maken met Intlayer en Storybook - compileer inhoudsdeclaraties, voeg een taalschakelaar toe en bekijk uw componenten in elke gewenste taal.
 keywords:
   - Internationalisering
   - Documentatie
@@ -33,7 +33,7 @@ history:
 
 ## Wat is Intlayer?
 
-**Intlayer** is een innovatieve, open-source internationaliseringsbibliotheek (i18n) die is ontworpen om meertalige ondersteuning in moderne webapplicaties te vereenvoudigen. Het werkt op **componentniveau** — elke component beheert zijn eigen inhoudsdeclaraties — waardoor vertalingen samen met de code worden bewaard die ze gebruikt.
+**Intlayer** is een innovatieve, open-source internationaliseringsbibliotheek (i18n) die is ontworpen om meertalige ondersteuning in moderne webapplicaties te vereenvoudigen. Het werkt op **componentniveau** - elke component beheert zijn eigen inhoudsdeclaraties - waardoor vertalingen samen met de code worden bewaard die ze gebruikt.
 
 Met Intlayer kunt u:
 
@@ -83,9 +83,9 @@ bun add vite-intlayer --dev
 
 | Pakket           | Rol                                                            |
 | ---------------- | -------------------------------------------------------------- |
-| `intlayer`       | Core — configuratie, inhoudscompilatie, CLI                    |
-| `react-intlayer` | React-bindingen — `IntlayerProvider`, `useIntlayer` hook       |
-| `vite-intlayer`  | Vite-plugin — bewaakt en compileert inhoudsdeclaratiebestanden |
+| `intlayer`       | Core - configuratie, inhoudscompilatie, CLI                    |
+| `react-intlayer` | React-bindingen - `IntlayerProvider`, `useIntlayer` hook       |
+| `vite-intlayer`  | Vite-plugin - bewaakt en compileert inhoudsdeclaratiebestanden |
 
 ---
 
@@ -291,7 +291,7 @@ export default config;
 
 ### Stap 4: De `IntlayerProvider` decorator en een locale-werkbalk toevoegen
 
-Hetzelfde als de Vite-instelling — voeg de decorator en het globale locale-type toe in `.storybook/preview.tsx`:
+Hetzelfde als de Vite-instelling - voeg de decorator en het globale locale-type toe in `.storybook/preview.tsx`:
 
 ```tsx fileName=".storybook/preview.tsx" codeFormat="typescript"
 import type { Preview, StoryContext } from "@storybook/react";
@@ -411,7 +411,7 @@ const meta: Meta<typeof CopyButton> = {
 export default meta;
 type Story = StoryObj<typeof CopyButton>;
 
-/** Default story — wissel van taal in de werkbalk om vertalingen te bekijken. */
+/** Default story - wissel van taal in de werkbalk om vertalingen te bekijken. */
 export const Default: Story = {
   args: {
     content: "npm install intlayer react-intlayer",

package/docs/nl/intlayer_with_vanilla.md

@@ -34,7 +34,7 @@ history:
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-vanilla-template?file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox — Intlayer"
+  title="Demo CodeSandbox - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -45,7 +45,7 @@ history:
 <iframe
   src="https://intlayer-vanilla-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo — intlayer-vanilla-template"
+  title="Demo - intlayer-vanilla-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/nl/intlayer_with_vite+lit.md

@@ -45,7 +45,7 @@ history:
 <iframe
   src="https://intlayer-vite-lit-template.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo — intlayer-vite-lit-template"
+  title="Demo - intlayer-vite-lit-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -263,7 +263,7 @@ export default appContent;
 
 ### Stap 6: Gebruik Intlayer in je LitElement
 
-Gebruik `useIntlayer` binnen een `LitElement`. Het retourneert een `ReactiveController`-proxy die automatisch herrenders activeert wanneer de actieve taal verandert — er is geen extra configuratie vereist.
+Gebruik `useIntlayer` binnen een `LitElement`. Het retourneert een `ReactiveController`-proxy die automatisch herrenders activeert wanneer de actieve taal verandert - er is geen extra configuratie vereist.
 
 ```typescript fileName="src/my-element.ts" codeFormat="typescript"
 import { LitElement, html } from "lit";

package/docs/nl/intlayer_with_vite+vanilla.md

@@ -35,7 +35,7 @@ history:
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-vite-vanilla-template?file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox — Intlayer"
+  title="Demo CodeSandbox - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-vite-vanilla.vercel.app"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo — intlayer-vite-vanilla-template"
+  title="Demo - intlayer-vite-vanilla-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -255,7 +255,7 @@ export default appContent;
 
 ### Stap 6: Gebruik Intlayer in uw JavaScript
 
-`vanilla-intlayer` spiegelt de `react-intlayer` surface API: `useIntlayer(key, locale?)` retourneert de vertaalde inhoud rechtstreeks. Koppel `.onChange()` aan het resultaat om u te abonneren op taalveranderingen — het expliciete equivalent van een React re-render.
+`vanilla-intlayer` spiegelt de `react-intlayer` surface API: `useIntlayer(key, locale?)` retourneert de vertaalde inhoud rechtstreeks. Koppel `.onChange()` aan het resultaat om u te abonneren op taalveranderingen - het expliciete equivalent van een React re-render.
 
 ```typescript fileName="src/main.ts" codeFormat="typescript"
 import { installIntlayer, useIntlayer } from "vanilla-intlayer";
@@ -456,7 +456,7 @@ const unsubscribe = useDictionaryDynamic(
 });
 ```
 
-> De bundel van elke taal wordt alleen opgehaald wanneer die taal actief wordt en het resultaat wordt in de cache opgeslagen — volgende overschakelingen naar dezelfde taal zijn onmiddellijk.
+> De bundel van elke taal wordt alleen opgehaald wanneer die taal actief wordt en het resultaat wordt in de cache opgeslagen - volgende overschakelingen naar dezelfde taal zijn onmiddellijk.
 
 ### (Optioneel) Stap 13: De inhoud van uw componenten extraheren
 

package/docs/pl/agent_skills.md

@@ -76,7 +76,7 @@ npx skills add aymericzip/intlayer-skills
 
 **intlayer-content**
 
-- Uczy agenta, jak korzystać z zaawansowanych węzłów treści — takich jak liczba mnoga, warunki i markdown — w celu tworzenia bogatych, dynamicznych i zlokalizowanych słowników.
+- Uczy agenta, jak korzystać z zaawansowanych węzłów treści - takich jak liczba mnoga, warunki i markdown - w celu tworzenia bogatych, dynamicznych i zlokalizowanych słowników.
 
 **intlayer-next-js**
 
@@ -108,7 +108,7 @@ npx skills add aymericzip/intlayer-skills
 
 **intlayer-vue**
 
-- Wyposaża agenta we wzorce specyficzne dla Vue — w tym Composable i wsparcie dla Nuxt — w celu budowania nowoczesnych, zlokalizowanych aplikacji internetowych.
+- Wyposaża agenta we wzorce specyficzne dla Vue - w tym Composable i wsparcie dla Nuxt - w celu budowania nowoczesnych, zlokalizowanych aplikacji internetowych.
 
 **intlayer-compiler**
 

package/docs/pl/benchmark/nextjs.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: Najlepsze rozwiązanie i18n dla Next.js w 2026 r. - Raport Benchmark
 description: Porównaj biblioteki internacjonalizacji (i18n) dla Next.js, takie jak next-intl, next-i18next i Intlayer. Szczegółowy raport wydajności dotyczący rozmiaru pakietu, wycieków i reaktywności.
 keywords:
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Dodaj porównanie gwiazdek GitHub"
   - version: 8.7.5
     date: 2026-01-06
     changes: "Inicjalizacja benchmarka"
 ---
 
-# Biblioteki i18n dla Next.js — Raport Benchmark 2026
+# Biblioteki i18n dla Next.js - Raport Benchmark 2026
 
 Ta strona to raport z benchmarku rozwiązań i18n w Next.js.
 
@@ -57,7 +60,7 @@ Jako przykład: w najgorszych przypadkach, po internacjonalizacji Twoja strona m
 
 Innym skutkiem bibliotek i18n jest wolniejszy rozwój. Przekształcanie komponentów w wielojęzyczne treści w wielu językach jest czasochłonne.
 
-Ponieważ problem jest trudny, istnieje wiele rozwiązań — niektóre koncentrują się na DX (Developer Experience), inne na wydajności lub skalowalności itd.
+Ponieważ problem jest trudny, istnieje wiele rozwiązań - niektóre koncentrują się na DX (Developer Experience), inne na wydajności lub skalowalności itd.
 
 Intlayer stara się optymalizować we wszystkich tych wymiarach.
 
@@ -95,7 +98,7 @@ To, co dzieje się w czasie budowania (build time), to fakt, że Next.js generuj
 
 Jeśli używasz składni typu `const t = useTranslation()` + `t('moj-obiekt.moj-podobiekt.moj-klucz')`, cały plik JSON musi zazwyczaj znajdować się w pakiecie, aby biblioteka mogła go przeanalizować i rozwiązać klucz. Duża część tej treści jest wysyłana nawet wtedy, gdy nie jest używana na stronie.
 
-Aby to złagodzić, niektóre biblioteki proszą o zadeklarowanie na poziomie strony, które przestrzenie nazw należy załadować — np. `next-i18next`, `next-intl`, `lingui`, `next-translate`, `next-international`.
+Aby to złagodzić, niektóre biblioteki proszą o zadeklarowanie na poziomie strony, które przestrzenie nazw należy załadować - np. `next-i18next`, `next-intl`, `lingui`, `next-translate`, `next-international`.
 
 Z kolei `Paraglide` dodaje dodatkowy krok przed budowaniem, aby zamienić pliki JSON na proste symbole, takie jak `const en_my_var = () => 'moja wartosc'`. Teoretycznie umożliwia to usuwanie (tree-shaking) nieużywanej treści na stronie. Jak zobaczymy, ta metoda wciąż ma swoje wady.
 
@@ -150,7 +153,7 @@ Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla
 
 - **Ś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.
 
-- **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.
+- **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.
 
 - **Praca renderowania po zmianie języka**: Bardziej szczegółowa analiza: ile wysiłku kosztowało interfejs ponowne odrysowanie dla nowego języka po rozpoczęciu zmiany. Przydatne, gdy „odczuwalny” czas i koszt frameworka się różnią.
 
@@ -158,11 +161,17 @@ Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla
 
 - **Czas hydratacji (Hydration)**: Gdy aplikacja to udostępnia, ile czasu klient spędza na zamianie kodu HTML z serwera w coś, co można faktycznie kliknąć. Myślnik w tabelach oznacza, że dana implementacja nie dostarczyła wiarygodnej wartości hydratacji w tym benchmarku.
 
+## Gwiazdki na GitHubie
+
+Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=i18next%2Fnext-i18next%2Camannn%2Fnext-intl%2Clingui%2Fjs-lingui%2Cvinissimus%2Fnext-translate%2Cinostudio%2Fnext-international%2Copral%2paraglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#i18next/next-i18next&amannn/next-intl&lingui/js-lingui&vinissimus/next-translate&inostudio/next-international&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
+
 ## Szczegóły wyników
 
-### 1 — Rozwiązania, których należy unikać
+### 1 - Rozwiązania, których należy unikać
 
-Należy wyraźnie unikać niektórych rozwiązań, takich jak `gt-next` czy `lingo.dev`. Łączą one uzależnienie od dostawcy (vendor lock-in) z zaśmiecaniem bazy kodu. Mimo wielu godzin spędzonych na próbach ich wdrożenia, nigdy nie udało mi się sprawić, by działały poprawnie — ani w TanStack Start, ani w Next.js.
+Należy wyraźnie unikać niektórych rozwiązań, takich jak `gt-next` czy `lingo.dev`. Łączą one uzależnienie od dostawcy (vendor lock-in) z zaśmiecaniem bazy kodu. Mimo wielu godzin spędzonych na próbach ich wdrożenia, nigdy nie udało mi się sprawić, by działały poprawnie - ani w TanStack Start, ani w Next.js.
 
 Napotkane problemy:
 
@@ -176,12 +185,12 @@ Napotkane problemy:
 
 **(Lingo.dev)** (`@lingo.dev/compiler@0.4.0`):
 
-- Przekroczenie limitu AI, co całkowicie blokuje budowanie — nie można zatem wdrożyć aplikacji na produkcję bez płacenia.
+- 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.
 
-### 2 — Rozwiązania eksperymentalne
+### 2 - Rozwiązania eksperymentalne
 
 **(Wuchale)** (`wuchale@0.22.11`):
 
@@ -195,7 +204,7 @@ Wreszcie, w porównaniu z innymi rozwiązaniami, Paraglide nie używa magazynu (
 
 > Notatka o paraglide: rozwiązanie to wstrzykuje kod do Twojej bazy kodu w celu importu, w wyniku czego metryka 'rozmiar biblioteki' w raporcie benchmarka wynosi prawie 0. Generowanie kodu to dobra rzecz, ponieważ używana funkcja będzie zawierać tylko niezbędną logikę (wszystkie prefiksy vs brak prefiksów, ciasteczka vs storage itp.). Dla porównania, Intlayer wykonuje to filtrowanie poprzez wstrzykiwanie zmiennych środowiskowych w procesie budowania, aby wymusić na bundlerze usunięcie treści (tree-shake) 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.
 
-### 3 — Akceptowalne rozwiązania
+### 3 - Akceptowalne rozwiązania
 
 **(Tolgee)** (`@tolgee/react@7.0.0`):
 
@@ -219,7 +228,7 @@ Różnią się również formaty komunikatów: `next-intl` używa ICU MessageFor
 
 `Lingui` jest często chwalony. Osobiście uznałem, że proces `lingui extract` / `lingui compile` jest bardziej złożony niż w przypadku alternatyw, bez wyraźnej przewagi. Zauważyłem również niespójne składnie, które mylą AI (np. `t()`, `t''`, `i18n.t()`, `<Trans>`).
 
-### 4 — Rekomendacje
+### 4 - Rekomendacje
 
 **(Next Translate)** (`next-translate@3.1.2`):
 

package/docs/pl/benchmark/solid.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
-title: Najlepsze rozwiązanie i18n dla Solid w 2026 r. — raport z benchmarku
+updatedAt: 2026-05-18
+title: Najlepsze rozwiązanie i18n dla Solid w 2026 r. - raport z benchmarku
 description: Porównaj biblioteki internacjonalizacji (i18n) dla Solid, takie jak solid-primitives, solid-i18next i Intlayer. Szczegółowy raport wydajności dotyczący rozmiaru paczki, wycieków i reaktywności.
 keywords:
   - benchmark
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-solid-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Dodaj porównanie gwiazdek GitHub"
   - version: 8.7.12
     date: 2026-01-06
     changes: "Inicjalizacja benchmarku"
 ---
 
-# Biblioteki i18n dla Solid — raport z benchmarku 2026
+# Biblioteki i18n dla Solid - raport z benchmarku 2026
 
 Ta strona zawiera raport z benchmarku rozwiązań i18n dla Solid.
 
@@ -115,13 +118,19 @@ Porównaliśmy **cztery strategie ładowania**:
 - **Scoped static**: Utrzymuje porządek w kodzie (logiczna separacja) bez skomplikowanych dodatkowych zapytań sieciowych.
 - **Scoped dynamic**: Najlepsze podejście dla _code splittingu_ i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
 
+## Gwiazdki na GitHubie
+
+Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=solidjs-community%2Fsolid-primitives%2Cmbarzda%2Fsolid-i18next%2Copral%2paraglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#solidjs-community/solid-primitives&mbarzda/solid-i18next&opral/paraglide-js&aymericzip/intlayer)
+
 ## Wyniki szczegółowe
 
-### 1 — Rozwiązania, których należy unikać
+### 1 - Rozwiązania, których należy unikać
 
 > W ekosystemie Solid nie ma jednoznacznego rozwiązania, którego należy unikać.
 
-### 2 — Rozwiązania akceptowalne
+### 2 - Rozwiązania akceptowalne
 
 **(solid-i18next)** (`solid-i18next@17.0.2`):
 
@@ -142,7 +151,7 @@ Brakuje mu również lazy loadingu i scopingu przestrzeni nazw w celu optymaliza
 Osobiście nie lubię konieczności regeneracji plików JS przed każdym pushem, co stwarza ciągłe ryzyko konfliktów przy mergowaniu poprzez PR-y.
 Wreszcie, w porównaniu z innymi rozwiązaniami, Paraglide nie używa store'a (np. Solid signal) 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.
 
-### 3 — Rekomendacje
+### 3 - Rekomendacje
 
 **(Intlayer)** (`solid-intlayer@8.7.12`):
 

package/docs/pl/benchmark/svelte.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
-title: Najlepsze rozwiązanie i18n dla Svelte w 2026 r. — raport z benchmarku
+updatedAt: 2026-05-18
+title: Najlepsze rozwiązanie i18n dla Svelte w 2026 r. - raport z benchmarku
 description: Porównaj biblioteki internacjonalizacji (i18n) dla Svelte, takie jak svelte-i18n, Paraglide i Intlayer. Szczegółowy raport wydajności dotyczący rozmiaru paczki, wycieków i reaktywności.
 keywords:
   - benchmark
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-svelte-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Dodaj porównanie gwiazdek GitHub"
   - version: 8.7.12
     date: 2026-01-06
     changes: "Inicjalizacja benchmarku"
 ---
 
-# Biblioteki i18n dla Svelte — raport z benchmarku 2026
+# Biblioteki i18n dla Svelte - raport z benchmarku 2026
 
 Ta strona zawiera raport z benchmarku rozwiązań i18n dla Svelte.
 
@@ -113,13 +116,19 @@ Porównaliśmy **cztery strategie ładowania**:
 - **Scoped static**: Utrzymuje porządek w kodzie (logiczna separacja) bez skomplikowanych dodatkowych zapytań sieciowych.
 - **Scoped dynamic**: Najlepsze podejście dla _code splittingu_ i wydajności. Minimalizuje zużycie pamięci, ładując tylko to, czego potrzebuje bieżący widok i aktywna lokalizacja.
 
+## Gwiazdki na GitHubie
+
+Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=kaisermann%2Fsvelte-i18n%2Copral%2paraglide-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#kaisermann/svelte-i18n&opral/paraglide-js&aymericzip/intlayer)
+
 ## Wyniki szczegółowe
 
-### 1 — Rozwiązania, których należy unikać
+### 1 - Rozwiązania, których należy unikać
 
 > W ekosystemie Svelte nie ma jednoznacznego rozwiązania, którego należy unikać.
 
-### 2 — Rozwiązania akceptowalne
+### 2 - Rozwiązania akceptowalne
 
 **(Paraglide)** (`@inlang/paraglide-js@2.17.0`):
 
@@ -135,7 +144,7 @@ Wreszcie, w porównaniu z innymi rozwiązaniami, Paraglide nie używa store'a (n
 
 To rozwiązanie odpowiada na wszystkie potrzeby i18n w projekcie Svelte. Ale podobnie jak w przypadku i18next lub innych głównych rozwiązań i18n, jest ono nieco ciężkie (~15.9kb, co stanowi około 7x `svelte-intlayer`).
 
-### 3 — Rekomendacje
+### 3 - Rekomendacje
 
 **(Intlayer)** (`svelte-intlayer@8.7.12`):
 

package/docs/pl/benchmark/tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: Najlepsze rozwiązanie i18n dla TanStack Start w 2026 r. - Raport Benchmark
 description: Porównaj biblioteki internacjonalizacji dla TanStack Start, takie jak react-i18next, use-intl i Intlayer. Szczegółowy raport wydajności dotyczący rozmiaru pakietu, wycieków i reaktywności.
 keywords:
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-tanstack-start-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Dodaj porównanie gwiazdek GitHub"
   - version: 8.7.5
     date: 2026-01-06
     changes: "Inicjalizacja benchmarka"
 ---
 
-# Biblioteki i18n dla TanStack Start — Raport Benchmark 2026
+# Biblioteki i18n dla TanStack Start - Raport Benchmark 2026
 
 Ta strona to raport z benchmarku rozwiązań i18n w TanStack Start.
 
@@ -121,9 +124,15 @@ Porównaliśmy **cztery strategie ładowania**:
 - **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.
 
+## Gwiazdki na GitHubie
+
+Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=formatjs%2Fformatjs%2Ci18next%2Freact-i18next%2Clingui%2Fjs-lingui%2Camannn%2Fnext-intl%2Copral%2paraglide-js%2Ctolgee%2Ftolgee-js%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#formatjs/formatjs&i18next/react-i18next&lingui/js-lingui&amannn/next-intl&opral/paraglide-js&tolgee/tolgee-js&aymericzip/intlayer)
+
 ## Szczegóły wyników
 
-### 1 — Rozwiązania, których należy unikać
+### 1 - Rozwiązania, których należy unikać
 
 Należy wyraźnie unikać niektórych rozwiązań, takich jak `gt-react` czy `lingo.dev`. Łączą one uzależnienie od dostawcy z zaśmiecaniem bazy kodu. Co gorsza: mimo wielu godzin spędzonych na próbach ich wdrożenia, nigdy nie udało mi się sprawić, by działały poprawnie w TanStack Start (podobnie jak w przypadku `gt-next` w Next.js).
 
@@ -145,13 +154,13 @@ Napotkane problemy:
 - 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.
 - 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
+### 2 - Rozwiązania eksperymentalne
 
 **(Wuchale)** (`wuchale@0.22.11`):
 
 Idea stojąca za `Wuchale` jest interesująca, ale nie jest to jeszcze opłacalne rozwiązanie. Napotkałem problemy z reaktywnością tej biblioteki i musiałem wymusić ponowne renderowanie dostawcy, aby aplikacja działała w TanStack Start. Dokumentacja jest również dość niejasna, co utrudnia wdrożenie.
 
-### 3 — Akceptowalne rozwiązania
+### 3 - Akceptowalne rozwiązania
 
 **(Paraglide)** (`@inlang/paraglide-js@2.15.1`):
 
@@ -177,7 +186,7 @@ W TanStack Start unikasz pułapek specyficznych dla Next.js (`setRequestLocale`,
 
 Mimo to ma on te same główne wady co stosy zbudowane na `t('a.b.c')`: optymalizacje są możliwe, ale bardzo czasochłonne, a duże projekty niosą ze sobą ryzyko wpadnięcia w złe praktyki (przestrzenie nazw + ładowanie dynamiczne + typy).
 
-Różnią się również formaty komunikatów: `use-intl` używa ICU MessageFormat, podczas gdy `i18next` używa własnego formatu — co komplikuje narzędzia lub migracje, jeśli się je miesza.
+Różnią się również formaty komunikatów: `use-intl` używa ICU MessageFormat, podczas gdy `i18next` używa własnego formatu - co komplikuje narzędzia lub migracje, jeśli się je miesza.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
 
@@ -187,7 +196,7 @@ Różnią się również formaty komunikatów: `use-intl` używa ICU MessageForm
 
 `react-intl` to wydajna implementacja zespołu Format.js. DX pozostaje rozwlekły: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` dodaje złożoność, dodatkową pracę JavaScript i wiąże globalną instancję i18n z wieloma węzłami w drzewie React.
 
-### 4 — Rekomendacje
+### 4 - Rekomendacje
 
 Ten benchmark TanStack Start nie ma bezpośredniego odpowiednika `next-translate` (wtyczka Next.js + `getStaticProps`). Dla zespołów, które naprawdę chcą API `t()` z dojrzałym ekosystemem, `react-i18next` i `use-intl` pozostają „rozsądnymi” wyborami, ale przygotuj się na zainwestowanie dużej ilości czasu w optymalizację, aby uniknąć wycieków.
 

package/docs/pl/benchmark/vue.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
-title: Najlepsze rozwiązanie i18n dla Vue w 2026 r. — raport z benchmarku
+updatedAt: 2026-05-18
+title: Najlepsze rozwiązanie i18n dla Vue w 2026 r. - raport z benchmarku
 description: Porównaj biblioteki internacjonalizacji (i18n) dla Vue, takie jak vue-i18n, fluent-vue i Intlayer. Szczegółowy raport wydajności dotyczący rozmiaru paczki, wycieków i reaktywności.
 keywords:
   - benchmark
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "Dodaj porównanie gwiazdek GitHub"
   - version: 8.7.12
     date: 2026-01-06
     changes: "Inicjalizacja benchmarku"
 ---
 
-# Biblioteki i18n dla Vue — raport z benchmarku 2026
+# Biblioteki i18n dla Vue - raport z benchmarku 2026
 
 Ta strona zawiera raport z benchmarku rozwiązań i18n dla Vue.
 
@@ -127,7 +130,7 @@ Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla
 
 - **Średni rozmiar paczki komponentu**: Typowe elementy interfejsu użytkownika są mierzone **pojedynczo**, zamiast ukrywać się w gigantycznej liczbie dla całej aplikacji. Pokazuje to, czy internacjonalizacja po cichu nadyma codzienne komponenty. Na przykład, jeśli Twój komponent renderuje się ponownie, załaduje wszystkie te dane z pamięci. Dołączanie gigantycznego JSON-a do dowolnego komponentu jest jak podłączanie dużego magazynu nieużywanych danych, co spowolni wydajność Twoich komponentów.
 
-- **Reaktywność przełączania języka**: Przełączam język za pomocą własnego sterowania aplikacji i mierzę czas, aż strona wyraźnie się przełączy — co zauważyłby odwiedzający.
+- **Reaktywność przełączania języka**: Przełączam język za pomocą własnego sterowania aplikacji i mierzę czas, aż strona wyraźnie się przełączy - co zauważyłby odwiedzający.
 
 - **Praca renderowania po zmianie języka**: Bardziej szczegółowe badanie: ile wysiłku interfejs włożył w ponowne odrysowanie dla nowego języka po rozpoczęciu zmiany. Przydatne, gdy „odczuwalny” czas i koszt frameworka się rozbiegają.
 
@@ -135,13 +138,19 @@ Uruchomiłem tę samą wielojęzyczną aplikację w prawdziwej przeglądarce dla
 
 - **Czas hydratacji (Hydration)**: Czas, jaki klient spędza na przekształcaniu HTML z serwera w interaktywny interfejs. Myślnik w tabelach oznacza, że ta implementacja nie dostarczyła wiarygodnej liczby dotyczącej hydratacji w tym benchmarku.
 
+## Gwiazdki na GitHubie
+
+Gwiazdki na GitHubie są silnym wskaźnikiem popularności projektu, zaufania społeczności i długoterminowego znaczenia. Choć nie są bezpośrednią miarą jakości technicznej, odzwierciedlają, ilu programistów uważa projekt za przydatny, śledzi jego postępy i prawdopodobnie go przyjmie. Przy szacowaniu wartości projektu gwiazdki pomagają porównać zainteresowanie alternatywami i dostarczają wglądu w rozwój ekosystemu.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&aymericzip/intlayer)
+
 ## Wyniki szczegółowe
 
-### 1 — Rozwiązania, których należy unikać
+### 1 - Rozwiązania, których należy unikać
 
 > W ekosystemie Vue nie ma jednoznacznego rozwiązania, którego należy unikać.
 
-### 2 — Rozwiązania akceptowalne
+### 2 - Rozwiązania akceptowalne
 
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
@@ -153,7 +162,7 @@ Paczka jest bardzo ciężka (~24.3kb, co stanowi około 9x `vue-intlayer`).
 
 - **fluent-vue** oferuje próbę innowacji poprzez format .ftl. Organizacja komunikatów jest świetna, łatwiej zacząć. Ale w praktyce brak bezpieczeństwa typów zwiększa ryzyko błędu, a debugowanie może szybko stać się czasochłonne. Co więcej, to rozwiązanie ładuje komunikaty za pomocą wtyczki vite, która wymusza ładowanie całej treści we wszystkich językach na każdej stronie. Dodatkowo jest to ekstremalnie ciężkie rozwiązanie (~92.7kb, co stanowi około 34x `vue-intlayer`).
 
-### 3 — Rekomendacje
+### 3 - Rekomendacje
 
 **(Intlayer)** (`vue-intlayer@8.7.12`):