@intlayer/docs 9.4.4 → 9.5.1

package/docs/pt/migration_from_react-i18next_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 Em vez de carregar enormes arquivos JSON em suas páginas, carregue apenas o conteúdo necessário. Intlayer ajuda você a **reduzir o tamanho do pacote e da página em até 50%**.
 
 </Accordion>
-
 <Accordion header="Manutenibilidade">
 
 Criar escopos para o conteúdo da sua aplicação torna aplicações em larga escala **fáceis de manter**. Você pode duplicar ou excluir um diretório de recursos inteiro sem o esforço mental de revisar toda a sua base de código de conteúdo. Além disso, Intlayer é **fortemente tipado** para garantir a precisão do seu conteúdo.
@@ -42,25 +41,21 @@ Criar escopos para o conteúdo da sua aplicação torna aplicações em larga es
 Intlayer também é a solução **desenvolvida mais ativamente** no ecossistema i18n — problemas são corrigidos rapidamente, novos adaptadores de frameworks são lançados regularmente e a API principal é continuamente refinada com base em feedback do mundo real em produção.
 
 </Accordion>
-
 <Accordion header="Agentes de IA">
 
 A co-localização do conteúdo **reduz o contexto necessário** para Modelos de Linguagem de Grande Escala (LLMs). O Intlayer também oferece um conjunto de ferramentas como uma **CLI** para testar traduções ausentes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)** e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)** para tornar a Experiência do Desenvolvedor (DX) muito mais suave para agentes de IA.
 
 </Accordion>
-
 <Accordion header="Automação">
 
 Automatize as traduções em seu pipeline de CI/CD usando o LLM de sua preferência pelo custo do seu provedor de IA. O Intlayer também oferece um **compilador** para automatizar a extração de conteúdo, bem como uma [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) para auxiliar com **tradução em segundo plano**.
 
 </Accordion>
-
 <Accordion header="Desempenho">
 
 Conectar enormes arquivos JSON aos componentes pode levar a problemas de desempenho e reatividade. O Intlayer otimiza o carregamento do conteúdo no momento do build (build time).
 
 </Accordion>
-
 <Accordion header="Escalabilidade com não desenvolvedores">
 
 Muito mais que apenas uma solução i18n, o Intlayer fornece um **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md)** auto-hospedável e um **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)** para ajudá-lo a gerenciar seu conteúdo multilíngue em **tempo real**, tornando perfeita a colaboração com tradutores, redatores e outros membros da equipe. O conteúdo pode ser armazenado local e/ou remotamente.
@@ -68,8 +63,6 @@ Muito mais que apenas uma solução i18n, o Intlayer fornece um **[editor visual
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Estratégias de Migração
 
 Existem duas estratégias complementares para migrar de `react-i18next` / `i18next` para o Intlayer:
@@ -80,20 +73,15 @@ Existem duas estratégias complementares para migrar de `react-i18next` / `i18ne
 
 Este guia cobre primeiro a **Estratégia 1** (adaptador de compatibilidade) e, em seguida, detalha a migração completa opcional.
 
----
-
 ## Índice
 
 <TOC/>
 
----
-
 ## Migração Rápida
 
 As etapas a seguir são o mínimo necessário para executar seu aplicativo `react-i18next` existente no Intlayer, sem alterar o código de nenhum componente.
 
 <Steps>
-
 <Step number={1} title="Instale as Dependências">
 
 Instale o pacote principal do Intlayer e o adaptador de compatibilidade:
@@ -137,7 +125,6 @@ bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intla
 > 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`.
 
 </Step>
-
 <Step number={2} title="Configure o Intlayer">
 
 O comando `intlayer init` cria um arquivo inicial `intlayer.config.ts`. Atualize-o para corresponder aos seus locales existentes e direcione o plugin `syncJSON` para seus arquivos de mensagens:
@@ -172,7 +159,6 @@ export default config;
 > **`source`** mapeia um locale para o caminho de seu arquivo JSON. **`location`** diz ao observador (watcher) do Intlayer qual pasta monitorar para alterações. A opção `format: 'i18next'` garante que os espaços reservados como `{{name}}` sejam interpretados corretamente.
 
 </Step>
-
 <Step number={3} title="Adicione os plugins do Intlayer ao seu bundler">
 
 Insira ao redor no centro global contendo sua forma inicial já estabelecida englobada a respeito e encargo atrelado à parte e seção dos dados descritores voltados à moldar seu agrupador que compila tudo engatando então, para junto daquele conjunto e ambiente, toda base construída no modelo feito no pacote designado à trazer uma tradução suave por base de ser um adaptante facilitador nas vias deste compatibilizador final e auxiliar. Ao integrar ele perfeitamente aos demais, ocorrerá de forma orgânica as definições automáticas contidas baseando as ligações intrínsecas essenciais ao passo a compor internamente para todo funcionamento o emparelhamento com monitoração dos conteúdos em si. O processo crucial por aqui acontece então garantindo na retaguarda de todo código principal e ao longo e tempo voltados a etapa do próprio momento exato do processo visando a checagem no Build-Time que uma injeção perfeitamente clara de alias no âmbito estruturado sobre os módulos transcorra sem incidentes. Sendo isso de suma utilidade já que ele faz automaticamente chamadas que estiverem originárias nos antigos moldes provenientes da sua herança antiga utilizando caminhos parecidos vindos num padrão referenciado que cita um `import … from 'react-i18next'` (inclusive no outro sendo pelo lado direto ao referir-se perante uso focado ao contido do chamado vindo a requerer o `'i18next'`) sejam interceptadas fluindo tranquilamente guiadas com transparência a passarem e repassarem a frente direcionadas para caírem num retorno certeiro e bem referenciado focando unicamente recair sua totalidade visando e retornando num fluxo para os emparelhamentos dos caminhos novos referenciados por vias dos padrões usando as vias criadas ao designar os caminhos `@intlayer/react-i18next` e bem em conjunto, também o que leva no padrão ao outro designado como parte no caminho `@intlayer/i18next`. Ao concluir as averiguações em campo visando o período completo deste percurso por todo o momento decorrente, o ponto focado no encerramento garante tranquilidade demonstrando claramente ser impossível exigirem ter de se executar intervenção manual buscando forçar com que se repasse alterando o que é seu por essência originada do código e base na via de código-fonte.
@@ -233,14 +219,11 @@ Isso é tudo para a migração rápida. Seu aplicativo agora está rodando no In
 > tAbout("counter.label"); // ✓ tipado
 > ```
 
----
-
 ## Migração Completa
 
 As etapas a seguir são opcionais e podem ser feitas gradativamente. Elas desbloqueiam o conjunto completo das funcionalidades do Intlayer: editor visual, CMS, arquivos de conteúdo tipados, automação de tradução por IA e muito mais.
 
 <Steps>
-
 <Step number={4} title="Renomeie Explícitamente as Importações (Opcional)" isOptional={true}>
 
 O plugin do Intlayer já lida com o aliasing (apelido) a nível do bundler. Se preferir tornar a dependência explícita nos seus arquivos de código-fonte, você pode renomear as importações manualmente:
@@ -265,7 +248,6 @@ Para Next.js (`next-i18next`):
 | `import { useTranslation } from 'next-i18next'`                                | `import { useTranslation } from '@intlayer/next-i18next'`         |
 
 </Step>
-
 <Step number={5} title="Habilite a Automação de Tradução por IA" isOptional={true}>
 
 Com o Intlayer configurado, você pode usar a CLI para preencher traduções ausentes automaticamente:
@@ -327,8 +309,6 @@ export default config;
 
 </Steps>
 
----
-
 ## O que pode ser excluído pós-migração
 
 Uma vez que o adaptador de compatibilidade esteja implementado, o seguinte boilerplate padrão do `react-i18next` / `i18next` pode ser excluído:
@@ -341,8 +321,6 @@ Uma vez que o adaptador de compatibilidade esteja implementado, o seguinte boile
 
 Quando você estiver pronto para ir mais além, o Intlayer **descobre automaticamente todos os arquivos `.content.ts` e `.content.json` em qualquer lugar da sua base de código** (por padrão, em qualquer lugar sob `./src`). Basta colocar um arquivo `my-component.content.ts` ao lado do seu `MyComponent.tsx`, e o Intlayer o detectará em tempo de build sem necessidade de configuração adicional — não são necessários imports, registros ou um arquivo index central. Isso torna a co-localização das traduções com páginas e componentes totalmente fluida.
 
----
-
 ## Configuração do TypeScript
 
 O Intlayer usa aumento de módulo (module augmentation) para fornecer IntelliSense completo no TypeScript (autocompletar) para as chaves de tradução. Certifique-se de que o seu arquivo `tsconfig.json` inclua os tipos gerados automaticamente:
@@ -357,8 +335,6 @@ O Intlayer usa aumento de módulo (module augmentation) para fornecer IntelliSen
 }
 ```
 
----
-
 ## Configuração do Git
 
 Adicione o diretório gerado pelo Intlayer ao seu `.gitignore`:
@@ -368,8 +344,6 @@ Adicione o diretório gerado pelo Intlayer ao seu `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Explore Além
 
 - **Editor Visual** — Gerencie traduções visualmente no seu navegador: [Editor Visual Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md)

package/docs/pt/migration_from_vue-i18n_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 Em vez de carregar enormes arquivos JSON em suas páginas, carregue apenas o conteúdo necessário. Intlayer ajuda você a **reduzir o tamanho do pacote e da página em até 50%**.
 
 </Accordion>
-
 <Accordion header="Manutenibilidade">
 
 Criar escopos para o conteúdo da sua aplicação torna aplicações em larga escala **fáceis de manter**. Você pode duplicar ou excluir um diretório de recursos inteiro sem o esforço mental de revisar toda a sua base de código de conteúdo. Além disso, Intlayer é **fortemente tipado** para garantir a precisão do seu conteúdo.
@@ -41,25 +40,21 @@ Criar escopos para o conteúdo da sua aplicação torna aplicações em larga es
 Intlayer também é a solução **desenvolvida mais ativamente** no ecossistema i18n — problemas são corrigidos rapidamente, novos adaptadores de frameworks são lançados regularmente e a API principal é continuamente refinada com base em feedback do mundo real em produção.
 
 </Accordion>
-
 <Accordion header="Agentes de IA">
 
 A co-localização do conteúdo **reduz o contexto necessário** para Modelos de Linguagem de Grande Escala (LLMs). O Intlayer também oferece um conjunto de ferramentas como uma **CLI** para testar traduções ausentes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/mcp_server.md)** e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/agent_skills.md)** para tornar a Experiência do Desenvolvedor (DX) muito mais suave para agentes de IA.
 
 </Accordion>
-
 <Accordion header="Automação">
 
 Automatize as traduções em seu pipeline de CI/CD usando o LLM de sua preferência pelo custo do seu provedor de IA. O Intlayer também oferece um **compilador** para automatizar a extração de conteúdo, bem como uma [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) para auxiliar com **tradução em segundo plano**.
 
 </Accordion>
-
 <Accordion header="Desempenho">
 
 Conectar enormes arquivos JSON aos componentes pode levar a problemas de desempenho e reatividade. O Intlayer otimiza o carregamento do conteúdo no momento do build (build time).
 
 </Accordion>
-
 <Accordion header="Escalabilidade com não desenvolvedores">
 
 Muito mais que apenas uma solução i18n, o Intlayer fornece um **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md)** auto-hospedável e um **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md)** para ajudá-lo a gerenciar seu conteúdo multilíngue em **tempo real**, tornando perfeita a colaboração com tradutores, redatores e outros membros da equipe. O conteúdo pode ser armazenado local e/ou remotamente.
@@ -67,8 +62,6 @@ Muito mais que apenas uma solução i18n, o Intlayer fornece um **[editor visual
 </Accordion>
 </AccordionGroup>
 
----
-
 ## Estratégias de Migração
 
 Existem duas estratégias complementares para migrar do `vue-i18n` para o Intlayer:
@@ -79,20 +72,15 @@ Existem duas estratégias complementares para migrar do `vue-i18n` para o Intlay
 
 Este guia cobre primeiro a **Estratégia 1** (adaptador de compatibilidade) e, em seguida, detalha a migração completa opcional.
 
----
-
 ## Índice
 
 <TOC/>
 
----
-
 ## Migração Rápida
 
 As etapas a seguir são o mínimo necessário para executar seu aplicativo `vue-i18n` existente no Intlayer, sem alterar o código de nenhum componente.
 
 <Steps>
-
 <Step number={1} title="Instale as Dependências">
 
 Instale o pacote principal do Intlayer e o adaptador de compatibilidade:
@@ -136,7 +124,6 @@ bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
 > 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".
 
 </Step>
-
 <Step number={2} title="Configure o Intlayer">
 
 O comando `intlayer init` cria um arquivo inicial `intlayer.config.ts`. Atualize-o para corresponder aos seus locales existentes e direcione o plugin `syncJSON` aos seus arquivos de mensagens:
@@ -171,7 +158,6 @@ export default config;
 > **`source`** mapeia um locale para o caminho de seu arquivo JSON correspondente. **`location`** diz ao observador (watcher) do Intlayer qual pasta monitorar para alterações. A opção `format: 'icu'` garante que espaços reservados do `vue-i18n` sejam analisados corretamente.
 
 </Step>
-
 <Step number={3} title="Adicione os plugins do Intlayer ao seu bundler">
 
 Insira ao redor contendo sua forma inicial já estabelecida englobada a respeito e encargo atrelado à parte e seção dos dados descritores voltados à moldar seu agrupador que compila as bases num conjunto agrupado (bundler) atrelando encarregamentos ao plugin com foco e papel para a compatibilidade e a base referida contendo foco no que se trata e trata focado sob a parte do aliasing, o que na teoria e em vias diretas quer dizer as partes em rotinas geradas baseadas e designadas focando injeções por trás dos módulos visando criar redirecionamentos nos módulos perante ao alias em uso no formato do pacote (e muito além por conta na parte encarregada sob bases perante o compilador onde opera ele focado em compilar e carregar via uso contido referenciado nas linhas com uso para o empacotamento que arrasta referências e vias perante onde trata a respeito do núcleo base do que opera no core das engrenagens oriundas na essência e nas ferramentas de bases oriundas sob responsabilidade na raiz vinculada sob pacote principal pertencente focado no próprio ambiente principal vindo com formato atrelado para as raízes focadas atreladas perante o uso na base do plugin próprio e nativo da extensão raiz atada perante uso contido pelo `Intlayer`). A partir da integração ele orgulhosamente encarregará suas automatizações de forma onde todas e qualquer importação preexistente advinda por chamadas nas vias do modelo `import … from 'vue-i18n'` acabe interceptada fluindo redirecionada transparente e de brinde à quem programar de via que ao transcorrer em rotina que ocorra englobando o instante de build por fim aponte referenciada pro caminho `@intlayer/vue-i18n`. Não são necessárias modificações focando no âmbito das frentes contidas e abarcando seus respectivos arquivos-fonte no decorrer perante esse processo e a esse quesito encarregado nas etapas a vir adiante baseando e embutindo para as partes ao decorrer perante o andamento encarregado nesta base descrita sob a etapa do decorrer e fase dessa parte atrelada com listagens e passos.
@@ -222,14 +208,11 @@ Isso é tudo para a migração rápida. Seu aplicativo agora está rodando no In
 > t("does.not.exist"); // ✗ erro do TypeScript
 > ```
 
----
-
 ## Migração Completa
 
 As etapas a seguir são opcionais e podem ser feitas gradativamente. Elas desbloqueiam o conjunto completo das funcionalidades do Intlayer: editor visual, CMS, arquivos de conteúdo tipados, automação de tradução por IA e muito mais.
 
 <Steps>
-
 <Step number={4} title="Renomeie Explícitamente as Importações (Opcional)" isOptional={true}>
 
 O plugin do Intlayer já lida com o aliasing (apelido) a nível do bundler. Se preferir tornar a dependência explícita nos seus arquivos de código-fonte, você pode renomear as importações manualmente:
@@ -242,7 +225,6 @@ O plugin do Intlayer já lida com o aliasing (apelido) a nível do bundler. Se p
 Essas são **substituições diretas** (drop-in) — nenhuma alteração de assinaturas de chamadas, argumentos ou tipos de retorno é necessária.
 
 </Step>
-
 <Step number={5} title="Habilite a Automação de Tradução por IA" isOptional={true}>
 
 Com o Intlayer configurado, você pode usar a CLI para preencher traduções ausentes automaticamente:
@@ -304,8 +286,6 @@ export default config;
 
 </Steps>
 
----
-
 ## O que pode ser excluído pós-migração
 
 Uma vez que o adaptador de compatibilidade esteja implementado, o seguinte boilerplate padrão do `vue-i18n` pode ser excluído:
@@ -318,8 +298,6 @@ Uma vez que o adaptador de compatibilidade esteja implementado, o seguinte boile
 
 Quando você estiver pronto para ir mais além, o Intlayer **descobre automaticamente todos os arquivos `.content.ts` e `.content.json` em qualquer lugar da sua base de código** (por padrão, em qualquer lugar sob `./src`). Basta colocar um arquivo `my-component.content.ts` ao lado do seu `MyComponent.vue`, e o Intlayer o detectará em tempo de build sem necessidade de configuração adicional — não são necessários imports, registros ou um arquivo index central. Isso torna a co-localização das traduções com páginas e componentes totalmente fluida.
 
----
-
 ## Configuração do TypeScript
 
 O Intlayer usa aumento de módulo (module augmentation) para fornecer IntelliSense completo no TypeScript (autocompletar) para as chaves de tradução. Certifique-se de que o seu arquivo `tsconfig.json` inclua os tipos gerados automaticamente:
@@ -334,8 +312,6 @@ O Intlayer usa aumento de módulo (module augmentation) para fornecer IntelliSen
 }
 ```
 
----
-
 ## Configuração do Git
 
 Adicione o diretório gerado pelo Intlayer ao seu `.gitignore`:
@@ -345,8 +321,6 @@ Adicione o diretório gerado pelo Intlayer ao seu `.gitignore`:
 .intlayer
 ```
 
----
-
 ## Explore Além
 
 - **Editor Visual** — Gerencie traduções visualmente no seu navegador: [Editor Visual Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md)

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

@@ -43,8 +43,6 @@ Importar:
 import { ... } from "@intlayer/babel";
 ```
 
----
-
 ### Plugins
 
 | Função / Classe                | Descrição                                                                                                                                                                                                                |
@@ -57,8 +55,6 @@ import { ... } from "@intlayer/babel";
 | `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                                                                                                                                              |
@@ -68,8 +64,6 @@ import { ... } from "@intlayer/babel";
 | `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                                                                                                                                    |
@@ -87,8 +81,6 @@ import { ... } from "@intlayer/babel";
 | `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                                                                                                                                                                             |
@@ -100,8 +92,6 @@ import { ... } from "@intlayer/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

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

@@ -27,14 +27,10 @@ author: aymericzip
 
 A função `t` no pacote `adonis-intlayer` é o utilitário principal para fornecer respostas localizadas em sua aplicação AdonisJS. Ela simplifica a internacionalização (i18n) selecionando dinamicamente o conteúdo com base no idioma de preferência do usuário.
 
----
-
 ## Visão Geral
 
 A função `t` é usada para definir e recuperar traduções para um determinado conjunto de idiomas. Ela determina automaticamente o idioma apropriado a ser retornado com base nas configurações de solicitação do cliente, como o cabeçalho `Accept-Language`. Se o idioma preferido não estiver disponível, ela recorre graciosamente ao locale padrão especificado em sua configuração.
 
----
-
 ## Principais Recursos
 
 - **Localização Dinâmica**: Seleciona automaticamente a tradução mais apropriada para o cliente.
@@ -42,8 +38,6 @@ A função `t` é usada para definir e recuperar traduções para um determinado
 - **Contexto Assíncrono**: Funciona perfeitamente dentro do ciclo de vida da solicitação AdonisJS usando Async Local Storage.
 - **Suporte ao TypeScript**: Garante a segurança de tipos para suas traduções.
 
----
-
 ## Assinatura da Função
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, any>): any;
 
 - O conteúdo que representa o idioma preferido do cliente.
 
----
-
 ## Carregando o Middleware
 
 Para garantir que a função `t` funcione corretamente, você **deve** registrar o middleware `intlayer` em sua aplicação AdonisJS.
@@ -68,8 +60,6 @@ Para garantir que a função `t` funcione corretamente, você **deve** registrar
 router.use([() => import("adonis-intlayer/middleware")]);
 ```
 
----
-
 ## Exemplos de Uso
 
 ### Exemplo Básico
@@ -105,8 +95,6 @@ export default class ExampleController {
 }
 ```
 
----
-
 ## Tópicos Avançados
 
 ### Mecanismo de Fallback

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

@@ -28,14 +28,10 @@ author: aymericzip
 
 A função `t` no pacote `express-intlayer` é a utilidade principal para fornecer respostas localizadas na sua aplicação Express. Ela simplifica a internacionalização (i18n) ao selecionar dinamicamente o conteúdo com base na língua preferida do usuário.
 
----
-
 ## Visão Geral
 
 A função `t` é usada para definir e recuperar traduções para um conjunto específico de idiomas. Ela determina automaticamente a língua apropriada a ser retornada com base nas configurações da requisição do cliente, como o cabeçalho `Accept-Language`. Se a língua preferida não estiver disponível, ela recorre de forma elegante ao locale padrão especificado na sua configuração.
 
----
-
 ## Principais Características
 
 - **Localização Dinâmica**: Seleciona automaticamente a tradução mais apropriada para o cliente.
@@ -43,8 +39,6 @@ A função `t` é usada para definir e recuperar traduções para um conjunto es
 - **Leve e Rápido**: Projetado para aplicações de alto desempenho, garantindo sobrecarga mínima.
 - **Suporte ao Modo Estrito**: Impõe aderência rigorosa aos locales declarados para comportamento confiável.
 
----
-
 ## Assinatura da Função
 
 ```typescript
@@ -59,8 +53,6 @@ t(translations: Record<string, string>): string;
 
 - Uma string representando o conteúdo na língua preferida do cliente.
 
----
-
 ## Carregando o Manipulador de Requisição de Internacionalização
 
 Para garantir que a funcionalidade de internacionalização fornecida pelo `express-intlayer` funcione corretamente, você **deve** carregar o middleware de internacionalização no início da sua aplicação Express. Isso habilita a função `t` e assegura o tratamento adequado da detecção de locale e tradução.
@@ -94,8 +86,6 @@ app.get("/", (_req, res) => {
 - **Contexto de Tradução**: Configura o contexto necessário para que a função `t` opere corretamente, garantindo que as traduções sejam retornadas no idioma correto.
 - **Prevenção de Erros**: Sem este middleware, usar a função `t` resultará em erros de tempo de execução porque as informações necessárias sobre a localidade não estarão disponíveis.
 
----
-
 ## Exemplos de Uso
 
 ### Exemplo Básico
@@ -136,8 +126,6 @@ app.get("/error", (_req, res) => {
 });
 ```
 
----
-
 ### Usando Variantes de Localidade
 
 Especifique traduções para variantes específicas de localidade:
@@ -184,8 +172,6 @@ app.get("/greet", (_req, res) => {
 });
 ```
 
----
-
 ## Tópicos Avançados
 
 ### Mecanismo de Fallback
@@ -210,8 +196,6 @@ Por exemplo:
 - Se `defaultLocale` for `Locales.CHINESE` e um cliente solicitar `Locales.DUTCH`, a tradução retornada será o valor padrão de `Locales.CHINESE`.
 - Se `defaultLocale` não estiver definido, a função `t` usará como fallback o valor de `Locales.ENGLISH`.
 
----
-
 ### Aplicação do Modo Estrito
 
 Configure a função `t` para impor a aderência estrita às localidades declaradas:
@@ -238,8 +222,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### Integração com TypeScript
 
 A função `t` é segura em termos de tipos quando usada com TypeScript. Defina um objeto de traduções com segurança de tipos:
@@ -258,8 +240,6 @@ app.get("/morning", (_req, res) => {
 });
 ```
 
----
-
 ### Erros Comuns e Solução de Problemas
 
 | Problema                   | Causa                                         | Solução                                                                     |
@@ -267,8 +247,6 @@ app.get("/morning", (_req, res) => {
 | Função `t` não funcionando | Middleware não carregado                      | Certifique-se de que `app.use(intlayer())` está adicionado antes das rotas. |
 | Erro de traduções faltando | Modo estrito ativado sem todas as localidades | Forneça todas as traduções necessárias.                                     |
 
----
-
 ## Dicas para Uso Eficaz
 
 1. **Centralize as Traduções**: Use um módulo centralizado ou arquivos JSON para gerenciar as traduções e melhorar a manutenção.
@@ -276,8 +254,6 @@ app.get("/morning", (_req, res) => {
 3. **Combine com i18n no Frontend**: Sincronize com a internacionalização do frontend para uma experiência de usuário fluida em todo o aplicativo.
 4. **Avalie o Desempenho**: Teste os tempos de resposta do seu aplicativo ao adicionar traduções para garantir impacto mínimo.
 
----
-
 ## Conclusão
 
 A função `t` é uma ferramenta poderosa para internacionalização no backend. 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 detalhadas de configuração, consulte a [documentação](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md).

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

@@ -27,14 +27,10 @@ author: aymericzip
 
 A função `t` no pacote `hono-intlayer` é o utilitário principal para fornecer respostas localizadas na sua aplicação Hono. Ela simplifica a internacionalização (i18n) selecionando dinamicamente o conteúdo com base no idioma de preferência do usuário.
 
----
-
 ## Visão Geral
 
 A função `t` é usada para definir e recuperar traduções para um determinado conjunto de idiomas. Ela determina automaticamente o idioma apropriado a ser retornado com base nas configurações de solicitação do cliente, como o cabeçalho `Accept-Language`. Se o idioma preferido não estiver disponível, ela recorre graciosamente ao local padrão especificado na sua configuração.
 
----
-
 ## Principais Recursos
 
 - **Localização Dinâmica**: Seleciona automaticamente a tradução mais apropriada para o cliente.
@@ -42,8 +38,6 @@ A função `t` é usada para definir e recuperar traduções para um determinado
 - **Leve e Rápido**: Projetado para aplicações de alto desempenho, garantindo uma sobrecarga mínima.
 - **Suporte ao Modo Estrito**: Reforça a adesão estrita aos locais declarados para um comportamento confiável.
 
----
-
 ## Assinatura da Função
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, string>): string;
 
 - Uma string representando o conteúdo no idioma de preferência do cliente.
 
----
-
 ## Carregando o Manipulador de Solicitação de Internacionalização
 
 Para garantir que a funcionalidade de internacionalização fornecida pelo `hono-intlayer` funcione corretamente, você **deve** carregar o middleware de internacionalização no início da sua aplicação Hono. Isso habilita a função `t` e garante o tratamento adequado da detecção de localidade e tradução.
@@ -94,8 +86,6 @@ app.get("/", (c) => {
 - **Contexto de Tradução**: Configura o contexto necessário para que a função `t` opere corretamente, garantindo que as traduções sejam retornadas no idioma correto.
 - **Prevenção de Erros**: Sem este middleware, o uso da função `t` resultará em erros de tempo de execução porque as informações de localidade necessárias não estarão disponíveis.
 
----
-
 ## Exemplos de Uso
 
 ### Exemplo Básico
@@ -137,8 +127,6 @@ app.get("/error", (c) => {
 });
 ```
 
----
-
 ### Usando Variantes de Localidade
 
 Especifique traduções para variantes específicas de localidade:
@@ -156,8 +144,6 @@ app.get("/greet", (c) => {
 });
 ```
 
----
-
 ## Tópicos Avançados
 
 ### Mecanismo de Fallback
@@ -177,8 +163,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### Execução do Modo Estrito
 
 Configure a função `t` para reforçar a adesão estrita aos locais declarados:
@@ -189,8 +173,6 @@ Configure a função `t` para reforçar a adesão estrita aos locais declarados:
 | `inclusive` | Locais declarados devem ter traduções. Locais ausentes acionam avisos, mas são aceitos.    |
 | `loose`     | Qualquer local existente é aceito, mesmo que não seja declarado.                           |
 
----
-
 ### Integração com TypeScript
 
 A função `t` é type-safe quando usada com TypeScript. Defina um objeto de traduções type-safe:
@@ -209,8 +191,6 @@ app.get("/morning", (c) => {
 });
 ```
 
----
-
 ### Erros Comuns e Solução de Problemas
 
 | Problema                   | Causa                                    | Solução                                                                          |
@@ -218,8 +198,6 @@ app.get("/morning", (c) => {
 | Função `t` não funciona    | Middleware não carregado                 | Certifique-se de que `app.use("*", intlayer())` seja adicionado antes das rotas. |
 | Erro de traduções ausentes | Modo estrito ativado sem todos os locais | Forneça todas as traduções necessárias.                                          |
 
----
-
 ## 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/pt/configuration.md).

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

@@ -45,8 +45,6 @@ O pacote também exporta o utilitário subjacente [`normalizePath`](#normalizepa
 - Tolera a ausência de barras iniciais e valores vazios (normalizado para `/`)
 - Leve — construído sobre `getPathWithoutLocale`
 
----
-
 ## Assinatura da Função
 
 ```typescript
@@ -62,8 +60,6 @@ normalizePath(
 ): string
 ```
 
----
-
 ## Parâmetros
 
 - `pathname: string`
@@ -86,8 +82,6 @@ normalizePath(
 - **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
@@ -132,8 +126,6 @@ const NavLink = ({ href, children }) => {
 };
 ```
 
----
-
 ## 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.
@@ -150,16 +142,12 @@ 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

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

@@ -37,8 +37,6 @@ A função `getCanonicalPath` resolve um caminho de URL localizado (por exemplo,
 - Compara caminhos localizados com regras de reescrita personalizadas definidas na sua configuração.
 - Retorna o caminho original caso nenhuma regra de reescrita correspondente seja encontrada.
 
----
-
 ## Assinatura da Função
 
 ```typescript
@@ -49,8 +47,6 @@ getCanonicalPath(
 ): string
 ```
 
----
-
 ## Parâmetros
 
 ### Parâmetros obrigatórios
@@ -72,15 +68,11 @@ getCanonicalPath(
   - **Tipo**: `RoutingConfig['rewrite']`
   - **Padrão**: `configuration.routing.rewrite`
 
----
-
 ## Retorno
 
 - **Tipo**: `string`
 - **Descrição**: O caminho canônico interno.
 
----
-
 ## Exemplo de Uso
 
 ### Uso Básico (Com Configuração)
@@ -126,8 +118,6 @@ getCanonicalPath("/contactez-nous", Locales.FRENCH, manualRules);
 // Output: "/contact"
 ```
 
----
-
 ## Funções relacionadas
 
 - [`getLocalizedPath`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/intlayer/getLocalizedPath.md): Resolve um caminho canônico para o seu equivalente localizado.