@intlayer/docs 9.3.0 → 9.3.1

package/docs/es/lsp.md

@@ -1,12 +1,14 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-05-31
+updatedAt: 2026-08-10
 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.
+description: Descubra cómo el servidor de lenguaje de Intlayer aporta Go-to-Definition, búsqueda de referencias, vistas previas al pasar el cursor, autocompletado de claves y diagnósticos a su IDE y a su agente de IA.
 keywords:
   - LSP
-  - Servidor de Lenguaje
-  - Ir a la definición
+  - Servidor de lenguaje
+  - Go to Definition
+  - Autocompletado
+  - Diagnósticos
   - IDE
   - Intlayer
   - VS Code
@@ -16,6 +18,9 @@ slugs:
   - doc
   - lsp
 history:
+  - version: 9.1.3
+    date: 2026-08-10
+    changes: "Se añaden búsqueda de referencias, hover, autocompletado y diagnósticos"
   - version: 8.12.0
     date: 2026-06-01
     changes: "Release LSP"
@@ -24,48 +29,47 @@ author: aymericzip
 
 # 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.
+El **servidor de lenguaje de Intlayer** es una implementación del [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/) que hace que su IDE — y su agente de IA — reconozcan Intlayer. Conecta una llamada como `useIntlayer("home")` con el archivo `.content.ts` que la declara, en ambas direcciones.
 
 ---
 
-## ¿Por qué usar el LSP?
+## Funcionalidades
 
-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:
+| Funcionalidad                    | Atajo               | Qué hace                                                                                                                 |
+| -------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| **Ir a la definición**           | `F12` / `Cmd+Clic`  | Saltar desde una clave de diccionario o el uso de un campo a su declaración en el archivo de contenido                   |
+| **Buscar todas las referencias** | `Mayús+F12`         | Desde un archivo de contenido, listar todos los puntos de llamada que usan esa clave o campo                             |
+| **Hover**                        | pasar el cursor     | Previsualizar los campos de un diccionario, o el valor traducido de un campo, sin salir del archivo                      |
+| **Autocompletado**               | `"` `'` `` ` `` `.` | Sugerir las claves de diccionario declaradas dentro de un getter, y los campos de contenido tras `.` o al desestructurar |
+| **Diagnósticos**                 | automático          | Avisar cuando una clave no está declarada en ningún archivo de contenido                                                 |
 
-**Sensibilización de agentes de IA**
+Merece la pena conocer dos comportamientos adicionales:
 
-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.
+- **Diccionarios fusionados** — una clave repartida entre varios archivos de contenido devuelve un resultado por archivo, de modo que puede navegar a cada declaración.
+- **Compatible con monorepos** — el servidor resuelve el `intlayer.config.*` _más cercano_ a cada archivo, de modo que varios proyectos en un mismo espacio de trabajo tienen cada uno sus propios diccionarios.
 
-**Ir a la definición**
+### Llamadas compatibles
 
-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:`.
+La clave se lee bien desde un argumento posicional de tipo cadena, bien desde un objeto de opciones (`{ namespace }`, `{ id }`).
 
-**Soporte de diccionarios fusionados**
+| Biblioteca                  | Llamadas                                                 |
+| --------------------------- | -------------------------------------------------------- |
+| **Intlayer**                | `useIntlayer`, `getIntlayer`                             |
+| **i18next / react-i18next** | `useTranslation`, `getFixedT`, `t`, `Trans`              |
+| **next-intl / use-intl**    | `useTranslations`, `getTranslations`, `createTranslator` |
+| **react-intl**              | `formatMessage`, `FormattedMessage`                      |
+| **Lingui**                  | `useLingui`, `t`, `Trans`, `_`                           |
+| **vue-i18n**                | `useI18n`                                                |
 
-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.
+Esto funciona 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`, `intlayer`), y con los paquetes adaptadores de compatibilidad que le permiten conservar su sintaxis i18n actual.
 
-**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.
+> Los diccionarios se leen de la salida de compilación, así que ejecute `npx intlayer build` — o mantenga su servidor de desarrollo en marcha — para darle al servidor algo que resolver.
 
 ---
 
 ## Instalación
 
-El servidor LSP se distribuye como parte de `@intlayer/lsp`:
+El servidor se distribuye como el binario `intlayer-lsp` dentro de `@intlayer/lsp`:
 
 ```bash packageManager="npm"
 npm install --save-dev @intlayer/lsp
@@ -83,43 +87,43 @@ pnpm add --save-dev @intlayer/lsp
 bun add --dev @intlayer/lsp
 ```
 
-El paquete expone el binario `intlayer-lsp`, que los editores utilizan como ejecutable del servidor.
+Instálelo globalmente (`npm install -g @intlayer/lsp`) si su editor necesita `intlayer-lsp` en el `PATH` — es el caso del plugin de Claude Code y de cualquier configuración de abajo que invoque el binario directamente.
 
 ---
 
-## Configuración como un plugin de Claude Code
+## Configuración
 
-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`.
+<Tabs defaultTab="vscode">
+  <Tab label="VS Code" value="vscode">
 
-### 1. Instalar el binario del servidor de lenguaje
+Instale la [extensión de VS Code de Intlayer](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension). El servidor de lenguaje va incluido desde la v8.12.0 y se inicia automáticamente — **no requiere configuración**.
 
-```bash packageManager="npm"
-npm install -g @intlayer/lsp
-```
+Consulte la [documentación de la extensión de VS Code](https://intlayer.org/doc/vs-code-extension) para conocer sus demás funcionalidades.
 
-```bash packageManager="yarn"
-yarn global add @intlayer/lsp
-```
+  </Tab>
+  <Tab label="Cursor / Windsurf" value="cursor">
 
-```bash packageManager="pnpm"
-pnpm add -g @intlayer/lsp
-```
+[Cursor](https://www.cursor.com/) y [Windsurf](https://windsurf.com/) son forks de VS Code y usan el mismo ecosistema de extensiones. Instale la [extensión de VS Code de Intlayer](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) una vez y el servidor se activa automáticamente — **no requiere configuración**.
+
+  </Tab>
+  <Tab label="Claude Code" value="claude-code">
 
-Esto coloca el binario `intlayer-lsp` en su PATH, que es lo que invoca la entrada `lspServers` del plugin.
+Intlayer ofrece un **plugin de Claude Code** alojado en el repositorio de Intlayer. Le da a Claude Code una resolución real de símbolos para sus claves de diccionario en lugar de recurrir a `grep`.
 
-### 2. Registrar el marketplace de Intlayer e instalar el plugin
+Ponga el binario en su `PATH`, luego registre el marketplace e instale el plugin:
 
 ```bash
+npm install -g @intlayer/lsp
+
 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`).
+`install` también habilita el plugin. **Reinicie Claude Code** — los servidores de lenguaje se cargan al arrancar, así que el plugin no tiene efecto hasta entonces.
 
-### 3. Habilitar la herramienta LSP (si aún no está activa)
+Claude Code inicia entonces el servidor en archivos `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.astro` y `.svelte`, y usa `goToDefinition`, `findReferences` y `hover` al navegar por su código.
 
-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:
+Si Go-to-Definition sigue sin hacer nada, puede que su versión de Claude Code limite la herramienta LSP tras una bandera:
 
 ```json fileName="~/.claude/settings.json"
 {
@@ -129,61 +133,10 @@ Algunas versiones de Claude Code requieren que se establezca la bandera de funci
 }
 ```
 
-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. El LSP está integrado directamente en la extensión de VSCode desde la versión 8.12.0.
-
-> 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
+  </Tab>
+  <Tab label="Zed" value="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`):
+Zed tiene soporte LSP nativo. Añada el servidor a sus ajustes de usuario:
 
 ```json fileName="~/.config/zed/settings.json"
 {
@@ -196,47 +149,21 @@ Para la configuración manual, cree `.vscode/settings.json` en la raíz del proy
     }
   },
   "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", "..."]
-    }
+    "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.
+El marcador `"..."` mantiene los servidores de lenguaje por defecto de Zed junto al de Intlayer.
 
-**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).
+  </Tab>
+  <Tab label="Neovim" value="neovim">
 
-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:
+Con [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')
@@ -245,7 +172,7 @@ 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
+      -- Iniciar el servidor con npx para no necesitar una instalación global
       cmd = { 'npx', '--yes', '@intlayer/lsp' },
       filetypes = {
         'typescript',
@@ -267,21 +194,10 @@ 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:
+Tras reiniciar Neovim, `gd` sobre una clave de diccionario ejecuta Ir a la definición y `gr` ejecuta Buscar referencias.
 
-- **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
+  </Tab>
+  <Tab label="coc.nvim" value="coc">
 
 ```json fileName="~/.config/nvim/coc-settings.json"
 {
@@ -307,9 +223,14 @@ Consulte la documentación de LSP de su editor para conocer el formato de config
 }
 ```
 
-### Ejemplo: Helix
+  </Tab>
+  <Tab label="Helix" value="helix">
 
 ```toml fileName="~/.config/helix/languages.toml"
+[language-server.intlayer-lsp]
+command = "npx"
+args = ["@intlayer/lsp"]
+
 [[language]]
 name = "typescript"
 language-servers = ["intlayer-lsp", "typescript-language-server"]
@@ -317,36 +238,54 @@ 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"]
 ```
 
+  </Tab>
+  <Tab label="Otros editores" value="other">
+
+Cualquier editor compatible con LSP puede ejecutar `@intlayer/lsp`. Apúntelo a:
+
+- **Ejecutable** — `npx @intlayer/lsp`, o el binario `intlayer-lsp`
+- **Transporte** — stdio (estándar)
+- **Capacidades** — `definitionProvider`, `referencesProvider`, `hoverProvider`, `completionProvider` (caracteres desencadenantes `"` `'` `` ` `` `.`), diagnósticos push, `textDocumentSync: Incremental`
+- **Patrones de raíz** — `intlayer.config.ts`, `intlayer.config.js`, `package.json`
+
+Consulte la documentación LSP de su editor para el formato de configuración exacto.
+
+  </Tab>
+</Tabs>
+
 ---
 
-## Cómo funciona
+## Nota sobre los agentes de IA en terminal
 
-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.
+**Claude Code** actúa como un cliente LSP real — vea la pestaña anterior.
 
-En cada solicitud de **Ir a la definición**:
+**OpenAI Codex** y la mayoría de las demás herramientas de terminal no son clientes LSP: leen y escriben archivos directamente. Ejecutar el servidor por sí solo no les ayuda; el valor viene de tenerlo activo en un editor acompañante cuyo índice el agente pueda consultar (Cursor Composer, Windsurf Cascade, Copilot Chat).
 
-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).
+## Cómo funciona
+
+Para cada archivo, el servidor localiza el `intlayer.config.*` más cercano y carga la configuración de ese proyecto para encontrar los diccionarios compilados. La configuración, los diccionarios y la lista de archivos fuente se cachean con TTL cortos, y se invalidan cuando cambia un archivo de contenido vigilado.
+
+En cada petición, el servidor analiza el documento (mediante [oxc](https://oxc.rs/)) e inspecciona la posición del cursor:
+
+1. **Sobre una cadena de clave** (`useIntlayer("home")`) → devuelve todos los archivos de contenido que declaran esa clave, situados en su línea `key:`.
+2. **Sobre el uso de un campo** (`content.title`, una propiedad desestructurada, `t('path.to.field')`, `<Trans>`, …) → resuelve la variable hasta su diccionario y devuelve el campo correspondiente dentro de los archivos de contenido.
+3. **Desde un archivo de contenido** → ejecuta la búsqueda inversa, recorriendo las fuentes del proyecto en busca de los puntos de llamada de esa clave o campo.
 
 ---
 
-## Resolución de problemas
+## Solución de problemas
+
+| Síntoma                                      | Causa probable                       | Solución                                                                         |
+| -------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------- |
+| No ocurre absolutamente nada                 | El servidor no está en ejecución     | Compruebe que `@intlayer/lsp` está instalado y que su editor lo lanza            |
+| Funciona en el editor, no en Claude Code     | Plugin instalado a mitad de sesión   | Reinicie Claude Code — los servidores de lenguaje se cargan al arrancar          |
+| No se encuentran definiciones para una clave | Diccionarios sin compilar            | Ejecute `npx intlayer build`, o inicie su servidor de desarrollo                 |
+| Todas las claves marcadas como no declaradas | Configuración no resuelta            | Verifique que existe un `intlayer.config.ts` (o `.js`) en la raíz de su proyecto |
+| Se usa el proyecto equivocado en un monorepo | Falta configuración por paquete      | Añada un `intlayer.config.*` a cada paquete que declare su propio contenido      |
+| El servidor falla al arrancar                | Versión de Node.js demasiado antigua | Requiere Node.js ≥ 14.18                                                         |
 
-| 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                                                                                   |
+En VS Code, el servidor registra en **Ver → Salida → «Intlayer LSP»** — útil para confirmar qué configuración se resolvió y cuántos diccionarios se encontraron.

package/docs/es/readme.md

@@ -46,27 +46,27 @@ Con **archivos de contenido por localidad**, **autocompletado de TypeScript**, *
 
 ## Beneficios clave de Intlayer:
 
-| Característica                                                                                                                                      | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **Soporte Multi-Frameworks**<br><br>Intlayer es compatible con todos los principales marcos y bibliotecas, incluidos Next.js, React, Vite, Vue.js, Nuxt, Preact, Express y más.                                                                                                                                                                                                                                                                                            |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **Gestión de contenido impulsada por JavaScript**<br><br>Aproveche la flexibilidad de JavaScript para definir y gestionar su contenido de manera eficiente. <br><br> - [Declaración de contenido](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **Archivo de declaración de contenido por localidad**<br><br>Acelere su desarrollo declarando su contenido una vez, antes de la generación automática.<br><br> - [Archivo de declaración de contenido por localidad](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                     |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">                            | **Compilador**<br><br>El compilador Intlayer extrae automáticamente el contenido de los componentes y genera los archivos de diccionario.<br><br> - [Compilador](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                        |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **Entorno seguro para tipos**<br><br>Aproveche TypeScript para garantizar que sus definiciones de contenido y código estén libres de errores, mientras se beneficia del autocompletado del IDE.<br><br> - [Configuración de TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                          |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **Configuración simplificada**<br><br>Póngase en marcha rápidamente con una configuración mínima. Ajuste configuraciones para internacionalización, enrutamiento, IA, compilación y manejo de contenido con facilidad. <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/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **Recuperación de contenido simplificada**<br><br>No es necesario llamar a su función `t` para cada elemento de contenido. Recupere todo su contenido directamente utilizando un solo hook.<br><br> - [Integración con React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                       |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **Implementación consistente de componentes de servidor**<br><br>Perfectamente adecuado para componentes de servidor de Next.js, use la misma implementación tanto para componentes de cliente como de servidor, sin necesidad de pasar su función `t` por cada componente de servidor. <br><br> - [Componentes de servidor](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                              |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **Base de código organizada**<br><br>Mantenga su base de código más organizada: 1 componente = 1 diccionario en la misma carpeta. Traducciones cerca de sus respectivos componentes, mejoran la mantenibilidad y claridad. <br><br> - [Cómo funciona Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                        |
-| <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 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)                                                                                                      |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **Extensión de VSCode**<br><br>Intlayer proporciona una extensión para VSCode para ayudarle a gestionar su contenido y traducciones, construir sus diccionarios, traducir su contenido y más. <br><br> - [Extensión de VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                 |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **Interoperabilidad**<br><br>Permitir la interoperabilidad con react-i18next, next-i18next, next-intl, react-intl, vue-i18n. <br><br> - [Intlayer y react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer y next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer y next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer y vue-i18n](https://intlayer.org/blog/intlayer-with-vue-i18n) |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **Rendimiento y Benchmark**<br><br>Utiliza tree-shaking avanzado y carga dinámica para mejorar el rendimiento y mantener la solución lo más ligera posible. <br><br> - [Rendimiento y Benchmark](https://intlayer.org/doc/benchmark)                                                                                                                                                                                                                                       |
+| Característica                                                                                                                                      | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **Soporte Multi-Frameworks**<br><br>Intlayer es compatible con todos los principales marcos y bibliotecas, incluidos Next.js, React, Vite, Vue.js, Nuxt, Preact, Express y más.                                                                                                                                                                                                                                                                                                                                                                                       |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **Gestión de contenido impulsada por JavaScript**<br><br>Aproveche la flexibilidad de JavaScript para definir y gestionar su contenido de manera eficiente. <br><br> - [Declaración de contenido](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                                                                                           |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **Archivo de declaración de contenido por localidad**<br><br>Acelere su desarrollo declarando su contenido una vez, antes de la generación automática.<br><br> - [Archivo de declaración de contenido por localidad](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">                            | **Compilador**<br><br>El compilador Intlayer extrae automáticamente el contenido de los componentes y genera los archivos de diccionario.<br><br> - [Compilador](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **Entorno seguro para tipos**<br><br>Aproveche TypeScript para garantizar que sus definiciones de contenido y código estén libres de errores, mientras se beneficia del autocompletado del IDE.<br><br> - [Configuración de TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                                                                                     |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **Configuración simplificada**<br><br>Póngase en marcha rápidamente con una configuración mínima. Ajuste configuraciones para internacionalización, enrutamiento, IA, compilación y manejo de contenido con facilidad. <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/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **Recuperación de contenido simplificada**<br><br>No es necesario llamar a su función `t` para cada elemento de contenido. Recupere todo su contenido directamente utilizando un solo hook.<br><br> - [Integración con React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                                                                                                  |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **Implementación consistente de componentes de servidor**<br><br>Perfectamente adecuado para componentes de servidor de Next.js, use la misma implementación tanto para componentes de cliente como de servidor, sin necesidad de pasar su función `t` por cada componente de servidor. <br><br> - [Componentes de servidor](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **Base de código organizada**<br><br>Mantenga su base de código más organizada: 1 componente = 1 diccionario en la misma carpeta. Traducciones cerca de sus respectivos componentes, mejoran la mantenibilidad y claridad. <br><br> - [Cómo funciona Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                                                                                                   |
+| <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 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)                                                                                                                                                                                                 |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **Extensión de VSCode**<br><br>Intlayer proporciona una extensión para VSCode para ayudarle a gestionar su contenido y traducciones, construir sus diccionarios, traducir su contenido y más. <br><br> - [Extensión de VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                                                                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **Interoperabilidad**<br><br>Permitir la interoperabilidad con react-i18next, next-i18next, next-intl, react-intl, vue-i18n. <br><br> - [Intlayer y react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer y next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer y next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer y vue-i18n](https://intlayer.org/blog/intlayer-with-vue-i18n) <br> - [Adaptadores de compatibilidad de Intlayer](https://intlayer.org/doc/compatibility) |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **Rendimiento y Benchmark**<br><br>Utiliza tree-shaking avanzado y carga dinámica para mejorar el rendimiento y mantener la solución lo más ligera posible. <br><br> - [Rendimiento y Benchmark](https://intlayer.org/doc/benchmark)                                                                                                                                                                                                                                                                                                                                  |
 
 ---
 
@@ -173,7 +173,7 @@ Explore nuestra documentación completa para comenzar con Intlayer y aprender c
   <li><a href="https://intlayer.org/doc/concept/cms" rel=''>CMS de Intlayer</a></li>
   <li><a href="https://intlayer.org/doc/concept/content" rel=''>Diccionario</a>
     <ul>
-      <li><a href="https://intlayer.org/doc/concept/content/per-locale-file" rel=''>Archivo de declaración de contenido por localidad</a></li>
+      <li><a href="https://intlayer.org/doc/concept/per-locale-file" rel=''>Archivo de declaración de contenido por localidad</a></li>
       <li><a href="https://intlayer.org/doc/concept/content/translation" rel=''>Traducción</a></li>
       <li><a href="https://intlayer.org/doc/concept/content/enumeration" rel=''>Enumeración</a></li>
       <li><a href="https://intlayer.org/doc/concept/content/condition" rel=''>Condición</a></li>
@@ -194,7 +194,7 @@ Explore nuestra documentación completa para comenzar con Intlayer y aprender c
     <ul>
       <li><a href="https://intlayer.org/doc/environment/nextjs/15" rel=''>Next.js 15</a></li>
       <li><a href="https://intlayer.org/doc/environment/nextjs/14" rel=''>Next.js 14 (App Router)</a></li>
-      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-Page-Router" rel=''>Next.js Page Router</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-page-router" rel=''>Next.js Page Router</a></li>
       <li><a href="https://intlayer.org/doc/environment/nextjs/compiler" rel=''>Next.js usando el Compilador</a></li>
     </ul>
   </li>
@@ -223,7 +223,7 @@ Explore nuestra documentación completa para comenzar con Intlayer y aprender c
   <li><a href="https://intlayer.org/doc/environment/sveltekit" rel=''>SvelteKit</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-preact" rel=''>Vite + Preact</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
-  <li><a href="https://intlayer.org/doc/environment/vite-and-nuxt" rel=''>Vite + Nuxt</a></li>
+  <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
   <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
   <li>