@intlayer/docs 9.5.4 → 9.5.6

package/docs/pt/intlayer_with_vite+preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Preact i18n - Guia completo para traduzir seu aplicativo"
 description: "Sem mais i18next. O guia 2026 para criar uma aplicação Vite + Preact multilíngue (i18n). Traduza com agentes de IA e otimize o tamanho do bundle, SEO e desempenho."
 keywords:
@@ -862,8 +862,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Atualize seu `vite.config.ts` para incluir o plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -878,6 +884,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compile sua aplicação para transformar seus componentes e extrair o conteúdo
+
 ```bash packageManager="npm"
 npm run build # Ou npm run dev
 ```
@@ -934,7 +945,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -947,7 +960,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1121,6 +1134,13 @@ Sim: [formas plurais](https://github.com/aymericzip/intlayer/blob/main/docs/docs
 
 Por meio do [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md), que roda em sua própria infraestrutura e permite editar textos diretamente no app em execução, ou pelo [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md), que externaliza o conteúdo para que ele possa ser alterado sem novos deploys.
 
+</Question>
+<Question title="Qual é o custo do editor visual? É excessivo se eu não precisar dele?">
+
+O [editor visual do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md) tem **custo zero** na sua aplicação se não estiver configurado. A lógica extra só é carregada se explicitamente ativada e necessária.
+
+Mesmo quando ativado, o impacto é extremamente leve (+5 KB, carregado dinamicamente apenas quando ativado), pois a maior parte da lógica é tratada pelo editor do servidor em [app.intlayer.org](https://app.intlayer.org) ou através do pacote `intlayer-editor`. Se você precisa apenas de uma solução simples de tradução sem edição visual, o Intlayer não adiciona nenhuma sobrecarga à sua aplicação.
+
 </Question>
 <Question title="O Intlayer é gratuito e de código aberto?">
 

package/docs/pt/intlayer_with_vite+react.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + React i18n - Guia completo para traduzir seu aplicativo"
 description: "Sem mais i18next. O guia 2026 para criar uma aplicação Vite + React multilíngue (i18n). Traduza com agentes de IA e otimize o tamanho do bundle, SEO e desempenho."
 keywords:
@@ -830,8 +830,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Atualize seu `vite.config.ts` para incluir o plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -846,6 +852,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compile sua aplicação para transformar seus componentes e extrair o conteúdo
+
 ```bash packageManager="npm"
 npm run build # Ou npm run dev
 ```
@@ -902,7 +913,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -915,7 +928,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -1071,6 +1084,13 @@ Sim: [formas plurais](https://github.com/aymericzip/intlayer/blob/main/docs/docs
 
 Por meio do [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md), auto-hospedado, que permite a qualquer pessoa editar textos diretamente na aplicação em execução, ou pelo [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) para conteúdos que precisam ser alterados sem novos deploys.
 
+</Question>
+<Question title="Qual é o custo do editor visual? É excessivo se eu não precisar dele?">
+
+O [editor visual do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md) tem **custo zero** na sua aplicação se não estiver configurado. A lógica extra só é carregada se explicitamente ativada e necessária.
+
+Mesmo quando ativado, o impacto é extremamente leve (+5 KB, carregado dinamicamente apenas quando ativado), pois a maior parte da lógica é tratada pelo editor do servidor em [app.intlayer.org](https://app.intlayer.org) ou através do pacote `intlayer-editor`. Se você precisa apenas de uma solução simples de tradução sem edição visual, o Intlayer não adiciona nenhuma sobrecarga à sua aplicação.
+
 </Question>
 <Question title="O Intlayer é gratuito e de código aberto?">
 

package/docs/pt/intlayer_with_vite+solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Solid i18n - Guia completo para traduzir seu aplicativo"
 description: "Sem mais i18next. O guia 2026 para criar uma aplicação Vite + Solid multilíngue (i18n). Traduza com agentes de IA e otimize o tamanho do bundle, SEO e desempenho."
 keywords:
@@ -585,8 +585,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Atualize seu `vite.config.ts` para incluir o plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -601,6 +607,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compile sua aplicação para transformar seus componentes e extrair o conteúdo
+
 ```bash packageManager="npm"
 npm run build # Ou npm run dev
 ```
@@ -657,7 +668,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -670,7 +683,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);
@@ -820,6 +833,13 @@ Sim: [formas plurais](https://github.com/aymericzip/intlayer/blob/main/docs/docs
 
 Por meio do [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md), que roda em sua própria infraestrutura e permite editar textos diretamente no app em execução, ou pelo [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md), que externaliza o conteúdo para que ele possa ser alterado sem novos deploys.
 
+</Question>
+<Question title="Qual é o custo do editor visual? É excessivo se eu não precisar dele?">
+
+O [editor visual do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_visual_editor.md) tem **custo zero** na sua aplicação se não estiver configurado. A lógica extra só é carregada se explicitamente ativada e necessária.
+
+Mesmo quando ativado, o impacto é extremamente leve (+5 KB, carregado dinamicamente apenas quando ativado), pois a maior parte da lógica é tratada pelo editor do servidor em [app.intlayer.org](https://app.intlayer.org) ou através do pacote `intlayer-editor`. Se você precisa apenas de uma solução simples de tradução sem edição visual, o Intlayer não adiciona nenhuma sobrecarga à sua aplicação.
+
 </Question>
 <Question title="O Intlayer é gratuito e de código aberto?">
 

package/docs/pt/intlayer_with_vite+svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Svelte i18n - Guia completo para traduzir seu aplicativo"
 description: "Sem mais i18next. O guia 2026 para criar uma aplicação Vite + Svelte multilíngue (i18n). Traduza com agentes de IA e otimize o tamanho do bundle, SEO e desempenho."
 keywords:
@@ -592,8 +592,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Atualize seu `vite.config.ts` para incluir o plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -608,6 +614,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compile sua aplicação para transformar seus componentes e extrair o conteúdo
+
 ```bash packageManager="npm"
 npm run build # Ou npm run dev
 ```
@@ -664,7 +675,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -677,7 +690,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/pt/intlayer_with_vite+vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vanilla JS i18n - Guia completo para traduzir seu aplicativo"
 description: "Sem mais i18next. O guia 2026 para criar uma aplicação Vite + Vanilla JS multilíngue (i18n). Traduza com agentes de IA e otimize o tamanho do bundle, SEO e desempenho."
 keywords:
@@ -613,8 +613,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Atualize o seu `vite.config.ts` para incluir o plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -629,6 +635,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compile sua aplicação para transformar seus componentes e extrair o conteúdo
+
 ```bash packageManager="npm"
 npm run build # Ou npm run dev
 ```
@@ -685,7 +696,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -698,7 +711,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/pt/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-08-30
+updatedAt: 2026-09-20
 title: "Vite + Vue i18n - Guia completo para traduzir seu aplicativo"
 description: "Sem mais i18next. O guia 2026 para criar uma aplicação Vite + Vue multilíngue (i18n). Traduza com agentes de IA e otimize o tamanho do bundle, SEO e desempenho."
 keywords:
@@ -983,8 +983,14 @@ bun x intlayer extract
  </Tab>
  <Tab value='Compilador Babel'>
 
+ <Tabs>
+ <Tab value='intlayer >= 9'>
+
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
+ </Tab>
+ <Tab value='intlayer < 9'>
+
 Atualize seu `vite.config.ts` para incluir o plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
@@ -999,6 +1005,11 @@ export default defineConfig({
 });
 ```
 
+ </Tab>
+ </Tabs>
+
+Compile sua aplicação para transformar seus componentes e extrair o conteúdo
+
 ```bash packageManager="npm"
 npm run build # Ou npm run dev
 ```
@@ -1055,7 +1066,9 @@ const pathList = [
   { path: "/about", changefreq: "monthly", priority: 0.7 },
 ];
 
-const sitemapXml = generateSitemap(pathList, { siteUrl: SITE_URL });
+const sitemapXml = generateSitemap(pathList, {
+  siteUrl: "https://example.com",
+});
 fs.writeFileSync(path.join(__dirname, "public", "sitemap.xml"), sitemapXml);
 
 const getAllMultilingualUrls = (urls) =>
@@ -1068,7 +1081,7 @@ const robotsTxt = [
   "Allow: /",
   ...disallowedPaths.map((path) => `Disallow: ${path}`),
   "",
-  `Sitemap: ${SITE_URL}/sitemap.xml`,
+  `Sitemap: https://example.com/sitemap.xml`,
 ].join("\n");
 
 fs.writeFileSync(path.join(__dirname, "public", "robots.txt"), robotsTxt);

package/docs/pt/introduction.md

@@ -189,7 +189,6 @@ Construímos o Intlayer a pensar na flexibilidade, oferecendo integração perfe
 - **[Intlayer com Astro + Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_astro_solid.md)**
 - **[Intlayer com Astro + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_astro_preact.md)**
 - **[Intlayer com Astro + Lit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_astro_lit.md)**
-- **[Intlayer com Astro + Vanilla JS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_astro_vanilla.md)**
 - **[Intlayer com Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_vite+vue.md)**
 - **[Intlayer com Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_nuxt.md)**
 - **[Intlayer com Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_with_vite+svelte.md)**

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

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-09-19
 title: Documentação do pacote astro-intlayer
-description: Integração do Astro para o Intlayer, fornecendo configuração para roteamento baseado em locale e gerenciamento de dicionários.
+description: Integração Astro para Intlayer, fornecendo configuração para roteamento baseado em locale, middleware, hooks, store de cliente e gestão de dicionários.
 keywords:
   - astro-intlayer
   - astro
@@ -14,6 +14,9 @@ slugs:
   - astro-intlayer
   - exports
 history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Adicionada documentação dos hooks useIntlayer, useDictionary, useLocale, do middleware e dos formatadores"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Documentação unificada para todas as exportações"
@@ -22,7 +25,7 @@ author: aymericzip
 
 # Pacote astro-intlayer
 
-O pacote `astro-intlayer` fornece as ferramentas necessárias para integrar o Intlayer em aplicações Astro. Ele configura o roteamento baseado em locale e o gerenciamento de dicionários.
+O pacote `astro-intlayer` fornece as ferramentas necessárias para integrar o Intlayer em aplicações Astro. Ele configura o roteamento baseado em locale, gerenciamento de dicionários, reescrita de páginas no momento da compilação, middleware de requisição e hooks para acessar conteúdo multilíngue tanto em componentes `.astro` renderizados no servidor quanto em scripts do lado do cliente.
 
 ## Instalação
 
@@ -34,22 +37,171 @@ npm install astro-intlayer
 
 ### Integração
 
-O pacote `astro-intlayer` fornece uma integração para Astro para configurar o Intlayer no seu projeto.
+O pacote `astro-intlayer` fornece uma integração Astro que configura o Intlayer no seu projeto.
 
-Importe:
+Importação:
 
 ```tsx
-import "astro-intlayer";
+import { intlayer } from "astro-intlayer";
 ```
 
-ou adicionando ao arquivo `astro.config.mjs`:
+ou importação padrão em `astro.config.mjs`:
 
 ```ts
+import { defineConfig } from "astro/config";
+import intlayer from "astro-intlayer";
+
 export default defineConfig({
   integrations: [intlayer()],
 });
 ```
 
-| Função     | Descrição                                                    |
-| ---------- | ------------------------------------------------------------ |
-| `intlayer` | Integração do Astro que configura o Intlayer no seu projeto. |
+| Função     | Descrição                                                                                                                                                                                                     | Documentação relacionada                                                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Integração Astro que prepara dicionários, configura plugins Vite (aliases, proxy de roteamento, poda), registra automaticamente middleware de requisição e emite páginas pré-renderizadas em URLs reescritas. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/intlayer.md) |
+
+### Hooks (Servidor e Cliente)
+
+Importação:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
+```
+
+| Hook            | Descrição                                                                                                                                                                             | Documentação relacionada                                                                                                |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Seleciona um dicionário por sua chave e retorna seu conteúdo localizado. No frontmatter `.astro`, lê o locale da requisição de `Astro.locals`. Em `<script>`, lê da store do cliente. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useIntlayer.md)     |
+| `useDictionary` | Transforma um objeto dicionário e retorna conteúdo para o locale resolvido. Funciona no frontmatter e em scripts do cliente.                                                          | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useDictionary.md) |
+| `useLocale`     | Retorna o locale atual, o locale padrão, os locales disponíveis e uma função para atualizar o locale.                                                                                 | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useLocale.md)         |
+
+### Middleware (astro-intlayer/middleware)
+
+Importação:
+
+```tsx
+import { onRequest } from "astro-intlayer/middleware";
+```
+
+| Exportação  | Tipo                | Descrição                                                                                                                                                               | Documentação relacionada                                                                                        |
+| ----------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `onRequest` | `MiddlewareHandler` | Middleware Astro que detecta o locale da requisição e anexa `Astro.locals.intlayer`. Registrado automaticamente por `intlayer()`, ou importado manualmente para compor. | [onRequest](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/onRequest.md) |
+
+### Utilitários
+
+Importação:
+
+```tsx
+import { getIntlayerLocals } from "astro-intlayer";
+```
+
+| Função              | Descrição                                                                                                                       | Documentação relacionada |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
+| `getIntlayerLocals` | Função auxiliar para recuperar o objeto `IntlayerLocals` atual do escopo de armazenamento da requisição fora de `Astro.locals`. | -                        |
+
+### Utilitários de Cliente (astro-intlayer/client)
+
+Importação:
+
+```tsx
+import {
+  useIntlayer,
+  useDictionary,
+  useDictionaryDynamic,
+  useLocale,
+  useLocaleStorage,
+  useLocaleCookie,
+  getIntlayer,
+  getDictionary,
+  installIntlayer,
+  setLocaleInStorage,
+  setLocaleCookie,
+  localeInStorage,
+  localeCookie,
+} from "astro-intlayer/client";
+```
+
+Quando importado no navegador ou dentro de tags `<script>` do cliente, `astro-intlayer` mapeia automaticamente para `astro-intlayer/client` (alimentado por `vanilla-intlayer`), fornecendo getters de dicionário do lado do cliente, assinantes da store e ferramentas de persistência de locale.
+
+### Formatadores (astro-intlayer/format)
+
+Importação:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "astro-intlayer/format";
+```
+
+| Hook              | Descrição                                                                                                 |
+| ----------------- | --------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Retorna uma instância Intl vinculada ao locale com recursos de cache e assinatura.                        |
+| `useDate`         | Retorna uma função de formatação de data vinculada ao locale atual (`Intl.DateTimeFormat`).               |
+| `useNumber`       | Retorna uma função de formatação de número vinculada ao locale atual (`Intl.NumberFormat`).               |
+| `useCurrency`     | Retorna uma função de formatação de moeda vinculada ao locale atual.                                      |
+| `usePercentage`   | Retorna uma função de formatação de porcentagem vinculada ao locale atual.                                |
+| `useRelativeTime` | Retorna uma função de formatação de tempo relativo vinculada ao locale atual (`Intl.RelativeTimeFormat`). |
+| `useList`         | Retorna uma função de formatação de lista vinculada ao locale atual (`Intl.ListFormat`).                  |
+| `useUnit`         | Retorna uma função de formatação de unidade vinculada ao locale atual.                                    |
+| `useCompact`      | Retorna uma função de formatação de número compacto vinculada ao locale atual (ex.: `1.5K`).              |
+
+### Utilitários HTML (astro-intlayer/html)
+
+Importação:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
+```
+
+| Exportação        | Tipo       | Descrição                                                        |
+| ----------------- | ---------- | ---------------------------------------------------------------- |
+| `renderHTML`      | `Function` | Função utilitária independente para renderizar nós HTML.         |
+| `useHTML`         | `Hook`     | Hook para obter o contexto e configuração do provedor HTML.      |
+| `useHTMLRenderer` | `Hook`     | Hook para obter uma função de renderização HTML pré-configurada. |
+
+### Utilitários Markdown (astro-intlayer/markdown)
+
+Importação:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "astro-intlayer/markdown";
+```
+
+| Exportação            | Tipo       | Descrição                                                            |
+| --------------------- | ---------- | -------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Compila strings markdown em uma representação estruturada.           |
+| `renderMarkdown`      | `Function` | Renderiza conteúdo markdown em nós de saída.                         |
+| `parseMarkdown`       | `Function` | Analisa conteúdo markdown bruto em uma AST.                          |
+| `useMarkdown`         | `Hook`     | Hook para obter o contexto do provedor markdown.                     |
+| `useMarkdownRenderer` | `Hook`     | Hook para obter uma função de renderização Markdown pré-configurada. |
+
+### Tipos
+
+Importação:
+
+```tsx
+import type {
+  IntlayerLocals,
+  UseLocaleProps,
+  UseLocaleResult,
+} from "astro-intlayer";
+```
+
+| Tipo              | Descrição                                                                                           |
+| ----------------- | --------------------------------------------------------------------------------------------------- |
+| `IntlayerLocals`  | O objeto anexado a `Astro.locals.intlayer` contendo `locale`, `defaultLocale` e `availableLocales`. |
+| `UseLocaleProps`  | Propriedades de configuração opcionais aceitas por `useLocale()`.                                   |
+| `UseLocaleResult` | O tipo de retorno de `useLocale()`, fornecendo propriedades de locale e métodos de atualização.     |

package/docs/pt/packages/astro-intlayer/intlayer.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-21
+updatedAt: 2026-09-19
+title: Documentação da integração intlayer | astro-intlayer
+description: Veja como configurar e usar a integração Astro intlayer no astro.config.mjs.
+keywords:
+  - intlayer
+  - astro
+  - astro-intlayer
+  - integração
+  - i18n
+  - internacionalização
+  - documentação
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Atualizada documentação de integração com detalhes de middleware e hooks"
+  - version: 8.0.0
+    date: 2026-01-21
+    changes: "Doc inicial"
+author: aymericzip
+---
+
+# Documentação da integração Astro intlayer
+
+A integração `intlayer` para Astro configura seu projeto para internacionalização (i18n) multilíngue. Ela cuida da preparação de dicionários no momento da compilação, injeção de plugins Vite, registro automático de middleware de requisição e emissão de páginas pré-renderizadas localizadas.
+
+## Utilização
+
+Adicione `intlayer()` ao seu `astro.config.mjs`:
+
+```ts fileName="astro.config.mjs"
+import { defineConfig } from "astro/config";
+import { intlayer } from "astro-intlayer";
+
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+O codemod do Astro CLI (`astro add astro-intlayer`) também gera uma importação padrão que é suportada:
+
+```ts
+import intlayer from "astro-intlayer";
+```
+
+## Descrição
+
+A integração se conecta ao ciclo de vida de build e execução do Astro:
+
+1. **Configuração inicial (`astro:config:setup`)**:
+   - **Preparação de Dicionários**: Prepara os dicionários do Intlayer e os tipos gerados antes da execução do build.
+   - **Plugins Vite**: Injeta plugins para aliases Vite (permitindo importações diretas de dicionários), proxies de roteamento de locale e poda de compilação.
+   - **Registro de Middleware**: Injeta automaticamente `astro-intlayer/middleware` na cadeia de middleware do seu projeto, preenchendo `Astro.locals.intlayer` em cada requisição recebida.
+2. **Build concluído (`astro:build:done`)**:
+   - **Reescritas de Página**: Inspeciona regras de reescrita de URL localizadas e emite páginas HTML pré-renderizadas em seus caminhos localizados correspondentes.
+
+## O que é fornecido imediatamente
+
+Uma vez configurada, sua aplicação Astro pode usar imediatamente:
+
+- Os hooks `useIntlayer`, `useDictionary` e `useLocale` no frontmatter de componentes `.astro`.
+- O objeto `Astro.locals.intlayer` em endpoints e páginas Astro.
+- Importações no lado do cliente em blocos `<script>` que espelham a mesma API com atualizações reativas.
+- Formatadores integrados em `astro-intlayer/format` (`useDate`, `useNumber`, `useCurrency`, etc.).
+
+## Documentação relacionada
+
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useLocale.md)
+- [Middleware `onRequest`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/onRequest.md)