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

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentation du Hook usePathname | angular-intlayer
+description: Découvrez comment utiliser le hook usePathname pour le package angular-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalisation
+  - Documentation
+  - Angular
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - angular-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 Angular : Documentation du Hook `usePathname`
+
+Le hook `usePathname` retourne le chemin de navigation actuel du navigateur avec le segment de locale supprimé, sous forme de `Signal<string>` Angular. Il est utile pour construire une navigation tenant compte de 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 Angular
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## Aperçu
+
+`usePathname` lit `window.location.pathname`, supprime le préfixe de la locale via `getPathWithoutLocale`, et met à jour le signal chaque fois que le navigateur déclenche un événement `popstate` (navigation retour/avant). Il utilise `DestroyRef` d'Angular pour nettoyer automatiquement l'écouteur d'événements lorsque le composant est détruit.
+
+## Utilisation
+
+```typescript fileName="src/app/nav-item.component.ts"
+import { Component, input } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-nav-item",
+  template: `
+    <a
+      [href]="href()"
+      [attr.aria-current]="pathname() === href() ? 'page' : null"
+    >
+      {{ label() }}
+    </a>
+  `,
+})
+export class NavItemComponent {
+  readonly href = input.required<string>();
+  readonly label = input.required<string>();
+
+  readonly pathname = usePathname();
+}
+```
+
+## Valeur de retour
+
+| Type             | Description                                                             |
+| ---------------- | ----------------------------------------------------------------------- |
+| `Signal<string>` | Signal Angular contenant le chemin actuel sans le préfixe de la locale. |
+
+## Comportement
+
+- **Suppression de la locale** : Supprime le segment de locale initial (ex. `/fr/dashboard` → `/dashboard`).
+- **Réactif** : Se met à jour automatiquement lors d'événements `popstate` (navigation retour / avant du navigateur).
+- **Compatible SSR** : Retourne `""` lorsque `window` n'est pas disponible.
+- **Nettoyage** : L'écouteur `popstate` est supprimé via `DestroyRef.onDestroy` lorsque le composant hôte est détruit.
+
+## Exemple
+
+```typescript fileName="src/app/sidebar.component.ts"
+import { Component } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-sidebar",
+  template: `
+    <nav>
+      @for (link of links; track link.href) {
+        <a
+          [href]="link.href"
+          [style.font-weight]="pathname() === link.href ? 'bold' : 'normal'"
+        >
+          {{ link.label }}
+        </a>
+      }
+    </nav>
+  `,
+})
+export class SidebarComponent {
+  readonly links = [
+    { href: "/dashboard", label: "Dashboard" },
+    { href: "/settings", label: "Settings" },
+  ];
+
+  readonly pathname = usePathname();
+}
+```
+
+## Liens associés
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/angular-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 utilisé par ce hook

package/docs/fr/packages/express-intlayer/t.md

@@ -280,13 +280,4 @@ app.get("/morning", (_req, res) => {
 
 ## Conclusion
 
-1. **Centraliser les traductions** : Utilisez un module centralisé ou des fichiers JSON pour gérer les traductions afin d'améliorer la maintenabilité.
-2. **Valider les traductions** : Assurez-vous que chaque variante linguistique dispose d'une traduction correspondante pour éviter les retours inutiles.
-3. **Combiner avec l'i18n frontend** : Synchronisez avec l'internationalisation frontend pour une expérience utilisateur fluide dans toute l'application.
-4. **Évaluer les performances** : Testez les temps de réponse de votre application lors de l'ajout de traductions pour garantir un impact minimal.
-
----
-
-## Conclusion
-
 La fonction `t` est un outil puissant pour l'internationalisation backend. En l'utilisant efficacement, vous pouvez créer une application plus inclusive et conviviale pour un public mondial. Pour une utilisation avancée et des options de configuration détaillées, référez-vous à la [documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md).

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

@@ -29,6 +29,38 @@ author: aymericzip
 
 ## Description
 
+La fonction `getLocalizedUrl` génère une URL localisée en préfixant l'URL donnée avec la locale spécifiée. Elle gère à la fois les URLs absolues et relatives, en s'assurant que le bon préfixe de locale est appliqué en fonction de la configuration.
+
+**Caractéristiques principales :**
+
+- Seulement 2 paramètres sont requis : `url` et `currentLocale`
+- Objet `options` optionnel avec `locales`, `defaultLocale`, et `mode`
+- Utilise la configuration d'internationalisation de votre projet comme valeurs par défaut
+- Peut être utilisé avec des paramètres minimaux pour les cas simples ou entièrement personnalisé pour les scénarios complexes
+- Supporte plusieurs modes de routage : `prefix-no-default`, `prefix-all`, `no-prefix`, et `search-params`
+
+---
+
+## Signature de fonction
+
+```typescript
+getLocalizedUrl(
+  url: string,                   // Requis
+  currentLocale: Locales,        // Requis
+  options?: {                    // Optionnel
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): string
+```
+
+---
+
+## Paramètres
+
+## Description
+
 La fonction `getLocalizedUrl` génère une URL localisée en préfixant l'URL donnée avec la locale spécifiée. Elle gère à la fois les URL absolues et relatives, en s'assurant que le préfixe de locale correct est appliqué selon la configuration.
 
 ---
@@ -67,6 +99,23 @@ La fonction `getLocalizedUrl` génère une URL localisée en préfixant l'URL do
 
 ## Exemple d'utilisation
 
+### Utilisation basique (Paramètres obligatoires uniquement)
+
+Lorsque vous avez configuré votre projet avec les paramètres d'internationalisation, vous pouvez utiliser la fonction avec juste les paramètres obligatoires :
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Utilise la configuration de votre projet pour les locales, defaultLocale et mode
+getLocalizedUrl("/about", Locales.FRENCH);
+// Output: "/fr/about" (en supposant que le français est supporté et que le mode est 'prefix-no-default')
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// Output: "/about" ou "/en/about" (en fonction de votre paramètre de mode)
+```
+
+## Exemple d'utilisation
+
 ### URLs relatives
 
 ```typescript codeFormat={["typescript", "esm"]}
@@ -114,6 +163,30 @@ getLocalizedUrl(
 // Résultat : "/about" pour la locale par défaut (anglais)
 ```
 
+### Remplacement Partiel de la Configuration
+
+Vous pouvez également fournir uniquement certains paramètres optionnels. La fonction utilisera la configuration de votre projet pour tous les paramètres que vous ne spécifiez pas :
+
+```typescript codeFormat="typescript"
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Remplacer uniquement les locales, utiliser la config du projet pour defaultLocale et mode
+getLocalizedUrl("/about", Locales.SPANISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+});
+
+// Remplacer uniquement le mode, utiliser la config du projet pour locales et defaultLocale
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  mode: "prefix-all", // Forcer le préfixe pour toutes les locales y compris la locale par défaut
+});
+
+// Remplacer plusieurs options
+getLocalizedUrl("/about", Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params", // Utiliser les paramètres de requête : /about?locale=fr
+});
+```
+
 ### URLs absolues
 
 ```typescript

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

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## Description
 
+La fonction `getMultilingualUrls` génère un mapping d'URLs multilingues en préfixant l'URL donnée avec chaque locale supportée. Elle peut gérer à la fois les URLs absolues et relatives, en appliquant le préfixe de locale approprié en fonction de la configuration fournie ou des valeurs par défaut.
+
+**Caractéristiques principales :**
+
+- Un seul paramètre est requis : `url`
+- Objet `options` optionnel avec `locales`, `defaultLocale` et `mode`
+- Utilise la configuration d'internationalisation de votre projet comme valeurs par défaut
+- Supporte plusieurs modes de routage : `prefix-no-default`, `prefix-all`, `no-prefix` et `search-params`
+- Retourne un objet de mapping avec toutes les locales comme clés et leurs URLs correspondantes comme valeurs
+
+---
+
+## Description
+
 La fonction `getMultilingualUrls` génère une correspondance d'URLs multilingues en préfixant l'URL donnée avec chaque locale prise en charge. Elle peut gérer à la fois des URLs absolues et relatives, en appliquant le préfixe de locale approprié basé sur la configuration fournie ou les valeurs par défaut.
 
 ---
 
 ## Paramètres
 
+## Paramètres
+
 - `url: string`
   - **Description** : La chaîne URL originale à préfixer avec les locales.
   - **Type** : `string`
@@ -54,6 +70,33 @@ La fonction `getMultilingualUrls` génère une correspondance d'URLs multilingue
   - **Type** : `boolean`
   - **Défaut** : `prefixDefaultDefault`
 
+### Paramètres Optionnels
+
+- `options?: object`
+  - **Description**: Objet de configuration pour le comportement de localisation des URL.
+  - **Type**: `object`
+  - **Required**: Non (Optionnel)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Tableau des locales supportées. Si non fourni, utilise les locales configurées dans la configuration de votre projet.
+    - **Type**: `Locales[]`
+    - **Default**: [`Configuration du Projet`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: La locale par défaut pour l'application. Si non fournie, utilise la locale par défaut configurée dans la configuration de votre projet.
+    - **Type**: `Locales`
+    - **Default**: [`Configuration du Projet`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: Le mode de routage des URL pour la gestion des locales. Si non fourni, utilise le mode configuré dans la configuration de votre projet.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Configuration du Projet`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Pas de préfixe pour la locale par défaut, préfixe pour toutes les autres
+      - `prefix-all`: Préfixe pour toutes les locales y compris la locale par défaut
+      - `no-prefix`: Pas de préfixe de locale dans l'URL
+      - `search-params`: Utiliser les paramètres de requête pour la locale (par ex. `?locale=fr`)
+
 ### Retour
 
 - **Type** : `IConfigLocales<string>`
@@ -61,6 +104,8 @@ La fonction `getMultilingualUrls` génère une correspondance d'URLs multilingue
 
 ---
 
+## Utilisation d'exemple
+
 ## Exemple d'utilisation
 
 ### URLs relatives
@@ -97,6 +142,60 @@ getMultilingualUrls(
 
 ---
 
+### Différents Modes de Routage
+
+```typescript
+// prefix-no-default: Pas de préfixe pour la locale par défaut
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Output: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: Préfixe pour toutes les locales
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// Output: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: Pas de préfixe de locale dans les URLs
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// Output: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: Locale comme paramètre de requête
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// Output: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## Cas particuliers
 
 - **Pas de segment de locale :**

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/t.md

@@ -102,7 +102,7 @@ export const ServerComponentExample: FC = () => (
 );
 ```
 
-###Traductions en ligne dans les attributs
+### Traductions en ligne dans les attributs
 
 La fonction `t` est particulièrement utile pour les traductions en ligne dans les attributs JSX.
 Lors de la localisation d'attributs tels que `alt`, `title`, `href` ou `aria-label`, vous pouvez utiliser `t` directement dans l'attribut.