@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/es/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: Archivo de Contenido
 description: Aprende a personalizar las extensiones para tus archivos de declaración de contenido. Sigue esta documentación para implementar condiciones de manera eficiente en tu proyecto.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Añadir tipo de nodo de contenido `plural`"
   - version: 8.0.0
     date: 2026-01-28
     changes: "Añadir tipo de nodo de contenido `html`"
@@ -66,6 +69,7 @@ import { type ReactNode } from "react";
 import {
   t,
   enu,
+  plural,
   cond,
   nest,
   md,
@@ -85,6 +89,7 @@ interface Content {
   };
   multilingualContent: string;
   quantityContent: string;
+  pluralContent: string;
   conditionalContent: string;
   markdownContent: never;
   htmlContent: never;
@@ -120,6 +125,10 @@ export default {
       ">5": "Algunos coches",
       ">19": "Muchos coches",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "La validación está habilitada",
       false: "La validación está deshabilitada",
@@ -174,6 +183,13 @@ export default {
         ">5": "Algunos coches",
         ">19": "Muchos coches",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condición",
@@ -221,6 +237,7 @@ Los nodos de contenido son los bloques de construcción del contenido del diccio
 - **Valores primitivos**: cadenas, números, booleanos, null, undefined
 - **Nodos tipados**: Tipos especiales de contenido como traducciones, condiciones, markdown, etc.
 - **Funciones**: Contenido dinámico que puede evaluarse en tiempo de ejecución [ver Obtención de Funciones](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/function_fetching.md)
+- **Contenido Plural**: Ver Contenido Plural [Ver Contenido Plural](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/plural.md)
 - **Contenido anidado**: Referencias a otros diccionarios
 
 #### Tipos de Contenido
@@ -539,6 +556,8 @@ multilingualContent: t({
 });
 ```
 
+> Ver [Contenido de Traducción (`t`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/translation.md) para más información.
+
 ### Contenido Condicional (`cond`)
 
 Contenido que cambia basado en condiciones booleanas:
@@ -552,6 +571,8 @@ conditionalContent: cond({
 });
 ```
 
+> Ver [Contenido Condicional (`cond`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/condition.md) para más información.
+
 ### Contenido de Enumeración (`enu`)
 
 Contenido que varía según valores enumerados:
@@ -566,6 +587,23 @@ statusContent: enu({
 });
 ```
 
+> Ver [Contenido de Enumeración (`enu`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/enumeration.md) para más información.
+
+### Contenido Plural (`plural`)
+
+Contenido que varía según las reglas de plural:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> Ver [Contenido Plural Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/plural.md) para más información.
+
 ### Contenido de Inserción (`insert`)
 
 Contenido que puede ser insertado en otro contenido:
@@ -576,6 +614,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Este texto puede ser insertado en cualquier lugar");
 ```
 
+> Ver [Contenido de Inserción (`insert`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/insertion.md) para más información.
+
 ### Contenido Anidado (`nest`)
 
 Referencias a otros diccionarios:
@@ -586,6 +626,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> Ver [Contenido Anidado (`nest`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/nesting.md) para más información.
+
 ### Contenido Markdown (`md`)
 
 Contenido de texto enriquecido en formato Markdown:
@@ -598,6 +640,8 @@ markdownContent: md(
 );
 ```
 
+> Ver [Contenido Markdown (`md`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/markdown.md) para más información.
+
 ### Contenido HTML (`html`)
 
 Contenido HTML enriquecido que puede usar etiquetas estándar o componentes personalizados:
@@ -615,6 +659,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> Ver [Contenido HTML (`html`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/html.md) para más información.
+
 ### Contenido según género (`gender`)
 
 Contenido que varía según el género:
@@ -629,6 +675,8 @@ genderContent: gender({
 });
 ```
 
+> Ver [Contenido según género (`gender`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/gender.md) para más información.
+
 ### Contenido de archivo (`file`)
 
 Referencias a archivos externos:
@@ -639,6 +687,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> Ver [Contenido de archivo (`file`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/file.md) para más información.
+
 ## Creación de archivos de contenido
 
 ### Estructura básica de un archivo de contenido

package/docs/es/mcp_server.md

@@ -23,7 +23,7 @@ history:
     changes: "Añadida configuración de Claude Desktop"
   - version: 5.5.12
     date: 2025-07-10
-    changes: "Añadido transporte SSE y servidor remoto"
+    changes: "Añadido transporte Streamable HTTP y servidor remoto"
   - version: 5.5.10
     date: 2025-06-29
     changes: "Historial inicial"
@@ -51,12 +51,12 @@ Al habilitar el Servidor MCP de Intlayer en tu IDE, desbloqueas:
 
   > Consulta la lista completa de comandos y opciones en la [documentación de la CLI de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/index.md).
 
-## Servidor local (stdio) vs Servidor remoto (SSE)
+## Servidor local (stdio) vs Servidor remoto (Streamable HTTP)
 
 El servidor MCP se puede usar de dos maneras:
 
 - Servidor local (stdio)
-- Servidor remoto (SSE)
+- Servidor remoto (Streamable HTTP)
 
 ### Servidor local (stdio) (recomendado)
 
@@ -64,7 +64,7 @@ Intlayer proporciona un paquete NPM que puede instalarse localmente en tu máqui
 
 Este servidor es la forma recomendada de usar el servidor MCP, ya que integra todas las funcionalidades del servidor MCP, incluyendo las herramientas CLI.
 
-### Servidor remoto (SSE)
+### Servidor remoto (Streamable HTTP)
 
 El servidor MCP también puede usarse de forma remota, utilizando el método de transporte SSE. Este servidor está alojado por Intlayer y está disponible en https://mcp.intlayer.org. Este servidor puede ser accedido públicamente, sin ninguna autenticación, y es gratuito para usar.
 
@@ -97,7 +97,7 @@ bun x intlayer init mcp
 Este comando hará lo siguiente:
 
 1. Te preguntará qué plataforma estás usando (Cursor, VS Code, Claude Desktop, etc.).
-2. Te preguntará qué método de transporte quieres usar (Servidor local (stdio) o Servidor remoto (SSE)).
+2. Te preguntará qué método de transporte quieres usar (Servidor local (stdio) o Servidor remoto (Streamable HTTP)).
 3. Actualizará automáticamente tu archivo de configuración (por ejemplo, `.cursor/mcp.json`, `.vscode/mcp.json`, o la configuración global de Claude Desktop).
 
 ---
@@ -107,7 +107,7 @@ Este comando hará lo siguiente:
 1. Abre la paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P).
 2. Escribe `Intlayer: Setup AI Agent Skills`
 3. Elige la plataforma que usas (ej. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, etc.).
-4. Elige el MCP a instalar (stdio, SSE)
+4. Elige el MCP a instalar (stdio, Streamable HTTP)
 5. Presiona Enter.
 
 ---
@@ -131,16 +131,16 @@ En la raíz de tu proyecto, agrega el siguiente archivo de configuración `.curs
 }
 ```
 
-### Servidor remoto (SSE)
+### Servidor remoto (Streamable HTTP)
 
-Para conectarte a un servidor Intlayer MCP remoto usando Server-Sent Events (SSE), puedes configurar tu cliente MCP para conectarse al servicio alojado.
+Para conectarte a un servidor Intlayer MCP remoto usando Server-Sent Events (Streamable HTTP), puedes configurar tu cliente MCP para conectarse al servicio alojado.
 
 ```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "transport": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -172,16 +172,16 @@ Crea un archivo `.vscode/mcp.json` en la raíz de tu proyecto:
 }
 ```
 
-### Servidor remoto (SSE)
+### Servidor remoto (Streamable HTTP)
 
-Para conectarte a un servidor Intlayer MCP remoto usando Server-Sent Events (SSE), puedes configurar tu cliente MCP para conectarse al servicio alojado.
+Para conectarte a un servidor Intlayer MCP remoto usando Server-Sent Events (Streamable HTTP), puedes configurar tu cliente MCP para conectarse al servicio alojado.
 
 ```json fileName=".vscode/mcp.json"
 {
   "servers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "type": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -191,7 +191,7 @@ Para conectarte a un servidor Intlayer MCP remoto usando Server-Sent Events (SSE
 
 ## Configuración en ChatGPT
 
-### Servidor remoto (SSE)
+### Servidor remoto (Streamable HTTP)
 
 Sigue la [documentación oficial](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) para configurar el servidor MCP en ChatGPT.
 
@@ -232,6 +232,19 @@ Ruta del archivo de configuración:
 }
 ```
 
+### Servidor remoto (Streamable HTTP)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
+    }
+  }
+}
+```
+
 ---
 
 ## Uso del Servidor MCP vía CLI

package/docs/es/plugins/sync-po.md

@@ -0,0 +1,333 @@
+---
+createdAt: 2026-05-10
+updatedAt: 2026-05-10
+title: Plugin Sync PO
+description: Sincroniza diccionarios Intlayer con archivos Gettext PO. Mantén tu i18n existente mientras usas Intlayer para gestionar, traducir y probar tus mensajes.
+keywords:
+  - Intlayer
+  - Sync PO
+  - Gettext
+  - i18n
+  - traducciones
+slugs:
+  - doc
+  - plugin
+  - sync-po
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 8.9.4
+    date: 2026-05-10
+    changes: "Documentación inicial del plugin Sync PO"
+---
+
+# Sync PO (puentes i18n) - Sync PO con soporte ICU / i18next
+
+Utiliza Intlayer como un complemento para tu stack de i18n existente. Este plugin mantiene tus mensajes de Gettext PO sincronizados con los diccionarios de Intlayer para que puedas:
+
+- Mantener tu flujo de trabajo de traducción basado en PO existente.
+- Gestionar y traducir tus mensajes con Intlayer (CLI, CI, proveedores, CMS), sin refactorizar tu aplicación.
+- Publicar tutoriales y contenido SEO dirigido a cada ecosistema, sugiriendo Intlayer como la capa de gestión de PO.
+
+Notas y alcance actual:
+
+- La externalización al CMS funciona para traducciones y texto clásico.
+- Aún no hay soporte para inserciones, plurales/ICU o funciones avanzadas de tiempo de ejecución de otras librerías dentro de las propias entradas de PO.
+- El editor visual aún no es compatible con salidas de i18n de terceros.
+
+### Cuándo usar este plugin
+
+- Ya utilizas archivos Gettext PO para tus traducciones.
+- Quieres relleno asistido por IA, pruebas en CI y operaciones de contenido sin cambiar tu tiempo de ejecución de renderizado.
+
+## Instalación
+
+```bash
+pnpm add -D @intlayer/sync-po-plugin
+# o
+npm i -D @intlayer/sync-po-plugin
+```
+
+## Plugins
+
+Este paquete proporciona dos plugins:
+
+- `loadPO`: Carga archivos PO en los diccionarios de Intlayer.
+  - Este plugin se utiliza para cargar archivos PO desde una fuente y se integrarán en los diccionarios de Intlayer. Puede escanear toda la base de código y buscar archivos PO específicos.
+    Este plugin se puede utilizar:
+    - si utilizas una librería de i18n que impone una ubicación específica para cargar tus archivos PO, pero quieres colocar tu declaración de contenido donde desees en tu base de código.
+    - También se puede usar si quieres obtener tus mensajes de una fuente remota (ej: un CMS, una API, etc.) y almacenar tus mensajes en archivos PO.
+
+  > Internamente, este plugin escaneará toda la base de código, buscará archivos PO específicos y los cargará en los diccionarios de Intlayer.
+  > Ten en cuenta que este plugin no escribirá la salida ni las traducciones de vuelta en los archivos PO.
+
+- `syncPO`: Sincroniza archivos PO con los diccionarios de Intlayer.
+  - Este plugin se utiliza para sincronizar archivos PO con los diccionarios de Intlayer. Puede escanear la ubicación dada y cargar los PO que coincidan con el patrón para archivos PO específicos. Este plugin es útil si quieres obtener los beneficios de Intlayer mientras usas otra librería de i18n.
+
+## Uso de ambos plugins
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO, syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mantén tus archivos PO actuales sincronizados con los diccionarios de Intlayer
+  plugins: [
+    /**
+     * Cargará todos los archivos PO en src que coincidan con el patrón {key}.i18n.po
+     */
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Asegura que estos archivos PO tengan prioridad sobre los archivos en `./locales/en/${key}.po`
+    }),
+    /**
+     * Cargará y escribirá la salida y las traducciones de vuelta en los archivos PO en el directorio locales
+     */
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Plugin `syncPO`
+
+### Inicio rápido
+
+Añade el plugin a tu `intlayer.config.ts` y apúntalo a tu estructura de PO existente.
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mantén tus archivos PO actuales sincronizados con los diccionarios de Intlayer
+  plugins: [
+    syncPO({
+      // Diseño por idioma y por espacio de nombres
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternativa: un solo archivo por idioma:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncPO({
+      source: ({ locale }) => `./locales/${locale}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+#### Cómo funciona
+
+- Lectura: el plugin descubre archivos PO desde tu constructor `source` y los carga como diccionarios de Intlayer.
+- Escritura: después de las compilaciones y rellenos, escribe los PO localizados de vuelta en las mismas rutas (con los encabezados de Gettext adecuados).
+- Autorrelleno: el plugin declara una ruta `autoFill` para cada diccionario. Ejecutar `intlayer fill` actualiza solo las traducciones faltantes en tus archivos PO por defecto.
+
+API:
+
+```ts
+syncPO({
+  source: ({ key, locale }) => string, // requerido
+  location?: string, // etiqueta opcional, por defecto: "sync-po::path/to/source"
+  priority?: number, // prioridad opcional para resolución de conflictos, por defecto: 0
+});
+```
+
+### Múltiples fuentes de PO y prioridad
+
+Puedes añadir múltiples plugins `syncPO` para sincronizar diferentes fuentes de PO. Esto es útil cuando tienes múltiples fuentes de traducción o diferentes estructuras de PO en tu proyecto.
+
+#### Sistema de prioridad
+
+Cuando múltiples plugins se dirigen a la misma clave de diccionario, el parámetro `priority` determina qué plugin tiene precedencia:
+
+- Los números de prioridad más altos ganan sobre los más bajos.
+- La prioridad por defecto de los archivos `.content` es `0`.
+- La prioridad por defecto de los plugins es `0`.
+- Los plugins con la misma prioridad se procesan en el orden en que aparecen en la configuración.
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Fuente PO principal (prioridad más alta)
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // Fuente PO de respaldo (prioridad más baja)
+    syncPO({
+      source: ({ locale }) => `./fallback-locales/${locale}.po`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // Fuente PO heredada (prioridad más baja)
+    syncPO({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.po`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Plugin Load PO
+
+### Inicio rápido
+
+Añade el plugin a tu `intlayer.config.ts` para ingerir archivos PO existentes como diccionarios de Intlayer. Este plugin es de solo lectura (no escribe en el disco):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Ingiere mensajes de PO ubicados en cualquier lugar de tu árbol de fuentes
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      // Carga un solo idioma por instancia de plugin (por defecto el defaultLocale de la configuración)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternativa: diseño por idioma, todavía de solo lectura (solo se carga el idioma seleccionado):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    loadPO({
+      // Solo se cargarán los archivos para Locales.FRENCH desde este patrón
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      locale: Locales.FRENCH,
+    }),
+  ],
+};
+
+export default config;
+```
+
+### Cómo funciona
+
+- Descubrimiento: construye un glob desde tu constructor `source` y recopila los archivos PO coincidentes.
+- Ingestión: carga cada archivo PO como un diccionario de Intlayer con el `locale` proporcionado.
+- Solo lectura: no escribe ni formatea archivos de salida; usa `syncPO` si necesitas sincronización de ida y vuelta.
+- Listo para autorrelleno: define una ruta `fill` para que `intlayer content fill` pueda poblar las claves faltantes.
+
+### API
+
+```ts
+loadPO({
+  // Construye rutas a tus PO. `locale` es opcional si tu estructura no tiene segmento de idioma
+  source: ({ key, locale }) => string,
+
+  // Idioma de destino para los diccionarios cargados por esta instancia de plugin
+  // Por defecto configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // Etiqueta opcional para identificar la fuente
+  location?: string, // por defecto: "plugin"
+
+  // Prioridad utilizada para la resolución de conflictos contra otras fuentes
+  priority?: number, // por defecto: 0
+});
+```
+
+### Comportamiento y convenciones
+
+- Si tu máscara `source` incluye un marcador de posición de idioma, solo se ingieren los archivos para el `locale` seleccionado.
+- Si no hay un segmento `{key}` en tu máscara, la clave del diccionario es "index".
+- Las claves se derivan de las rutas de los archivos sustituyendo el marcador de posición `{key}` en tu constructor `source`.
+- El plugin solo utiliza archivos descubiertos y no fabrica idiomas o claves faltantes.
+- La ruta `fill` se infiere de tu `source` y se utiliza para actualizar los valores faltantes a través de la CLI cuando optas por ello.
+
+## Resolución de conflictos
+
+Cuando la misma clave de traducción existe en múltiples fuentes de PO:
+
+1. El plugin con la prioridad más alta determina el valor final.
+2. Las fuentes de menor prioridad se utilizan como respaldo para las claves faltantes.
+3. Esto te permite mantener las traducciones heredadas mientras migras gradualmente a nuevas estructuras.
+
+## CLI
+
+Los archivos PO sincronizados se considerarán como otros archivos `.content`. Eso significa que todos los comandos de intlayer estarán disponibles para los archivos PO sincronizados. Incluyendo:
+
+- `intlayer content test` para probar si faltan traducciones
+- `intlayer content list` para listar los archivos PO sincronizados
+- `intlayer content fill` para completar las traducciones faltantes
+- `intlayer content push` para subir los archivos PO sincronizados
+- `intlayer content pull` para bajar los archivos PO sincronizados
+
+Consulta [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) para más detalles.
+
+## Limitaciones (actuales)
+
+- No hay soporte para inserciones o plurales/ICU al dirigirse a librerías de terceros.
+- El editor visual aún no está disponible para tiempos de ejecución que no sean Intlayer.
+- Solo sincronización de PO; no se admiten formatos de catálogo que no sean PO.
+
+## Por qué esto es importante
+
+- Podemos recomendar soluciones de i18n establecidas y posicionar a Intlayer como un complemento.
+- Aprovechamos su SEO/palabras clave con tutoriales que terminan sugiriendo Intlayer para gestionar PO.
+- Amplía la audiencia a la que nos dirigimos de "nuevos proyectos" a "cualquier equipo que ya use i18n".

package/docs/fr/benchmark/index.md

@@ -30,6 +30,3 @@ Les rapports détaillés et la documentation technique pour chaque framework se
 - [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
 - [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
 - [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)
-- [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
-- [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
-- [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)

package/docs/fr/benchmark/nextjs.md

@@ -61,6 +61,13 @@ Parce que le problème est complexe, de nombreuses solutions existent — certai
 
 Intlayer tente d'optimiser l'ensemble de ces dimensions.
 
+## TL;DR
+
+- **Intlayer** & **next-translate** : Meilleurs choix pour la performance Next.js, offrant l'empreinte la plus faible et le meilleur support du rendu statique.
+- **next-intl** : L'option la plus tendance mais lourde et complexe à optimiser pour les grandes applications.
+- **next-i18next** : Populaire et riche en plugins, mais porte un poids de bundle significatif (~3× Intlayer).
+- **À éviter** : **gt-next** et **lingo.dev** en raison de graves problèmes de performance, de verrouillage propriétaire et de bugs cassant le build.
+
 ## Testez votre application
 
 Pour mettre en lumière ces problèmes, j'ai construit un scanner gratuit que vous pouvez essayer [ici](https://intlayer.org/i18n-seo-scanner).
@@ -99,14 +106,14 @@ Enfin, `Intlayer` applique une optimisation au moment du build afin que `useIntl
 Pour ce benchmark, nous avons comparé les bibliothèques suivantes :
 
 - `Base App` (Pas de bibliothèque i18n)
-- `next-intlayer` (v8.7.5)
+- `next-intlayer` (v8.7.12)
 - `next-i18next` (v16.0.5)
 - `next-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
 - `next-translate` (v3.1.2)
 - `next-international` (v1.3.1)
 - `@inlang/paraglide-js` (v2.15.1)
-- `tolgee` (v7.0.0)
+- `@tolgee/react` (v7.0.0)
 - `@lingo.dev/compiler` (v0.4.0)
 - `wuchale` (v0.22.11)
 - `gt-next` (v6.16.5)
@@ -161,10 +168,10 @@ Problèmes rencontrés :
 
 **(General Translation)** (`gt-next@6.16.5`) :
 
-- Pour une application de 110 Ko, `gt-react` ajoute plus de 440 Ko supplémentaires.
+- Pour une application de 110 Ko, `gt-next` ajoute plus de 440 Ko supplémentaires.
 - `Quota Exceeded, please upgrade your plan` dès le tout premier build avec General Translation.
 - Les traductions ne sont pas rendues ; j'obtiens l'erreur `Error: <T> used on the client-side outside of <GTProvider>`, ce qui semble être un bug de la bibliothèque.
-- Lors de l'implémentation de **gt-tanstack-start-react**, je suis également tombé sur un [problème](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) avec la bibliothèque : `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, ce qui cassait l'application. Après avoir signalé ce problème, le mainteneur l'a corrigé sous 24 heures.
+- Lors de l'implémentation de **gt-next**, je suis également tombé sur un [problème](https://github.com/generaltranslation/gt/issues/1210#event-24510646961) avec la bibliothèque : `does not provide an export named 'printAST' - @formatjs/icu-messageformat-parser`, ce qui cassait l'application. Après avoir signalé ce problème, le mainteneur l'a corrigé sous 24 heures.
 - La bibliothèque bloque le rendu statique des pages Next.js.
 
 **(Lingo.dev)** (`@lingo.dev/compiler@0.4.0`) :
@@ -186,9 +193,11 @@ L'idée derrière `Wuchale` est intéressante mais pas encore viable. J'ai renco
 Personnellement, je n'aime pas devoir régénérer des fichiers JS avant chaque push, ce qui crée un risque constant de conflit de fusion via les PRs. L'outil semble également plus axé sur Vite que sur Next.js.
 Enfin, par rapport aux autres solutions, Paraglide n'utilise pas de "store" (ex: contexte React) pour récupérer la langue actuelle afin de rendre le contenu. Pour chaque nœud analysé, il demandera la langue au localStorage / cookie etc. Cela conduit à l'exécution d'une logique inutile qui impacte la réactivité des composants.
 
+> Note sur paraglide : la solution injecte du code dans votre base de code à importer, par conséquent la métrique 'taille de la lib' dans le rapport de benchmark est presque de 0. La génération de code est une bonne chose, car la fonction utilisée n'inclura que la logique nécessaire (préfixe total vs pas de préfixe, cookie vs stockage etc). En comparaison, Intlayer procède à ce filtrage via des injections de variables d'environnement dans le build pour forcer le bundler à tree-shaker le contenu selon la logique. Grâce à cela, paraglide et intlayer finissent par être des solutions 6 à 10 fois plus légères que i18next ou next-intl.
+
 ### 3 — Solutions acceptables
 
-**(Tolgee)** (`tolgee@7.0.0`) :
+**(Tolgee)** (`@tolgee/react@7.0.0`) :
 
 `Tolgee` traite bon nombre des problèmes mentionnés plus haut. Je l'ai trouvé plus difficile à adopter que des outils similaires. Il n'offre pas de sécurité de type (type safety), ce qui rend également plus difficile la détection des clés manquantes à la compilation. J'ai dû wrapper les fonctions de Tolgee avec les miennes pour ajouter la détection des clés manquantes.
 
@@ -216,7 +225,7 @@ Les formats de messages diffèrent également : `next-intl` utilise ICU MessageF
 
 `next-translate` est ma recommandation principale si vous aimez une API de style `t()`. C'est élégant via `next-translate-plugin`, chargeant les namespaces via `getStaticProps` avec un loader Webpack / Turbopack. C'est aussi l'option la plus légère ici (env. 2,5 Ko). Pour le découpage en namespaces, la définition par page ou par route dans la config est bien pensée et plus facile à maintenir que les alternatives principales comme **next-intl** ou **next-i18next**. Dans la version `3.1.2`, j'ai noté que le rendu statique ne fonctionnait pas ; Next.js se repliait sur le rendu dynamique.
 
-**(Intlayer)** (`next-intlayer@8.7.5`) :
+**(Intlayer)** (`next-intlayer@8.7.12`) :
 
 Je ne jugerai pas personnellement `next-intlayer` par souci d'objectivité, puisqu'il s'agit de ma propre solution.