@intlayer/docs 9.5.6 → 9.5.8

package/docs/pt/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Saiba como usar o comando init infra da CLI do Intlayer para instalar o aplicativo desktop ou fazer auto-hospedagem do CMS Intlayer com Docker (contêiner tudo-em-um ou stack Docker Compose).
+keywords:
+  - CLI
+  - Infraestrutura
+  - Auto-hospedagem
+  - Aplicativo desktop
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Adicionar o comando init infra"
+author: aymericzip
+---
+
+# Comando Intlayer CLI Init Infra
+
+## Descrição
+
+O comando `init infra` configura a infraestrutura do Intlayer em sua máquina. Ele baixa o instalador hospedado para sua plataforma (`https://intlayer.org/install.sh` no macOS / Linux, `https://intlayer.org/install.ps1` no Windows) e o executa com o terminal anexado, de modo que o menu e o progresso do instalador chegam sem alterações.
+
+O instalador pergunta como você deseja executar o Intlayer:
+
+- **Aplicativo desktop**: baixa o painel nativo para seu SO e CPU e o abre ou instala. A versão desktop se comunica com o backend Intlayer Cloud.
+- **Docker tudo-em-um**: painel + API + MongoDB + Redis + MinIO em um único contêiner com um volume. Grava `./intlayer.env` com os segredos gerados e baixa a imagem `intlayer/cms-all`.
+- **Docker Compose**: um contêiner por serviço, para auto-hospedagem escalável. Grava `docker-compose.yml` e `.env` em `./intlayer/` e baixa as imagens.
+
+O instalador hospedado é a única fonte da verdade para o fluxo de configuração: a CLI o executa em vez de reimplementar as mesmas etapas, então `npx intlayer init infra` e `curl -fsSL https://intlayer.org/install.sh | sh` fazem exatamente a mesma coisa.
+
+## Uso
+
+```bash packageManager="npm"
+npx intlayer init infra [options]
+```
+
+```bash packageManager="yarn"
+yarn intlayer init infra [options]
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer init infra [options]
+```
+
+```bash packageManager="bun"
+bun x intlayer init infra [options]
+```
+
+A mesma etapa é oferecida na lista de verificação de `npx intlayer init --interactive`, em **Infraestrutura (aplicativo desktop / auto-hospedagem)**.
+
+## Opções
+
+- `-m, --mode <mode>` - Opcional. Pula o menu do instalador e executa um modo diretamente. Valores aceitos: `desktop`, `docker` (tudo-em-um) ou `compose`. Qualquer outro valor encerra com um erro listando os modos aceitos.
+
+## Exemplos
+
+### Escolha o modo interativamente
+
+```bash
+npx intlayer init infra
+```
+
+### Instalar o aplicativo desktop
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### Auto-hospedagem com o contêiner tudo-em-um
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Auto-hospedagem com Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## Exemplo de saída
+
+```bash
+npx intlayer init infra --mode compose
+◇  Installer downloaded
+▸ Fetching docker-compose.yml into ./intlayer
+▸ Writing ./intlayer/.env
+▸ Pulling images
+
+  Everything is installed. Two steps left.
+
+  1. Configure a mailer in:
+
+       ./intlayer/.env
+
+     Either RESEND_API_KEY (resend.com) or the MAIL_SMTP_* block — the first
+     account cannot be verified without a working mailer.
+  2. Start the stack:
+
+       cd ./intlayer && docker compose up -d
+
+  Then open http://localhost:3000 — first boot initialises the
+  datastores, so give it a minute. The first account you create becomes the
+  super admin.
+
+    Logs      docker compose logs -f
+    Stop      docker compose down
+    Upgrade   docker compose pull && docker compose up -d
+```
+
+## Configurações do instalador
+
+O instalador lê algumas variáveis de ambiente, que a CLI repassa intactas. Defina-as em seu shell antes de executar o comando:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| Variável                  | Padrão                    | Aplica-se a | Descrição                                                  |
+| ------------------------- | ------------------------- | ----------- | ---------------------------------------------------------- |
+| `INTLAYER_MODE`           | _(solicitado)_            | todos       | `desktop`, `docker` ou `compose`, igual a `--mode`         |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop     | Onde o instalador do aplicativo é salvo                    |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker      | Imagem tudo-em-um a ser baixada                            |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker      | Onde gravar o arquivo de ambiente                          |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker      | Nome do contêiner                                          |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker      | Volume nomeado montado em `/data`                          |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker      | Porta do host para o painel                                |
+| `INTLAYER_API_PORT`       | `3100`                    | docker      | Porta do host para a API                                   |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker      | Porta do host para a API S3 MinIO                          |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker      | Porta do host para o console MinIO                         |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose     | Onde `docker-compose.yml` e `.env` são gravados            |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | ambos       | Ref Git de onde o arquivo compose e modelo env são obtidos |
+
+> As variáveis de porta alteram apenas o lado do **host** do mapeamento. As imagens publicadas possuem `http://localhost:3000`, `http://localhost:3100` e `http://localhost:9000` compilados no pacote do painel, portanto mantenha os padrões a menos que construa suas próprias imagens: consulte o [guia de auto-hospedagem](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md#limitations).
+
+## Requisitos
+
+- **Aplicativo desktop** precisa de [Node.js](https://nodejs.org): o app incorpora o servidor do painel e o inicia com o binário `node` da máquina.
+- **Modos Docker** precisam de [Docker](https://docs.docker.com/get-docker/) (Docker Desktop com backend WSL 2 no Windows). O modo Compose também requer o plugin `docker compose`.
+
+## Notas
+
+- Executar novamente o comando é seguro: um arquivo de ambiente existente nunca é sobrescrito, servindo também como caminho de atualização (o instalador baixa as imagens mais recentes e mantém seus segredos).
+- O instalador é baixado em um diretório temporário e excluído assim que finaliza, qualquer que seja o resultado.
+- O código de saída do comando é o do instalador. Se o download falhar, a CLI exibe o comando equivalente `curl … | sh` (ou `irm … | iex`) para que você execute o instalador diretamente.
+- Os modos Docker ainda precisam de um serviço de e-mail para envio de links de login. Após a conclusão do instalador, configure o Resend ou SMTP no arquivo de ambiente gerado: consulte [Mailer global](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md#global-mailer).
+
+## Relacionado
+
+- [Guia de auto-hospedagem](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md) - Arquitetura, primeiros passos e limitações de cada modo
+- [Inicializar Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/init.md) - O comando pai `init` e sua lista de verificação interativa
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/intlayer_CMS.md) - O que faz o painel que você acabou de instalar

package/docs/pt/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Inicializar Intlayer
 description: Saiba como inicializar o Intlayer no seu projeto.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Adicionar subcomando init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Adicionar opção --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 Isto configurará todos os ficheiros de configuração mas não modificará o seu `.gitignore`.
 
+### Configurar a infraestrutura (aplicativo desktop ou auto-hospedagem):
+
+```bash
+npx intlayer init infra
+```
+
+Baixa e executa o instalador hospedado (`https://intlayer.org/install.sh`, ou `install.ps1` no Windows), que pergunta como você deseja executar o Intlayer:
+
+- **Aplicativo desktop** - instala o painel nativo em sua máquina, conectado ao Intlayer Cloud.
+- **Docker tudo-em-um** - painel + API + MongoDB + Redis + MinIO em um único contêiner.
+- **Docker Compose** - um contêiner por serviço, para auto-hospedagem escalável.
+
+Pule o menu com `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+A mesma etapa é oferecida por `npx intlayer init --interactive`. Consulte a [referência do `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/infra.md) para as configurações do instalador, e o [guia de auto-hospedagem](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/self_hosting.md) para ver o que cada modo configura.
+
 ## Exemplo de saída:
 
 ```bash

package/docs/pt/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Atualizar pacotes Intlayer
+description: Aprenda a utilizar o comando upgrade do CLI Intlayer para listar todos os pacotes Intlayer do seu projeto ou monorepo e atualizá-los para a versão mais recente.
+keywords:
+  - CLI
+  - Upgrade
+  - Atualizar
+  - Pacotes
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Adicionar o comando upgrade"
+author: aymericzip
+---
+
+# Atualizar Pacotes Intlayer
+
+```bash packageManager="npm"
+npx intlayer upgrade
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade
+```
+
+O comando `upgrade` lista os pacotes Intlayer declarados em cada `package.json` do seu projeto, incluindo workspaces de monorepo, e atualiza-os para a versão publicada mais recente. Executa o mesmo passo de atualização de pacotes que o `intlayer init`, de forma autónoma.
+
+## Argumentos:
+
+- `--project-root [projectRoot]` - Opcional. O diretório raiz do projeto. Por padrão, o comando inicia a partir do `package.json` mais próximo acima do diretório de trabalho atual.
+- `--dry-run` - Opcional. Lista os pacotes e a respetiva versão de destino sem modificar nenhum ficheiro.
+- `--tag <tag>` - Opcional. A dist-tag npm para a qual atualizar (por exemplo `canary`). O padrão é `latest`.
+
+## O que faz:
+
+1. **Lista os pacotes Intlayer** - Faz scan a cada `package.json` do projeto (ignorando `node_modules` e saídas de build) à procura de dependências e devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` e `intlayer-*`.
+2. **Obtém a versão de destino** - Lê a versão da dist-tag selecionada (`latest` por padrão) de cada pacote a partir do registo npm.
+3. **Reescreve os intervalos** - Atualiza cada intervalo desatualizado diretamente no ficheiro, mantendo o seu operador (`^`, `~` ou nenhum) e a indentação do ficheiro.
+4. **Instala de uma só vez** - Executa uma única instalação a partir da raiz do workspace (o diretório mais próximo com um lock file), utilizando o gestor de pacotes associado ao lock file:
+
+| Lock file                       | Comando        |
+| ------------------------------- | -------------- |
+| `bun.lock` / `bun.lockb`        | `bun install`  |
+| `pnpm-lock.yaml`                | `pnpm install` |
+| `yarn.lock`                     | `yarn install` |
+| `package-lock.json` ou sem lock | `npm install`  |
+
+Se não houver nenhum lock file, o campo `packageManager` do `package.json` (por exemplo `"bun@1.2.0"`) é utilizado antes de recorrer ao npm.
+
+Intervalos que não apontam para o registo, como `workspace:*`, `file:`, `link:`, `catalog:` ou URLs git, nunca são modificados.
+
+## Exemplos:
+
+### Listar as atualizações disponíveis sem aplicá-las:
+
+```bash packageManager="npm"
+npx intlayer upgrade --dry-run
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --dry-run
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --dry-run
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --dry-run
+```
+
+### Atualizar para a versão canary:
+
+```bash packageManager="npm"
+npx intlayer upgrade --tag canary
+```
+
+```bash packageManager="yarn"
+yarn intlayer upgrade --tag canary
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer upgrade --tag canary
+```
+
+```bash packageManager="bun"
+bun x intlayer upgrade --tag canary
+```
+
+## Exemplo de saída:
+
+```bash
+npx intlayer upgrade
+Intlayer packages:
+  package.json
+    intlayer ^9.0.0 → ^9.5.7
+  apps/web/package.json
+    next-intlayer ^9.5.7 (latest)
+    vite-intlayer ~9.2.0 → ~9.5.7
+Running bun install...
+✓ Upgraded 2 Intlayer dependencies to latest
+```
+
+## Notas:
+
+- Execute o comando a partir da raiz do seu repositório para atualizar todos os workspaces. Execute-o a partir de um workspace para atualizar apenas esse workspace.
+- Pacotes cuja versão não pode ser obtida (offline, pacote privado ou não publicado) são listados e mantidos inalterados.
+- Se a instalação falhar, os intervalos atualizados são mantidos no `package.json`. Execute manualmente o comando de instalação do seu gestor de pacotes.

package/docs/pt/dictionary/html.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-20
-updatedAt: 2026-03-24
+updatedAt: 2026-09-21
 title: Conteúdo HTML
 description: Aprenda como declarar e usar conteúdo HTML com componentes personalizados no Intlayer. Siga esta documentação para incorporar conteúdo rico semelhante a HTML com substituição dinâmica de componentes no seu projeto internacionalizado.
 keywords:
@@ -13,6 +13,8 @@ keywords:
   - React
   - Vue
   - Svelte
+  - Remix
+  - Astro
   - Solid
   - Angular
 slugs:
@@ -238,6 +240,83 @@ Quando você acessa conteúdo via `useIntlayer`, os nós HTML já estão prepara
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    No Remix 3, os nós HTML são resolvidos em uma string HTML. Injete-a com a prop `innerHTML` do Remix JSX ou com `html.raw` em uma visualização `html-template`.
+
+    ```tsx fileName="src/views/home.tsx"
+    import { useIntlayer } from "remix-intlayer";
+
+    export const HomePage = () => () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return <div innerHTML={myHtmlContent.value} />;
+    };
+    ```
+
+    ```ts fileName="src/views/home.ts"
+    import { html } from "remix/html-template";
+    import { useIntlayer } from "remix-intlayer";
+
+    export const renderHomePage = () => {
+      const { myHtmlContent } = useIntlayer("app");
+
+      return html.raw`<div>${myHtmlContent.value}</div>`;
+    };
+    ```
+
+    > O Remix escapa valores interpolados por padrão. `innerHTML` e `html.raw` são as duas exceções, que é o que uma string HTML precisa.
+
+    Use o método `.use()` para substituir tags ou mapear componentes personalizados. As substituições são funções que retornam uma string HTML:
+
+    ```tsx
+    <div
+      innerHTML={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    No Astro, os nós HTML são resolvidos em uma string HTML. Injete-a com a diretiva `set:html` no template ou com `innerHTML` em um `<script>` do cliente.
+
+    ```astro fileName="src/pages/index.astro"
+    ---
+    import { useIntlayer } from "astro-intlayer";
+
+    const { myHtmlContent } = useIntlayer("app");
+    ---
+
+    <div set:html={myHtmlContent.value} />
+    ```
+
+    ```astro fileName="src/components/Content.astro"
+    <div id="content"></div>
+
+    <script>
+      import { useIntlayer } from "astro-intlayer";
+
+      const { myHtmlContent } = useIntlayer("app");
+
+      document.querySelector("#content")!.innerHTML = myHtmlContent.value;
+    </script>
+    ```
+
+    > O Astro escapa `{expressões}` por padrão. `set:html` é a exceção, que é o que uma string HTML precisa.
+
+    Use o método `.use()` para substituir tags ou mapear componentes personalizados. As substituições são funções que retornam uma string HTML:
+
+    ```astro
+    <div
+      set:html={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Configuração Global com `HTMLProvider`
@@ -473,6 +552,41 @@ Você pode configurar a renderização de HTML globalmente para toda a sua aplic
     > Importar dinamicamente o seu renderizador de HTML é uma boa maneira de reduzir o tamanho do bundle da sua aplicação.
 
   </Tab>
+  <Tab label="Remix" value="remix">
+
+    O Remix não possui uma árvore de componentes para manter um provider, portanto, a configuração é instalada uma vez, como um singleton, na inicialização do servidor. Ela configura o renderizador retornado por `useHTMLRenderer()`. Os nós `html` retornados por `useIntlayer` são renderizados no estado em que se encontram; substitua suas tags por nó com `.use()`.
+
+    ```typescript fileName="src/router.ts"
+    import { installIntlayerHTML } from "remix-intlayer/html";
+
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+    ```
+
+    > Use `installIntlayerHTMLDynamic(async () => …)` para carregar o renderizador de forma preguiçosa; o carregador é executado apenas na primeira chamada.
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+
+    O Astro não possui uma árvore de componentes para manter um provider, portanto, a configuração é instalada uma vez, como um singleton, no middleware (servidor) e em um `<script>` do cliente (navegador). Ela configura o renderizador retornado por `useHTMLRenderer()`. Os nós `html` retornados por `useIntlayer` são renderizados no estado em que se encontram; substitua suas tags por nó com `.use()`.
+
+    ```typescript fileName="src/middleware.ts"
+    import { installIntlayerHTML } from "astro-intlayer/html";
+    import { defineMiddleware } from "astro:middleware";
+
+    // Executa uma vez quando o servidor inicia; o próprio middleware do Intlayer é
+    // registrado pela integração, antes deste arquivo.
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+
+    export const onRequest = defineMiddleware((_context, next) => next());
+    ```
+
+    > Use `installIntlayerHTMLDynamic(async () => …)` para carregar o renderizador de forma preguiçosa; o carregador é executado apenas na primeira chamada.
+
+  </Tab>
 </Tabs>
 
 ### Renderização Manual e Ferramentas Avançadas
@@ -645,15 +759,69 @@ Se precisar renderizar strings HTML brutas ou tiver mais controlo sobre o mapeam
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    #### Hook `useHTMLRenderer()`
+
+    Obtenha uma função de renderização pré-configurada por `installIntlayerHTML()`. Ela retorna uma string HTML.
+
+    ```tsx
+    import { useHTMLRenderer } from "remix-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+
+    return <div innerHTML={renderHTML("<p>Hello <strong>World</strong></p>")} />;
+    ```
+
+    #### Utilitário `renderHTML()`
+
+    Utilitário independente que ignora a configuração global.
+
+    ```tsx
+    import { renderHTML } from "remix-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    #### Hook `useHTMLRenderer()`
+
+    Obtenha uma função de renderização pré-configurada por `installIntlayerHTML()`. Ela retorna uma string HTML.
+
+    ```astro
+    ---
+    import { useHTMLRenderer } from "astro-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+    ---
+
+    <div set:html={renderHTML("<p>Hello <strong>World</strong></p>")} />
+    ```
+
+    #### Utilitário `renderHTML()`
+
+    Utilitário independente que ignora a configuração global.
+
+    ```astro
+    ---
+    import { renderHTML } from "astro-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ---
+
+    <div set:html={html} />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Referência de Opções
 
 Essas opções podem ser passadas para `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` e `renderHTML`.
 
-| Opção        | Tipo                  | Padrão | Descrição                                                                                                                       |
-| :----------- | :-------------------- | :----- | :------------------------------------------------------------------------------------------------------------------------------ |
-| `components` | `Record<string, any>` | `{}`   | Um mapa que associa tags HTML ou nomes de componentes personalizados aos componentes.                                           |
-| `renderHTML` | `Function`            | `null` | Uma função de renderização personalizada para substituir completamente o parser HTML padrão (Apenas para providers Vue/Svelte). |
+| Opção        | Tipo                  | Padrão | Descrição                                                                                                                           |
+| :----------- | :-------------------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------- |
+| `components` | `Record<string, any>` | `{}`   | Um mapa que associa tags HTML ou nomes de componentes personalizados aos componentes.                                               |
+| `renderHTML` | `Function`            | `null` | Uma função de renderização personalizada para substituir completamente o parser HTML padrão (providers Vue, Svelte, Remix e Astro). |
 
 > Nota: Para React e Preact, as tags HTML padrão são fornecidas automaticamente. Você só precisa passar a prop `components` se quiser sobrescrevê-las ou adicionar componentes personalizados.