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

package/docs/pt/migration_from_next-intl_to_intlayer.md

@@ -97,24 +97,40 @@ As etapas a seguir são o mínimo necessário para executar seu aplicativo `next
 
 Instale os pacotes principais do Intlayer e o adaptador de compatibilidade `@intlayer/next-intl`:
 
+```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
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```bash packageManager="npm"
 npm install intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer next-intlayer @intlayer/next-intl @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Mantenha o `next-intl` instalado — ele ainda é exigido para o **roteamento de URL** (`createNavigation`, `createMiddleware`, `Link`, `redirect`, `usePathname`, `useRouter`). O adaptador de compatibilidade **não** substitui a camada de roteamento.

package/docs/pt/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -100,24 +100,40 @@ As etapas a seguir são o mínimo necessário para executar seu aplicativo Nuxt
 
 Instale o pacote principal do Intlayer e o adaptador de compatibilidade:
 
+```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
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer vue-intlayer nuxt-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Fique a vontade para manter o `@nuxtjs/i18n` instalado e ativo seguramente ao longo de sua etapa de migração do código (estaremos desabilitando e varrendo o tal serviço brevemente na definição/configuração principal do Nuxt ali no passo adiante).

package/docs/pt/migration_from_react-i18next_to_intlayer.md

@@ -100,24 +100,40 @@ As etapas a seguir são o mínimo necessário para executar seu aplicativo `reac
 
 Instale o pacote principal do Intlayer e o adaptador de compatibilidade:
 
+```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
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```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
 ```
 
 > Mantenha em segurança os seus pacotes ligados diretamente de base instalados na aplicação vinda da estrutura original como o seu `react-i18next` acompanhado ainda paralelamente do `i18next` presentes no decorrer de tudo que fará. O novo adaptador encarregado na compatibilização com ele faz proveito exigindo tais referências com ligações que visam fins relacionados à averiguação do compilador TypeScript enquanto classificados de forma branda seja no modo das conhecidas marcações opcionais tratadas por opções designadas pelas extensões denominadas em formato de rótulos tanto pela vertente de `devDependencies` ou via preenchimento sob o arranjo de modelo atrelado por características na modelagem visual de exigência e suporte de classes associadas referidas por via das `peerDependencies`. Em sumo e no final do percurso de execução prática, em tempo nenhum por parte deste ou aquele momento, a menor que seja uma obrigatória modificação se mostrará pedida e passará exigindo ter ou haver edição prévia nas dependências originadas em base à sua antiga raiz contida sob a sua grade de pares inserida lá mesmo perante arquivos definidores de referências presentes nos módulos contidos no final com a exata terminação e nome por parte da listagem no seu base e raiz `package.json`.

package/docs/pt/migration_from_vue-i18n_to_intlayer.md

@@ -99,24 +99,40 @@ As etapas a seguir são o mínimo necessário para executar seu aplicativo `vue-
 
 Instale o pacote principal do Intlayer e o adaptador de compatibilidade:
 
+```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
+```
+
+> a flag `--interactive` é opcional. Use `intlayer-cli init` se você for um agente de IA.
+
+> Este comando detectará seu ambiente e instalará os pacotes necessários. Por exemplo:
+
 ```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
 ```
 
 > Você pode manter o pacote base listado que reside na estrutura e formato focado de uso com nome via o termo para designar listando no pacote no seu aplicativo onde mora as referências provindas perante via com base e nome referenciado provindo com termo em base e listado `vue-i18n` como instalado contido na segurança com total integridade e em extrema segurança na raiz com total via perante do base na via do projeto perante a estrutura base de dependências — todo pacote auxiliar que encarrega por trás com adaptação na classe de auxiliar de adaptador das compatibilidades e das partes engajadas por vias ligadas a auxiliar de compatibilidade usa por trás dos cenários focando a parte contida por e para encarregado na fonte atrelada perante em classificar nas bases atadas via dependência secundária onde habita nas extensões designando por vias do lado para apontamento atrelado a `devDependency` / com o parceiro no arrasto no caso o também lado voltado nas configurações na área designando apontamentos no caso referenciando apontamento focado em vias das frentes designando com `peerDependency` operando tudo isso em bases de referências para focar em retornos atrelados com utilidade no caso do foco de uso em retornos encarregados por via ao auxílio para auxiliar a parte atrelada base no uso focado perante o lado do auxílio com o compilador base perante a estruturação dos tipos e arranjos atrelados do que lida ali no modo onde opera com a área dos arranjos voltados perante e de utilidade pro ambiente e linguagem provinda listando com formatação perante o auxílio provindo na parte que opera e encarrega sob o Typescript focando com as vias de suas tratativas atadas e ligadas às partes dos e para encarregados ao repasse focando repasses visando com vias do compilador nas listagens nas frentes que atam com encarregados via dos "tipos TypeScript".

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

@@ -14,9 +14,12 @@ slugs:
   - angular-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Adicionado utilitário usePathname"
   - version: 8.0.0
     date: 2026-01-21
-    changes: "Documentação unificada para todos os exports"
+    changes: "Documentação unificada para todas as exportações"
 author: aymericzip
 ---
 
@@ -46,15 +49,16 @@ import "angular-intlayer";
 
 ### Hooks
 
-| Hook                   | Descrição                                                                                                      | Documento Relacionado |
-| ---------------------- | -------------------------------------------------------------------------------------------------------------- | --------------------- |
-| `useIntlayer`          | Baseado em `useDictionary`, mas injeta uma versão otimizada do dicionário a partir da declaração gerada.       | -                     |
-| `useDictionary`        | Processa objetos que se parecem com dicionários (chave, conteúdo). Processa traduções `t()`, enumerações, etc. | -                     |
-| `useDictionaryAsync`   | Mesmo que `useDictionary`, mas lida com dicionários assíncronos.                                               | -                     |
-| `useDictionaryDynamic` | Mesmo que `useDictionary`, mas lida com dicionários dinâmicos.                                                 | -                     |
-| `useLocale`            | Retorna a locale atual e uma função para defini-la.                                                            | -                     |
-| `useIntl`              | Retorna o objeto Intl para a locale atual.                                                                     | -                     |
-| `useLoadDynamic`       | Hook para carregar dicionários dinâmicos.                                                                      | -                     |
+| Hook                   | Descrição                                                                                                                       | Documento Relacionado                                                                                                 |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`          | Baseado em `useDictionary`, mas injeta uma versão otimizada do dicionário a partir da declaração gerada.                        | -                                                                                                                     |
+| `useDictionary`        | Processa objetos que se parecem com dicionários (chave, conteúdo). Processa traduções `t()`, enumerações, etc.                  | -                                                                                                                     |
+| `useDictionaryAsync`   | Mesmo que `useDictionary`, mas lida com dicionários assíncronos.                                                                | -                                                                                                                     |
+| `useDictionaryDynamic` | Mesmo que `useDictionary`, mas lida com dicionários dinâmicos.                                                                  | -                                                                                                                     |
+| `useLocale`            | Retorna a localidade atual e uma função para configurá-la.                                                                      | -                                                                                                                     |
+| `usePathname`          | Retorna o pathname atual como um `Signal<string>` com o segmento de localidade removido. Reativo a `popstate` via `DestroyRef`. | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/angular-intlayer/usePathname.md) |
+| `useIntl`              | Retorna o objeto Intl para a localidade atual.                                                                                  | -                                                                                                                     |
+| `useLoadDynamic`       | Hook para carregar dicionários dinâmicos.                                                                                       | -                                                                                                                     |
 
 ### Componentes
 

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

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentação do Hook usePathname | angular-intlayer
+description: Veja como usar o hook usePathname no pacote angular-intlayer
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internacionalização
+  - Documentação
+  - Angular
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Adicionado utilitário usePathname"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "Inicialização do histórico"
+author: aymericzip
+---
+
+# Integração Angular: Documentação do Hook `usePathname`
+
+O hook `usePathname` retorna o caminho (pathname) atual do navegador com o segmento de localidade removido, na forma de um `Signal<string>` do Angular. Ele é útil para criar navegação sensível à localidade — por exemplo, para determinar qual item de navegação está ativo — sem precisar remover o prefixo da localidade manualmente.
+
+## Importando `usePathname` no Angular
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## Visão Geral
+
+O `usePathname` lê o `window.location.pathname`, remove o prefixo de localidade via `getPathWithoutLocale` e atualiza o sinal sempre que o navegador aciona um evento `popstate` (navegação para trás/frente). Ele utiliza o `DestroyRef` do Angular para limpar automaticamente o ouvinte de eventos quando o componente é destruído.
+
+## 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             | Descrição                                                               |
+| ---------------- | ----------------------------------------------------------------------- |
+| `Signal<string>` | Sinal do Angular contendo o pathname atual sem o prefixo da localidade. |
+
+## Comportamento
+
+- **Remoção da localidade**: Remove o segmento inicial de localidade (ex. `/pt/dashboard` → `/dashboard`).
+- **Reativo**: Atualiza automaticamente em eventos `popstate` (navegação de voltar/avançar no navegador).
+- **Seguro em SSR**: Retorna `""` quando `window` não está disponível.
+- **Limpeza**: O ouvinte de `popstate` é removido via `DestroyRef.onDestroy` quando o componente pai é destruído.
+
+## Exemplo
+
+```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: "Configurações" },
+  ];
+
+  readonly pathname = usePathname();
+}
+```
+
+## Relacionados
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/angular-intlayer/exports.md) — localidade atual + alternador de localidade
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getPathWithoutLocale.md) — o utilitário principal usado por este hook

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: Documentação da função comparePaths | intlayer
+description: Veja como usar a função comparePaths para o pacote intlayer
+keywords:
+  - comparePaths
+  - normalizePath
+  - link ativo
+  - navegação
+  - Intlayer
+  - intlayer
+  - Internacionalização
+  - Documentação
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "Documentação inicial"
+author: aymericzip
+---
+
+# Documentação: Função `comparePaths` em `intlayer`
+
+## Descrição
+
+A função `comparePaths` compara duas URLs ou caminhos para verificar sua igualdade, ignorando o segmento de locale, o protocolo/host, a query string, o hash e as barras finais (trailing slashes). É a maneira recomendada de determinar se um link de navegação aponta para a página atual — por exemplo, para destacar o link ativo — sem ter que criar sua própria lógica de normalização (sujeita a erros).
+
+Internamente, ela reutiliza [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getPathWithoutLocale.md) para remover o segmento de locale, de modo que respeita o modo de roteamento e os locales configurados.
+
+O pacote também exporta o utilitário subjacente [`normalizePath`](#normalizepath), que retorna o caminho canônico e independente de locale usado para a comparação.
+
+**Principais Características:**
+
+- Comparação independente de locale (`/pt/about` corresponde a `/about`)
+- Funciona com URLs absolutas e caminhos relativos
+- Ignora query string, hash e barras finais
+- Tolera a ausência de barras iniciais e valores vazios (normalizado para `/`)
+- Leve — construído sobre `getPathWithoutLocale`
+
+---
+
+## Assinatura da Função
+
+```typescript
+comparePaths(
+  pathname: string,  // Obrigatório
+  href: string,      // Obrigatório
+  locales?: Locales[] // Opcional
+): boolean
+
+normalizePath(
+  inputUrl: string,   // Obrigatório
+  locales?: Locales[] // Opcional
+): string
+```
+
+---
+
+## Parâmetros
+
+- `pathname: string`
+  - **Descrição**: A primeira string de URL ou caminho a ser comparada (geralmente o caminho atual).
+  - **Tipo**: `string`
+  - **Obrigatório**: Sim
+
+- `href: string`
+  - **Descrição**: A segunda string de URL ou caminho a ser comparada (geralmente o `href` de um link de navegação).
+  - **Tipo**: `string`
+  - **Obrigatório**: Sim
+
+- `locales: Locales[]`
+  - **Descrição**: Array opcional de locales suportados. Por padrão, os locales configurados no projeto.
+  - **Tipo**: `Locales[]`
+  - **Obrigatório**: Não (Opcional)
+
+### Retorno
+
+- **Tipo**: `boolean`
+- **Descrição**: `true` quando ambas as entradas resolvem para o mesmo caminho independente de locale, caso contrário `false`.
+
+---
+
+## Exemplo 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
+```
+
+### URLs absolutas e relativas
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### Destacando o link de navegação ativo
+
+```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` retorna o caminho canônico e independente de locale usado por `comparePaths`. Ele remove o segmento de locale, o protocolo/host, a query string e o hash, garante uma única barra inicial, remove qualquer barra final (exceto para a raiz) e usa `/` como fallback para valores vazios.
+
+```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"
+```
+
+---
+
+## Funções Relacionadas
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getPathWithoutLocale.md): Remove o segmento de locale de uma URL ou caminho.
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getPrefix.md): Determina o prefixo da URL para um dado locale.
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getLocalizedUrl.md): Gera uma URL localizada para um locale específico.
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "Adicionado o utilitário comparePaths"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Unified documentation for all exports"
@@ -119,6 +122,8 @@ import "intlayer";
 | `getMultilingualUrls`  | `Function` | Gera URLs para todos os locales suportados.            | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getMultilingualUrls.md)   |
 | `getPathWithoutLocale` | `Function` | Remove o prefixo de locale de um caminho.              | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getPathWithoutLocale.md) |
 | `getPrefix`            | `Function` | Obtém o prefixo de locale de um caminho.               | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | Compara dois caminhos ignorando o locale.              | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | Normaliza um caminho para um independente de locale.   | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/comparePaths.md)                 |
 | `getHTMLTextDir`       | `Function` | Obtém a direção do texto (LTR/RTL).                    | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getHTMLTextDir.md)             |
 | `validatePrefix`       | `Function` | Valida um prefixo de locale.                           | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/validatePrefix.md)             |
 

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

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "Utilitário usePathname adicionado"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentação unificada para todas as exportações"
@@ -99,6 +102,7 @@ Re-exporta a maioria dos hooks de `react-intlayer`.
 | `useDictionaryAsync`   | Hook que lida com dicionários assíncronos. Aceita um mapa de dicionários baseado em Promise e resolve-o para o locale atual.                        | -                                                                                                                       |
 | `useDictionaryDynamic` | Hook que lida com dicionários dinâmicos carregados por chave. Usa React Suspense internamente para estados de carregamento.                         | -                                                                                                                       |
 | `useLocale`            | Hook do lado do cliente para obter a locale atual e uma função para defini-la. Aprimorado para o App Router do Next.js com suporte à navegação.     | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | Retorna o caminho atual sem o prefixo da localidade e sem os parâmetros de consulta da localidade.                                                  | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | Hook do lado do cliente para gerenciar reescritas de URL. Atualiza automaticamente a URL se existir uma regra de reescrita localizada mais legível. | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/next-intlayer/useRewriteURL.md)  |
 | `useLocalePageRouter`  | Hook específico do Page Router do Next.js para gerenciamento de locale. Trata redirecionamentos e recarregamentos de página ao alterar o locale.    | -                                                                                                                       |
 | `useI18n`              | Hook que fornece uma função de tradução `t()` para acessar conteúdo aninhado por chave. Imita o padrão i18next/next-intl.                           | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/react-intlayer/useI18n.md)             |