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

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentation de la fonction comparePaths | intlayer
+description: Découvrez comment utiliser la fonction comparePaths pour le package intlayer
+keywords:
+  - comparePaths
+  - normalizePath
+  - lien actif
+  - navigation
+  - Intlayer
+  - intlayer
+  - Internationalisation
+  - Documentation
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "Documentation initiale"
+author: aymericzip
+---
+
+# Documentation : Fonction `comparePaths` dans `intlayer`
+
+## Description
+
+La fonction `comparePaths` compare deux URL ou chemins pour vérifier leur égalité tout en ignorant le segment de la locale, le protocole/domaine, la chaîne de requête (query string), le hash et les barres obliques de fin (trailing slashes). C'est la méthode recommandée pour déterminer si un lien de navigation pointe vers la page courante — par exemple pour mettre en évidence le lien actif — sans avoir à recréer votre propre logique de normalisation (sujette aux erreurs).
+
+En interne, elle réutilise [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPathWithoutLocale.md) pour supprimer le segment de la locale, de sorte qu'elle respecte votre mode de routage et vos locales configurés.
+
+Le package exporte également la fonction utilitaire sous-jacente [`normalizePath`](#normalizepath), qui retourne le chemin canonique, indépendant de la locale, utilisé pour la comparaison.
+
+**Fonctionnalités clés :**
+
+- Comparaison indépendante de la locale (`/fr/about` correspond à `/about`)
+- Fonctionne avec des URL absolues et des chemins relatifs
+- Ignore la chaîne de requête, le hash et les barres obliques de fin
+- Tolère l'absence de barre oblique initiale et les valeurs vides (normalisé en `/`)
+- Léger — construit par-dessus `getPathWithoutLocale`
+
+---
+
+## Signature de la fonction
+
+```typescript
+comparePaths(
+  pathname: string,  // Requis
+  href: string,      // Requis
+  locales?: Locales[] // Optionnel
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Requis
+  locales?: Locales[] // Optionnel
+): string
+```
+
+---
+
+## Paramètres
+
+- `pathname: string`
+  - **Description** : La première chaîne d'URL ou de chemin à comparer (généralement le chemin actuel).
+  - **Type** : `string`
+  - **Requis** : Oui
+
+- `href: string`
+  - **Description** : La deuxième chaîne d'URL ou de chemin à comparer (généralement le `href` d'un lien de navigation).
+  - **Type** : `string`
+  - **Requis** : Oui
+
+- `locales: Locales[]`
+  - **Description** : Tableau optionnel des locales prises en charge. Par défaut, les locales configurées dans le projet.
+  - **Type** : `Locales[]`
+  - **Requis** : Non (Optionnel)
+
+### Retours
+
+- **Type** : `boolean`
+- **Description** : `true` lorsque les deux entrées se résolvent vers le même chemin indépendant de la locale, sinon `false`.
+
+---
+
+## Exemple d'utilisation
+
+### Utilisation de 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 absolues et relatives
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### Mettre en évidence le lien de navigation actif
+
+```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` retourne le chemin canonique et indépendant de la locale utilisé par `comparePaths`. Il supprime le segment de la locale, le protocole/domaine, la chaîne de requête et le hash, assure la présence d'une seule barre oblique initiale, supprime toute barre oblique de fin (sauf pour la racine) et utilise `/` comme valeur de repli pour les valeurs vides.
+
+```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"
+```
+
+---
+
+## Fonctions associées
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPathWithoutLocale.md) : Supprime le segment de la locale d'une URL ou d'un chemin.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPrefix.md) : Détermine le préfixe d'URL pour une locale donnée.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocalizedUrl.md) : Génère une URL localisée pour une locale spécifique.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire comparePaths"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Unified documentation for all exports"
@@ -108,19 +111,21 @@ Import :
 import "intlayer";
 ```
 
-| Fonction               | Type       | Description                                               | Documentation associée                                                                                                          |
-| ---------------------- | ---------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `getLocale`            | `Fonction` | Détecte la locale à partir d'une chaîne ou d'un chemin.   | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocale.md)                       |
-| `getLocaleLang`        | `Function` | Obtient la partie langue d'une locale.                    | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocaleLang.md)               |
-| `getLocaleName`        | `Function` | Obtient le nom d'affichage d'une locale.                  | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocaleName.md)               |
-| `getLocalizedPath`     | `Function` | Résout un chemin canonique vers sa version localisée.     | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocalizedPath.md)         |
-| `getCanonicalPath`     | `Function` | Résout un chemin localisé vers sa forme canonique.        | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getCanonicalPath.md)         |
-| `getLocalizedUrl`      | `Function` | Génère une URL localisée.                                 | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocalizedUrl.md)           |
-| `getMultilingualUrls`  | `Function` | Génère des URLs pour toutes les locales prises en charge. | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getMultilingualUrls.md)   |
-| `getPathWithoutLocale` | `Function` | Supprime le préfixe de locale d'un chemin.                | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPathWithoutLocale.md) |
-| `getPrefix`            | `Function` | Récupère le préfixe de locale d'un chemin.                | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPrefix.md)                       |
-| `getHTMLTextDir`       | `Function` | Obtient la direction du texte (LTR/RTL).                  | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getHTMLTextDir.md)             |
-| `validatePrefix`       | `Function` | Valide un préfixe de locale.                              | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/validatePrefix.md)             |
+| Fonction               | Type       | Description                                                  | Documentation associée                                                                                                          |
+| ---------------------- | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| `getLocale`            | `Fonction` | Détecte la locale à partir d'une chaîne ou d'un chemin.      | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocale.md)                       |
+| `getLocaleLang`        | `Function` | Obtient la partie langue d'une locale.                       | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocaleLang.md)               |
+| `getLocaleName`        | `Function` | Obtient le nom d'affichage d'une locale.                     | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocaleName.md)               |
+| `getLocalizedPath`     | `Function` | Résout un chemin canonique vers sa version localisée.        | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocalizedPath.md)         |
+| `getCanonicalPath`     | `Function` | Résout un chemin localisé vers sa forme canonique.           | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getCanonicalPath.md)         |
+| `getLocalizedUrl`      | `Function` | Génère une URL localisée.                                    | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocalizedUrl.md)           |
+| `getMultilingualUrls`  | `Function` | Génère des URLs pour toutes les locales prises en charge.    | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getMultilingualUrls.md)   |
+| `getPathWithoutLocale` | `Function` | Supprime le préfixe de locale d'un chemin.                   | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPathWithoutLocale.md) |
+| `getPrefix`            | `Function` | Récupère le préfixe de locale d'un chemin.                   | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | Compare deux chemins en ignorant la locale.                  | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | Normalise un chemin vers un chemin indépendant de la locale. | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/comparePaths.md)                 |
+| `getHTMLTextDir`       | `Function` | Obtient la direction du texte (LTR/RTL).                     | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getHTMLTextDir.md)             |
+| `validatePrefix`       | `Function` | Valide un préfixe de locale.                                 | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/validatePrefix.md)             |
 
 ### Utilitaires du navigateur
 

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

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentation unifiée pour toutes les exportations"
@@ -99,6 +102,7 @@ Réexporte la plupart des hooks depuis `react-intlayer`.
 | `useDictionaryAsync`   | Hook qui gère des dictionnaires asynchrones. Accepte une map de dictionnaires basée sur des promesses et la résout pour la locale courante.                 | -                                                                                                                       |
 | `useDictionaryDynamic` | Hook qui gère des dictionnaires dynamiques chargés par clé. Utilise React Suspense en interne pour les états de chargement.                                 | -                                                                                                                       |
 | `useLocale`            | Hook côté client pour récupérer la locale courante et une fonction pour la définir. Amélioré pour Next.js App Router avec prise en charge de la navigation. | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | Retourne le chemin actuel sans le préfixe de la locale et sans les paramètres de requête de locale.                                                         | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | Hook côté client pour gérer les réécritures d'URL. Met automatiquement à jour l'URL si une règle de réécriture localisée plus "propre" existe.              | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/next-intlayer/useRewriteURL.md)  |
 | `useLocalePageRouter`  | Hook spécifique au Page Router de Next.js pour la gestion des locales. Gère les redirections et les rechargements de page lors des changements de locale.   | -                                                                                                                       |
 | `useI18n`              | Hook qui fournit une fonction de traduction `t()` pour accéder au contenu imbriqué par clé. Imite le pattern i18next/next-intl.                             | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/useI18n.md)             |

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

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentation du Hook usePathname | next-intlayer
+description: Découvrez comment utiliser le hook usePathname avec le package next-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalisation
+  - Documentation
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - next-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Initialisation de l'historique"
+author: aymericzip
+---
+
+# Intégration Next.js : Documentation du Hook `usePathname`
+
+Le hook `usePathname` retourne le chemin (pathname) actuel de Next.js en supprimant le segment de la locale. Il est utile pour créer une navigation adaptée à la locale — par exemple, déterminer quel élément de navigation est actif — sans avoir à retirer manuellement le préfixe de la locale.
+
+## Importer `usePathname` dans Next.js
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## Aperçu
+
+`usePathname` enveloppe le hook natif `usePathname()` de Next.js provenant de `next/navigation`, ajoute les paramètres de recherche (search params), et retire le préfixe de la locale via `getPathWithoutLocale`. Il se met à jour à chaque navigation côté client. Ce hook n'est disponible que dans les Composants Clients (Client Components, nécessite `"use client"`).
+
+## Utilisation
+
+```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;
+```
+
+## Valeur de retour
+
+| Type     | Description                                                                                         |
+| -------- | --------------------------------------------------------------------------------------------------- |
+| `string` | Le chemin actuel sans le préfixe de locale et les paramètres de recherche débarrassés de la locale. |
+
+## Comportement
+
+- **Suppression de la locale** : Retire le segment de locale initial (ex. `/fr/dashboard` → `/dashboard`).
+- **Suppression des paramètres de recherche** : Retire également le paramètre de requête `?locale=...` lorsqu'un mode de routage basé sur les paramètres de recherche est utilisé.
+- **Réactif** : Se met à jour à chaque navigation côté client via Next.js App Router.
+- **Compatible SSR** : Retourne le chemin côté serveur lors du premier rendu, puis synchronise les paramètres de recherche côté client.
+
+## Comparaison avec `useLocale`
+
+`useLocale` de `next-intlayer` expose déjà `pathWithoutLocale` dans sa valeur de retour. Utilisez `usePathname` lorsque vous n'avez besoin que du chemin et non de la fonctionnalité de changement de locale.
+
+```tsx codeFormat={["typescript", "esm"]}
+// Lorsque vous avez besoin à la fois de l'état de la locale et du chemin :
+import { useLocale } from "next-intlayer";
+const { locale, pathWithoutLocale } = useLocale();
+
+// Lorsque vous n'avez besoin que du chemin :
+import { usePathname } from "next-intlayer";
+const pathname = usePathname();
+```
+
+## Exemple
+
+```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: "Tableau de bord" },
+  { href: "/settings", label: "Paramètres" },
+];
+
+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;
+```
+
+## Liens connexes
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/next-intlayer/useLocale.md) — locale actuelle + sélecteur de locale (expose aussi `pathWithoutLocale`)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPathWithoutLocale.md) — l'utilitaire sous-jacent utilisé par ce hook

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

@@ -14,6 +14,9 @@ slugs:
   - preact-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentation unifiée pour tous les exports"
@@ -40,12 +43,13 @@ npm install preact-intlayer
 
 ### Hooks
 
-| Hook            | Description                                                                                                                   | Doc associée                                                                                          |
-| --------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
-| `useIntlayer`   | Basé sur `useDictionary`, mais injecte une version optimisée du dictionnaire issue de la déclaration générée.                 | -                                                                                                     |
-| `useDictionary` | Traite les objets qui ressemblent à des dictionnaires (clé, contenu). Il traite les traductions `t()`, les énumérations, etc. | -                                                                                                     |
-| `useLocale`     | Renvoie la locale actuelle et une fonction pour la définir.                                                                   | -                                                                                                     |
-| `t`             | Sélectionne le contenu en fonction de la locale courante.                                                                     | [traduction](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/translation.md) |
+| Hook            | Description                                                                                                                   | Doc associée                                                                                                         |
+| --------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Basé sur `useDictionary`, mais injecte une version optimisée du dictionnaire issue de la déclaration générée.                 | -                                                                                                                    |
+| `useDictionary` | Traite les objets qui ressemblent à des dictionnaires (clé, contenu). Il traite les traductions `t()`, les énumérations, etc. | -                                                                                                                    |
+| `useLocale`     | Renvoie la locale actuelle et une fonction pour la définir.                                                                   | -                                                                                                                    |
+| `usePathname`   | Hook qui retourne le chemin actuel avec le segment de locale retiré. Réactif à la navigation du navigateur via `popstate`.    | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/preact-intlayer/usePathname.md) |
+| `t`             | Sélectionne le contenu en fonction de la locale courante.                                                                     | [traduction](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/translation.md)                |
 
 ### Composants
 

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

@@ -0,0 +1,117 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentation du Hook usePathname | preact-intlayer
+description: Découvrez comment utiliser le hook usePathname avec le package preact-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalisation
+  - Documentation
+  - Preact
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - preact-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Initialisation de l'historique"
+author: aymericzip
+---
+
+# Intégration Preact : Documentation du Hook `usePathname`
+
+Le hook `usePathname` retourne le chemin actuel du navigateur en supprimant le segment de la locale. Il est utile pour créer une navigation adaptée à la locale — par exemple, pour déterminer quel élément de navigation est actif — sans avoir à supprimer manuellement le préfixe de la locale.
+
+## Importer `usePathname` dans Preact
+
+```typescript
+import { usePathname } from "preact-intlayer";
+```
+
+## Aperçu
+
+`usePathname` lit `window.location.pathname`, retire le préfixe de la locale via `getPathWithoutLocale`, et déclenche un nouveau rendu du composant chaque fois que le navigateur émet un événement `popstate` (navigation via les boutons Précédent/Suivant). Il retourne une chaîne vide pendant le rendu côté serveur (SSR).
+
+## Utilisation
+
+```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;
+```
+
+## Valeur de Retour
+
+| Type     | Description                                                                            |
+| -------- | -------------------------------------------------------------------------------------- |
+| `string` | Le chemin actuel sans le préfixe de la locale. Chaîne vide lors du rendu côté serveur. |
+
+## Comportement
+
+- **Suppression de la locale** : Retire le segment de locale au début de l'URL (ex. `/fr/dashboard` → `/dashboard`).
+- **Réactif** : Se met à jour automatiquement lors des événements `popstate` (navigation Précédent / Suivant du navigateur).
+- **Compatible SSR** : Retourne `""` lorsque `window` n'est pas disponible.
+- **Nettoyage** : L'écouteur `popstate` est supprimé automatiquement lors du démontage du composant.
+
+## Exemple
+
+```tsx fileName="src/components/Sidebar.tsx"
+import type { FunctionComponent } from "preact";
+import { usePathname } from "preact-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "Tableau de bord" },
+  { href: "/settings", label: "Paramètres" },
+];
+
+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;
+```
+
+## Ressources associées
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/preact-intlayer/exports.md) — locale actuelle + sélecteur de locale
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPathWithoutLocale.md) — l'utilitaire sous-jacent employé par ce hook

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

@@ -14,6 +14,9 @@ slugs:
   - react-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire usePathname"
   - version: 7.5.14
     date: 2026-01-21
     changes: "Documentation unifiée pour tous les exports"
@@ -64,6 +67,7 @@ import "react-intlayer";
 | `useDictionaryDynamic` | Hook qui gère des dictionnaires dynamiques chargés par clé. Utilise React Suspense en interne pour gérer les états de chargement.                     | -                                                                                                                       |
 | `useLocale`            | Hook côté client pour obtenir la locale courante, la locale par défaut, les locales disponibles, et une fonction pour mettre à jour la locale.        | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/useLocale.md)         |
 | `useLocaleBase`        | Hook pour obtenir la locale actuelle et tous les champs associés (locale, defaultLocale, availableLocales, setLocale) depuis le contexte.             | -                                                                                                                       |
+| `usePathname`          | Hook qui renvoie le chemin actuel (pathname) avec le segment de locale supprimé. Réactif à la navigation du navigateur via `popstate`.                | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Hook côté client pour gérer les réécritures d'URL. Si une règle de réécriture existe pour le pathname et la locale actuels, elle mettra à jour l'URL. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/useRewriteURL.md) |
 | `useI18n`              | Hook qui fournit une fonction de traduction `t()` pour accéder au contenu imbriqué par clé. Imite le pattern i18next/next-intl.                       | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/useI18n.md)             |
 | `useIntl`              | Hook qui fournit un objet `Intl` lié à la locale. Injecte automatiquement la locale courante et utilise un cache optimisé.                            | -                                                                                                                       |

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

@@ -0,0 +1,87 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentation du Hook usePathname | react-intlayer
+description: Apprenez à utiliser le hook usePathname du package react-intlayer pour obtenir le chemin (pathname) de l'URL actuelle sans le segment de langue.
+keywords:
+  - usePathname
+  - pathname
+  - react
+  - intlayer
+  - routing
+  - internationalisation
+slugs:
+  - doc
+  - packages
+  - react-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Initialisation de l'historique"
+author: aymericzip
+---
+
+# Intégration React : Documentation du Hook `usePathname`
+
+Le hook `usePathname` de `react-intlayer` renvoie le chemin (pathname) actuel du navigateur avec le segment de locale supprimé. Il s'appuie sur la propriété native `window.location.pathname` et réagit aux événements de navigation du navigateur via `popstate`.
+
+## Importer `usePathname`
+
+```typescript
+import { usePathname } from "react-intlayer";
+```
+
+## Vue d'ensemble
+
+Contrairement aux hooks de routage spécifiques aux frameworks (comme ceux de `next-intlayer` ou `react-router`), ce hook est une solution légère et indépendante de tout framework pour les applications React classiques. Il extrait l'URL actuelle et supprime tout préfixe de langue correspondant (par exemple, `/fr/about` devient `/about`).
+
+## Utilisation
+
+```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" }}
+      >
+        Accueil
+      </a>
+      <a
+        href="/about"
+        style={{ fontWeight: pathname === "/about" ? "bold" : "normal" }}
+      >
+        À propos
+      </a>
+    </nav>
+  );
+};
+
+export default Navigation;
+```
+
+## Valeur de Retour
+
+| Type     | Description                                                                                                         |
+| -------- | ------------------------------------------------------------------------------------------------------------------- |
+| `string` | Le chemin (pathname) actuel du navigateur avec le préfixe de locale supprimé (ex : `/fr/dashboard` → `/dashboard`). |
+
+## Comportement
+
+- **Suppression de la locale** : Utilise l'utilitaire `getPathWithoutLocale` en interne pour détecter et supprimer automatiquement la locale du pathname en fonction de la configuration Intlayer de l'application.
+- **Réactivité** : Écoute l'événement `popstate`. Lorsque l'utilisateur navigue à l'aide des boutons précédent/suivant du navigateur ou lorsque `pushState`/`replaceState` est appelé, le hook met à jour le pathname retourné.
+- **Repli SSR** : Côté serveur (où `window` est indéfini), il renvoie `/` par défaut puisqu'il n'a pas accès à l'URL de la requête par défaut dans un contexte React pur.
+
+## Documentation Associée
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/useLocale.md)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getPathWithoutLocale.md)

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

@@ -14,6 +14,9 @@ slugs:
   - solid-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Ajout de l'utilitaire usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentation unifiée pour tous les exports"
@@ -59,6 +62,7 @@ import "solid-intlayer";
 | `useDictionaryAsync`   | Identique à `useDictionary`, mais gère les dictionnaires asynchrones.                                                            | -                                                                                                                       |
 | `useDictionaryDynamic` | Identique à `useDictionary`, mais gère les dictionnaires dynamiques.                                                             | -                                                                                                                       |
 | `useLocale`            | Retourne la locale actuelle et une fonction pour la définir.                                                                     | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/solid-intlayer/useLocale.md)         |
+| `usePathname`          | Retourne le chemin (pathname) actuel sous forme d'`Accessor<string>` en ignorant le segment de la locale. Réactif à `popstate`.  | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/solid-intlayer/usePathname.md)     |
 | `useRewriteURL`        | Hook côté client pour gérer les réécritures d'URL. Met à jour automatiquement l'URL si une règle de réécriture localisée existe. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/solid-intlayer/useRewriteURL.md) |
 | `useIntl`              | Retourne l'objet Intl pour la locale actuelle.                                                                                   | -                                                                                                                       |
 | `useLoadDynamic`       | Hook pour charger des dictionnaires dynamiques.                                                                                  | -                                                                                                                       |