@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/pl/packages/svelte-intlayer/usePathname.md

@@ -0,0 +1,103 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Dokumentacja funkcji usePathname | svelte-intlayer
+description: Dowiedz się, jak korzystać z funkcji usePathname w pakiecie svelte-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internacjonalizacja
+  - Dokumentacja
+  - Svelte
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - svelte-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodano narzędzie usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inicjalizacja historii"
+author: aymericzip
+---
+
+# Integracja ze Svelte: Dokumentacja `usePathname`
+
+Funkcja `usePathname` zwraca bieżącą ścieżkę przeglądarki (pathname) z usuniętym segmentem locale jako `Readable<string>` ze Svelte. Jest to przydatne do budowania nawigacji uwzględniającej locale — na przykład określania, który element nawigacji jest aktywny — bez konieczności ręcznego usuwania prefiksu locale.
+
+## Importowanie `usePathname` w Svelte
+
+```typescript
+import { usePathname } from "svelte-intlayer";
+```
+
+## Przegląd
+
+`usePathname` tworzy store w Svelte w trybie tylko do odczytu (readable store), który odczytuje `window.location.pathname`, usuwa prefiks locale za pomocą `getPathWithoutLocale` i emituje nową wartość za każdym razem, gdy przeglądarka wywoła zdarzenie `popstate` (nawigacja wstecz/dalej). Subskrybuj przy użyciu składni `$` w komponentach.
+
+## Użycie
+
+```svelte fileName="src/components/NavItem.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  export let href: string;
+  export let label: string;
+
+  const pathname = usePathname();
+</script>
+
+<a {href} aria-current={$pathname === href ? "page" : undefined}>
+  {label}
+</a>
+```
+
+## Zwracana wartość
+
+| Typ                | Opis                                                                                  |
+| ------------------ | ------------------------------------------------------------------------------------- |
+| `Readable<string>` | Readable store ze Svelte, zawierający bieżącą ścieżkę (pathname) bez prefiksu locale. |
+
+## Zachowanie
+
+- **Usuwanie locale**: Usuwa początkowy segment locale (np. `/pl/dashboard` → `/dashboard`).
+- **Reaktywność**: Emituje nową wartość po każdym zdarzeniu `popstate` (nawigacja w przeglądarce w tył/w przód).
+- **Bezpieczeństwo w SSR**: Zwraca `""`, gdy obiekt `window` nie jest dostępny.
+- **Czyszczenie (Cleanup)**: Nasłuchiwacz `popstate` jest automatycznie usuwany po odsubskrybowaniu ostatniego subskrybenta.
+
+## Przykład
+
+```svelte fileName="src/components/Sidebar.svelte"
+<script lang="ts">
+  import { usePathname } from "svelte-intlayer";
+
+  const links = [
+    { href: "/dashboard", label: "Panel sterowania" },
+    { href: "/settings", label: "Ustawienia" },
+  ];
+
+  const pathname = usePathname();
+</script>
+
+<nav>
+  {#each links as link}
+    <a
+      href={link.href}
+      style:font-weight={$pathname === link.href ? "bold" : "normal"}
+    >
+      {link.label}
+    </a>
+  {/each}
+</nav>
+```
+
+## Zobacz również
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/svelte-intlayer/useLocale.md) — bieżące locale + przełącznik locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getPathWithoutLocale.md) — bazowe narzędzie używane przez ten hook

package/docs/pl/packages/svelte-intlayer/useRewriteURL.md

@@ -15,6 +15,7 @@ slugs:
   - packages
   - svelte-intlayer
   - useRewriteURL
+author: aymericzip
 ---
 
 # Hook useRewriteURL

package/docs/pl/packages/vite-intlayer/exports.md

@@ -18,6 +18,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Ujednolicona dokumentacja dla wszystkich eksportów"
+author: aymericzip
 ---
 
 # Pakiet vite-intlayer

package/docs/pl/packages/vite-intlayer/intlayer.md

@@ -20,6 +20,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Inicjalizacja dokumentacji"
+author: aymericzip
 ---
 
 # Dokumentacja wtyczki Vite intlayer

package/docs/pl/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentacja wtyczki Vite intlayerCompiler | vite-intlayer
+description: Wtyczka Vite, która ekstrahuje wbudowane deklaracje zawartości Intlayer z plików komponentów i zapisuje je do plików JSON słownika w czasie budowania/transformacji.
+keywords:
+  - intlayerCompiler
+  - vite
+  - wtyczka
+  - kompilator
+  - zawartość
+  - słownik
+  - umiędzynarodowienie
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Zintegrowano z intlayer(); inicjalizacja dokumentacji"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` to wtyczka Vite, która skanuje pliki źródłowe komponentów w poszukiwaniu **wbudowanych deklaracji zawartości Intlayer** (inline declarations) — zawartości zdefiniowanej bezpośrednio w komponencie, a nie w osobnym pliku `.content.ts` — i zapisuje je do plików JSON słownika podczas fazy transformacji.
+
+> **Od Intlayer v9** `intlayerCompiler` jest automatycznie dołączany do głównej wtyczki [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayer.md), gdy zarówno `compiler.enabled` ma wartość `true`, jak i `compiler.output` jest ustawiony w konfiguracji Intlayer. Musisz go zarejestrować osobno tylko wtedy, gdy chcesz mieć pełną kontrolę nad konfiguracją specyficzną dla kompilatora.
+
+## Użycie
+
+### Jako część `intlayer()` (zalecane, v9+)
+
+Włącz kompilator w konfiguracji Intlayer:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // gdzie zapisywane są wyekstrahowane słowniki
+  },
+});
+```
+
+Następnie użyj standardowej wtyczki bez dodatkowej rejestracji:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### Samodzielnie (w razie potrzeby)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## Opcje
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| Opcja            | Typ                       | Opis                                                                                                |
+| ---------------- | ------------------------- | --------------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Nadpisania konfiguracji Intlayer przekazywane do `getConfiguration()`.                              |
+| `compilerConfig` | `Partial<CompilerConfig>` | Nadpisania sekcji konfiguracji specyficznej dla kompilatora (np. `enabled`, `output`, `filesList`). |
+
+### Przykład
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## Jak to działa
+
+### Faza transformacji
+
+Dla każdego pliku źródłowego, który pasuje do `compiler.filesList`, wtyczka kompilatora:
+
+1. Przekazuje zawartość pliku do `extractContent` z pakietu `@intlayer/babel`.
+2. Wywołuje `onExtract` dla każdej znalezionej deklaracji, co zapisuje wynikowy słownik JSON do ścieżki `compiler.output`.
+3. Zwraca przetransformowany kod źródłowy z wbudowanymi deklaracjami zastąpionymi standardowymi wywołaniami `useIntlayer('key')` / `getIntlayer('key')`.
+
+Obsługiwane typy plików: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`.
+
+### HMR (Hot Module Replacement)
+
+Gdy plik komponentu zostanie zapisany w trybie deweloperskim, kompilator:
+
+1. Wykrywa zmianę pliku za pomocą hooka `handleHotUpdate` w Vite.
+2. Ponownie ekstrahuje zawartość ze zaktualizowanego pliku.
+3. Zapisuje zaktualizowany słownik JSON.
+4. Wyzwala pełne przeładowanie strony (`server.ws.send({ type: 'full-reload' })`).
+
+Debounce o wartości 500 ms zapobiega zapętleniu ponownej ekstrakcji spowodowanemu przez sam zapis słownika (który również wyzwala zdarzenie zmiany pliku).
+
+### Deduplikacja
+
+`intlayerCompiler` używa tego samego mechanizmu deduplikacji `createPrimaryInstanceGuard` co inne wbudowane wtyczki. Gdy obecne są zarówno `intlayer()` (który zawiera kompilator), jak i ręczne wywołanie `intlayerCompiler()`, uruchamiana jest tylko pierwsza zarejestrowana instancja — żadne słowniki nie są zapisywane dwukrotnie.

package/docs/pl/packages/vite-intlayer/intlayerMinify.md

@@ -0,0 +1,92 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentacja wtyczki Vite intlayerMinify | vite-intlayer
+description: Wtyczka Vite, która minifikuje skompilowane pliki JSON słownika Intlayer i opcjonalnie maskuje nazwy pól zawartości w celu zmniejszenia rozmiaru pakietu.
+keywords:
+  - intlayerMinify
+  - vite
+  - wtyczka
+  - minifikacja
+  - rozmiar pakietu
+  - słownik
+  - umiędzynarodowienie
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerMinify
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Inicjalizacja dokumentacji"
+author: aymericzip
+---
+
+# intlayerMinify
+
+`intlayerMinify` to wtyczka Vite, która minifikuje skompilowane pliki JSON słowników podczas kompilacji produkcyjnej. Usuwa wszystkie niepotrzebne białe znaki i, w połączeniu z `intlayerPrune`, opcjonalnie zmienia nazwy pól zawartości na krótkie alfabetyczne aliasy (`a`, `b`, `c`, …), aby jeszcze bardziej zmniejszyć rozmiar pakietu (bundle'a).
+
+> Ta wtyczka jest automatycznie dołączana i konfigurowana, gdy używasz wtyczki [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayer.md). Musisz ją zarejestrować ręcznie tylko wtedy, gdy samodzielnie tworzysz stos wtyczek.
+
+## Użycie
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerMinify, intlayerPrune } from "vite-intlayer";
+import { createPruneContext } from "@intlayer/babel";
+
+const pruneContext = createPruneContext();
+
+export default defineConfig({
+  plugins: [
+    intlayerPrune(intlayerConfig, pruneContext),
+    intlayerMinify(intlayerConfig, pruneContext),
+  ],
+});
+```
+
+## Warunki aktywacji
+
+`intlayerMinify` jest aktywna **tylko** wtedy, gdy spełnione są wszystkie trzy poniższe warunki:
+
+1. Polecenie Vite to `build` (nie `serve` / dev).
+2. Opcja `build.optimize` ma wartość `true` (lub `undefined`, co dla kompilacji domyślnie oznacza `true`).
+3. Opcja `build.minify` w konfiguracji Intlayer ma wartość `true`.
+
+Wtyczka jest automatycznie **wyłączana**, gdy `editor.enabled` ma wartość `true`, ponieważ edytor wymaga pełnej, czytelnej dla człowieka zawartości słownika.
+
+## Co podlega minifikacji
+
+Wtyczka kieruje swoje działanie na dwie lokalizacje słowników (rozpoznane na podstawie `intlayer.system`):
+
+- `dictionariesDir` — statyczne słowniki dla wszystkich języków (np. `.intlayer/dictionaries/*.json`)
+- `dynamicDictionariesDir` — dynamiczne słowniki dla poszczególnych języków
+
+> Słowniki w trybie pobierania (`fetchDictionariesDir`) **nigdy** nie są minifikowane, ponieważ są serwowane z zewnętrznego API w czasie rzeczywistym przy użyciu ich oryginalnych nazw pól. Zmiana nazw pól stworzyłaby niezgodność między odpowiedzią serwera a dostępem do właściwości po stronie klienta.
+
+## Maskowanie nazw pól (minifikacja właściwości)
+
+Gdy wtyczka `intlayerPrune` przeanalizuje bazę kodu i uzupełni `pruneContext.dictionaryKeyToFieldRenameMap`, wtyczka `intlayerMinify` również zmienia nazwy pól zawartości na krótkie aliasy. Na przykład:
+
+```json
+// przed
+{ "key": "myDict", "content": { "title": "Hello", "description": "World" } }
+
+// po (z maskowaniem)
+{ "key": "myDict", "content": { "a": "Hello", "b": "World" } }
+```
+
+Odpowiednie odwołania do właściwości w plikach źródłowych są zmieniane przez przebieg Babel wewnątrz `intlayerOptimize`, więc zachowanie w czasie rzeczywistym pozostaje niezmienione.
+
+Wewnętrzne pola Intlayer (`nodeType`, `translation` itp.) nigdy nie zmieniają nazw.
+
+## Słowniki z przypadkami brzegowymi
+
+Słowniki oznaczone w `pruneContext.dictionariesWithEdgeCases` (anomalie strukturalne wykryte podczas fazy oczyszczania/prune) są całkowicie pomijane — nie są minifikowane ani maskowane — aby uniknąć dostarczenia uszkodzonych danych.
+
+## Grupy kwalifikowane (kolekcje / warianty / metarekordy)
+
+W przypadku słowników z tablicą `qualifierTypes` (kolekcje, warianty i metarekordy), wtyczka zachowuje tablicę `qualifierTypes` oraz mapę poboczną `meta` w oryginalnej formie. Maskowane są tylko nazwy pól wewnątrz wpisów `content`. Złożone klucze (używane do dopasowywania selektorów w czasie rzeczywistym) nigdy nie są modyfikowane.

package/docs/pl/packages/vite-intlayer/intlayerProxy.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: Dokumentacja wtyczki Vite intlayerProxy | vite-intlayer
+description: Oprogramowanie pośredniczące (middleware) do routingu języków dla serwerów deweloperskich i podglądu Vite oraz produkcyjnego SSR. Obsługuje wykrywanie języka, przekierowania URL i wewnętrzne przepisywanie ścieżek.
+keywords:
+  - intlayerProxy
+  - vite
+  - wtyczka
+  - middleware
+  - język
+  - routing
+  - umiędzynarodowienie
+  - i18n
+  - SSR
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerProxy
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Scalono configOptions w jeden obiekt opcji; proxy jest wbudowane w intlayer()"
+author: aymericzip
+---
+
+# intlayerProxy
+
+`intlayerProxy` to wtyczka Vite, która rejestruje oprogramowanie pośredniczące (middleware) do routingu języków dla **każdego środowiska**: serwera deweloperskiego, serwera podglądu i produkcyjnego SSR (Nitro / TanStack Start).
+
+> **Od Intlayer v9** `intlayerProxy` jest automatycznie dołączany do głównej wtyczki [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vite-intlayer/intlayer.md) i domyślnie włączony poprzez `routing.enableProxy: true`. Musisz go zarejestrować osobno tylko wtedy, gdy potrzebujesz kontroli na niższym poziomie lub używasz go poza standardową konfiguracją `intlayer()`.
+
+## Użycie
+
+### Jako część `intlayer()` (zalecane, v9+)
+
+Przekaż opcje `proxy` do głównej wtyczki zamiast rejestrować `intlayerProxy` osobno:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
+### Samodzielnie (w razie potrzeby)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+## Opcje
+
+```ts
+import type { IntlayerProxyPluginOptions } from "vite-intlayer";
+```
+
+Wszystkie opcje są opcjonalne i przekazywane jako pojedynczy obiekt:
+
+| Opcja           | Typ                                 | Opis                                                                                                                                                                     |
+| --------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `ignore`        | `(req: IncomingMessage) => boolean` | Predykat wykluczający żądania z routingu języków. Zwróć `true`, aby pominąć żądanie (np. ścieżki API, testy kondycji/health checki).                                     |
+| `configOptions` | `GetConfigurationOptions`           | Nadpisania konfiguracji Intlayer przekazywane do `getConfiguration()`. Użyj, gdy potrzebujesz, aby proxy czytało określony plik konfiguracyjny lub nadpisywało wartości. |
+
+### Przykład
+
+```ts
+intlayerProxy({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+```
+
+## createIntlayerProxyHandler
+
+`createIntlayerProxyHandler` tworzy samodzielne, niezależne od frameworka oprogramowanie pośredniczące Node.js `(req, res, next)`, które zawiera całą logikę routingu języków. Jest przydatne w środowiskach, w których API wtyczek Vite jest niedostępne (np. czysty serwer Node.js lub niestandardowy moduł Nitro).
+
+```ts
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+const handler = createIntlayerProxyHandler({
+  ignore: (req) => req.url?.startsWith("/api"),
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+});
+
+// Express / Connect
+app.use(handler);
+```
+
+### Produkcyjny SSR (TanStack Start / Nitro przez h3)
+
+```ts
+// server/middleware/intlayerProxy.ts
+import { fromNodeMiddleware } from "h3";
+import { createIntlayerProxyHandler } from "vite-intlayer";
+
+export default fromNodeMiddleware(
+  createIntlayerProxyHandler({
+    ignore: (req) => req.url?.startsWith("/api"),
+  })
+);
+```
+
+## Zachowanie routingu
+
+Oprogramowanie pośredniczące odzwierciedla logikę routingu z middleware `next-intlayer` i obsługuje wszystkie tryby routingu Intlayer.
+
+### Tryby routingu
+
+| Tryb            | Widoczność URL w przeglądarce | Zachowanie                                                                                                                                                          |
+| --------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `prefix`        | `/pl/about`                   | Domyślny. Prefiks języka w adresie URL. Domyślny język przekierowuje do adresu URL bez prefiksu, chyba że włączono `prefix-all`.                                    |
+| `prefix-all`    | `/en/about`, `/pl/about`      | Wszystkie języki — w tym domyślny — są zawsze poprzedzone prefiksem.                                                                                                |
+| `no-prefix`     | `/about`                      | Brak języka w adresie URL. Język jest przechowywany wyłącznie w plikach cookie; przepisywanie URL odbywa się wewnętrznie.                                           |
+| `search-params` | `/about?locale=pl`            | Język przekazywany jako parametr zapytania (query parameter). Przekierowuje w celu dodania/aktualizacji parametru `locale`, jeśli go brakuje lub jest przestarzały. |
+
+### Priorytet wykrywania
+
+1. Prefiks ścieżki URL (np. `/pl/about` → `pl`).
+2. Wartość pliku cookie / localStorage (`intlayer-locale`).
+3. Nagłówek `Accept-Language`.
+4. `defaultLocale` z konfiguracji.
+
+### Automatyczne pomijanie (bypass)
+
+Oprogramowanie pośredniczące zawsze przepuszcza te żądania bezpośrednio, bez obsługi języka:
+
+- Żądania pasujące do predykatu `ignore`.
+- `/node_modules/**`
+- `/@**` – wewnętrzne zasoby Vite (`@vite/`, `@fs/`, `@id/` itp.).
+- `/_**` – wewnętrzne zasoby serwera (`__vite_ping`, `__manifest` itp.).
+- Żądania, których ścieżka kończy się rozszerzeniem pliku (zasoby statyczne). Jeśli w ścieżce zasobu statycznego obecny jest prefiks języka (np. `/pl/logo.png`), zostaje on usunięty, aby plik mógł być serwowany poprawnie.
+
+### Routing domenowy
+
+Gdy w konfiguracji Intlayer skonfigurowano `routing.domains`, oprogramowanie pośredniczące obsługuje routing językowy między różnymi domenami:
+
+- Żądanie dla `/zh/about` w domenie `intlayer.org` jest przekierowywane na `https://intlayer.zh/about`, gdy `domains.zh = "intlayer.zh"`.
+- Żądanie do `intlayer.zh/about` jest wewnętrznie przepisywane na `/zh/about`, aby parametr trasy `[locale]` został uzupełniony.
+
+### Ochrona przed pętlą przekierowań
+
+Oprogramowanie pośredniczące śledzi liczbę przekierowań dla pary `originalUrl → newUrl` w ruchomym oknie 2 sekund. Więcej niż 10 przekierowań w tym oknie zwraca odpowiedź `500` z opisowym błędem zamiast zapętlania się w nieskończoność.
+
+## Nitro / produkcyjny SSR (automatyczna iniekcja, v9+)
+
+Gdy `intlayerProxy` jest używany jako wtyczka Vite, niesie ze sobą właściwość `.nitro`. Wtyczka budująca `nitro/vite` odczytuje tę właściwość i wstrzykuje ją do `nitroConfig.modules`, dzięki czemu `intlayerNitroHandler` rejestruje się jako serwerowe oprogramowanie pośredniczące Nitro automatycznie — dla produkcyjnego SSR nie jest wymagana żadna ręczna konfiguracja.
+
+Handler Nitro korzysta z modelu zdarzeń Web Fetch API h3 v2 (nie `fromNodeMiddleware`), więc jest kompatybilny ze wszystkimi szablonami (presets) Nitro: Node, Bun, Deno, środowiskami edge.
+
+## Zdeprecjonowane aliasy
+
+| Zdeprecjonowany eksport    | Zamiennik       |
+| -------------------------- | --------------- |
+| `intlayerMiddleware`       | `intlayerProxy` |
+| `intLayerMiddlewarePlugin` | `intlayerProxy` |

package/docs/pl/packages/vite-intlayer/intlayerPrune.md

@@ -21,6 +21,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Inicjalizacja dokumentacji"
+author: aymericzip
 ---
 
 # Dokumentacja wtyczki intlayerPrune dla Vite

package/docs/pl/packages/vue-intlayer/exports.md

@@ -14,9 +14,13 @@ slugs:
   - vue-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodanie narzędzia usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Ujednolicona dokumentacja dla wszystkich eksportów"
+author: aymericzip
 ---
 
 # Pakiet vue-intlayer
@@ -58,6 +62,7 @@ import "vue-intlayer";
 | `useDictionaryAsync`   | Tak jak `useDictionary`, ale obsługuje asynchroniczne słowniki.                                                                                            | -                                                                                                                     |
 | `useDictionaryDynamic` | Tak jak `useDictionary`, ale obsługuje dynamiczne słowniki.                                                                                                | -                                                                                                                     |
 | `useLocale`            | Zwraca bieżący locale oraz funkcję do jego ustawienia.                                                                                                     | -                                                                                                                     |
+| `usePathname`          | Zwraca bieżący pathname jako `ComputedRef<string>` z usuniętym segmentem locale. Reaguje na zdarzenia `popstate`.                                          | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vue-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Composable po stronie klienta do zarządzania przepisywaniem adresów URL. Automatycznie aktualizuje URL, jeśli istnieje zlokalizowana reguła przepisywania. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vue-intlayer/useRewriteURL.md) |
 | `useIntl`              | Zwraca obiekt Intl dla bieżącej lokalizacji.                                                                                                               | -                                                                                                                     |
 | `useLoadDynamic`       | Composable do ładowania dynamicznych słowników.                                                                                                            | -                                                                                                                     |

package/docs/pl/packages/vue-intlayer/usePathname.md

@@ -0,0 +1,109 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Dokumentacja funkcji usePathname | vue-intlayer
+description: Dowiedz się, jak korzystać z funkcji usePathname z pakietu vue-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internacjonalizacja
+  - Dokumentacja
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - vue-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodanie narzędzia usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inicjalizacja historii"
+author: aymericzip
+---
+
+# Integracja Vue: Dokumentacja `usePathname`
+
+Funkcja `usePathname` zwraca obecny pathname przeglądarki z usuniętym segmentem locale, w postaci `ComputedRef<string>` z Vue. Jest to przydatne do budowy nawigacji uwzględniającej locale — na przykład, aby określić, który element nawigacji jest aktywny — bez konieczności ręcznego usuwania prefiksu locale.
+
+## Importowanie `usePathname` w Vue
+
+```typescript
+import { usePathname } from "vue-intlayer";
+```
+
+## Przegląd
+
+`usePathname` tworzy Vue computed ref, który odczytuje `window.location.pathname`, usuwa prefiks locale za pomocą `getPathWithoutLocale`, i aktualizuje swoją wartość za każdym razem, gdy przeglądarka wywoła zdarzenie `popstate` (nawigacja wstecz/dalej). Ta wartość może być używana bezpośrednio w Twoich szablonach Vue lub funkcjach setup.
+
+## Użycie
+
+```vue fileName="src/components/NavItem.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const props = defineProps<{
+  href: string;
+  label: string;
+}>();
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <a :href="href" :aria-current="pathname === href ? 'page' : undefined">
+    {{ label }}
+  </a>
+</template>
+```
+
+## Zwracana Wartość
+
+| Typ                   | Opis                                                                                            |
+| --------------------- | ----------------------------------------------------------------------------------------------- |
+| `ComputedRef<string>` | Obiekt typu Computed Ref z Vue, zawierający obecny pathname z przeglądarki bez prefiksu locale. |
+
+## Zachowanie
+
+- **Usuwanie locale**: Usuwa wiodący segment locale (np. `/pl/dashboard` → `/dashboard`).
+- **Reaktywność**: Aktualizuje wartość przy każdym zdarzeniu `popstate` (nawigacja wstecz / do przodu w przeglądarce).
+- **Bezpieczne dla SSR**: Zwraca `""`, gdy `window` nie jest dostępne.
+- **Czyszczenie (Cleanup)**: Nasłuchiwacz (listener) `popstate` jest dodawany globalnie podczas inicjalizacji i zazwyczaj nie wymaga ręcznego czyszczenia na poziomie komponentu, dzięki temu, jak Vue zarządza cyklem życia.
+
+## Przykład
+
+```vue fileName="src/components/Sidebar.vue"
+<script setup lang="ts">
+import { usePathname } from "vue-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Panel" },
+  { href: "/settings", label: "Ustawienia" },
+];
+
+const pathname = usePathname();
+</script>
+
+<template>
+  <nav>
+    <a
+      v-for="link in links"
+      :key="link.href"
+      :href="link.href"
+      :style="{ fontWeight: pathname === link.href ? 'bold' : 'normal' }"
+    >
+      {{ link.label }}
+    </a>
+  </nav>
+</template>
+```
+
+## Powiązane
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/vue-intlayer/useLocale.md) — obecny locale + przełącznik locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getPathWithoutLocale.md) — użyteczność bazowa (utility) wykorzystywana przez ten hook

package/docs/pl/packages/vue-intlayer/useRewriteURL.md

@@ -14,6 +14,7 @@ slugs:
   - packages
   - vue-intlayer
   - useRewriteURL
+author: aymericzip
 ---
 
 # Composable useRewriteURL

package/docs/pl/per_locale_file.md

@@ -18,6 +18,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Inicjalizacja historii"
+author: aymericzip
 ---
 
 # Deklaracja zawartości `Per-Locale` w Intlayer