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

package/docs/es/migration_from_react-i18next_to_intlayer.md

@@ -100,24 +100,44 @@ Los siguientes pasos son el mínimo requerido para que tu aplicación `react-i18
 
 Instala los paquetes principales de Intlayer y los adaptadores de compatibilidad:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> la bandera `--interactive` es opcional. Usa `intlayer-cli init` si eres un agente de IA.
+
+> Este comando detectará su entorno e instalará los paquetes necesarios. Por ejemplo:
+
 ```bash packageManager="npm"
 npm install intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Puedes mantener `react-i18next` e `i18next` instalados — los adaptadores de compatibilidad los usan como `devDependencies` / `peerDependencies` opcionales para los tipos de TypeScript. No necesitas cambiar ningún peer de tu `package.json`.
@@ -193,9 +213,7 @@ import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
 
 const withIntlayer = createNextI18nPlugin();
 
-const nextConfig: NextConfig = {
-  /* tus opciones */
-};
+const nextConfig: NextConfig = {/* tus opciones */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/es/migration_from_vue-i18n_to_intlayer.md

@@ -99,24 +99,44 @@ Los siguientes pasos son el mínimo requerido para que tu aplicación `vue-i18n`
 
 Instala los paquetes principales de Intlayer y el adaptador de compatibilidad:
 
+```bash packageManager="npm"
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
+```
+
+```bash packageManager="bun"
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
+```
+
+> la bandera `--interactive` es opcional. Usa `intlayer-cli init` si eres un agente de IA.
+
+> Este comando detectará su entorno e instalará los paquetes necesarios. Por ejemplo:
+
 ```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
 ```
 
 > Puedes mantener `vue-i18n` instalado — el adaptador de compatibilidad lo usa como `devDependency` / `peerDependency` para los tipos de TypeScript.

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

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Documentación del paquete @intlayer/babel"
+description: Complementos de Babel para Intlayer para manejar la extracción de contenido, la optimización de importaciones, la depuración de campos no utilizados y la ofuscación de nombres de campos durante la compilación.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - internacionalización
+  - i18n
+  - compilador
+  - optimizar
+  - depurar
+  - minificar
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Documentación unificada de todas las exportaciones"
+author: aymericzip
+---
+
+# Paquete @intlayer/babel
+
+El paquete `@intlayer/babel` proporciona un conjunto de plugins de Babel especializados para Intlayer. Estos plugins cubren todo el ciclo de compilación: extracción de declaraciones de contenido, reescritura de llamadas a `useIntlayer` / `getIntlayer` a importaciones de diccionarios optimizadas, depuración de campos no utilizados y minificación de nombres de campos.
+
+## Instalación
+
+```bash
+npm install @intlayer/babel
+```
+
+## Exportaciones
+
+Importar:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Plugins
+
+| Función / Clase                | Descripción                                                                                                                                                                                                              |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `intlayerExtractBabelPlugin`   | Plugin de Babel que extrae contenido traducible de archivos fuente e inyecta los hooks `useIntlayer` / `getIntlayer` automáticamente. Diseñado para su uso con Next.js y herramientas de compilación basadas en Babel.   |
+| `intlayerOptimizeBabelPlugin`  | Plugin de Babel que transforma las llamadas `useIntlayer` y `getIntlayer` y reescribe sus importaciones a importaciones de diccionarios JSON optimizadas (estáticas, dinámicas o a través de fetch).                     |
+| `intlayerPurgeBabelPlugin`     | Plugin de Babel que analiza archivos fuente y reescribe archivos JSON de diccionarios compilados para eliminar campos no utilizados (`build.purge`) o renombrarlos a alias cortos (`build.minify`).                      |
+| `intlayerMinifyBabelPlugin`    | Plugin de Babel que reescribe archivos fuente para usar los alias de campos cortos asignados durante la fase de minificación (por ejemplo, `content.title` ← `content.a`). Depende de `intlayerPurgeBabelPlugin`.        |
+| `makeFieldRenameBabelPlugin`   | Función de fábrica que produce un plugin de Babel para renombrar los accesos a campos de contenido de diccionarios en archivos fuente de acuerdo con la `dictionaryKeyToFieldRenameMap` completada en el `PruneContext`. |
+| `makeUsageAnalyzerBabelPlugin` | Función de fábrica que produce un plugin de Babel para analizar el uso de `useIntlayer` / `getIntlayer` en el código fuente y acumular datos de uso de campos en el `PruneContext` compartido.                           |
+| `getSharedPruneContext`        | Función de ayuda que devuelve el objeto `PruneContext` compartido para el directorio base especificado, o `null` si aún no se ha inicializado.                                                                           |
+
+---
+
+### Utilidades de configuración del plugin
+
+| Función                    | Descripción                                                                                                                                                |
+| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getExtractPluginOptions`  | Carga la configuración de Intlayer y devuelve `ExtractPluginOptions` listas para su uso con `intlayerExtractBabelPlugin`.                                  |
+| `getOptimizePluginOptions` | Carga la configuración de Intlayer y los diccionarios compilados, y devuelve `OptimizePluginOptions` listas para su uso con `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Carga la configuración de Intlayer y devuelve `PurgePluginOptions` listas para su uso con `intlayerPurgeBabelPlugin`.                                      |
+| `getMinifyPluginOptions`   | Carga la configuración de Intlayer y devuelve `MinifyPluginOptions` listas para su uso con `intlayerMinifyBabelPlugin`.                                    |
+
+---
+
+### Tipos
+
+| Tipo                    | Descripción                                                                                                                                       |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Modo de compilador: `'dev'` para desarrollo con soporte HMR, o `'build'` para compilaciones de producción.                                        |
+| `ExtractPluginOptions`  | Opciones para `intlayerExtractBabelPlugin`: lista de archivos, configuración, callback `onExtract`, etc.                                          |
+| `ExtractResult`         | Resultado de la extracción: clave de diccionario, ruta del archivo, contenido y idioma.                                                           |
+| `OptimizePluginOptions` | Opciones para `intlayerOptimizeBabelPlugin`: rutas de diccionarios, modo de importación, mapa de modos por diccionario, etc.                      |
+| `PurgePluginOptions`    | Opciones para `intlayerPurgeBabelPlugin`: directorio base, indicadores de depuración/minificación/optimización, lista de archivos de componentes. |
+| `MinifyPluginOptions`   | Opciones para `intlayerMinifyBabelPlugin`: directorio base, indicadores de minificación/optimización/editorEnabled.                               |
+| `PruneContext`          | Estado compartido entre los plugins de análisis y depuración: mapas de uso de campos, mapas de renombrado, etc.                                   |
+| `DictionaryFieldUsage`  | Resultado del uso de campos para un solo diccionario: `Set<string>` o `'all'` cuando el análisis estático no es concluyente.                      |
+| `NestedRenameEntry`     | Nodo en el árbol de renombrado: el `shortName` y el mapa de hijos.                                                                                |
+| `NestedRenameMap`       | Un nivel en el árbol de renombrado: `Map<string, NestedRenameEntry>`.                                                                             |
+| `CompatCallerConfig`    | Configuración para un analizador de uso compatible para paquetes compat-adapter (nombre de la llamada y opciones de procesamiento).               |
+| `ScriptBlock`           | Bloque de script extraído de un tệp SFC (Vue o Svelte): contenido, desplazamiento de inicio y desplazamiento de final.                            |
+
+---
+
+### Funciones utilitarias
+
+| Función                           | Description                                                                                                                                                                                   |
+| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Convierte un entero (empezando desde cero) en un identificador alfabético corto: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, etc.                                                               |
+| `buildNestedRenameMapFromContent` | Construye recursivamente una `NestedRenameMap` a partir del valor de contenido de un diccionario compilado, respetando las estructuras de nodos de Intlayer (translation, enumeration, etc.). |
+| `createPruneContext`              | Crea un nuevo objeto `PruneContext` vacío inicializado con los valores predeterminados.                                                                                                       |
+| `extractScriptBlocks`             | Extrae bloques `<script>` de archivos SFC (Vue / Svelte) para un análisis Babel posterior.                                                                                                    |
+| `BABEL_PARSER_OPTIONS`            | Constante que representa las opciones del parser de Babel que cubren los frameworks admitidos (React/Vue/Svelte/Angular/...).                                                                 |
+| `INTLAYER_CALLER_NAMES`           | Lista constante de nombres de llamada originales de Intlayer: `['useIntlayer', 'getIntlayer']`.                                                                                               |
+
+---
+
+## Ejemplo de uso
+
+```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()],
+  ],
+};
+```
+
+> **Nota:** El plugin `intlayerPurgeBabelPlugin` debe declararse **antes** de `intlayerMinifyBabelPlugin`, porque este último lee el mapa de renombrado creado por el primero. Además, ambos deben estar precedidos por `intlayerOptimizeBabelPlugin` para que este pueda ver las claves del diccionario antes de que se reescriban las llamadas a `useIntlayer`.

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

@@ -14,6 +14,9 @@ slugs:
   - angular-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Añadida utilidad usePathname"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentación unificada para todas las exportaciones"
@@ -46,15 +49,16 @@ import "angular-intlayer";
 
 ### Hooks
 
-| Hook                   | Descripción                                                                                                         | Documento relacionado |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------- | --------------------- |
-| `useIntlayer`          | Basado en `useDictionary`, pero inyecta una versión optimizada del diccionario a partir de la declaración generada. | -                     |
-| `useDictionary`        | Procesa objetos que parecen diccionarios (clave, contenido). Procesa traducciones `t()`, enumeraciones, etc.        | -                     |
-| `useDictionaryAsync`   | Igual que `useDictionary`, pero maneja diccionarios asíncronos.                                                     | -                     |
-| `useDictionaryDynamic` | Igual que `useDictionary`, pero maneja diccionarios dinámicos.                                                      | -                     |
-| `useLocale`            | Devuelve la locale actual y una función para establecerla.                                                          | -                     |
-| `useIntl`              | Devuelve el objeto Intl para la locale actual.                                                                      | -                     |
-| `useLoadDynamic`       | Hook para cargar diccionarios dinámicos.                                                                            | -                     |
+| Hook                   | Descripción                                                                                                                           | Documento relacionado                                                                                                 |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | Basado en `useDictionary`, pero inyecta una versión optimizada del diccionario a partir de la declaración generada.                   | -                                                                                                                     |
+| `useDictionary`        | Procesa objetos que parecen diccionarios (clave, contenido). Procesa traducciones `t()`, enumeraciones, etc.                          | -                                                                                                                     |
+| `useDictionaryAsync`   | Igual que `useDictionary`, pero maneja diccionarios asíncronos.                                                                       | -                                                                                                                     |
+| `useDictionaryDynamic` | Igual que `useDictionary`, pero maneja diccionarios dinámicos.                                                                        | -                                                                                                                     |
+| `useLocale`            | Devuelve la locale actual y una función para establecerla.                                                                            | -                                                                                                                     |
+| `usePathname`          | Devuelve la ruta actual como un `Signal<string>` con el segmento de idioma eliminado. Reactivo a `popstate` a través de `DestroyRef`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | Devuelve el objeto Intl para la locale actual.                                                                                        | -                                                                                                                     |
+| `useLoadDynamic`       | Hook para cargar diccionarios dinámicos.                                                                                              | -                                                                                                                     |
 
 ### Componentes
 

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentación del Hook usePathname | angular-intlayer
+description: Descubre cómo utilizar el hook usePathname en el paquete angular-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internacionalización
+  - Documentación
+  - Angular
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Añadida utilidad usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inicialización del historial"
+author: aymericzip
+---
+
+# Integración Angular: Documentación del Hook `usePathname`
+
+El hook `usePathname` devuelve la ruta de navegación actual del navegador con el segmento de idioma eliminado, como un `Signal<string>` de Angular. Es útil para construir navegación basada en idiomas — por ejemplo, para determinar qué elemento de navegación está activo — sin tener que eliminar manualmente el prefijo de idioma.
+
+## Importar `usePathname` en Angular
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## Resumen
+
+`usePathname` lee `window.location.pathname`, elimina el prefijo de idioma usando `getPathWithoutLocale` y actualiza el signal cada vez que el navegador dispara un evento `popstate` (navegación atrás/adelante). Utiliza el `DestroyRef` de Angular para limpiar automáticamente el escuchador de eventos cuando el componente es destruido.
+
+## Uso
+
+```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();
+}
+```
+
+## Valor de retorno
+
+| Tipo             | Descripción                                                              |
+| ---------------- | ------------------------------------------------------------------------ |
+| `Signal<string>` | Signal de Angular que contiene la ruta actual sin el prefijo del idioma. |
+
+## Comportamiento
+
+- **Eliminación del idioma**: Elimina el segmento inicial del idioma (ej. `/es/dashboard` → `/dashboard`).
+- **Reactivo**: Se actualiza automáticamente en los eventos `popstate` (navegación atrás / adelante del navegador).
+- **Compatible con SSR**: Devuelve `""` cuando `window` no está disponible.
+- **Limpieza**: El escuchador `popstate` se elimina a través de `DestroyRef.onDestroy` cuando el componente anfitrión es destruido.
+
+## Ejemplo
+
+```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();
+}
+```
+
+## Relacionado
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/angular-intlayer/exports.md) — idioma actual + selector de idiomas
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPathWithoutLocale.md) — la utilidad subyacente utilizada por este hook

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

@@ -269,15 +269,6 @@ app.get("/morning", (_req, res) => {
 
 ---
 
-## Consejos para un Uso Efectivo
-
-1. **Centralizar las Traducciones**: Utilice un módulo centralizado o archivos JSON para gestionar las traducciones y mejorar el mantenimiento.
-2. **Validar las Traducciones**: Asegúrese de que cada variante de idioma tenga una traducción correspondiente para evitar retrocesos innecesarios.
-3. **Combinar con i18n en el Frontend**: Sincronice con la internacionalización del frontend para una experiencia de usuario fluida en toda la aplicación.
-4. **Medir el Rendimiento**: Pruebe los tiempos de respuesta de su aplicación al agregar traducciones para asegurar un impacto mínimo.
-
----
-
 ## Conclusión
 
 1. **Centralizar las traducciones**: Utilice un módulo centralizado o archivos JSON para gestionar las traducciones y mejorar el mantenimiento.

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentación de la función comparePaths | intlayer
+description: Descubre cómo utilizar la función comparePaths para el paquete intlayer
+keywords:
+  - comparePaths
+  - normalizePath
+  - enlace activo
+  - navegación
+  - Intlayer
+  - intlayer
+  - Internacionalización
+  - Documentación
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "Documentación inicial"
+author: aymericzip
+---
+
+# Documentación: Función `comparePaths` en `intlayer`
+
+## Descripción
+
+La función `comparePaths` compara dos URL o rutas para comprobar su igualdad mientras ignora el segmento de idioma (locale), el protocolo/dominio, la cadena de consulta (query string), el hash y las barras diagonales finales. Es la forma recomendada para determinar si un enlace de navegación apunta a la página actual —por ejemplo, para resaltar el enlace activo— sin tener que implementar tu propia lógica de normalización (propensa a errores).
+
+Internamente reutiliza [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPathWithoutLocale.md) para eliminar el segmento de idioma, por lo que respeta tu modo de enrutamiento y los idiomas configurados.
+
+El paquete también exporta la utilidad subyacente [`normalizePath`](#normalizepath), que devuelve la ruta canónica independiente del idioma utilizada para la comparación.
+
+**Características principales:**
+
+- Comparación independiente del idioma (`/es/about` coincide con `/about`)
+- Funciona con URL absolutas y rutas relativas
+- Ignora la cadena de consulta, el hash y las barras diagonales finales
+- Tolera la ausencia de barra oblicua inicial y valores vacíos (normalizado a `/`)
+- Ligero — construido sobre `getPathWithoutLocale`
+
+---
+
+## Firma de la función
+
+```typescript
+comparePaths(
+  pathname: string,  // Requerido
+  href: string,      // Requerido
+  locales?: Locales[] // Opcional
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Requerido
+  locales?: Locales[] // Opcional
+): string
+```
+
+---
+
+## Parámetros
+
+- `pathname: string`
+  - **Descripción**: La primera cadena de URL o ruta a comparar (generalmente la ruta actual).
+  - **Tipo**: `string`
+  - **Requerido**: Sí
+
+- `href: string`
+  - **Descripción**: La segunda cadena de URL o ruta a comparar (generalmente el `href` de un enlace de navegación).
+  - **Tipo**: `string`
+  - **Requerido**: Sí
+
+- `locales: Locales[]`
+  - **Descripción**: Array opcional de idiomas soportados. Por defecto, los idiomas configurados en el proyecto.
+  - **Tipo**: `Locales[]`
+  - **Requerido**: No (Opcional)
+
+### Retornos
+
+- **Tipo**: `boolean`
+- **Descripción**: `true` cuando ambas entradas se resuelven a la misma ruta independiente del idioma, de lo contrario `false`.
+
+---
+
+## Ejemplo de uso
+
+### Uso básico
+
+```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 absolutas y relativas
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### Resaltar el enlace de navegación activo
+
+```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` devuelve la ruta canónica e independiente del idioma utilizada por `comparePaths`. Elimina el segmento de idioma, el protocolo/dominio, la cadena de consulta y el hash, asegura una única barra oblicua inicial, elimina cualquier barra diagonal final (excepto en la raíz) y usa `/` como valor predeterminado para valores vacíos.
+
+```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"
+```
+
+---
+
+## Funciones relacionadas
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPathWithoutLocale.md): Elimina el segmento de idioma de una URL o ruta.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPrefix.md): Determina el prefijo de URL para un idioma dado.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocalizedUrl.md): Genera una URL localizada para un idioma específico.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "Añadida la utilidad comparePaths"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentación unificada para todas las exportaciones"
@@ -108,19 +111,21 @@ Importación:
 import "intlayer";
 ```
 
-| Función                | Tipo       | Descripción                                         | Documento relacionado                                                                                                           |
-| ---------------------- | ---------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| `getLocale`            | `Function` | Detecta el locale a partir de una cadena o ruta.    | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocale.md)                       |
-| `getLocaleLang`        | `Function` | Obtiene la parte de idioma de un locale.            | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocaleLang.md)               |
-| `getLocaleName`        | `Function` | Obtiene el nombre para mostrar de un locale.        | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocaleName.md)               |
-| `getLocalizedPath`     | `Function` | Resuelve una ruta canónica a su versión localizada. | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocalizedPath.md)         |
-| `getCanonicalPath`     | `Function` | Resuelve una ruta localizada a su forma canónica.   | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getCanonicalPath.md)         |
-| `getLocalizedUrl`      | `Function` | Genera una URL localizada.                          | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocalizedUrl.md)           |
-| `getMultilingualUrls`  | `Function` | Genera URLs para todos los locales soportados.      | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getMultilingualUrls.md)   |
-| `getPathWithoutLocale` | `Function` | Elimina el prefijo de idioma de una ruta.           | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPathWithoutLocale.md) |
-| `getPrefix`            | `Function` | Obtiene el prefijo de idioma de una ruta.           | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPrefix.md)                       |
-| `getHTMLTextDir`       | `Function` | Obtiene la dirección del texto (LTR/RTL).           | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getHTMLTextDir.md)             |
-| `validatePrefix`       | `Function` | Valida un prefijo de locale.                        | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/validatePrefix.md)             |
+| Función                | Tipo       | Descripción                                            | Documento relacionado                                                                                                           |
+| ---------------------- | ---------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
+| `getLocale`            | `Function` | Detecta el locale a partir de una cadena o ruta.       | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocale.md)                       |
+| `getLocaleLang`        | `Function` | Obtiene la parte de idioma de un locale.               | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocaleLang.md)               |
+| `getLocaleName`        | `Function` | Obtiene el nombre para mostrar de un locale.           | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocaleName.md)               |
+| `getLocalizedPath`     | `Function` | Resuelve una ruta canónica a su versión localizada.    | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocalizedPath.md)         |
+| `getCanonicalPath`     | `Function` | Resuelve una ruta localizada a su forma canónica.      | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getCanonicalPath.md)         |
+| `getLocalizedUrl`      | `Function` | Genera una URL localizada.                             | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocalizedUrl.md)           |
+| `getMultilingualUrls`  | `Function` | Genera URLs para todos los locales soportados.         | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getMultilingualUrls.md)   |
+| `getPathWithoutLocale` | `Function` | Elimina el prefijo de idioma de una ruta.              | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPathWithoutLocale.md) |
+| `getPrefix`            | `Function` | Obtiene el prefijo de idioma de una ruta.              | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | Compara dos rutas ignorando la configuración regional. | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | Normaliza una ruta a una independiente del idioma.     | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/comparePaths.md)                 |
+| `getHTMLTextDir`       | `Function` | Obtiene la dirección del texto (LTR/RTL).              | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getHTMLTextDir.md)             |
+| `validatePrefix`       | `Function` | Valida un prefijo de locale.                           | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/validatePrefix.md)             |
 
 ### Utilidades del navegador