@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/fr/migration_from_vue-i18n_to_intlayer.md

@@ -17,9 +17,10 @@ slugs:
   - migration
   - vue-i18n
 history:
-  - version: 8.13.0
+  - version: 9.0.0
     date: 2026-06-05
     changes: "Init history"
+author: aymericzip
 ---
 
 # Migrer de vue-i18n à Intlayer
@@ -98,24 +99,40 @@ Les étapes suivantes sont le minimum requis pour faire fonctionner votre applic
 
 Installez les packages principaux d'Intlayer et l'adaptateur de compatibilité :
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> l'indicateur `--interactive` est facultatif. Utilisez `intlayer-cli init` si vous êtes un agent IA.
+
+> Cette commande détectera votre environnement et installera les packages requis. Par exemple :
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Vous pouvez garder `vue-i18n` installé — l'adaptateur de compatibilité l'utilise comme `devDependency` / `peerDependency` pour les types TypeScript.

package/docs/fr/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Documentation du package @intlayer/babel"
+description: Plugins Babel pour Intlayer afin de gérer l'extraction de contenu, l'optimisation des importations, la purge des champs inutilisés et le masquage des noms de champs lors de la construction.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - internationalisation
+  - i18n
+  - compilateur
+  - optimiser
+  - purger
+  - minifier
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Documentation unifiée de toutes les exportations"
+author: aymericzip
+---
+
+# Package @intlayer/babel
+
+Le package `@intlayer/babel` fournit un ensemble de plugins Babel spécialisés pour Intlayer. Ces plugins couvrent l'ensemble du cycle de construction : extraction des déclarations de contenu, réécriture des appels `useIntlayer` / `getIntlayer` en importations de dictionnaires optimisés, purge des champs inutilisés et minification des noms de champs.
+
+## Installation
+
+```bash
+npm install @intlayer/babel
+```
+
+## Exportations
+
+Importation :
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Plugins
+
+| Fonction / Classe              | Description                                                                                                                                                                                                                  |
+| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | Plugin Babel qui extrait le contenu traduisible des fichiers sources et injecte automatiquement les hooks `useIntlayer` / `getIntlayer`. Conçu pour être utilisé avec Next.js et les outils de construction basés sur Babel. |
+| `intlayerOptimizeBabelPlugin`  | Plugin Babel qui transforme les appels `useIntlayer` et `getIntlayer` et réécrit leurs importations en importations de dictionnaires JSON optimisées (statiques, dynamiques ou via fetch).                                   |
+| `intlayerPurgeBabelPlugin`     | Plugin Babel qui analyse les fichiers sources et réécrit les fichiers JSON des dictionnaires compilés pour supprimer les champs inutilisés (`build.purge`) ou les renommer en alias courts (`build.minify`).                 |
+| `intlayerMinifyBabelPlugin`    | Plugin Babel qui réécrit les fichiers sources pour utiliser les alias de champs courts attribués pendant la phase de minification (par exemple, `content.title` ← `content.a`). Dépend de `intlayerPurgeBabelPlugin`.        |
+| `makeFieldRenameBabelPlugin`   | Fonction factory qui produit un plugin Babel pour renommer les accès aux champs de contenu des dictionnaires dans les fichiers sources selon la `dictionaryKeyToFieldRenameMap` renseignée dans le `PruneContext`.           |
+| `makeUsageAnalyzerBabelPlugin` | Fonction factory qui produit un plugin Babel pour analyser l'utilisation de `useIntlayer` / `getIntlayer` dans le code source et regrouper les données d'utilisation des champs dans le `PruneContext` partagé.              |
+| `getSharedPruneContext`        | Fonction utilitaire qui renvoie l'objet `PruneContext` partagé pour le répertoire de base spécifié, ou `null` si le contexte n'a pas encore été initialisé.                                                                  |
+
+---
+
+### Utilitaires de configuration des plugins
+
+| Fonction                   | Description                                                                                                                                                  |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `getExtractPluginOptions`  | Charge la configuration Intlayer et renvoie les `ExtractPluginOptions` prêtes à l'emploi avec `intlayerExtractBabelPlugin`.                                  |
+| `getOptimizePluginOptions` | Charge la configuration Intlayer et les dictionnaires compilés, et renvoie les `OptimizePluginOptions` prêtes à l'emploi avec `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Charge la configuration Intlayer et renvoie les `PurgePluginOptions` prêtes à l'emploi avec `intlayerPurgeBabelPlugin`.                                      |
+| `getMinifyPluginOptions`   | Charge la configuration Intlayer et renvoie les `MinifyPluginOptions` prêtes à l'emploi avec `intlayerMinifyBabelPlugin`.                                    |
+
+---
+
+### Types
+
+| Type                    | Description                                                                                                                                |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `CompilerMode`          | Mode du compilateur : `'dev'` pour le développement avec support HMR, ou `'build'` pour les builds de production.                          |
+| `ExtractPluginOptions`  | Options pour `intlayerExtractBabelPlugin` : liste des fichiers, configuration, callback `onExtract`, etc.                                  |
+| `ExtractResult`         | Résultat de l'extraction : clé de dictionnaire, chemin du fichier, contenu et locale.                                                      |
+| `OptimizePluginOptions` | Options pour `intlayerOptimizeBabelPlugin` : chemins des dictionnaires, mode d'importation, carte des modes par dictionnaire, etc.         |
+| `PurgePluginOptions`    | Options pour `intlayerPurgeBabelPlugin` : répertoire de base, drapeaux purge/minify/optimize, liste des fichiers de composants.            |
+| `MinifyPluginOptions`   | Options pour `intlayerMinifyBabelPlugin` : répertoire de base, drapeaux minify/optimize/editorEnabled.                                     |
+| `PruneContext`          | État partagé entre les plugins d'analyse et de purge : cartes d'utilisation des champs, cartes de renommage, etc.                          |
+| `DictionaryFieldUsage`  | Résultat de l'utilisation des champs pour un seul dictionnaire : `Set<string>` ou `'all'` lorsque l'analyse statique n'est pas concluante. |
+| `NestedRenameEntry`     | Nœud dans l'arbre de renommage : le `shortName` et la carte des enfants.                                                                   |
+| `NestedRenameMap`       | Un niveau dans l'arbre de renommage : `Map<string, NestedRenameEntry>`.                                                                    |
+| `CompatCallerConfig`    | Configuration pour un analyseur d'utilisation compatible pour les packages compat-adapter (nom de l'appelant et options de traitement).    |
+| `ScriptBlock`           | Bloc de script extrait d'un fichier SFC (Vue ou Svelte) : contenu, décalage de début et décalage de fin.                                   |
+
+---
+
+### Fonctions utilitaires
+
+| Fonction                          | Description                                                                                                                                                                                       |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Convertit un entier (en commençant par zéro) en un identifiant alphabétique court : `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, etc.                                                                |
+| `buildNestedRenameMapFromContent` | Construit de manière récursive une `NestedRenameMap` à partir de la valeur du contenu d'un dictionnaire compilé, en respectant les structures de nœuds Intlayer (translation, enumeration, etc.). |
+| `createPruneContext`              | Crée un nouvel objet `PruneContext` vide initialisé avec les valeurs par défaut.                                                                                                                  |
+| `extractScriptBlocks`             | Extrait les blocs `<script>` des fichiers SFC (Vue / Svelte) pour une analyse Babel ultérieure.                                                                                                   |
+| `BABEL_PARSER_OPTIONS`            | Constante représentant les options du parseur Babel couvrant les frameworks pris en charge (React/Vue/Svelte/Angular/...).                                                                        |
+| `INTLAYER_CALLER_NAMES`           | Liste constante des noms d'appelants originaux d'Intlayer : `['useIntlayer', 'getIntlayer']`.                                                                                                     |
+
+---
+
+## Exemple d'utilisation
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **Note :** Le plugin `intlayerPurgeBabelPlugin` doit être déclaré **avant** `intlayerMinifyBabelPlugin`, car ce dernier lit la carte de renommage construite par le premier. De plus, ils doivent tous deux être précédés par `intlayerOptimizeBabelPlugin` afin que celui-ci puisse voir les clés de dictionnaire avant que les appels à `useIntlayer` ne soient réécrits.

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

@@ -18,6 +18,7 @@ history:
   - version: 8.0.0
     date: 2026-01-30
     changes: "Documentation initiale"
+author: aymericzip
 ---
 
 # Package adonis-intlayer

package/docs/fr/packages/adonis-intlayer/intlayer.md

@@ -19,6 +19,7 @@ history:
   - version: 8.0.0
     date: 2026-01-30
     changes: "Documentation initiale"
+author: aymericzip
 ---
 
 # Documentation du Middleware AdonisJS Intlayer

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

@@ -20,6 +20,7 @@ history:
   - version: 8.0.0
     date: 2026-01-30
     changes: "Documentation initiale"
+author: aymericzip
 ---
 
 # Documentation : Fonction `t` dans `adonis-intlayer`

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

@@ -14,9 +14,13 @@ slugs:
   - angular-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"
+author: aymericzip
 ---
 
 # Package angular-intlayer
@@ -45,15 +49,16 @@ import "angular-intlayer";
 
 ### Hooks
 
-| Hook                   | Description                                                                                                                 | Documentation 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 gère les traductions `t()`, les énumérations, etc. | -                      |
-| `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.                                                                | -                      |
-| `useIntl`              | Retourne l'objet Intl pour la locale courante.                                                                              | -                      |
-| `useLoadDynamic`       | Hook pour charger des dictionnaires dynamiques.                                                                             | -                      |
+| Hook                   | Description                                                                                                                         | Documentation 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 gère les traductions `t()`, les énumérations, etc.         | -                                                                                                                     |
+| `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.                                                                        | -                                                                                                                     |
+| `usePathname`          | Retourne le chemin actuel sous forme de `Signal<string>` avec le segment de locale supprimé. Réactif à `popstate` via `DestroyRef`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | Retourne l'objet Intl pour la locale courante.                                                                                      | -                                                                                                                     |
+| `useLoadDynamic`       | Hook pour charger des dictionnaires dynamiques.                                                                                     | -                                                                                                                     |
 
 ### Composants
 

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

@@ -17,6 +17,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentation unifiée pour tous les exports"
+author: aymericzip
 ---
 
 # Paquet astro-intlayer

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

@@ -18,6 +18,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentation unifiée pour tous les exports"
+author: aymericzip
 ---
 
 # Package express-intlayer

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

@@ -20,6 +20,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Initialisation de la documentation"
+author: aymericzip
 ---
 
 # Documentation du middleware intlayer pour Express

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

@@ -21,6 +21,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Historique initial"
+author: aymericzip
 ---
 
 # Documentation : Fonction `t` dans `express-intlayer`
@@ -279,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/fastify-intlayer/exports.md

@@ -18,6 +18,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentation unifiée pour tous les exports"
+author: aymericzip
 ---
 
 # Package fastify-intlayer

package/docs/fr/packages/fastify-intlayer/intlayer.md

@@ -20,6 +20,7 @@ history:
   - version: 8.0.0
     date: 2026-01-21
     changes: "Initialisation de la documentation"
+author: aymericzip
 ---
 
 # Documentation du plugin intlayer pour Fastify

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

@@ -18,6 +18,7 @@ history:
   - version: 8.0.0
     date: 2026-01-29
     changes: "Documentation unifiée pour tous les exports"
+author: aymericzip
 ---
 
 # Paquet hono-intlayer

package/docs/fr/packages/hono-intlayer/intlayer.md

@@ -19,6 +19,7 @@ history:
   - version: 8.0.0
     date: 2026-01-29
     changes: "Initialisation de la doc"
+author: aymericzip
 ---
 
 # Documentation du Middleware Hono intlayer

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

@@ -20,6 +20,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "Historique initial"
+author: aymericzip
 ---
 
 # Documentation : Fonction `t` dans `hono-intlayer`

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;
+```