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

package/docs/pt/migration_from_i18next_to_intlayer.md

@@ -98,24 +98,44 @@ As etapas a seguir são o mínimo necessário para executar seu aplicativo `i18n
 
 Instale o pacote principal do Intlayer e o adaptador de compatibilidade:
 
+```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
+```
+
+> 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 @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Você pode manter o `i18next` instalado com segurança — o adaptador de compatibilidade o utiliza como uma `devDependency` / `peerDependency` para tipos TypeScript.

package/docs/pt/migration_from_next-i18next_to_intlayer.md

@@ -101,24 +101,44 @@ As etapas a seguir são o mínimo necessário para executar seu aplicativo Next.
 
 Instale os pacotes principais do Intlayer e os adaptadores de compatibilidade:
 
+```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
+```
+
+> 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 react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer next-intlayer react-intlayer @intlayer/next-i18next @intlayer/react-i18next @intlayer/i18next @intlayer/sync-json-plugin
-bun x intlayer init
 ```
 
 > Você pode manter com segurança o `next-i18next`, `react-i18next` e `i18next` instalados durante a migração até que os aliases sejam resolvidos.

package/docs/pt/migration_from_next-intl_to_intlayer.md

@@ -97,24 +97,44 @@ 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@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
+```
+
+> 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.
@@ -168,9 +188,7 @@ import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
 
 const withIntlayer = createNextIntlPlugin();
 
-const nextConfig: NextConfig = {
-  /* Suas opções de configuração existentes */
-};
+const nextConfig: NextConfig = {/* Suas opções de configuração existentes */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/pt/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -100,24 +100,44 @@ 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@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
+```
+
+> 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,44 @@ 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@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
+```
+
+> 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`.
@@ -193,9 +213,7 @@ import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
 
 const withIntlayer = createNextI18nPlugin();
 
-const nextConfig: NextConfig = {
-  /* Suas opções de configuração */
-};
+const nextConfig: NextConfig = {/* Suas opções de configuração */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/pt/migration_from_vue-i18n_to_intlayer.md

@@ -99,24 +99,44 @@ 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@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
+```
+
+> 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/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "Documentação do pacote @intlayer/babel"
+description: Plugins do Babel para o Intlayer para lidar com extração de conteúdo, otimização de importação, limpeza de campos não utilizados e ofuscação de nomes de campos durante a compilação.
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - internacionalização
+  - i18n
+  - compilador
+  - otimizar
+  - limpar
+  - minificar
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "Documentação unificada de todas as exportações"
+author: aymericzip
+---
+
+# Pacote @intlayer/babel
+
+O pacote `@intlayer/babel` fornece um conjunto de plugins especializados do Babel para o Intlayer. Esses plugins cobrem todo o ciclo de build: extração de declarações de conteúdo, reescrita de chamadas `useIntlayer` / `getIntlayer` para importações de dicionário otimizadas, limpeza de campos não utilizados e minificação de nomes de campos.
+
+## Instalação
+
+```bash
+npm install @intlayer/babel
+```
+
+## Exportações
+
+Importar:
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### Plugins
+
+| Função / Classe                | Descrição                                                                                                                                                                                                                |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `intlayerExtractBabelPlugin`   | Plugin do Babel que extrai conteúdo traduzível de arquivos-fonte e injeta ganchos (hooks) `useIntlayer` / `getIntlayer` automaticamente. Projetado para uso com o Next.js e ferramentas de compilação baseadas em Babel. |
+| `intlayerOptimizeBabelPlugin`  | Plugin do Babel que transforma chamadas `useIntlayer` e `getIntlayer` e reescreve suas importações para importações de dicionário JSON otimizadas (estáticas, dinâmicas ou via fetch).                                   |
+| `intlayerPurgeBabelPlugin`     | Plugin do Babel que analisa arquivos-fonte e reescreve arquivos JSON de dicionário compilados para remover campos não utilizados (`build.purge`) ou renomeá-los para aliases curtos (`build.minify`).                    |
+| `intlayerMinifyBabelPlugin`    | Plugin do Babel que reescreve arquivos-fonte para usar os aliases curtos de campo atribuídos durante a fase de minificação (por exemplo, `content.title` ← `content.a`). Depende do `intlayerPruneBabelPlugin`.          |
+| `makeFieldRenameBabelPlugin`   | Função factory que produz um plugin do Babel para renomear acessos a campos de conteúdo de dicionário em arquivos-fonte de acordo com o `dictionaryKeyToFieldRenameMap` preenchido no `PruneContext`.                    |
+| `makeUsageAnalyzerBabelPlugin` | Função factory que produz um plugin do Babel para analisar o uso de `useIntlayer` / `getIntlayer` no código-fonte e agregar dados de uso de campo no `PruneContext` compartilhado.                                       |
+| `getSharedPruneContext`        | Função auxiliar que retorna o objeto `PruneContext` compartilhado para o diretório base especificado, ou `null` se ainda não tiver sido inicializado.                                                                    |
+
+---
+
+### Utilitários de Configuração de Plugins
+
+| Função                     | Descrição                                                                                                                                              |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `getExtractPluginOptions`  | Carrega a configuração do Intlayer e retorna `ExtractPluginOptions` prontas para uso com o `intlayerExtractBabelPlugin`.                               |
+| `getOptimizePluginOptions` | Carrega a configuração do Intlayer e os dicionários compilados e retorna `OptimizePluginOptions` prontas para uso com o `intlayerOptimizeBabelPlugin`. |
+| `getPurgePluginOptions`    | Carrega a configuração do Intlayer e retorna `PurgePluginOptions` prontas para uso com o `intlayerPurgeBabelPlugin`.                                   |
+| `getMinifyPluginOptions`   | Carrega a configuração do Intlayer e retorna `MinifyPluginOptions` prontas para uso com o `intlayerMinifyBabelPlugin`.                                 |
+
+---
+
+### Tipos
+
+| Tipo                    | Descrição                                                                                                                                    |
+| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | Modo do compilador: `'dev'` para desenvolvimento com suporte HMR, ou `'build'` para compilações de produção.                                 |
+| `ExtractPluginOptions`  | Opções para o `intlayerExtractBabelPlugin`: lista de arquivos, configuração, callback `onExtract`, etc.                                      |
+| `ExtractResult`         | Resultado da extração: chave do dicionário, caminho do arquivo, conteúdo e idioma.                                                           |
+| `OptimizePluginOptions` | Opções para o `intlayerOptimizeBabelPlugin`: caminhos do dicionário, modo de importação, mapa de modos por dicionário, etc.                  |
+| `PurgePluginOptions`    | Opções para o `intlayerPurgeBabelPlugin`: diretório base, sinalizadores de limpeza/minificação/otimização, lista de arquivos de componentes. |
+| `MinifyPluginOptions`   | Opções para o `intlayerMinifyBabelPlugin`: diretório base, sinalizadores de minificação/otimização/editorEnabled.                            |
+| `PruneContext`          | Estado compartilhado entre plugins de análise e limpeza: mapas de uso de campo, mapas de renomeação, etc.                                    |
+| `DictionaryFieldUsage`  | Resultado do uso do campo para um único dicionário: `Set<string>` ou `'all'` quando a análise estática é inconclusiva.                       |
+| `NestedRenameEntry`     | Nó na árvore de renomeação: o `shortName` e o mapa de filhos.                                                                                |
+| `NestedRenameMap`       | Um nível na árvore de renomeação: `Map<string, NestedRenameEntry>`.                                                                          |
+| `CompatCallerConfig`    | Configuração para um analisador de uso compatível para pacotes compat-adapter (nome do chamador e opções de processamento).                  |
+| `ScriptBlock`           | Bloco de script extraído de um arquivo SFC (Vue ou Svelte): conteúdo, deslocamento de início e deslocamento de fim.                          |
+
+---
+
+### Funções Utilitárias
+
+| Função                            | Descrição                                                                                                                                                                             |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | Converte um número inteiro (começando do zero) em um identificador alfabético curto: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, etc.                                                   |
+| `buildNestedRenameMapFromContent` | Constrói recursivamente um `NestedRenameMap` a partir do valor do conteúdo de um dicionário compilado, respeitando as estruturas de nós do Intlayer (translation, enumeration, etc.). |
+| `createPruneContext`              | Cria um novo objeto `PruneContext` vazio inicializado com valores padrão.                                                                                                             |
+| `extractScriptBlocks`             | Extrai blocos `<script>` de arquivos SFC (Vue / Svelte) para análise subsequente do Babel.                                                                                            |
+| `BABEL_PARSER_OPTIONS`            | Constante que representa as opções do analisador do Babel que cobrem os frameworks suportados (React/Vue/Svelte/Angular/...).                                                         |
+| `INTLAYER_CALLER_NAMES`           | Lista constante de nomes de chamadores originais do Intlayer: `['useIntlayer', 'getIntlayer']`.                                                                                       |
+
+---
+
+## Exemplo 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:** O plugin `intlayerPurgeBabelPlugin` deve ser declarado **antes** do `intlayerMinifyBabelPlugin`, porque o último lê o mapa de renomeação construído pelo primeiro. Além disso, ambos devem ser precedidos pelo `intlayerOptimizeBabelPlugin` para que ele possa ver as chaves do dicionário antes que as chamadas do `useIntlayer` sejam reescritas.

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

@@ -222,4 +222,4 @@ app.get("/morning", (c) => {
 
 ## Conclusão
 
-A função `t` é uma ferramenta poderosa para a internacionalização de back-end. Ao usá-la de forma eficaz, você pode criar uma aplicação mais inclusiva e amigável para um público global. Para uso avançado e opções de configuração detalhadas, consulte a [documentação](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md).
+A função `t` é uma ferramenta poderosa para a internacionalização de back-end. Ao usá-la de forma eficaz, você pode criar uma aplicação mais inclusiva e amigável para um público global. Para uso avançado e opções de configuração detalhadas, consulte a [documentação](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md).