@intlayer/docs 9.0.0-canary.3 → 9.0.0-canary.4

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

@@ -14,6 +14,9 @@ slugs:
   - preact-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodano narzędzie usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Ujednolicona dokumentacja dla wszystkich eksportów"
@@ -40,12 +43,13 @@ npm install preact-intlayer
 
 ### Hooki
 
-| Hook            | Opis                                                                                                             | Powiązana dokumentacja                                                                                 |
-| --------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `useIntlayer`   | Bazuje na `useDictionary`, ale wstrzykuje zoptymalizowaną wersję słownika pochodzącą z wygenerowanej deklaracji. | -                                                                                                      |
-| `useDictionary` | Przetwarza obiekty przypominające słowniki (klucz, zawartość). Przetwarza tłumaczenia `t()`, enumeracje itp.     | -                                                                                                      |
-| `useLocale`     | Zwraca bieżący locale oraz funkcję do jego ustawienia.                                                           | -                                                                                                      |
-| `t`             | Wybiera treść na podstawie bieżącego locale.                                                                     | [tłumaczenie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/translation.md) |
+| Hook            | Opis                                                                                                                              | Powiązana dokumentacja                                                                                               |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Bazuje na `useDictionary`, ale wstrzykuje zoptymalizowaną wersję słownika pochodzącą z wygenerowanej deklaracji.                  | -                                                                                                                    |
+| `useDictionary` | Przetwarza obiekty przypominające słowniki (klucz, zawartość). Przetwarza tłumaczenia `t()`, enumeracje itp.                      | -                                                                                                                    |
+| `useLocale`     | Zwraca bieżący locale oraz funkcję do jego ustawienia.                                                                            | -                                                                                                                    |
+| `usePathname`   | Hook, który zwraca bieżącą ścieżkę (pathname) po usunięciu segmentu locale. Reaguje na nawigację przeglądarki poprzez `popstate`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/preact-intlayer/usePathname.md) |
+| `t`             | Wybiera treść na podstawie bieżącego locale.                                                                                      | [tłumaczenie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/dictionary/translation.md)               |
 
 ### Komponenty
 

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

@@ -0,0 +1,117 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Dokumentacja Hooka usePathname | preact-intlayer
+description: Zobacz, jak korzystać z hooka usePathname z pakietu preact-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internacjonalizacja
+  - Dokumentacja
+  - Preact
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - preact-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 z Preact: Dokumentacja Hooka `usePathname`
+
+Hook `usePathname` zwraca bieżącą ścieżkę przeglądarki (pathname) z usuniętym segmentem locale. Jest to przydatne do tworzenia nawigacji uwzględniającej wielojęzyczność — na przykład określania, który element nawigacji jest aktywny — bez konieczności ręcznego usuwania prefiksu locale.
+
+## Importowanie `usePathname` w Preact
+
+```typescript
+import { usePathname } from "preact-intlayer";
+```
+
+## Przegląd
+
+`usePathname` odczytuje `window.location.pathname`, usuwa prefiks locale za pomocą `getPathWithoutLocale` i ponownie renderuje komponent za każdym razem, gdy przeglądarka wywoła zdarzenie `popstate` (nawigacja wstecz/dalej). Podczas renderowania po stronie serwera (SSR) zwraca pusty ciąg znaków.
+
+## Użycie
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: FunctionComponent<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+  const isActive = pathname === href;
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## Zwracana Wartość
+
+| Typ      | Opis                                                                                                  |
+| -------- | ----------------------------------------------------------------------------------------------------- |
+| `string` | Bieżąca ścieżka bez prefiksu locale. Pusty ciąg znaków podczas renderowania po stronie serwera (SSR). |
+
+## Zachowanie
+
+- **Usuwanie locale (Locale stripping)**: Usuwa początkowy segment locale (np. `/pl/dashboard` → `/dashboard`).
+- **Reaktywność**: Aktualizuje się automatycznie przy zdarzeniach `popstate` (nawigacja wstecz / dalej przeglądarki).
+- **Bezpieczeństwo w SSR**: Zwraca `""`, gdy obiekt `window` jest niedostępny.
+- **Czyszczenie (Cleanup)**: Nasłuchiwacz `popstate` jest usuwany automatycznie podczas odmontowywania komponentu.
+
+## Przykład
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Pulpit" },
+  { href: "/settings", label: "Ustawienia" },
+];
+
+const Sidebar: FunctionComponent = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      {links.map(({ href, label }) => (
+        <a
+          key={href}
+          href={href}
+          style={{ fontWeight: pathname === href ? "bold" : "normal" }}
+        >
+          {label}
+        </a>
+      ))}
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## Powiązane
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/preact-intlayer/exports.md) — bieżący locale + przełącznik locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getPathWithoutLocale.md) — podstawowe narzędzie wykorzystywane przez ten hook

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

@@ -14,6 +14,9 @@ slugs:
   - react-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodano narzędzie usePathname"
   - version: 7.5.14
     date: 2026-01-21
     changes: "Ujednolicona dokumentacja dla wszystkich eksportów"
@@ -62,6 +65,7 @@ import "react-intlayer";
 | `useDictionaryDynamic` | Hook obsługujący dynamiczne słowniki ładowane po kluczu. Wykorzystuje wewnętrznie React Suspense do obsługi stanów ładowania.                              | -                                                                                                                       |
 | `useLocale`            | Hook po stronie klienta do pobrania bieżącego locale, domyślnego locale, dostępnych locales oraz funkcji do zmiany locale.                                 | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/react-intlayer/useLocale.md)         |
 | `useLocaleBase`        | Hook do pobierania bieżącego locale oraz wszystkich powiązanych pól (locale, defaultLocale, availableLocales, setLocale) z kontekstu.                      | -                                                                                                                       |
+| `usePathname`          | Hook zwracający obecną ścieżkę (pathname) bez segmentu lokalizacji. Reaktywny na nawigację w przeglądarce za pośrednictwem `popstate`.                     | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/react-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Hook po stronie klienta do zarządzania przepisywaniem URL. Jeśli dla bieżącej ścieżki (pathname) i locale istnieje reguła przepisywania, zaktualizuje URL. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/react-intlayer/useRewriteURL.md) |
 | `useI18n`              | Hook, który dostarcza funkcję tłumaczącą `t()` do dostępu do zagnieżdżonej zawartości po kluczu. Naśladuje wzorzec i18next/next-intl.                      | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/react-intlayer/useI18n.md)             |
 | `useIntl`              | Hook, który zapewnia obiekt `Intl` powiązany z locale. Automatycznie wstrzykuje aktualne locale i korzysta z zoptymalizowanego cachingu.                   | -                                                                                                                       |

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

@@ -0,0 +1,87 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Dokumentacja hooka usePathname | react-intlayer
+description: Dowiedz się, jak używać hooka usePathname z pakietu react-intlayer, aby uzyskać bieżącą ścieżkę URL bez segmentu lokalizacji.
+keywords:
+  - usePathname
+  - pathname
+  - react
+  - intlayer
+  - routing
+  - internacjonalizacja
+slugs:
+  - doc
+  - packages
+  - react-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 React: Dokumentacja hooka `usePathname`
+
+Hook `usePathname` z `react-intlayer` zwraca obecną ścieżkę (pathname) przeglądarki z usuniętym segmentem lokalizacji (locale). Opiera się na natywnej właściwości `window.location.pathname` i reaguje na zdarzenia nawigacji przeglądarki za pośrednictwem `popstate`.
+
+## Importowanie `usePathname`
+
+```typescript
+import { usePathname } from "react-intlayer";
+```
+
+## Przegląd
+
+W przeciwieństwie do hooków routingu specyficznych dla frameworków (takich jak te w `next-intlayer` lub `react-router`), ten hook jest lekkim, niezależnym od frameworka rozwiązaniem dla czystych aplikacji React. Wyciąga bieżący adres URL i usuwa wszelkie pasujące prefiksy lokalizacji (np. `/pl/about` staje się `/about`).
+
+## Użycie
+
+```tsx fileName="src/components/Navigation.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { usePathname } from "react-intlayer";
+
+const Navigation: FC = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <a
+        href="/home"
+        style={{ fontWeight: pathname === "/home" ? "bold" : "normal" }}
+      >
+        Strona główna
+      </a>
+      <a
+        href="/about"
+        style={{ fontWeight: pathname === "/about" ? "bold" : "normal" }}
+      >
+        O nas
+      </a>
+    </nav>
+  );
+};
+
+export default Navigation;
+```
+
+## Zwracana wartość
+
+| Typ      | Opis                                                                                                           |
+| -------- | -------------------------------------------------------------------------------------------------------------- |
+| `string` | Obecna ścieżka (pathname) przeglądarki z usuniętym prefiksem lokalizacji (np. `/pl/dashboard` → `/dashboard`). |
+
+## Zachowanie
+
+- **Usuwanie lokalizacji**: Pod maską korzysta z narzędzia `getPathWithoutLocale`, aby automatycznie wykrywać i usuwać lokalizację ze ścieżki w oparciu o konfigurację Intlayer aplikacji.
+- **Reaktywność**: Nasłuchuje zdarzenia `popstate`. Gdy użytkownik nawiguje za pomocą przycisków wstecz/dalej w przeglądarce lub gdy wywoływane jest `pushState`/`replaceState`, hook aktualizuje zwracaną ścieżkę.
+- **SSR Fallback**: Na serwerze (gdzie `window` jest niezdefiniowane), domyślnie zwraca `/`, ponieważ w czystym kontekście React domyślnie nie ma dostępu do adresu URL żądania.
+
+## Powiązana dokumentacja
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/react-intlayer/useLocale.md)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getPathWithoutLocale.md)

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

@@ -14,6 +14,9 @@ slugs:
   - solid-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"
@@ -59,6 +62,7 @@ import "solid-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 i funkcję do jego ustawienia.                                                                                                  | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/solid-intlayer/useLocale.md)         |
+| `usePathname`          | Zwraca bieżącą ścieżkę (pathname) jako `Accessor<string>` z usuniętym segmentem locale. Reaguje na `popstate`.                                       | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/solid-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Hook 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/solid-intlayer/useRewriteURL.md) |
 | `useIntl`              | Zwraca obiekt Intl dla bieżącego locale.                                                                                                             | -                                                                                                                       |
 | `useLoadDynamic`       | Hook do ładowania dynamicznych słowników.                                                                                                            | -                                                                                                                       |

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Dokumentacja Hooka usePathname | solid-intlayer
+description: Zobacz, jak korzystać z hooka usePathname z pakietu solid-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internacjonalizacja
+  - Dokumentacja
+  - Solid
+  - Solid.js
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - solid-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 Solid: Dokumentacja Hooka `usePathname`
+
+Hook `usePathname` zwraca bieżącą ścieżkę (pathname) przeglądarki z usuniętym segmentem locale, w postaci `Accessor<string>` w Solid. Jest to przydatne do budowania nawigacji z uwzględnieniem locale — na przykład w celu określenia, który element nawigacji jest aktywny — bez konieczności ręcznego usuwania prefiksu locale.
+
+## Importowanie `usePathname` w Solid
+
+```typescript
+import { usePathname } from "solid-intlayer";
+```
+
+## Przegląd
+
+`usePathname` tworzy reaktywny sygnał zainicjowany na podstawie `window.location.pathname`, usuwa prefiks locale za pomocą `getPathWithoutLocale` i aktualizuje sygnał, gdy przeglądarka wywoła zdarzenie `popstate` (nawigacja wstecz/dalej). Nasłuchiwacz zdarzeń (event listener) jest automatycznie czyszczony przez `onCleanup`.
+
+## Użycie
+
+```tsx fileName="src/components/NavItem.tsx"
+import type { Component } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: Component<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+
+  return (
+    <a href={href} aria-current={pathname() === href ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## Zwracana wartość
+
+| Typ                | Opis                                                                                          |
+| ------------------ | --------------------------------------------------------------------------------------------- |
+| `Accessor<string>` | Akcesor w Solid (reaktywny getter) zwracający bieżącą ścieżkę (pathname) bez prefiksu locale. |
+
+## Zachowanie
+
+- **Usuwanie Locale**: Usuwa początkowy segment locale (np. `/pl/dashboard` → `/dashboard`).
+- **Reaktywność**: Aktualizuje się automatycznie przy zdarzeniach `popstate` (nawigacja wstecz / dalej w przeglądarce).
+- **Bezpieczne dla SSR**: Zwraca `""` gdy `window` jest niedostępne.
+- **Czyszczenie**: Nasłuchiwacz `popstate` jest usuwany automatycznie przez funkcję `onCleanup` w Solid.
+
+## Przykład
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { Component } from "solid-js";
+import { For } from "solid-js";
+import { usePathname } from "solid-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Pulpit" },
+  { href: "/settings", label: "Ustawienia" },
+];
+
+const Sidebar: Component = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      <For each={links}>
+        {({ href, label }) => (
+          <a
+            href={href}
+            style={{ "font-weight": pathname() === href ? "bold" : "normal" }}
+          >
+            {label}
+          </a>
+        )}
+      </For>
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## Powiązane
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/solid-intlayer/useLocale.md) — bieżący locale + przełącznik locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/intlayer/getPathWithoutLocale.md) — narzędzie pomocnicze, na którym opiera się ten hook

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

@@ -14,6 +14,9 @@ slugs:
   - svelte-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Dodano narzędzie usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Ujednolicono dokumentację dla wszystkich eksportów"
@@ -71,6 +74,7 @@ import "svelte-intlayer";
 | `useDictionaryAsync`   | Tak jak `useDictionary`, ale obsługuje asynchroniczne słowniki.                                                                                       | -                                                                                                                        |
 | `useDictionaryDynamic` | Tak jak `useDictionary`, ale obsługuje słowniki dynamiczne.                                                                                           | -                                                                                                                        |
 | `useLocale`            | Zwraca bieżący locale oraz funkcję do jego ustawienia.                                                                                                | -                                                                                                                        |
+| `usePathname`          | Zwraca bieżącą ścieżkę (pathname) jako store `Readable<string>` z usuniętym segmentem locale. Reaktywny na `popstate`.                                | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/svelte-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Funkcja po stronie klienta do zarządzania przepisywaniem URL. Automatycznie aktualizuje adres URL, jeśli istnieje zlokalizowana reguła przepisywania. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/packages/svelte-intlayer/useRewriteURL.md) |
 | `useIntl`              | Zwraca obiekt Intl dla bieżącego locale.                                                                                                              | -                                                                                                                        |
 

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/vue-intlayer/exports.md

@@ -14,6 +14,9 @@ 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"
@@ -59,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