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

package/docs/it/packages/intlayer/comparePaths.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentazione della funzione comparePaths | intlayer
+description: Scopri come utilizzare la funzione comparePaths per il pacchetto intlayer
+keywords:
+  - comparePaths
+  - normalizePath
+  - link attivo
+  - navigazione
+  - Intlayer
+  - intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "Documentazione iniziale"
+author: aymericzip
+---
+
+# Documentazione: Funzione `comparePaths` in `intlayer`
+
+## Descrizione
+
+La funzione `comparePaths` confronta due URL o percorsi per verificarne l'uguaglianza ignorando il segmento locale, il protocollo/host, la query string, l'hash e le barre finali. È il metodo consigliato per determinare se un link di navigazione punta alla pagina corrente — ad esempio per evidenziare il link attivo — senza dover creare una logica di normalizzazione personalizzata (soggetta a errori).
+
+Internamente riutilizza [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) per rimuovere il segmento locale, in modo da rispettare la modalità di routing e i locale configurati.
+
+Il pacchetto esporta anche l'utility sottostante [`normalizePath`](#normalizepath), che restituisce il percorso canonico, indipendente dal locale, utilizzato per il confronto.
+
+**Funzionalità chiave:**
+
+- Confronto indipendente dal locale (`/it/about` corrisponde a `/about`)
+- Funziona sia con URL assoluti che con percorsi relativi
+- Ignora query string, hash e barre finali
+- Tollera l'assenza di barre iniziali e valori vuoti (normalizzato a `/`)
+- Leggero — basato su `getPathWithoutLocale`
+
+---
+
+## Firma della funzione
+
+```typescript
+comparePaths(
+  pathname: string,  // Richiesto
+  href: string,      // Richiesto
+  locales?: Locales[] // Opzionale
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Richiesto
+  locales?: Locales[] // Opzionale
+): string
+```
+
+---
+
+## Parametri
+
+- `pathname: string`
+  - **Descrizione**: La prima stringa URL o percorso da confrontare (in genere il percorso corrente).
+  - **Tipo**: `string`
+  - **Richiesto**: Sì
+
+- `href: string`
+  - **Descrizione**: La seconda stringa URL o percorso da confrontare (in genere l'`href` di un link di navigazione).
+  - **Tipo**: `string`
+  - **Richiesto**: Sì
+
+- `locales: Locales[]`
+  - **Descrizione**: Array opzionale di locale supportati. Per impostazione predefinita, i locale configurati nel progetto.
+  - **Tipo**: `Locales[]`
+  - **Richiesto**: No (Opzionale)
+
+### Restituisce
+
+- **Tipo**: `boolean`
+- **Descrizione**: `true` quando entrambi gli input si risolvono allo stesso percorso indipendente dal locale, altrimenti `false`.
+
+---
+
+## Esempio di utilizzo
+
+### Utilizzo di base
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { comparePaths } from "intlayer";
+
+comparePaths("/ru/path", "/path"); // true
+comparePaths("/ru/path/", "/path"); // true
+comparePaths("/ru/path", "/path/"); // true
+comparePaths("/ru/", "/"); // true
+comparePaths("/ru", "/"); // true
+comparePaths("ru/path", "/path"); // true
+comparePaths("", "/"); // true
+comparePaths("/ru", ""); // true
+comparePaths("/ru/path", "/other"); // false
+```
+
+### URL assoluti e relativi
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### Evidenziare il link di navigazione attivo
+
+```tsx
+import { comparePaths } from "intlayer";
+import { useLocation } from "react-router";
+
+const NavLink = ({ href, children }) => {
+  const { pathname } = useLocation();
+  const isActive = comparePaths(pathname, href);
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {children}
+    </a>
+  );
+};
+```
+
+---
+
+## normalizePath
+
+`normalizePath` restituisce il percorso canonico e indipendente dal locale utilizzato da `comparePaths`. Rimuove il segmento locale, il protocollo/host, la query string e l'hash, assicura la presenza di una singola barra iniziale, rimuove qualsiasi barra finale (tranne che per la root) e utilizza `/` come fallback per i valori vuoti.
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { normalizePath } from "intlayer";
+
+normalizePath("/ru/path"); // "/path"
+normalizePath("/ru/path/"); // "/path"
+normalizePath("ru/path"); // "/path"
+normalizePath("/ru/"); // "/"
+normalizePath("/ru"); // "/"
+normalizePath(""); // "/"
+normalizePath("https://example.com/ru/path"); // "/path"
+```
+
+---
+
+## Funzioni correlate
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md): Rimuove il segmento locale da un URL o percorso.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPrefix.md): Determina il prefisso URL per un dato locale.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedUrl.md): Genera un URL localizzato per uno specifico locale.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

package/docs/it/packages/intlayer/exports.md

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "Aggiunta l'utilità comparePaths"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -108,19 +111,21 @@ Importazione:
 import "intlayer";
 ```
 
-| Funzione               | Tipo       | Descrizione                                               | Doc correlata                                                                                                                   |
-| ---------------------- | ---------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `getLocale`            | `Function` | Rileva la locale da una stringa o da un percorso.         | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocale.md)                       |
-| `getLocaleLang`        | `Function` | Estrae la parte lingua di una locale.                     | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleLang.md)               |
-| `getLocaleName`        | `Function` | Restituisce il nome di visualizzazione di una locale.     | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleName.md)               |
-| `getLocalizedPath`     | `Function` | Converte un percorso canonico in un percorso localizzato. | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedPath.md)         |
-| `getCanonicalPath`     | `Function` | Risolve un percorso localizzato nella forma canonica.     | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getCanonicalPath.md)         |
-| `getLocalizedUrl`      | `Function` | Genera un URL localizzato.                                | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedUrl.md)           |
-| `getMultilingualUrls`  | `Function` | Genera URL per tutte le locali supportate.                | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getMultilingualUrls.md)   |
-| `getPathWithoutLocale` | `Function` | Rimuove il prefisso locale da un percorso.                | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) |
-| `getPrefix`            | `Function` | Ottiene il prefisso locale da un percorso.                | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPrefix.md)                       |
-| `getHTMLTextDir`       | `Function` | Ottiene la direzione del testo (LTR/RTL).                 | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getHTMLTextDir.md)             |
-| `validatePrefix`       | `Function` | Valida un prefisso locale.                                | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/validatePrefix.md)             |
+| Funzione               | Tipo       | Descrizione                                                  | Doc correlata                                                                                                                   |
+| ---------------------- | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| `getLocale`            | `Function` | Rileva la locale da una stringa o da un percorso.            | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocale.md)                       |
+| `getLocaleLang`        | `Function` | Estrae la parte lingua di una locale.                        | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleLang.md)               |
+| `getLocaleName`        | `Function` | Restituisce il nome di visualizzazione di una locale.        | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocaleName.md)               |
+| `getLocalizedPath`     | `Function` | Converte un percorso canonico in un percorso localizzato.    | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedPath.md)         |
+| `getCanonicalPath`     | `Function` | Risolve un percorso localizzato nella forma canonica.        | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getCanonicalPath.md)         |
+| `getLocalizedUrl`      | `Function` | Genera un URL localizzato.                                   | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getLocalizedUrl.md)           |
+| `getMultilingualUrls`  | `Function` | Genera URL per tutte le locali supportate.                   | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getMultilingualUrls.md)   |
+| `getPathWithoutLocale` | `Function` | Rimuove il prefisso locale da un percorso.                   | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) |
+| `getPrefix`            | `Function` | Ottiene il prefisso locale da un percorso.                   | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | Confronta due percorsi ignorando la lingua (locale).         | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | Normalizza un percorso rendendolo indipendente dalla lingua. | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/comparePaths.md)                 |
+| `getHTMLTextDir`       | `Function` | Ottiene la direzione del testo (LTR/RTL).                    | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getHTMLTextDir.md)             |
+| `validatePrefix`       | `Function` | Valida un prefisso locale.                                   | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/validatePrefix.md)             |
 
 ### Utility del browser
 

package/docs/it/packages/next-intlayer/exports.md

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Aggiunta utility usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -99,6 +102,7 @@ Re-esporta la maggior parte degli hook da `react-intlayer`.
 | `useDictionaryAsync`   | Hook che gestisce dizionari asincroni. Accetta una mappa di dizionari basata su Promise e la risolve per la locale corrente.                               | -                                                                                                                       |
 | `useDictionaryDynamic` | Hook che gestisce dizionari dinamici caricati per chiave. Utilizza internamente React Suspense per gli stati di caricamento.                               | -                                                                                                                       |
 | `useLocale`            | Hook lato client per ottenere la locale corrente e una funzione per impostarla. Migliorato per Next.js App Router con supporto alla navigazione.           | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | Restituisce il percorso attuale senza il prefisso della lingua e senza i parametri di query della lingua.                                                  | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | Hook lato client per gestire la riscrittura degli URL. Aggiorna automaticamente l'URL se esiste una regola di riscrittura localizzata più pulita.          | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/next-intlayer/useRewriteURL.md)  |
 | `useLocalePageRouter`  | Hook specifico per il Page Router di Next.js per la gestione della localizzazione. Gestisce i redirect e i ricaricamenti della pagina al cambio di locale. | -                                                                                                                       |
 | `useI18n`              | Hook che fornisce una funzione di traduzione `t()` per accedere a contenuti nidificati tramite chiave. Riprende il pattern di i18next/next-intl.           | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useI18n.md)             |

package/docs/it/packages/next-intlayer/usePathname.md

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentazione dell'Hook usePathname | next-intlayer
+description: Scopri come utilizzare l'hook usePathname per il pacchetto next-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - next-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Aggiunta utility usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inizializzazione della cronologia"
+author: aymericzip
+---
+
+# Integrazione Next.js: Documentazione dell'Hook `usePathname`
+
+L'hook `usePathname` restituisce il percorso corrente di Next.js senza il segmento della lingua. È utile per creare una navigazione consapevole della lingua — ad esempio, per determinare quale elemento di navigazione è attivo — senza dover rimuovere manualmente il prefisso della lingua.
+
+## Importare `usePathname` in Next.js
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## Panoramica
+
+`usePathname` avvolge il `usePathname()` integrato di Next.js proveniente da `next/navigation`, aggiunge eventuali parametri di ricerca (search params) e rimuove il prefisso della lingua tramite `getPathWithoutLocale`. Riavvia il rendering (re-render) ad ogni navigazione lato client. L'hook è disponibile solo nei Client Components (richiede `"use client"`).
+
+## Utilizzo
+
+```tsx fileName="src/components/NavItem.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: FC<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+  const isActive = pathname === href;
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## Valore Restituito
+
+| Tipo     | Descrizione                                                                                             |
+| -------- | ------------------------------------------------------------------------------------------------------- |
+| `string` | Il percorso corrente senza il prefisso della lingua e senza i parametri di query correlati alla lingua. |
+
+## Comportamento
+
+- **Rimozione della lingua**: Rimuove il segmento iniziale della lingua (es. `/it/dashboard` → `/dashboard`).
+- **Rimozione dei parametri di ricerca**: Rimuove anche un parametro di query `?locale=...` quando si utilizza la modalità di routing basata sui parametri di ricerca.
+- **Reattivo**: Si aggiorna automaticamente ad ogni navigazione lato client tramite l'App Router di Next.js.
+- **Sicuro per il SSR**: Restituisce il percorso lato server durante il primo rendering, sincronizzando poi i parametri di ricerca lato client.
+
+## Confronto con `useLocale`
+
+`useLocale` di `next-intlayer` espone già `pathWithoutLocale` come parte del suo valore restituito. Usa `usePathname` quando ti serve solo il percorso e non hai bisogno della funzionalità di cambio lingua.
+
+```tsx codeFormat={["typescript", "esm"]}
+// Quando ti servono sia lo stato della lingua che il percorso:
+import { useLocale } from "next-intlayer";
+const { locale, pathWithoutLocale } = useLocale();
+
+// Quando ti serve solo il percorso:
+import { usePathname } from "next-intlayer";
+const pathname = usePathname();
+```
+
+## Esempio
+
+```tsx fileName="src/components/Sidebar.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Dashboard" },
+  { href: "/settings", label: "Impostazioni" },
+];
+
+const Sidebar: FC = () => {
+  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;
+```
+
+## Articoli Correlati
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/next-intlayer/useLocale.md) — lingua corrente + commutatore di lingua (espone anche `pathWithoutLocale`)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) — l'utility di base usata da questo hook

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

@@ -14,6 +14,9 @@ slugs:
   - preact-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Aggiunta utility usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -40,12 +43,13 @@ npm install preact-intlayer
 
 ### Hooks
 
-| Hook            | Descrizione                                                                                                      | Documento correlato                                                                                   |
-| --------------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
-| `useIntlayer`   | Si basa su `useDictionary`, ma inietta una versione ottimizzata del dizionario dalla dichiarazione generata.     | -                                                                                                     |
-| `useDictionary` | Processa oggetti che assomigliano a dizionari (chiave, contenuto). Gestisce traduzioni `t()`, enumerazioni, ecc. | -                                                                                                     |
-| `useLocale`     | Restituisce la locale corrente e una funzione per impostarla.                                                    | -                                                                                                     |
-| `t`             | Seleziona il contenuto in base alla locale corrente.                                                             | [traduzione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md) |
+| Hook            | Descrizione                                                                                                                                    | Documento correlato                                                                                                  |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Si basa su `useDictionary`, ma inietta una versione ottimizzata del dizionario dalla dichiarazione generata.                                   | -                                                                                                                    |
+| `useDictionary` | Processa oggetti che assomigliano a dizionari (chiave, contenuto). Gestisce traduzioni `t()`, enumerazioni, ecc.                               | -                                                                                                                    |
+| `useLocale`     | Restituisce la locale corrente e una funzione per impostarla.                                                                                  | -                                                                                                                    |
+| `usePathname`   | Hook che restituisce il percorso corrente (pathname) senza il segmento della locale. Reattivo alla navigazione del browser tramite `popstate`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/preact-intlayer/usePathname.md) |
+| `t`             | Seleziona il contenuto in base alla locale corrente.                                                                                           | [traduzione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md)                |
 
 ### Componenti
 

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

@@ -0,0 +1,117 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentazione dell'Hook usePathname | preact-intlayer
+description: Scopri come utilizzare l'hook usePathname con il pacchetto preact-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internazionalizzazione
+  - Documentazione
+  - Preact
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - preact-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Aggiunta utility usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inizializzazione della cronologia"
+author: aymericzip
+---
+
+# Integrazione Preact: Documentazione dell'Hook `usePathname`
+
+L'hook `usePathname` restituisce il percorso corrente (pathname) del browser con il segmento della locale rimosso. È utile per creare navigazioni basate sulla locale — ad esempio, per determinare quale elemento del menu è attivo — senza dover rimuovere manualmente il prefisso della locale.
+
+## Importare `usePathname` in Preact
+
+```typescript
+import { usePathname } from "preact-intlayer";
+```
+
+## Panoramica
+
+`usePathname` legge `window.location.pathname`, rimuove il prefisso della locale tramite `getPathWithoutLocale` e forza un re-rendering del componente ogni volta che il browser emette un evento `popstate` (navigazione indietro/avanti). Restituisce una stringa vuota durante il rendering lato server (SSR).
+
+## Utilizzo
+
+```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;
+```
+
+## Valore di Ritorno
+
+| Tipo     | Descrizione                                                                                                |
+| -------- | ---------------------------------------------------------------------------------------------------------- |
+| `string` | Il percorso corrente senza il prefisso della locale. Stringa vuota durante il rendering lato server (SSR). |
+
+## Comportamento
+
+- **Rimozione della locale (Locale stripping)**: Rimuove il segmento iniziale della locale (es. `/it/dashboard` → `/dashboard`).
+- **Reattività**: Si aggiorna automaticamente agli eventi `popstate` (navigazione indietro / avanti del browser).
+- **Sicuro per SSR**: Restituisce `""` quando `window` non è disponibile.
+- **Pulizia (Cleanup)**: Il listener per `popstate` viene rimosso automaticamente quando il componente viene smontato.
+
+## Esempio
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Dashboard" },
+  { href: "/settings", label: "Impostazioni" },
+];
+
+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;
+```
+
+## Correlati
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/preact-intlayer/exports.md) — locale corrente + selettore della locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getPathWithoutLocale.md) — l'utility di base impiegata da questo hook

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

@@ -14,6 +14,9 @@ slugs:
   - react-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Aggiunta l'utilità usePathname"
   - version: 7.5.14
     date: 2026-01-21
     changes: "Documentazione unificata per tutte le esportazioni"
@@ -54,22 +57,23 @@ Importazione:
 import "react-intlayer";
 ```
 
-| Hook                   | Descrizione                                                                                                                                        | Documentazione correlata                                                                                                |
-| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `useIntlayer`          | Hook lato client che seleziona un dizionario tramite la sua chiave e ne restituisce il contenuto. Usa la locale dal contesto se non fornita.       | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useIntlayer.md)     |
-| `useDictionary`        | Hook che trasforma un oggetto dizionario e restituisce il contenuto per la locale corrente. Elabora le traduzioni `t()`, le enumerazioni, ecc.     | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useDictionary.md) |
-| `useDictionaryAsync`   | Hook che gestisce dizionari asincroni. Accetta una mappa di dizionari basata su promise e la risolve per la locale corrente.                       | -                                                                                                                       |
-| `useDictionaryDynamic` | Hook che gestisce dizionari dinamici caricati per chiave. Utilizza internamente React Suspense per gli stati di caricamento.                       | -                                                                                                                       |
-| `useLocale`            | Hook client-side per ottenere la locale corrente, la locale predefinita, le località disponibili e una funzione per aggiornare la locale.          | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useLocale.md)         |
-| `useLocaleBase`        | Hook per ottenere la locale corrente e tutti i campi correlati (locale, defaultLocale, availableLocales, setLocale) dal contesto.                  | -                                                                                                                       |
-| `useRewriteURL`        | Hook client-side per gestire le riscritture degli URL. Se esiste una regola di riscrittura per il pathname corrente e la locale, aggiornerà l'URL. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useRewriteURL.md) |
-| `useI18n`              | Hook che fornisce una funzione di traduzione `t()` per accedere a contenuti nidificati tramite chiave. Imita il pattern di i18next/next-intl.      | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useI18n.md)             |
-| `useIntl`              | Hook che fornisce un oggetto `Intl` legato alla locale. Inietta automaticamente la locale corrente e utilizza caching ottimizzato.                 | -                                                                                                                       |
-| `useLocaleStorage`     | Hook che fornisce la persistenza della locale nel local storage o nei cookie. Restituisce funzioni getter e setter.                                | -                                                                                                                       |
-| `useLocaleCookie`      | Deprecato. Usa `useLocaleStorage` invece. Hook che gestisce la persistenza della locale nei cookie.                                                | -                                                                                                                       |
-| `useLoadDynamic`       | Hook per caricare dizionari dinamici usando React Suspense. Accetta una chiave e una promise, memorizza i risultati nella cache.                   | -                                                                                                                       |
-| `useIntlayerContext`   | Hook che fornisce i valori del contesto client Intlayer correnti (locale, setLocale, ecc.).                                                        | -                                                                                                                       |
-| `useHTMLContext`       | Hook per accedere agli override dei componenti HTML dal contesto HTMLProvider.                                                                     | -                                                                                                                       |
+| Hook                   | Descrizione                                                                                                                                                   | Documentazione correlata                                                                                                |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | Hook lato client che seleziona un dizionario tramite la sua chiave e ne restituisce il contenuto. Usa la locale dal contesto se non fornita.                  | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useIntlayer.md)     |
+| `useDictionary`        | Hook che trasforma un oggetto dizionario e restituisce il contenuto per la locale corrente. Elabora le traduzioni `t()`, le enumerazioni, ecc.                | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useDictionary.md) |
+| `useDictionaryAsync`   | Hook che gestisce dizionari asincroni. Accetta una mappa di dizionari basata su promise e la risolve per la locale corrente.                                  | -                                                                                                                       |
+| `useDictionaryDynamic` | Hook che gestisce dizionari dinamici caricati per chiave. Utilizza internamente React Suspense per gli stati di caricamento.                                  | -                                                                                                                       |
+| `useLocale`            | Hook lato client per ottenere la lingua corrente, la lingua predefinita, le lingue disponibili e una funzione per aggiornare la lingua.                       | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useLocale.md)         |
+| `useLocaleBase`        | Hook per ottenere la locale corrente e tutti i campi correlati (locale, defaultLocale, availableLocales, setLocale) dal contesto.                             | -                                                                                                                       |
+| `usePathname`          | Hook che restituisce il percorso corrente (pathname) con il segmento della lingua rimosso. Reattivo alla navigazione del browser tramite `popstate`.          | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/usePathname.md)     |
+| `useRewriteURL`        | Hook lato client per gestire le riscritture degli URL. Se esiste una regola di riscrittura per il percorso (pathname) e la lingua correnti, aggiornerà l'URL. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useRewriteURL.md) |
+| `useI18n`              | Hook che fornisce una funzione di traduzione `t()` per accedere a contenuti nidificati tramite chiave. Imita il pattern di i18next/next-intl.                 | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/useI18n.md)             |
+| `useIntl`              | Hook che fornisce un oggetto `Intl` legato alla locale. Inietta automaticamente la locale corrente e utilizza caching ottimizzato.                            | -                                                                                                                       |
+| `useLocaleStorage`     | Hook che fornisce la persistenza della locale nel local storage o nei cookie. Restituisce funzioni getter e setter.                                           | -                                                                                                                       |
+| `useLocaleCookie`      | Deprecato. Usa `useLocaleStorage` invece. Hook che gestisce la persistenza della locale nei cookie.                                                           | -                                                                                                                       |
+| `useLoadDynamic`       | Hook per caricare dizionari dinamici usando React Suspense. Accetta una chiave e una promise, memorizza i risultati nella cache.                              | -                                                                                                                       |
+| `useIntlayerContext`   | Hook che fornisce i valori del contesto client Intlayer correnti (locale, setLocale, ecc.).                                                                   | -                                                                                                                       |
+| `useHTMLContext`       | Hook per accedere agli override dei componenti HTML dal contesto HTMLProvider.                                                                                | -                                                                                                                       |
 
 ### Funzioni