@intlayer/docs 8.11.2 → 8.12.0-canary.0

package/docs/es/introduction.md

@@ -1,8 +1,8 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: Introducción
-description: Descubre cómo funciona Intlayer. Ve los pasos que usa Intlayer en tu aplicación. Descubre qué hacen los diferentes paquetes.
+description: Descubre cómo funciona Intlayer. Conoce los pasos que utiliza Intlayer en tu aplicación. Descubre qué hacen los diferentes paquetes.
 keywords:
   - Introducción
   - Comenzar
@@ -26,9 +26,9 @@ history:
 
 ### ¿Qué es Intlayer?
 
-**Intlayer** es una biblioteca de internacionalización diseñada específicamente para desarrolladores de JavaScript. Permite la declaración de tu contenido en cualquier parte de tu código. Convierte la declaración de contenido multilingüe en diccionarios estructurados para integrarlos fácilmente en tu código. Usando TypeScript, **Intlayer** hace que tu desarrollo sea más sólido y eficiente.
+**Intlayer** es una biblioteca de internacionalización diseñada específicamente para desarrolladores de JavaScript. Permite la declaración de tu contenido en cualquier parte de tu código. Convierte la declaración de contenido multilingüe en diccionarios estructurados para integrarse fácilmente en tu código. Usando TypeScript, **Intlayer** hace que tu desarrollo sea más robusto y eficiente.
 
-Intlayer también proporciona un editor visual opcional que te permite editar y gestionar tu contenido fácilmente. Este editor es particularmente útil para desarrolladores que prefieren una interfaz visual para la gestión de contenido, o para equipos que generan contenido sin tener que preocuparse por el código.
+Intlayer también proporciona un editor visual opcional que te permite editar y gestionar fácilmente tu contenido. Este editor es particularmente útil para desarrolladores que prefieren una interfaz visual para la gestión de contenido, o para equipos que generan contenido sin tener que preocuparse por el código.
 
 ### Ejemplo de uso
 
@@ -85,67 +85,119 @@ export const MyComponent: FC = () => {
 };
 ```
 
-## Características Principales
+### ¿Por qué Intlayer en lugar de otras alternativas?
 
-Intlayer ofrece una variedad de características diseñadas para satisfacer las necesidades del desarrollo web moderno. A continuación, se presentan las características clave, con enlaces a la documentación detallada de cada una:
+En comparación con las soluciones principales como `next-intl` o `i18next`, Intlayer es una solución que incluye optimizaciones integradas como:
 
-- **Soporte de Internacionalización**: Mejora el alcance global de tu aplicación con soporte integrado para internacionalización.
+<AccordionGroup>
+
+<Accordion header="Tamaño del bundle">
+
+En lugar de cargar archivos JSON masivos en tus páginas, carga solo el contenido necesario. Intlayer te ayuda a **reducir el tamaño de tu bundle y de tus páginas hasta en un 50%**.
+
+</Accordion>
+
+<Accordion header="Mantenibilidad">
+
+Declarar tu contenido cerca de tus componentes **facilita el mantenimiento** en aplicaciones a gran escala. Puedes duplicar o eliminar una sola carpeta de funcionalidad sin la carga mental de revisar todo tu código fuente de contenido. Además, Intlayer está **completamente tipado** para garantizar la precisión de tu contenido.
+
+</Accordion>
+
+<Accordion header="Agente de IA">
+
+La proximidad del contenido **reduce el contexto necesario** para los modelos de lenguaje grandes (LLM). Intlayer también viene con un conjunto de herramientas, como una **CLI** para comprobar si faltan traducciones, un **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**, un **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**, para que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
+
+</Accordion>
+
+<Accordion header="Automatización">
+
+Automatiza la traducción en tu pipeline CI/CD utilizando el LLM de tu elección al costo de tu proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para ayudarte a **traducir en segundo plano**.
+
+</Accordion>
+
+<Accordion header="Rendimiento">
+
+La conexión de archivos JSON masivos a los componentes puede provocar problemas de rendimiento y reactividad. Intlayer optimiza la carga de tu contenido en el momento de la compilación.
+
+</Accordion>
+
+<Accordion header="Colaboración con perfiles no técnicos">
+
+Más que una simple solución de i18n, Intlayer proporciona un **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)** autoalojado y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)** para ayudarte a administrar tu contenido multilingüe en **tiempo real**, lo que facilita la colaboración con traductores, redactores y otros miembros del equipo. El contenido se puede almacenar de forma local y/o remota.
+
+</Accordion>
+</AccordionGroup>
+
+## Características principales
+
+Intlayer ofrece una variedad de características adaptadas a las necesidades del desarrollo web moderno. A continuación se presentan las características clave, con enlaces a la documentación detallada de cada una:
+
+- **Soporte de internacionalización**: Mejora el alcance global de tu aplicación con soporte integrado para la internacionalización.
 - **Editor Visual**: Mejora tu flujo de trabajo de desarrollo con plugins de editor diseñados para Intlayer. Consulta la [Guía del Editor Visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md).
-- **Flexibilidad de Configuración**: Personaliza tu configuración con amplias opciones detalladas en la [Guía de Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
-- **Herramientas Avanzadas de CLI**: Gestiona tus proyectos de manera eficiente usando la interfaz de línea de comandos de Intlayer. Explora las capacidades en la [Documentación de Herramientas CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/index.md).
+- **Flexibilidad de configuración**: Personaliza tu configuración con amplias opciones de configuración detalladas en la [Guía de Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+- **Herramientas avanzadas de CLI**: Administra tus proyectos de manera eficiente utilizando la interfaz de línea de comandos de Intlayer. Explora las capacidades en la [Documentación de herramientas CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/index.md).
 
-## Conceptos Básicos
+## Conceptos clave
 
 ### Diccionario
 
-Organiza tu contenido multilingüe cerca de tu código para mantener todo consistente y fácil de mantener.
+Organiza tu contenido multilingüe cerca de tu código para mantener todo consistente y mantenible.
 
-- **[Comenzando](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md)**  
+- **[Comenzar](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md)**  
   Aprende los conceptos básicos para declarar tu contenido en Intlayer.
 
 - **[Traducción](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/translation.md)**  
   Comprende cómo se generan, almacenan y utilizan las traducciones en tu aplicación.
 
 - **[Enumeración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/enumeration.md)**  
-  Gestiona fácilmente conjuntos de datos repetidos o fijos en varios idiomas.
+  Administra fácilmente conjuntos de datos repetidos o fijos en varios idiomas.
 
 - **[Condición](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/condition.md)**  
-  Aprende a usar lógica condicional en Intlayer para crear contenido dinámico.
+  Aprende a usar la lógica condicional en Intlayer para crear contenido dinámico.
 
 - **[Inserción](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/insertion.md)**  
-  Descubre cómo insertar valores en una cadena usando marcadores de posición de inserción.
+  Descubre cómo insertar valores en una cadena de texto utilizando marcadores de posición de inserción.
 
-- **[Obtención de Funciones](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/function_fetching.md)**  
-  Aprende cómo obtener contenido dinámicamente con lógica personalizada para adaptarse al flujo de trabajo de tu proyecto.
+- **[Recuperación de Funciones](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/function_fetching.md)**  
+  Observa cómo recuperar contenido dinámicamente con lógica personalizada para que coincida con el flujo de trabajo de tu proyecto.
 
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/markdown.md)**  
   Aprende a usar Markdown en Intlayer para crear contenido enriquecido.
 
-- **[Incrustaciones de Archivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/file.md)**  
-  Descubre cómo incrustar archivos externos en Intlayer para usarlos en el editor de contenido.
+- **[Integraciones de archivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/file.md)**  
+  Descubre cómo integrar archivos externos en Intlayer para usarlos en el editor de contenido.
 
 - **[Anidamiento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/nesting.md)**  
   Comprende cómo anidar contenido en Intlayer para crear estructuras complejas.
 
 ### Entornos e Integraciones
 
-Hemos construido Intlayer pensando en la flexibilidad, ofreciendo una integración perfecta con los frameworks y herramientas de construcción más populares:
+Hemos creado Intlayer pensando en la flexibilidad, ofreciendo una integración perfecta en frameworks y herramientas de construcción populares:
 
+- **[Intlayer con Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_16.md)**
 - **[Intlayer con Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_15.md)**
 - **[Intlayer con Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_14.md)**
 - **[Intlayer con Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_page_router.md)**
 - **[Intlayer con React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_create_react_app.md)**
 - **[Intlayer con Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+react.md)**
+- **[Intlayer con React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_react_router_v7.md)**
+- **[Intlayer con Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_tanstack.md)**
 - **[Intlayer con React Native y Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_react_native+expo.md)**
 - **[Intlayer con Lynx y React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_lynx+react.md)**
+- **[Intlayer con Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+preact.md)**
+- **[Intlayer con Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+vue.md)**
+- **[Intlayer con Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nuxt.md)**
+- **[Intlayer con Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+svelte.md)**
+- **[Intlayer con SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_svelte_kit.md)**
 - **[Intlayer con Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_express.md)**
+- **[Intlayer con NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nestjs.md)**
+- **[Intlayer con Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_hono.md)**
+- **[Intlayer con Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_angular_21.md)**
 
-Cada guía de integración incluye las mejores prácticas para usar las funcionalidades de Intlayer, como **renderizado del lado del servidor**, **enrutamiento dinámico** o **renderizado del lado del cliente**, para que puedas mantener una aplicación rápida, optimizada para SEO y altamente escalable.
+Cada guía de integración incluye las mejores prácticas para utilizar las características de Intlayer, como el **renderizado del lado del servidor**, el **enrutamiento dinámico** o el **renderizado del lado del cliente**, de modo que puedas mantener una aplicación rápida, optimizada para SEO y altamente escalable.
 
-## Contribuciones y Retroalimentación
+## Contribución y comentarios
 
 Valoramos el poder del código abierto y el desarrollo impulsado por la comunidad. Si deseas proponer mejoras, agregar una nueva guía o corregir cualquier problema en nuestra documentación, no dudes en enviar un Pull Request o abrir un issue en nuestro [repositorio de GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
 
-**¿Listo para traducir tu aplicación de manera más rápida y eficiente?** Sumérgete en nuestra documentación para comenzar a usar Intlayer hoy mismo. Experimenta un enfoque robusto y optimizado para la internacionalización que mantiene tu contenido organizado y a tu equipo más productivo.
-
----
+**¿Listo para traducir tu aplicación de manera más rápida y eficiente?** Sumérgete en nuestra documentación para comenzar a usar Intlayer hoy. Experimenta un enfoque robusto y optimizado para la internacionalización que mantiene tu contenido organizado y a tu equipo más productivo.

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 {