@intlayer/docs 9.5.4 → 9.5.6

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

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentação do middleware onRequest | astro-intlayer
+description: Veja como usar o middleware onRequest em aplicações Astro para resolver o locale da requisição e preencher Astro.locals.intlayer.
+keywords:
+  - onRequest
+  - middleware
+  - astro
+  - astro-intlayer
+  - Astro.locals
+  - internacionalização
+  - documentação
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - onRequest
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Doc inicial"
+author: aymericzip
+---
+
+# Documentação do middleware Astro onRequest
+
+O middleware `onRequest` de `astro-intlayer/middleware` resolve o locale de cada requisição HTTP recebida e preenche `Astro.locals.intlayer`.
+
+Quando você registra a integração `intlayer()` em `astro.config.mjs`, esse middleware é injetado automaticamente. Você só precisa importá-lo diretamente se estiver compondo manualmente o middleware Astro usando `sequence(...)`.
+
+## Utilização
+
+```ts fileName="src/middleware.ts"
+import { onRequest as intlayer } from "astro-intlayer/middleware";
+import { sequence } from "astro:middleware";
+
+export const onRequest = sequence(intlayer, async (context, next) => {
+  // Acesse o locale resolvido em seu middleware personalizado
+  const { locale } = context.locals.intlayer;
+  console.log(`Manipulando requisição para o locale: ${locale}`);
+
+  return next();
+});
+```
+
+## Descrição
+
+O middleware realiza as seguintes tarefas:
+
+1. **Detecção de Locale**:
+   - **URL**: Analisa o prefixo do caminho da URL ou o parâmetro de busca `?locale=` (a menos que `routing.mode` esteja configurado como `no-prefix`).
+   - **Cookies / Cabeçalhos**: Verifica cookies de locale persistidos ou valores de cabeçalho personalizados.
+   - **Accept-Language**: Utiliza a negociação de idioma preferencial do navegador como fallback.
+   - Para páginas pré-renderizadas (`context.isPrerendered`), o locale é extraído estritamente da URL para evitar avisos de compilação do Astro.
+2. **Preenchimento de Contexto**: Preenche `Astro.locals.intlayer` com:
+   - `locale`: O locale resolvido.
+   - `defaultLocale`: O locale de fallback padrão.
+   - `availableLocales`: O array de locales configurados.
+3. **Escopo AsyncLocalStorage**: Envolve o processamento subsequente da requisição dentro de um escopo `AsyncLocalStorage`, permitindo que `useIntlayer()`, `useDictionary()` e `useLocale()` acessem o estado da requisição sem passar argumentos.
+
+## Tipo `IntlayerLocals`
+
+```ts
+export type IntlayerLocals = {
+  locale: DeclaredLocales;
+  defaultLocale: DeclaredLocales;
+  availableLocales: DeclaredLocales[];
+};
+```
+
+## Documentação relacionada
+
+- [Integração `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/intlayer.md)
+- [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)

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

@@ -0,0 +1,95 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentação do hook useDictionary | astro-intlayer
+description: Veja como usar o hook useDictionary em componentes e scripts Astro para resolver objetos de dicionário.
+keywords:
+  - useDictionary
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - internacionalização
+  - documentação
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useDictionary
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Doc inicial"
+author: aymericzip
+---
+
+# Documentação do hook useDictionary
+
+O hook `useDictionary` resolve um objeto de dicionário importado ou em linha e retorna seu conteúdo para o locale atual em aplicações Astro.
+
+Diferente do `useIntlayer`, que busca dicionários por chave a partir do registro global de dicionários, o `useDictionary` trabalha diretamente com um objeto de dicionário.
+
+## Utilização
+
+```astro fileName="src/pages/index.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import homeContent from "../content/home.content";
+
+const content = useDictionary(homeContent);
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+Você também pode passar dicionários em linha definidos com `t()`:
+
+```astro fileName="src/components/Footer.astro"
+---
+import { useDictionary } from "astro-intlayer";
+import { t } from "intlayer";
+
+const footer = useDictionary({
+  key: "footer",
+  content: {
+    copyright: t({
+      pt: "Todos os direitos reservados.",
+      en: "All rights reserved.",
+      fr: "Tous droits réservés.",
+      es: "Todos los derechos reservados.",
+    }),
+  },
+});
+---
+
+<footer>
+  <p>{footer.copyright}</p>
+</footer>
+```
+
+## Parâmetros
+
+```ts
+useDictionary(dictionary, localeOrSelector?)
+```
+
+1. **`dictionary`**: Um objeto de dicionário ou grupo de dicionários qualificado.
+2. **`localeOrSelector`** (opcional): Um locale específico ou objeto seletor (`{ item }`, `{ variant }`, opcionalmente com `locale`).
+
+## Descrição
+
+O hook realiza as seguintes tarefas:
+
+1. **Detecção de Locale**: No servidor, obtém o locale de `Astro.locals.intlayer`. No navegador, utiliza o locale da store do cliente.
+2. **Processamento de Conteúdo**: Resolve traduções (`t()`), enumerações, condições e estruturas aninhadas de acordo com o locale resolvido.
+3. **Seletores**: Aplica quaisquer seletores de item ou variante fornecidos nos argumentos.
+
+## Documentação relacionada
+
+- [Integração `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/intlayer.md)
+- [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)

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

@@ -0,0 +1,98 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentação do hook useIntlayer | astro-intlayer
+description: Veja como usar o hook useIntlayer em componentes e scripts de cliente Astro para acessar conteúdo localizado.
+keywords:
+  - useIntlayer
+  - dictionary
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - internacionalização
+  - documentação
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useIntlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Doc inicial"
+author: aymericzip
+---
+
+# Documentação do hook useIntlayer
+
+O hook `useIntlayer` permite recuperar conteúdo de dicionário localizado por chave em aplicações Astro.
+
+Ele pode ser chamado em dois contextos distintos usando o mesmo caminho de importação:
+
+1. **Servidor / Frontmatter**: Dentro de arquivos `.astro`, ele resolve automaticamente o conteúdo usando o locale da requisição armazenado em `Astro.locals.intlayer`.
+2. **Navegador / Tag `<script>` do cliente**: Em scripts do cliente ou componentes de frameworks de interface, ele resolve para a implementação de store do lado do cliente (`vanilla-intlayer`).
+
+## Utilização
+
+### No Frontmatter de componentes Astro
+
+```astro fileName="src/pages/index.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<main>
+  <h1>{content.title}</h1>
+  <p>{content.description}</p>
+</main>
+```
+
+### Em blocos `<script>` do cliente
+
+```astro fileName="src/components/InteractiveWidget.astro"
+---
+import { useIntlayer } from "astro-intlayer";
+
+const content = useIntlayer("home");
+---
+
+<button id="alert-btn">{content.buttonText}</button>
+
+<script>
+  import { useIntlayer } from "astro-intlayer";
+
+  const content = useIntlayer("home");
+
+  document.getElementById("alert-btn")?.addEventListener("click", () => {
+    alert(content.buttonText);
+  });
+</script>
+```
+
+## Parâmetros
+
+```ts
+useIntlayer(key, localeOrSelector?)
+```
+
+1. **`key`**: A chave única do dicionário (conforme definida em seus arquivos de declaração `.content.ts`).
+2. **`localeOrSelector`** (opcional): Um locale específico ou objeto seletor (`{ item }`, `{ variant }`, opcionalmente com `locale`). Quando fornecido, substitui o locale detectado do contexto da requisição ou store do cliente.
+
+## Descrição
+
+O hook realiza as seguintes tarefas:
+
+1. **Resolução de Locale**:
+   - No servidor, lê o locale ativo de `Astro.locals.intlayer` por meio de um escopo `AsyncLocalStorage` inicializado por `astro-intlayer/middleware`.
+   - No navegador, lê o locale ativo do armazenamento/store do cliente.
+2. **Recuperação de Dicionário**: Injeta o conteúdo do dicionário correspondente à chave especificada.
+3. **Processamento de Tradução**: Resolve traduções (`t()`), enumerações, condições e markdown em conteúdo pronto para renderização.
+
+## Documentação relacionada
+
+- [Integração `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/intlayer.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useDictionary.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useLocale.md)

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

@@ -0,0 +1,126 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentação do hook useLocale | astro-intlayer
+description: Veja como usar o hook useLocale em aplicações Astro para acessar e gerenciar o locale atual.
+keywords:
+  - useLocale
+  - locale
+  - astro
+  - astro-intlayer
+  - Intlayer
+  - intlayer
+  - internacionalização
+  - documentação
+slugs:
+  - doc
+  - packages
+  - astro-intlayer
+  - useLocale
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Doc inicial"
+author: aymericzip
+---
+
+# Documentação do hook useLocale
+
+O hook `useLocale` de `astro-intlayer` fornece acesso ao locale da requisição atual, ao locale padrão configurado e a todos os locales disponíveis em aplicações Astro.
+
+Ele se comporta de maneira consistente no frontmatter `.astro` renderizado no servidor e em blocos `<script>` do lado do cliente.
+
+## Utilização
+
+### No Frontmatter de componentes (Renderizado no Servidor)
+
+```astro fileName="src/layouts/Layout.astro"
+---
+import { useLocale } from "astro-intlayer";
+import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
+
+const { locale, defaultLocale, availableLocales } = useLocale();
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<!DOCTYPE html>
+<html lang={locale}>
+  <head>
+    <meta charset="utf-8" />
+    <title>Astro + Intlayer</title>
+  </head>
+  <body>
+    <header>
+      <span>Atual: {locale}</span>
+      <span>Padrão: {defaultLocale}</span>
+      <nav>
+        <ul>
+          {availableLocales.map((localeItem) => (
+            <li key={localeItem} className="p-1">
+              <a
+                href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+                aria-current={localeItem === locale ? "page" : undefined}
+              >
+                {localeItem.toUpperCase()}
+              </a>
+            </li>
+          ))}
+        </ul>
+      </nav>
+    </header>
+    <slot />
+  </body>
+</html>
+```
+
+### Em `<script>` do cliente (Interativo)
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import { useLocale } from "astro-intlayer";
+
+const { locale, availableLocales } = useLocale();
+---
+
+<select id="locale-select">
+  {availableLocales.map((loc) => (
+    <option value={loc} selected={loc === locale}>
+      {loc.toUpperCase()}
+    </option>
+  ))}
+</select>
+
+<script>
+  import { useLocale, setLocaleInStorage } from "astro-intlayer";
+
+  const { setLocale } = useLocale();
+
+  document.getElementById("locale-select")?.addEventListener("change", (e) => {
+    const target = e.target as HTMLSelectElement;
+    setLocale(target.value);
+  });
+</script>
+```
+
+## Valores de retorno
+
+O hook retorna um objeto do tipo `UseLocaleResult`:
+
+| Propriedade        | Tipo                                   | Descrição                                                                      |
+| ------------------ | -------------------------------------- | ------------------------------------------------------------------------------ |
+| `locale`           | `DeclaredLocales`                      | O locale ativo.                                                                |
+| `defaultLocale`    | `DeclaredLocales`                      | O locale de fallback padrão configurado em `intlayer.config.ts`.               |
+| `availableLocales` | `DeclaredLocales[]`                    | Array de todos os locales suportados configurados para o projeto.              |
+| `setLocale`        | `(locale: LocalesValues) => void`      | Função para atualizar o locale. (Interativa no `<script>`, avisa durante SSR). |
+| `subscribe`        | `(callback: () => void) => () => void` | Inscreve-se nas alterações de locale no lado do cliente.                       |
+
+## Comportamento Servidor vs Cliente
+
+- **Durante SSR / Renderização no Servidor**: Uma requisição é renderizada uma vez com parâmetros fixos. Chamar `setLocale()` durante a renderização no servidor não tem efeito e emite um aviso; a alteração de locale deve ser feita no cliente ou navegando para a URL do locale desejado.
+- **Em scripts do cliente**: `setLocale` atualiza a store do cliente e atualiza cookies persistidos ou o armazenamento local de acordo com sua configuração do Intlayer.
+
+## Documentação relacionada
+
+- [Integração `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/intlayer.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useIntlayer.md)
+- [Hook `useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/astro-intlayer/useDictionary.md)

package/docs/pt/packages/remix-intlayer/Intlayer.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentação do contexto Intlayer | remix-intlayer
+description: Veja como usar a chave e a propriedade de contexto de requisição Intlayer em aplicações Remix 3.
+keywords:
+  - Intlayer
+  - remix
+  - remix-3
+  - contexto
+  - RequestContext
+  - Internacionalização
+  - Documentação
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - Intlayer
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Init doc"
+author: aymericzip
+---
+
+# Documentação do contexto Intlayer
+
+No `remix-intlayer`, `Intlayer` é a chave de `RequestContext` usada para acessar o estado de internacionalização dentro dos manipuladores de requisição do Remix 3.
+
+## Uso
+
+Quando o middleware `intlayer()` é executado, ele armazena um objeto `IntlayerState` no contexto da requisição sob a chave `Intlayer`. Você pode recuperá-lo dentro de qualquer manipulador de rota:
+
+```ts fileName="src/server.ts"
+import { createRouter } from "remix/router";
+import { intlayer, Intlayer } from "remix-intlayer";
+
+const router = createRouter({
+  middleware: [intlayer()],
+});
+
+router.get("/api/profile", (context) => {
+  // Acesso via context.get(Intlayer)
+  const { locale, defaultLocale, availableLocales } = context.get(Intlayer);
+
+  return Response.json({
+    locale,
+    defaultLocale,
+    availableLocales,
+  });
+});
+```
+
+Você também pode acessar utilizando o atalho de propriedade direta `context.intlayer`:
+
+```ts
+router.get("/api/status", (context) => {
+  const currentLocale = context.intlayer.locale;
+  return Response.json({ status: "ok", locale: currentLocale });
+});
+```
+
+## Estrutura do `IntlayerState`
+
+O objeto `IntlayerState` contém:
+
+| Propriedade        | Tipo                | Descrição                                                           |
+| ------------------ | ------------------- | ------------------------------------------------------------------- |
+| `locale`           | `DeclaredLocales`   | A locale resolvida para a requisição atual.                         |
+| `defaultLocale`    | `DeclaredLocales`   | A locale de fallback padrão configurada em `intlayer.config.ts`.    |
+| `availableLocales` | `DeclaredLocales[]` | A lista de todas as locales suportadas configuradas para o projeto. |
+
+## Documentação relacionada
+
+- [Middleware `intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/intlayerMiddleware.md)
+- [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/useLocale.md)
+- [Hook `useIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/useIntlayer.md)

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

@@ -0,0 +1,176 @@
+---
+createdAt: 2026-09-19
+updatedAt: 2026-09-19
+title: Documentação do pacote remix-intlayer
+description: Integração do Remix 3 para o Intlayer, fornecendo middleware, contexto, hooks e formatadores para roteamento baseado em locale e gerenciamento de conteúdo.
+keywords:
+  - remix-intlayer
+  - remix
+  - remix-3
+  - internacionalização
+  - i18n
+slugs:
+  - doc
+  - packages
+  - remix-intlayer
+  - exports
+history:
+  - version: 9.5.5
+    date: 2026-09-19
+    changes: "Documentação unificada para todas as exportações"
+author: aymericzip
+---
+
+# Pacote remix-intlayer
+
+O pacote `remix-intlayer` fornece as ferramentas necessárias para integrar o Intlayer em aplicações Remix 3. Desenvolvido inteiramente sobre padrões web (`Request`, `Response`, `Headers` e `URL`), oferece middleware de roteador para roteamento por locale e reescritas internas, armazenamento de contexto, hooks e utilitários de formatação para gerenciamento simples de conteúdo multilíngue.
+
+## Instalação
+
+```bash
+npm install remix-intlayer
+```
+
+## Exportações
+
+### Middleware
+
+Importação:
+
+```tsx
+import { intlayer } from "remix-intlayer";
+```
+
+| Função     | Descrição                                                                                                                                                                                                                               | Doc relacionada                                                                                                         |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Middleware de roteador Remix 3 que gerencia o roteamento baseado em locale (redirecionamentos e reescritas internas), resolve a locale da requisição, persiste-a em cookies/cabeçalhos e estabelece o escopo de contexto da requisição. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/intlayerMiddleware.md) |
+
+### Contexto
+
+Importação:
+
+```tsx
+import { Intlayer, INTLAYER_CONTEXT_PROPERTY } from "remix-intlayer";
+```
+
+| Exportação                  | Tipo         | Descrição                                                                                                                                       | Doc relacionada                                                                                               |
+| --------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `Intlayer`                  | `ContextKey` | Chave de RequestContext contendo o `IntlayerState` (`locale`, `defaultLocale`, `availableLocales`) para a requisição atual.                     | [Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/Intlayer.md) |
+| `INTLAYER_CONTEXT_PROPERTY` | `string`     | Nome de propriedade (`'intlayer'`) instalado diretamente no contexto da requisição, acessível via `context.intlayer` e `context.get(Intlayer)`. | -                                                                                                             |
+
+### Hooks
+
+Importação:
+
+```tsx
+import { useIntlayer, useDictionary, useLocale } from "remix-intlayer";
+```
+
+| Hook            | Descrição                                                                                                                                     | Doc relacionada                                                                                                         |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | Seleciona um dicionário por sua chave e retorna seu conteúdo para a locale da requisição atual. Lê automaticamente do contexto da requisição. | [useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/useIntlayer.md)     |
+| `useDictionary` | Transforma um objeto de dicionário importado e retorna seu conteúdo para a locale da requisição atual. Suporta seletores.                     | [useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/useDictionary.md) |
+| `useLocale`     | Retorna a locale resolvida da requisição atual, juntamente com `defaultLocale` e `availableLocales` configuradas.                             | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/packages/remix-intlayer/useLocale.md)         |
+
+### Utilitários
+
+Importação:
+
+```tsx
+import { createLocaleRouting, getIntlayerState } from "remix-intlayer";
+```
+
+| Função                | Descrição                                                                                                                       | Doc relacionada |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------- |
+| `createLocaleRouting` | Função pura que calcula decisões de roteamento (`redirect`, `rewrite` ou `pass`) com base em requisição, configuração e opções. | -               |
+| `getIntlayerState`    | Lê o `IntlayerState` atual (`locale`, `defaultLocale`, `availableLocales`) do escopo `AsyncLocalStorage`.                       | -               |
+
+### Formatadores (remix-intlayer/format)
+
+Importação:
+
+```tsx
+import {
+  useIntl,
+  useDate,
+  useNumber,
+  useCurrency,
+  usePercentage,
+  useRelativeTime,
+  useList,
+  useUnit,
+  useCompact,
+} from "remix-intlayer/format";
+```
+
+| Hook              | Descrição                                                                                                        |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `useIntl`         | Retorna uma instância Intl vinculada à locale da requisição com recursos de cache e assinatura.                  |
+| `useDate`         | Retorna uma função de formatação de data vinculada à locale da requisição (`Intl.DateTimeFormat`).               |
+| `useNumber`       | Retorna uma função de formatação de número vinculada à locale da requisição (`Intl.NumberFormat`).               |
+| `useCurrency`     | Retorna uma função de formatação de moeda vinculada à locale da requisição.                                      |
+| `usePercentage`   | Retorna uma função de formatação de porcentagem vinculada à locale da requisição.                                |
+| `useRelativeTime` | Retorna uma função de formatação de tempo relativo vinculada à locale da requisição (`Intl.RelativeTimeFormat`). |
+| `useList`         | Retorna uma função de formatação de lista vinculada à locale da requisição (`Intl.ListFormat`).                  |
+| `useUnit`         | Retorna uma função de formatação de unidade vinculada à locale da requisição.                                    |
+| `useCompact`      | Retorna uma função de formatação de número compacto vinculada à locale da requisição (ex.: `1.5K`).              |
+
+### Utilitários HTML (remix-intlayer/html)
+
+Importação:
+
+```tsx
+import { renderHTML, useHTML, useHTMLRenderer } from "remix-intlayer/html";
+```
+
+| Exportação        | Tipo       | Descrição                                                                |
+| ----------------- | ---------- | ------------------------------------------------------------------------ |
+| `renderHTML`      | `Function` | Função utilitária para renderizar nós HTML fora da interface do usuário. |
+| `useHTML`         | `Hook`     | Hook para obter o contexto e a configuração do provedor HTML.            |
+| `useHTMLRenderer` | `Hook`     | Hook para obter uma função de renderização HTML pré-configurada.         |
+
+### Utilitários Markdown (remix-intlayer/markdown)
+
+Importação:
+
+```tsx
+import {
+  compileMarkdown,
+  renderMarkdown,
+  parseMarkdown,
+  useMarkdown,
+  useMarkdownRenderer,
+} from "remix-intlayer/markdown";
+```
+
+| Exportação            | Tipo       | Descrição                                                            |
+| --------------------- | ---------- | -------------------------------------------------------------------- |
+| `compileMarkdown`     | `Function` | Compila strings markdown em 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 acessar 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 {
+  IntlayerState,
+  IntlayerMiddlewareOptions,
+  LocaleRoutingOptions,
+  LocaleRoutingAction,
+  LocaleRoutingRequest,
+  UseLocaleResult,
+} from "remix-intlayer";
+```
+
+| Tipo                        | Descrição                                                                                              |
+| --------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `IntlayerState`             | Objeto de estado contendo `locale`, `defaultLocale` e `availableLocales` armazenado no contexto Remix. |
+| `IntlayerMiddlewareOptions` | Opções de configuração passadas para o middleware `intlayer()`.                                        |
+| `LocaleRoutingOptions`      | Opções que personalizam prefixos de locale, detecção e redirecionamentos.                              |
+| `LocaleRoutingAction`       | União discriminada representando a decisão de roteamento: `redirect`, `rewrite` ou `pass`.             |
+| `LocaleRoutingRequest`      | Representação mínima de requisição exigida por `createLocaleRouting`.                                  |
+| `UseLocaleResult`           | Tipo de retorno de `useLocale()`, contendo `locale`, `defaultLocale` e `availableLocales`.             |