@intlayer/docs 9.5.6 → 9.5.8

package/docs/es/cli/infra.md

@@ -0,0 +1,162 @@
+---
+createdAt: 2026-09-21
+updatedAt: 2026-09-21
+title: CLI - Init Infra
+description: Aprenda a usar el comando init infra de la CLI de Intlayer para instalar la aplicación de escritorio o autoalojar el CMS de Intlayer con Docker (contenedor todo en uno o stack de Docker Compose).
+keywords:
+  - CLI
+  - Infraestructura
+  - Autoalojamiento
+  - Aplicación de escritorio
+  - Docker
+  - Docker Compose
+  - CMS
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - infra
+history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Agregar el comando init infra"
+author: aymericzip
+---
+
+# Comando Intlayer CLI Init Infra
+
+## Descripción
+
+El comando `init infra` configura la infraestructura de Intlayer en su máquina. Descarga el instalador alojado para su plataforma (`https://intlayer.org/install.sh` en macOS / Linux, `https://intlayer.org/install.ps1` en Windows) y lo ejecuta con su terminal adjunto, por lo que el menú del instalador y el progreso se muestran sin cambios.
+
+El instalador pregunta cómo desea ejecutar Intlayer:
+
+- **Aplicación de escritorio**: descarga el panel de control nativo para su sistema operativo y CPU y lo abre o instala. La compilación de escritorio se comunica con el backend de Intlayer Cloud.
+- **Docker todo en uno**: panel de control + API + MongoDB + Redis + MinIO en un solo contenedor respaldado por un volumen. Escribe `./intlayer.env` con los secretos generados y descarga la imagen `intlayer/cms-all`.
+- **Docker Compose**: un contenedor por servicio, para un autoalojamiento escalable. Escribe `docker-compose.yml` y `.env` en `./intlayer/` y descarga las imágenes.
+
+El instalador alojado es la única fuente de verdad para el flujo de instalación: la CLI lo ejecuta en lugar de reimplementar los mismos pasos, por lo que `npx intlayer init infra` y `curl -fsSL https://intlayer.org/install.sh | sh` hacen exactamente lo mismo.
+
+## 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]
+```
+
+El mismo paso se ofrece en la lista de verificación de `npx intlayer init --interactive`, en **Infraestructura (aplicación de escritorio / autoalojamiento)**.
+
+## Opciones
+
+- `-m, --mode <mode>` - Opcional. Omita el menú del instalador y ejecute un modo directamente. Valores aceptados: `desktop`, `docker` (todo en uno) o `compose`. Cualquier otro valor sale con un error listando los modos aceptados.
+
+## Ejemplos
+
+### Seleccionar el modo de forma interactiva
+
+```bash
+npx intlayer init infra
+```
+
+### Instalar la aplicación de escritorio
+
+```bash
+npx intlayer init infra --mode desktop
+```
+
+### Autoalojar con el contenedor todo en uno
+
+```bash
+npx intlayer init infra --mode docker
+```
+
+### Autoalojar con Docker Compose
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+## Salida de ejemplo
+
+```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
+```
+
+## Configuración del instalador
+
+El instalador lee algunas variables de entorno, que la CLI pasa intactas. Configúrelas en su terminal antes de ejecutar el comando:
+
+```bash
+INTLAYER_COMPOSE_DIR=./cms npx intlayer init infra --mode compose
+```
+
+| Variable                  | Predeterminado            | Aplica a | Descripción                                                            |
+| ------------------------- | ------------------------- | -------- | ---------------------------------------------------------------------- |
+| `INTLAYER_MODE`           | _(solicitado)_            | todos    | `desktop`, `docker` o `compose`, igual que `--mode`                    |
+| `INTLAYER_DOWNLOAD_DIR`   | `~/Downloads`             | desktop  | Dónde se guarda el instalador de la app                                |
+| `INTLAYER_IMAGE`          | `intlayer/cms-all:latest` | docker   | Imagen todo en uno a descargar                                         |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`          | docker   | Dónde escribir el archivo de entorno                                   |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                | docker   | Nombre del contenedor                                                  |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`           | docker   | Volumen con nombre montado en `/data`                                  |
+| `INTLAYER_APP_PORT`       | `3000`                    | docker   | Puerto del host para el panel                                          |
+| `INTLAYER_API_PORT`       | `3100`                    | docker   | Puerto del host para la API                                            |
+| `INTLAYER_S3_PORT`        | `9000`                    | docker   | Puerto del host para la API S3 MinIO                                   |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                    | docker   | Puerto del host para la consola MinIO                                  |
+| `INTLAYER_COMPOSE_DIR`    | `./intlayer`              | compose  | Dónde se escriben `docker-compose.yml` y `.env`                        |
+| `INTLAYER_SELFHOST_REF`   | `main`                    | ambos    | Referencia Git de la cual se obtienen el compose y la plantilla de env |
+
+> Las variables de puerto solo cambian el lado del **host** del mapeo. Las imágenes publicadas tienen `http://localhost:3000`, `http://localhost:3100` y `http://localhost:9000` compilados en el paquete del panel, así que mantenga los valores predeterminados a menos que compile sus propias imágenes: consulte la [guía de autoalojamiento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md#limitations).
+
+## Requisitos
+
+- **La aplicación de escritorio** necesita [Node.js](https://nodejs.org): la app incorpora el servidor del panel y lo inicia con el binario `node` de la máquina.
+- **Los modos Docker** necesitan [Docker](https://docs.docker.com/get-docker/) (Docker Desktop con backend WSL 2 en Windows). El modo Compose también necesita el plugin `docker compose`.
+
+## Notas
+
+- Reejecutar el comando es seguro: un archivo de entorno existente nunca se sobrescribe, por lo que sirve también como ruta de actualización (el instalador descarga las últimas imágenes y conserva sus secretos).
+- El instalador se descarga en un directorio temporal y se elimina al salir, cualquiera sea el resultado.
+- El código de salida del comando es el del instalador. Si la descarga falla, la CLI imprime el comando equivalente `curl … | sh` (o `irm … | iex`) para que pueda ejecutar el instalador directamente.
+- Los modos Docker aún necesitan un servicio de correo para enviar correos de inicio de sesión. Una vez finalizado el instalador, configure Resend o SMTP en el archivo de entorno generado: consulte [Servicio de correo global](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md#global-mailer).
+
+## Relacionado
+
+- [Guía de autoalojamiento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md) - Arquitectura, pasos iniciales y limitaciones de cada modo
+- [Inicializar Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/init.md) - El comando principal `init` y su lista de verificación interactiva
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) - Qué hace el panel que acaba de instalar

package/docs/es/cli/init.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2025-12-30
+updatedAt: 2026-09-21
 title: Inicializar Intlayer
 description: Aprenda cómo inicializar Intlayer en su proyecto.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - cli
   - init
 history:
+  - version: 9.5.6
+    date: 2026-09-21
+    changes: "Agregar el subcomando init infra"
   - version: 8.6.4
     date: 2026-03-31
     changes: "Agregar opción --no-gitignore"
@@ -125,6 +128,26 @@ bun x intlayer init --no-gitignore
 
 Esto establecerá todos los archivos de configuración pero no modificará su `.gitignore`.
 
+### Configurar la infraestructura (aplicación de escritorio o autoalojamiento):
+
+```bash
+npx intlayer init infra
+```
+
+Descarga y ejecuta el instalador alojado (`https://intlayer.org/install.sh`, o `install.ps1` en Windows), que pregunta cómo desea ejecutar Intlayer:
+
+- **Aplicación de escritorio** - instala el panel de control nativo en su máquina, conectado a Intlayer Cloud.
+- **Docker todo en uno** - panel de control + API + MongoDB + Redis + MinIO en un solo contenedor.
+- **Docker Compose** - un contenedor por servicio, para un autoalojamiento escalable.
+
+Omita el menú con `--mode`:
+
+```bash
+npx intlayer init infra --mode compose
+```
+
+El mismo paso se ofrece mediante `npx intlayer init --interactive`. Consulte la [referencia de `init infra`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/infra.md) para conocer la configuración del instalador, y la [guía de autoalojamiento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md) para ver lo que configura cada modo.
+
 ## Ejemplo de salida:
 
 ```bash

package/docs/es/cli/upgrade.md

@@ -0,0 +1,125 @@
+---
+createdAt: 2026-09-23
+updatedAt: 2026-09-23
+title: CLI - Actualizar paquetes de Intlayer
+description: Aprenda a usar el comando upgrade de Intlayer CLI para listar cada paquete de Intlayer de su proyecto o monorepo y actualizarlos a la última versión.
+keywords:
+  - CLI
+  - Upgrade
+  - Actualizar
+  - Paquetes
+  - Monorepo
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - upgrade
+history:
+  - version: 9.5.8
+    date: 2026-09-23
+    changes: "Agregar el comando upgrade"
+author: aymericzip
+---
+
+# Actualizar paquetes de 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
+```
+
+El comando `upgrade` lista los paquetes de Intlayer declarados en cada `package.json` de su proyecto, incluidos los workspaces de un monorepo, y los actualiza a la última versión publicada. Ejecuta el mismo paso de actualización de paquetes que `intlayer init`, de forma independiente.
+
+## Argumentos:
+
+- `--project-root [projectRoot]` - Opcional. El directorio raíz del proyecto. Por defecto, el comando comienza desde el `package.json` más cercano encima del directorio de trabajo actual.
+- `--dry-run` - Opcional. Lista los paquetes y su versión de destino sin modificar ningún archivo.
+- `--tag <tag>` - Opcional. El dist-tag de npm al que actualizar (por ejemplo `canary`). Por defecto es `latest`.
+
+## Qué hace:
+
+1. **Lista los paquetes de Intlayer** - Escanea cada `package.json` del proyecto (omitiendo `node_modules` y salidas de build) en busca de dependencias y devDependencies `intlayer`, `@intlayer/*`, `*-intlayer` e `intlayer-*`.
+2. **Obtiene la versión de destino** - Lee la versión del dist-tag seleccionado (`latest` por defecto) de cada paquete desde el registro de npm.
+3. **Reescribe los rangos** - Actualiza cada rango desactualizado directamente en el archivo, conservando su operador (`^`, `~` o ninguno) y la indentación del archivo.
+4. **Instala una sola vez** - Ejecuta una sola instalación desde la raíz del workspace (el directorio más cercano con un lock file), usando el gestor de paquetes propietario del lock file:
+
+| Lock file                      | Comando        |
+| ------------------------------ | -------------- |
+| `bun.lock` / `bun.lockb`       | `bun install`  |
+| `pnpm-lock.yaml`               | `pnpm install` |
+| `yarn.lock`                    | `yarn install` |
+| `package-lock.json` o sin lock | `npm install`  |
+
+Si no hay ningún lock file, se utiliza el campo `packageManager` de `package.json` (por ejemplo `"bun@1.2.0"`) antes de recurrir a npm.
+
+Los rangos que no apuntan al registro, como `workspace:*`, `file:`, `link:`, `catalog:` o URLs de git, nunca se modifican.
+
+## Ejemplos:
+
+### Listar las actualizaciones disponibles sin aplicarlas:
+
+```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
+```
+
+### Actualizar a la versión 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
+```
+
+## Salida de ejemplo:
+
+```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:
+
+- Ejecute el comando desde la raíz de su repositorio para actualizar todos los workspaces. Ejecútelo desde un workspace para actualizar únicamente ese workspace.
+- Los paquetes cuya versión no se puede obtener (sin conexión, paquete privado o no publicado) se listan y se dejan sin cambios.
+- Si la instalación falla, los rangos actualizados se conservan en `package.json`. Ejecute manualmente el comando de instalación de su gestor de paquetes.

package/docs/es/dictionary/html.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-01-20
-updatedAt: 2026-03-24
+updatedAt: 2026-09-21
 title: Contenido HTML
 description: Aprende a declarar y utilizar contenido HTML con componentes personalizados en Intlayer. Sigue esta documentación para incrustar contenido enriquecido tipo HTML con reemplazo dinámico de componentes en tu proyecto internacionalizado.
 keywords:
@@ -13,6 +13,8 @@ keywords:
   - React
   - Vue
   - Svelte
+  - Remix
+  - Astro
 slugs:
   - doc
   - concept
@@ -235,6 +237,83 @@ Cuando accedes al contenido a través de `useIntlayer`, los nodos HTML ya están
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    En Remix 3, los nodos HTML se resuelven en una cadena HTML. Inyéctala con la prop `innerHTML` de Remix JSX, o con `html.raw` en una vista `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>`;
+    };
+    ```
+
+    > Remix escapa los valores interpolados por defecto. `innerHTML` y `html.raw` son las dos opciones de exclusión, que es lo que necesita una cadena HTML.
+
+    Usa el método `.use()` para anular etiquetas o mapear componentes personalizados. Las anulaciones son funciones que devuelven una cadena 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">
+    En Astro, los nodos HTML se resuelven en una cadena HTML. Inyéctala con la directiva `set:html` en la plantilla, o con `innerHTML` en un `<script>` del 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>
+    ```
+
+    > Astro escapa las `{expresiones}` por defecto. `set:html` es la opción de exclusión, que es lo que necesita una cadena HTML.
+
+    Usa el método `.use()` para anular etiquetas o mapear componentes personalizados. Las anulaciones son funciones que devuelven una cadena HTML:
+
+    ```astro
+    <div
+      set:html={myHtmlContent.use({
+        p: ({ children }) => `<p class="prose">${children}</p>`,
+        CustomLink: ({ children }) => `<a href="/details">${children}</a>`,
+      })}
+    />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Configuración Global con `HTMLProvider`
@@ -470,6 +549,41 @@ Puedes configurar el renderizado de HTML de forma global para toda tu aplicació
     > Importar dinámicamente su renderizador de HTML es una buena manera de reducir el tamaño del bundle de su aplicación.
 
   </Tab>
+  <Tab label="Remix" value="remix">
+
+    Remix no tiene un árbol de componentes para contener un proveedor, por lo que la configuración se instala una vez, como un singleton, al inicio del servidor. Configura el renderizador devuelto por `useHTMLRenderer()`. Los nodos `html` devueltos por `useIntlayer` se renderizan tal cual; anula sus etiquetas por nodo con `.use()`.
+
+    ```typescript fileName="src/router.ts"
+    import { installIntlayerHTML } from "remix-intlayer/html";
+
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+    ```
+
+    > Usa `installIntlayerHTMLDynamic(async () => …)` para cargar el renderizador de forma perezosa; el cargador solo se ejecuta en la primera llamada.
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+
+    Astro no tiene un árbol de componentes para contener un proveedor, por lo que la configuración se instala una vez, como un singleton, en el middleware (servidor) y en un `<script>` del cliente (navegador). Configura el renderizador devuelto por `useHTMLRenderer()`. Los nodos `html` devueltos por `useIntlayer` se renderizan tal cual; anula sus etiquetas por nodo con `.use()`.
+
+    ```typescript fileName="src/middleware.ts"
+    import { installIntlayerHTML } from "astro-intlayer/html";
+    import { defineMiddleware } from "astro:middleware";
+
+    // Se ejecuta una vez cuando el servidor se inicia; el middleware de Intlayer es
+    // registrado por la integración, antes de este archivo.
+    installIntlayerHTML({
+      renderHTML: (html) => html.replaceAll("<p>", '<p class="prose">'),
+    });
+
+    export const onRequest = defineMiddleware((_context, next) => next());
+    ```
+
+    > Usa `installIntlayerHTMLDynamic(async () => …)` para cargar el renderizador de forma perezosa; el cargador solo se ejecuta en la primera llamada.
+
+  </Tab>
 </Tabs>
 
 ### Renderizado Manual y Herramientas Avanzadas
@@ -642,15 +756,69 @@ Si necesitas renderizar cadenas de HTML sin procesar o tener más control sobre
     ```
 
   </Tab>
+  <Tab label="Remix" value="remix">
+    #### Hook `useHTMLRenderer()`
+
+    Obtén una función de renderizado preconfigurada por `installIntlayerHTML()`. Devuelve una cadena HTML.
+
+    ```tsx
+    import { useHTMLRenderer } from "remix-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+
+    return <div innerHTML={renderHTML("<p>Hello <strong>World</strong></p>")} />;
+    ```
+
+    #### Utilidad `renderHTML()`
+
+    Utilidad independiente que ignora la configuración global.
+
+    ```tsx
+    import { renderHTML } from "remix-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ```
+
+  </Tab>
+  <Tab label="Astro" value="astro">
+    #### Hook `useHTMLRenderer()`
+
+    Obtén una función de renderizado preconfigurada por `installIntlayerHTML()`. Devuelve una cadena HTML.
+
+    ```astro
+    ---
+    import { useHTMLRenderer } from "astro-intlayer/html";
+
+    const renderHTML = useHTMLRenderer();
+    ---
+
+    <div set:html={renderHTML("<p>Hello <strong>World</strong></p>")} />
+    ```
+
+    #### Utilidad `renderHTML()`
+
+    Utilidad independiente que ignora la configuración global.
+
+    ```astro
+    ---
+    import { renderHTML } from "astro-intlayer/html";
+
+    const html = renderHTML("<p>Hello</p>");
+    ---
+
+    <div set:html={html} />
+    ```
+
+  </Tab>
 </Tabs>
 
 ## Referencia de Opciones
 
 Estas opciones se pueden pasar a `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` y `renderHTML`.
 
-| Opción       | Tipo                  | Por Defecto | Descripción                                                                                                                                 |
-| :----------- | :-------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------ |
-| `components` | `Record<string, any>` | `{}`        | Un mapa de etiquetas HTML o nombres de componentes personalizados a componentes.                                                            |
-| `renderHTML` | `Function`            | `null`      | Una función de renderizado personalizada para reemplazar completamente el parser HTML predeterminado (Solo para proveedores de Vue/Svelte). |
+| Opción       | Tipo                  | Por Defecto | Descripción                                                                                                                                       |
+| :----------- | :-------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `components` | `Record<string, any>` | `{}`        | Un mapa de etiquetas HTML o nombres de componentes personalizados a componentes.                                                                  |
+| `renderHTML` | `Function`            | `null`      | Una función de renderizado personalizada para reemplazar completamente el parser HTML predeterminado (proveedores de Vue, Svelte, Remix y Astro). |
 
 > Nota: Para React y Preact, las etiquetas HTML estándar se proporcionan automáticamente. Solo necesitas pasar la prop `components` si deseas sobrescribirlas o agregar componentes personalizados.