@intlayer/docs 8.11.2 → 8.11.3

package/docs/es/lsp.md

@@ -0,0 +1,351 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2026-05-31
+title: Servidor LSP de Intlayer
+description: Aprenda cómo el servidor de lenguaje de Intlayer proporciona la función Ir a la definición y otras características de IDE para useIntlayer, getIntlayer y llamadas relacionadas en todos los editores compatibles.
+keywords:
+  - LSP
+  - Servidor de Lenguaje
+  - Ir a la definición
+  - IDE
+  - Intlayer
+  - VS Code
+  - Neovim
+  - TypeScript
+slugs:
+  - doc
+  - lsp
+history:
+  - version: 8.12.0
+    date: 2026-06-01
+    changes: "Release LSP"
+---
+
+# Servidor LSP de Intlayer
+
+El **Servidor de Lenguaje de Intlayer (LSP)** es una implementación del [Protocolo de Servidor de Lenguaje (LSP)](https://microsoft.github.io/language-server-protocol/) que mejora su IDE con inteligencia adaptada a Intlayer. Actualmente proporciona **Ir a la definición (Go to Definition)** para llamadas a claves de diccionario, lo que le permite saltar directamente desde `useIntlayer("my-key")` en su componente al archivo `.content.ts` que lo declara.
+
+---
+
+## ¿Por qué usar el LSP?
+
+Cuando utiliza Intlayer, la conexión entre una llamada como `useIntlayer("homepage")` y su declaración en `src/homepage.content.ts` es implícita. Sin herramientas, debe buscar el archivo manualmente. El LSP hace que ese enlace sea explícito:
+
+**Sensibilización de agentes de IA**
+
+Los agentes de codificación de IA (Cursor, Windsurf, GitHub Copilot, Claude Code, Codex) dependen del servidor de lenguaje para resolver símbolos y comprender las relaciones entre archivos. Con el LSP de Intlayer en funcionamiento, los agentes pueden seguir `useIntlayer("key")` hasta su declaración, lo que les brinda un contexto preciso sobre las claves de contenido disponibles, la estructura de cada diccionario y qué archivos leer o editar.
+
+**Ir a la definición**
+
+Coloque el cursor sobre cualquier cadena de clave de diccionario dentro de una llamada de obtención admitida y presione `F12` (o `Cmd/Ctrl+Clic`). El editor abre el archivo de declaración de contenido y posiciona el cursor en la línea `key:`.
+
+**Soporte de diccionarios fusionados**
+
+Una clave se puede dividir en varios archivos de contenido (Intlayer los fusiona). El servidor devuelve una ubicación (`Location`) por archivo de origen para que pueda navegar a cada declaración.
+
+**Funciona en todas partes**
+
+Es compatible con todos los paquetes `*-intlayer` (`next-intlayer`, `react-intlayer`, `vue-intlayer`, `svelte-intlayer`, `solid-intlayer`, `preact-intlayer`, `angular-intlayer`, `lit-intlayer`, `express-intlayer`, `hono-intlayer`, `fastify-intlayer`, `adonis-intlayer`, `intlayer`).
+
+### Llamadas de obtención admitidas
+
+El servidor detecta las siguientes llamadas a funciones y extrae el primer argumento de cadena literal como la clave del diccionario:
+
+| Función       | Ejemplo                       |
+| ------------- | ----------------------------- |
+| `useIntlayer` | `useIntlayer("hero")`         |
+| `getIntlayer` | `getIntlayer("hero", locale)` |
+
+Se ignoran los genéricos de TypeScript y los argumentos adicionales; solo importa la cadena de la clave.
+
+> `useDictionary` y `getDictionary` reciben un objeto `Dictionary` ya importado como su primer argumento en lugar de una clave de cadena, por lo que no se benefician de Ir a la definición y no son rastreados por el servidor.
+
+---
+
+## Instalación
+
+El servidor LSP se distribuye como parte de `@intlayer/lsp`:
+
+```bash packageManager="npm"
+npm install --save-dev @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn add --dev @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev @intlayer/lsp
+```
+
+```bash packageManager="bun"
+bun add --dev @intlayer/lsp
+```
+
+El paquete expone el binario `intlayer-lsp`, que los editores utilizan como ejecutable del servidor.
+
+---
+
+## Configuración como un plugin de Claude Code
+
+El LSP de Intlayer está disponible como un **plugin de Claude Code** alojado directamente en el repositorio de GitHub de Intlayer. Instalarlo le da a Claude Code una sensibilidad nativa de Ir a la definición para todas sus llamadas a `useIntlayer` / `getIntlayer`.
+
+### 1. Instalar el binario del servidor de lenguaje
+
+```bash packageManager="npm"
+npm install -g @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn global add @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add -g @intlayer/lsp
+```
+
+Esto coloca el binario `intlayer-lsp` en su PATH, que es lo que invoca la entrada `lspServers` del plugin.
+
+### 2. Registrar el marketplace de Intlayer e instalar el plugin
+
+```bash
+claude plugin marketplace add intlayer@github:aymericzip/intlayer
+claude plugin install intlayer-lsp@intlayer
+claude plugin enable intlayer-lsp@intlayer
+```
+
+Claude Code agregará `"intlayer-lsp@intlayer": true` a sus `enabledPlugins` y encenderá automáticamente el servidor de lenguaje en los tipos de archivos compatibles (`.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`).
+
+### 3. Habilitar la herramienta LSP (si aún no está activa)
+
+Algunas versiones de Claude Code requieren que se establezca la bandera de función LSP. Agregue lo siguiente a su archivo `~/.claude/settings.json` si Ir a la definición no funciona después de la instalación:
+
+```json fileName="~/.claude/settings.json"
+{
+  "env": {
+    "ENABLE_LSP_TOOL": "1"
+  }
+}
+```
+
+Reinicie Claude Code; ahora usará `goToDefinition`, `findReferences` y otras operaciones de LSP al navegar por su código de Intlayer en lugar de recurrir a `grep`.
+
+---
+
+## Configuración en VS Code (a través de la extensión — recomendado)
+
+Si tiene instalada la **extensión Intlayer de VS Code**, el servidor de lenguaje se inicia automáticamente. No se requiere configuración adicional.
+
+> Consulte la [documentación de la extensión de VS Code](https://intlayer.org/doc/vs-code-extension) para conocer la instalación y otras características.
+
+---
+
+## Configuración manual en VS Code
+
+Si no está utilizando la extensión de Intlayer, puede conectar el servidor de lenguaje manualmente utilizando una extensión de cliente LSP genérica como [**vscode-glspc**](https://marketplace.visualstudio.com/items?itemName=sibiraj-s.vscode-scss-formatter) o escribiendo su propia extensión pequeña. El enfoque recomendado es utilizar la extensión de Intlayer.
+
+Como referencia, el servidor se inicia a través del binario `intlayer-lsp` sobre stdio:
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+La extensión de Intlayer lee estas configuraciones para iniciar el servidor. Si depende únicamente de la extensión, no se necesitan configuraciones manuales.
+
+---
+
+## Configuración en Cursor
+
+[Cursor](https://www.cursor.com/) es una bifurcación de VS Code con características de IA integradas. Utiliza el mismo ecosistema de extensiones, por lo que la **extensión Intlayer de VS Code** funciona sin ninguna configuración adicional; instálela una vez y Cursor la detectará automáticamente.
+
+Si prefiere una configuración manual, Cursor también lee `.vscode/settings.json` desde la raíz del espacio de trabajo, por lo que el fragmento de VS Code anterior se aplica directamente.
+
+---
+
+## Configuración en Windsurf
+
+[Windsurf](https://windsurf.com/) (de Codeium) es otro editor basado en VS Code. Instale la extensión de Intlayer desde el mercado de VS Code y el servidor de lenguaje se activará automáticamente, exactamente como lo hace en VS Code y Cursor.
+
+Para la configuración manual, cree `.vscode/settings.json` en la raíz del proyecto:
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+---
+
+## Configuración en Zed
+
+[Zed](https://zed.dev/) tiene soporte LSP nativo a través de sus configuraciones de idioma. Agregue una entrada en su configuración de usuario de Zed (`~/.config/zed/settings.json`):
+
+```json fileName="~/.config/zed/settings.json"
+{
+  "lsp": {
+    "intlayer-lsp": {
+      "binary": {
+        "path": "npx",
+        "arguments": ["--yes", "@intlayer/lsp"]
+      }
+    }
+  },
+  "languages": {
+    "TypeScript": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "TSX": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "JavaScript": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "Vue.js": {
+      "language_servers": ["intlayer-lsp", "..."]
+    },
+    "Svelte": {
+      "language_servers": ["intlayer-lsp", "..."]
+    }
+  }
+}
+```
+
+El marcador de posición `"..."` le dice a Zed que mantenga sus servidores de lenguaje predeterminados junto con el de Intlayer.
+
+---
+
+## Configuración para CLIs de agentes de IA (Claude Code, Codex, etc.)
+
+**Claude Code** tiene soporte de primer nivel para plugins de LSP; siga la [configuración del plugin de Claude Code](#configuración-como-un-plugin-de-claude-code) anterior para obtener la experiencia completa de Ir a la definición directamente en sus sesiones de terminal.
+
+**OpenAI Codex** y otras herramientas basadas en terminal aún no actúan como clientes LSP; leen y escriben archivos directamente en lugar de mantener una sesión de servidor de lenguaje persistente. Para esas herramientas, el valor de tener el LSP ejecutándose surge de manera indirecta: cuando el servidor está activo en un editor complementario (VS Code, Cursor, Windsurf, ...), el índice en vivo del editor está disponible para cualquier agente de IA que pueda consultarlo a través del contexto proporcionado por el editor (por ejemplo, Cursor Composer, Windsurf Cascade, GitHub Copilot Chat).
+
+Si está trabajando puramente en una terminal sin un editor abierto, puede iniciar el servidor de lenguaje en segundo plano para que esté listo para cualquier editor que se conecte más tarde al mismo espacio de trabajo:
+
+```bash
+# Mantener el servidor activo en segundo plano
+npx @intlayer/lsp &
+```
+
+---
+
+## Configuración manual en Neovim
+
+Usando [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig), registre una configuración de servidor personalizada:
+
+```lua fileName="~/.config/nvim/init.lua"
+local lspconfig = require('lspconfig')
+local configs = require('lspconfig.configs')
+
+if not configs.intlayer_lsp then
+  configs.intlayer_lsp = {
+    default_config = {
+      -- Inicie el servidor con npx para que no necesite una instalación global
+      cmd = { 'npx', '--yes', '@intlayer/lsp' },
+      filetypes = {
+        'typescript',
+        'typescriptreact',
+        'javascript',
+        'javascriptreact',
+        'vue',
+        'svelte',
+      },
+      root_dir = lspconfig.util.root_pattern(
+        'intlayer.config.ts',
+        'intlayer.config.js',
+        'package.json'
+      ),
+    },
+  }
+end
+
+lspconfig.intlayer_lsp.setup({})
+```
+
+Después de reiniciar Neovim, presionar `gd` sobre una clave de Intlayer invocará Ir a la definición.
+
+---
+
+## Configuración manual en otros editores
+
+Cualquier editor que admita el Protocolo de Servidor de Lenguaje puede usar `@intlayer/lsp`. El servidor:
+
+- **Transporte** – Node.js IPC / stdio (estándar)
+- **Ejecutable** – `npx @intlayer/lsp` (o el binario `intlayer-lsp` instalado localement)
+- **Capacidades** – `definitionProvider: true`, `textDocumentSync: Incremental`
+
+Consulte la documentación de LSP de su editor para conocer el formato de configuración exacto (por ejemplo, `languageserver.json` para [coc.nvim](https://github.com/neoclide/coc.nvim), o la configuración del cliente LSP en [Helix](https://helix-editor.com)).
+
+### Ejemplo: coc.nvim
+
+```json fileName="~/.config/nvim/coc-settings.json"
+{
+  "languageserver": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["@intlayer/lsp"],
+      "filetypes": [
+        "typescript",
+        "typescriptreact",
+        "javascript",
+        "javascriptreact",
+        "vue",
+        "svelte"
+      ],
+      "rootPatterns": [
+        "intlayer.config.ts",
+        "intlayer.config.js",
+        "package.json"
+      ]
+    }
+  }
+}
+```
+
+### Ejemplo: Helix
+
+```toml fileName="~/.config/helix/languages.toml"
+[[language]]
+name = "typescript"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[[language]]
+name = "tsx"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[language-server.intlayer-lsp]
+command = "npx"
+args = ["@intlayer/lsp"]
+```
+
+---
+
+## Cómo funciona
+
+Cuando se inicia el servidor, este resuelve la configuración de Intlayer desde la raíz del espacio de trabajo utilizando `getConfiguration()`. Esto le proporciona las rutas `build` y `system` necesarias para encontrar los diccionarios compilados.
+
+En cada solicitud de **Ir a la definición**:
+
+1. El servidor lee el texto completo del documento abierto.
+2. Escanea llamadas de obtención (`useIntlayer`, `getIntlayer`, etc.) utilizando una expresión regular.
+3. Comprueba si la posición del cursor cae dentro de una de esas llamadas.
+4. Si es así, extrae la clave del diccionario (grupo de captura 3 de la expresión regular) y llama a `getUnmergedDictionaries()` para ubicar cada archivo de contenido que declara esa clave.
+5. Lee cada archivo correspondiente y busca la línea exacta que contiene `key: "<key>"` para posicionar el cursor con precisión.
+6. Devuelve una matriz de objetos `Location` — uno por archivo de origen.
+
+La configuración se resuelve de manera diferida y se almacena en caché por sesión; se restablece en cada solicitud de `initialize` (por ejemplo, cuando abre una nueva carpeta de espacio de trabajo).
+
+---
+
+## Resolución de problemas
+
+| Síntoma                                      | Causa probable                           | Solución                                                                                                   |
+| -------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| Ir a la definición no hace nada              | El servidor no se está ejecutando        | Compruebe que `@intlayer/lsp` esté instalado y que el editor lo esté iniciando                             |
+| Raíz de espacio de trabajo incorrecta        | Múltiples carpetas de espacio de trabajo | Asegúrese de que la carpeta que contiene `intlayer.config.ts` sea la primera carpeta de espacio de trabajo |
+| No se encuentran definiciones para una clave | Configuración no resuelta                | Verifique que `intlayer.config.ts` (o `.js`) exista en la raíz del espacio de trabajo                      |
+| El servidor se bloquea al iniciar            | Versión de Node.js demasiado antigua     | Requiere Node.js ≥ 14.18                                                                                   |

package/docs/es/mcp_server.md

@@ -247,6 +247,28 @@ Ruta del archivo de configuración:
 
 ---
 
+## Configuración en Claude Code (CLI)
+
+Sigue la [documentación oficial](https://modelcontextprotocol.io/quickstart/user) para configurar el servidor MCP en Claude Code.
+
+### Servidor local (stdio) (recomendado)
+
+Para conectar el servidor MCP de Intlayer a Claude Code usando stdio:
+
+```bash
+claude mcp add intlayer npx -y @intlayer/mcp
+```
+
+### Servidor remoto (Streamable HTTP)
+
+Para conectar el servidor MCP de Intlayer a Claude Code usando Streamable HTTP (SSE):
+
+```bash
+claude mcp add intlayer https://mcp.intlayer.org -t http
+```
+
+---
+
 ## Uso del Servidor MCP vía CLI
 
 También puedes ejecutar el servidor MCP de Intlayer directamente desde la línea de comandos para pruebas, depuración o integración con otras herramientas.

package/docs/es/packages/express-intlayer/t.md

@@ -91,7 +91,7 @@ app.get("/", (_req, res) => {
 
 - **Detección de idioma**: El middleware `intlayer` procesa las solicitudes entrantes para detectar el idioma preferido del usuario basándose en encabezados, cookies u otros métodos configurados.
 - **Contexto de traducción**: Configura el contexto necesario para que la función `t` opere correctamente, asegurando que las traducciones se devuelvan en el idioma correcto.
-- **Prevención de errores**: Sin este middleware, el uso de la función `t` resultará en errores en tiempo de ejecución porque no estará disponible la información necesaria del idioma.
+- **Prevención de errores**: Sin este middleware, el uso de la función `t` resultará en errores en runtime porque no estará disponible la información necesaria del idioma.
 
 ---
 

package/docs/es/packages/next-intlayer/useDictionary.md

@@ -69,7 +69,7 @@ El hook acepta dos parámetros:
 
 ## Diccionario
 
-Todos los objetos diccionario deben declararse en archivos de contenido estructurado para garantizar la seguridad de tipos y prevenir errores en tiempo de ejecución. Puedes encontrar las [instrucciones de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md). Aquí tienes un ejemplo de declaración de contenido:
+Todos los objetos diccionario deben declararse en archivos de contenido estructurado para garantizar la seguridad de tipos y prevenir errores en runtime. Puedes encontrar las [instrucciones de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md). Aquí tienes un ejemplo de declaración de contenido:
 
 ```typescript fileName="component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
 import { t, type Dictionary } from "intlayer";

package/docs/es/packages/next-intlayer/useIntlayer.md

@@ -70,7 +70,7 @@ Dependiendo de si estás trabajando en componentes del lado del cliente o del la
 
 ## Archivos de Diccionario
 
-Es crucial que todas las claves de contenido estén definidas dentro de archivos de declaración de contenido para evitar errores en tiempo de ejecución y garantizar la seguridad de tipos. Este enfoque también facilita la integración con TypeScript para la validación en tiempo de compilación.
+Es crucial que todas las claves de contenido estén definidas dentro de archivos de declaración de contenido para evitar errores en runtime y garantizar la seguridad de tipos. Este enfoque también facilita la integración con TypeScript para la validación en tiempo de compilación (build time).
 
 Las instrucciones para configurar archivos de declaración de contenido están disponibles [aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md).
 

package/docs/es/packages/react-intlayer/useDictionary.md

@@ -68,7 +68,7 @@ El hook acepta dos parámetros:
 
 ## Diccionario
 
-Todos los objetos diccionario deben ser declarados en archivos de contenido estructurado para garantizar la seguridad de tipos y prevenir errores en tiempo de ejecución. Puedes encontrar las [instrucciones de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md). Aquí tienes un ejemplo de declaración de contenido:
+Todos los objetos diccionario deben ser declarados en archivos de contenido estructurado para garantizar la seguridad de tipos y prevenir errores en runtime. Puedes encontrar las [instrucciones de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md). Aquí tienes un ejemplo de declaración de contenido:
 
 ```typescript fileName="./component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
 import { t, type Dictionary } from "intlayer";

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

@@ -45,7 +45,7 @@ Usa Intlayer como un complemento para tu stack i18n existente. Este plugin manti
 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 en tiempo de ejecución de otras bibliotecas.
+- Aún no hay soporte para inserciones, plurales/ICU, o funciones avanzadas en runtime de otras bibliotecas.
 - El editor visual aún no es compatible con salidas i18n de terceros.
 
 ### Cuándo usar este plugin

package/docs/es/readme.md

@@ -60,7 +60,7 @@ Con **archivos de contenido por localidad**, **autocompletado de TypeScript**, *
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Feature" width="700">                         | **Enrutamiento mejorado**<br><br>Soporte completo de enrutamiento de aplicaciones, adaptándose perfectamente a estructuras complejas de aplicaciones para Next.js, React, Vite, Vue.js, etc.<br><br> - [Explorar la integración con Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                  |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Soporte para Markdown**<br><br>Importe e interprete archivos locales y Markdown remoto para contenido multilingüe como las políticas de privacidad, documentación, etc. Interprete y haga accesibles los metadatos de Markdown en su código.<br><br> - [Archivos de contenido](https://intlayer.org/doc/concept/content/file)                                                                                                                                            |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **Editor visual y CMS gratuitos**<br><br>Un editor visual y un CMS gratuitos están disponibles para los redactores de contenido, eliminando la necesidad de una plataforma de localización. Mantenga su contenido sincronizado usando Git, o externalícelo total o parcialmente con el CMS.<br><br> - [Editor Intlayer](https://intlayer.org/doc/concept/editor) <br> - [CMS Intlayer](https://intlayer.org/doc/concept/cms)                                               |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **Contenido tree-shakable**<br><br>Contenido tree-shakable, que reduce el tamaño del paquete final. Carga el contenido por componente, excluyendo cualquier contenido no utilizado de su paquete. Admite la carga diferida (lazy loading) para mejorar la eficiencia de carga de la aplicación. <br><br> - [Optimización de la compilación de la aplicación](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **Contenido tree-shakable**<br><br>Contenido tree-shakable, que reduce el tamaño del bundle final. Carga el contenido por componente, excluyendo cualquier contenido no utilizado de su paquete. Admite la carga diferida (lazy loading) para mejorar la eficiencia de carga de la aplicación. <br><br> - [Optimización de la compilación de la aplicación](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                    |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **Renderizado estático**<br><br>No bloquea el renderizado estático. <br><br> - [Integración con Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                      |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **Traducción impulsada por IA**<br><br>Transforme su sitio web a 231 idiomas con un solo clic utilizando las avanzadas herramientas de traducción impulsadas por IA de Intlayer con su propio proveedor de IA / clave API. <br><br> - [Integración CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [CLI de Intlayer](https://intlayer.org/doc/concept/cli) <br> - [Llenado automático](https://intlayer.org/doc/concept/auto-fill)                                   |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **Integración del servidor MCP**<br><br>Proporciona un servidor MCP (Protocolo de Contexto de Modelo) para la automatización del IDE, permitiendo una gestión de contenido fluida y flujos de trabajo de i18n directamente dentro de su entorno de desarrollo. <br><br> - [Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)                                                                                                      |

package/docs/es/releases/v6.md

@@ -224,9 +224,9 @@ Salida:
 
 ## Mejoras en el registro de eventos (Logging)
 
-El sistema de registro se ha mejorado para proporcionar información más detallada sobre lo que sucede durante las transformaciones en tiempo de compilación y ejecución.
+El sistema de registro se ha mejorado para proporcionar información más detallada sobre lo que sucede durante las transformaciones en tiempo de compilación (build time) y ejecución.
 
-> Habilite los registros detallados para comprender mejor lo que sucede durante las transformaciones en tiempo de compilación y ejecución.
+> Habilite los registros detallados para comprender mejor lo que sucede durante las transformaciones en tiempo de compilación (build time) y ejecución.
 
 ```ts fileName="intlayer.config.ts"
 export default {

package/docs/es/releases/v7.md

@@ -32,7 +32,7 @@ slugs:
 - Nuevos modos de enrutamiento: `prefix-no-default`, `prefix-all`, `no-prefix`, `search-params`
 - Almacenamiento de localización conforme al GDPR con localStorage por defecto
 - Configuración flexible de almacenamiento: cookies, localStorage, sessionStorage o múltiples
-- Tamaño del paquete del Editor Visual un 30% más pequeño
+- Tamaño del bundlee del Editor Visual un 30% más pequeño
 - Opciones mejoradas de configuración del middleware
 - Comportamiento actualizado del comando fill para una mejor gestión de contenido
 - Mayor estabilidad con actualizaciones completas del archivo de declaración de contenido
@@ -255,7 +255,7 @@ El paquete del Editor Visual ha sido optimizado para ser un 30% más pequeño qu
 - Eliminación de dependencias innecesarias en los paquetes principales de Intlayer
 - Mejor tree-shaking y empaquetado de módulos
 
-Esto se traduce en tiempos de descarga más rápidos y un mejor rendimiento en tiempo de ejecución para tu aplicación.
+Esto se traduce en tiempos de descarga más rápidos y un mejor rendimiento en runtime para tu aplicación.
 
 ---
 

package/docs/es/releases/v8.md

@@ -1063,8 +1063,8 @@ La propiedad booleana `live` ha sido marcada como obsoleta en favor de una propi
 ### Modos
 
 - **`static`** (Por defecto): El diccionario se incluye en el bundle en el momento de la construcción. Es el mejor para el rendimiento.
-- **`dynamic`**: El diccionario se carga en tiempo de ejecución (por ejemplo, mediante fetch JSON o suspense).
-- **`fetch`**: El diccionario se obtiene del CMS/Servidor en tiempo de ejecución y se sincroniza.
+- **`dynamic`**: El diccionario se carga en runtime (por ejemplo, mediante fetch JSON o suspense).
+- **`fetch`**: El diccionario se obtiene del CMS/Servidor en runtime y se sincroniza.
 
 **Migración:**
 

package/docs/es/roadmap.md

@@ -108,7 +108,7 @@ Intlayer proporciona varios métodos para insertar y gestionar contenido dinámi
 
    Intlayer permite declarar contenido como funciones, habilitando la obtención de contenido tanto síncrona como asíncrona.
 
-   Funciones Síncronas: El contenido se genera dinámicamente en tiempo de compilación.
+   Funciones Síncronas: El contenido se genera dinámicamente en tiempo de compilación (build time).
 
    Funciones Asíncronas: Obtienen datos de fuentes externas (por ejemplo, APIs, bases de datos) de forma dinámica.
 

package/docs/es/testing.md

@@ -29,7 +29,7 @@ Esta guía muestra cómo verificar automáticamente que tus diccionarios estén
 
 - **Traducciones faltantes**: falla en CI si faltan locales requeridos en cualquier diccionario.
 - **Renderizado de UI localizada**: renderiza componentes con un proveedor de locales específico y verifica el texto/atributos visibles.
-- **Auditorías en tiempo de compilación**: ejecuta una auditoría rápida localmente vía CLI.
+- **Auditorías en tiempo de compilación (build time)**: ejecuta una auditoría rápida localmente vía CLI.
 
 ---
 

package/docs/fr/benchmark/tanstack.md

@@ -2,7 +2,7 @@
 createdAt: 2026-04-20
 updatedAt: 2026-05-18
 title: La meilleure solution i18n pour TanStack Start en 2026 - Rapport de Benchmark
-description: Comparez les bibliothèques d'internationalisation pour TanStack Start comme react-i18next, use-intl et Intlayer. Rapport de performance détaillé sur la taille du bundle, les fuites et la réactivité.
+description: Comparez les bibliothèques d'internationalisation pour TanStack Start comme react-i18next, next-intl et Intlayer. Rapport de performance détaillé sur la taille du bundle, les fuites et la réactivité.
 keywords:
   - benchmark
   - i18n
@@ -63,7 +63,7 @@ L'autre impact concerne l'expérience développeur (DX) : la façon dont vous d
 ## TL;DR
 
 - **Intlayer** : Fournit la meilleure performance et la plus petite taille de bundle (v8.7.12) pour TanStack Start.
-- **react-i18next** & **use-intl** : Alternatives matures avec de grands écosystèmes, mais nettement plus lourdes et complexes à optimiser.
+- **react-i18next** & **next-intl** : Alternatives matures avec de grands écosystèmes, mais nettement plus lourdes et complexes à optimiser.
 - **Paraglide** : Idée innovante de tree-shaking qui ne fonctionne pas en pratique. DX complexe et surcoût de réactivité dans TanStack Start.
 - **À éviter** : **General Translation (GT)** et **Lingo.dev** en raison de graves problèmes de performance, des limites de quota AI et du verrouillage propriétaire (vendor lock-in).
 
@@ -99,7 +99,7 @@ Pour ce benchmark, nous avons comparé les bibliothèques suivantes :
 - `Base App` (Pas de bibliothèque i18n)
 - `react-intlayer` (v8.7.12)
 - `react-i18next` (v17.0.2)
-- `use-intl` (v4.9.1)
+- `next-intl` (v4.9.1)
 - `@lingui/core` (v5.3.0)
 - `@inlang/paraglide-js` (v2.15.1)
 - `@tolgee/react` (v7.0.0)
@@ -174,9 +174,9 @@ L'idée derrière `Wuchale` est intéressante mais ce n'est pas encore une solut
 
 Sur TanStack Start, j'ai également eu des problèmes de réactivité : au changement de locale, je devais forcer le provider à se re-rendre et souscrire aux événements de changement de locale pour que le chargement dans une autre langue se comporte correctement.
 
-**(use-intl)** (`use-intl@4.9.1`) :
+**(next-intl)** (`next-intl@4.9.1`) :
 
-`use-intl` est la pièce "intl" la plus à la mode dans l'écosystème React (même famille que `next-intl`) et est souvent poussée par les agents IA, mais à mon avis à tort dans un contexte privilégiant la performance. La mise en route est assez simple. En pratique, le processus pour optimiser et limiter les fuites est assez complexe. De même, combiner chargement dynamique + namespacing + types TypeScript ralentit beaucoup le développement.
+`next-intl` est la pièce "intl" la plus à la mode dans l'écosystème React (même famille que `next-intl`) et est souvent poussée par les agents IA, mais à mon avis à tort dans un contexte privilégiant la performance. La mise en route est assez simple. En pratique, le processus pour optimiser et limiter les fuites est assez complexe. De même, combiner chargement dynamique + namespacing + types TypeScript ralentit beaucoup le développement.
 
 Sur TanStack Start, vous évitez les pièges spécifiques à Next.js (`setRequestLocale`, rendu statique), mais le problème de fond est le même : sans une discipline stricte, le bundle transporte rapidement trop de messages et la maintenance des namespaces par route devient pénible.
 
@@ -186,7 +186,7 @@ Sur TanStack Start, vous évitez les pièges spécifiques à Next.js (`setReques
 
 Pourtant, elle partage les mêmes inconvénients majeurs que les stacks basées sur `t('a.b.c')` : les optimisations sont possibles mais très gourmandes en temps, et les gros projets risquent de mauvaises pratiques (namespaces + chargement dynamique + types).
 
-Les formats de messages divergent également : `use-intl` utilise ICU MessageFormat, tandis qu'i18next utilise son propre format - ce qui complique l'outillage ou les migrations si vous les mélangez.
+Les formats de messages divergent également : `next-intl` utilise ICU MessageFormat, tandis qu'i18next utilise son propre format - ce qui complique l'outillage ou les migrations si vous les mélangez.
 
 **(Lingui)** (`@lingui/core@5.3.0`) :
 
@@ -198,7 +198,7 @@ Les formats de messages divergent également : `use-intl` utilise ICU MessageFor
 
 ### 4 - Recommandations
 
-Ce benchmark TanStack Start n'a pas d'équivalent direct à `next-translate` (plugin Next.js + `getStaticProps`). Pour les équipes qui veulent vraiment une API `t()` avec un écosystème mature, `react-i18next` et `use-intl` restent des choix "raisonnables", mais attendez-vous à investir beaucoup de temps dans l'optimisation pour éviter les fuites.
+Ce benchmark TanStack Start n'a pas d'équivalent direct à `next-translate` (plugin Next.js + `getStaticProps`). Pour les équipes qui veulent vraiment une API `t()` avec un écosystème mature, `react-i18next` et `next-intl` restent des choix "raisonnables", mais attendez-vous à investir beaucoup de temps dans l'optimisation pour éviter les fuites.
 
 **(Intlayer)** (`react-intlayer@8.7.12`) :