@intlayer/docs 9.4.0 → 9.4.2

package/docs/es/dictionary/markdown.md

@@ -51,6 +51,7 @@ Puede declarar contenido Markdown usando la función `md` o simplemente como una
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     A partir de la versión `8.10.0`, puede declarar contenido Markdown directamente en archivos `.content.md`. Intlayer detectará y analizará automáticamente el contenido Markdown.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ Puede declarar contenido Markdown usando la función `md` o simplemente como una
     ```
 
   </Tab>
+
   <Tab label="Archivos Externos" value="external-files">
     Importe archivos `.md` directamente usando la función `file`.
 
@@ -129,6 +131,7 @@ Puede declarar contenido Markdown usando la función `md` o simplemente como una
     ```
 
   </Tab>
+
 </Tabs>
 
 ## Renderización de Markdown
@@ -957,7 +960,21 @@ Estas utilidades renderizan **únicamente cadenas Markdown puras** y son indepen
   </Tab>
   <Tab label="Angular" value="angular">
 
-> MDX es compatible — cualquier nombre de componente utilizado dentro de tu Markdown (por ejemplo, `<MyCustomJSXComponent />`) se resuelve contra el mapa de `components`.
+    ```typescript fileName="app.config.ts"
+    import { createIntlayerMarkdownProvider } from "angular-intlayer/markdown";
+
+    export const appConfig: ApplicationConfig = {
+      providers: [
+        createIntlayerMarkdownProvider({
+          components: {
+            h1: { class: "text-2xl font-bold" },
+          },
+        }),
+      ],
+    };
+    ```
+
+    > MDX es compatible — cualquier nombre de componente utilizado dentro de tu Markdown (por ejemplo, `<MyCustomJSXComponent />`) se resuelve contra el mapa de `components`.
 
 También puedes usar tu propio renderizador de markdown:
 

package/docs/es/dictionary/plurial.md

@@ -35,9 +35,12 @@ To use plural content in Angular components, retrieve it via the `useIntlayer` h
 
 ## Cuándo usar `plural` vs `enu`
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Caso de uso                                                               | Helper   |
+| ------------------------------------------------------------------------- | -------- |
+| Formas plurales gramaticales según la locale (una manzana / dos manzanas) | `plural` |
+| Rangos numéricos personalizados (`<5`, `>=10`) o categorías fuera de CLDR | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Si solo apunta al inglés (que solo tiene `one` / `other`), cualquiera funciona. Para cualquier idioma con distinciones `few` / `many` / `two`, prefiera `plural`.
 
 ## Configuración del contenido en plural
 

package/docs/es/how_works_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-12
-updatedAt: 2025-06-29
+updatedAt: 2026-08-30
 title: Cómo funciona Intlayer
 description: Aprenda cómo funciona Intlayer internamente. Comprenda la arquitectura y los componentes que hacen que Intlayer sea potente.
 keywords:
@@ -258,3 +258,95 @@ El paquete `@intlayer/backend` exporta tipos de backend y eventualmente ofrecer
 ## Chatea con nuestra documentación inteligente
 
 - [Haz tus preguntas a nuestra documentación inteligente](https://intlayer.org/es/doc/chat)
+
+## Preguntas frecuentes
+
+<FAQ>
+
+<Question title="¿Cuándo se construyen los diccionarios, en tiempo de compilación o en tiempo de ejecución?">
+
+En tiempo de compilación. El plugin del empaquetador, o `npx intlayer build`, escanea tus archivos `.content.ts`, los resuelve en diccionarios en la carpeta `.intlayer` y genera los tipos de TypeScript correspondientes. En tiempo de ejecución tus componentes solo leen el resultado, así que no se produce ningún análisis ni carga de archivos en la ruta de la solicitud.
+
+</Question>
+
+<Question title="¿Cuánto añade la i18n al tamaño de mi bundle?">
+
+Mucho menos que una configuración basada en espacios de nombres, porque una página nunca descarga un catálogo que no renderiza. El marcado renderizado en el servidor resuelve su contenido en el servidor, y el compilador de tiempo de compilación reemplaza las llamadas a `useIntlayer` por las entradas de diccionario exactas que usa un componente, de modo que se descartan las claves sin usar y los idiomas sin usar. Los [diccionarios dinámicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/index.md) reparten el resto por idioma. Frente a las alternativas habituales, Intlayer reduce el tamaño del bundle y de la página hasta en un 50%. Consulta la [optimización del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/bundle_optimization.md) y el [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/index.md).
+
+</Question>
+
+<Question title="¿Puedo migrar desde `i18next`, `next-intl` o `react-i18next` sin reescribir mis componentes?">
+
+Sí, y hay dos caminos. Puedes migrar el contenido de forma progresiva con la [guía de migración de i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_i18next_to_intlayer.md) o la [guía de migración de next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_next-intl_to_intlayer.md). O puedes mantener tu API actual por completo: los [adaptadores de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md) exponen exactamente la misma API que `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` y `Lingui`, pero servida por diccionarios de Intlayer, así que cambian los imports y el código de los componentes no.
+
+</Question>
+
+<Question title="¿Puedo conservar mis archivos de traducción JSON existentes?">
+
+Sí. El [plugin de sincronización JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-json.md) mantiene tus archivos `/messages/{locale}/{namespace}.json` como fuente de verdad y genera diccionarios de Intlayer a partir de ellos, en ambas direcciones. Un [plugin de sincronización PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-po.md) hace lo mismo para los catálogos gettext, y los [archivos por idioma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/per_locale_file.md) te permiten dividir el contenido por idioma en lugar de agrupar los idiomas en un solo archivo.
+
+</Question>
+
+<Question title="¿Tengo que trasladar mi contenido clave por clave?">
+
+No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae las cadenas visibles para el usuario y escribe un archivo `.content` junto a cada uno, así que revisas un diff en lugar de copiar cadenas a un catálogo una por una. Consulta el [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md).
+
+Para una canalización totalmente automatizada, el [compilador de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md) hace lo mismo en tiempo de compilación sobre código JSX, TSX, Vue y Svelte, generando los diccionarios en cada cambio para que no haya ninguna clave que mantener a mano. Funciona por análisis estático, así que las cadenas que solo existen en tiempo de ejecución quedan fuera de su alcance, y necesita unas pocas anotaciones para distinguir el texto visible para el usuario de la lógica de la aplicación.
+
+</Question>
+
+<Question title="¿Qué herramientas para editores y agentes de IA están disponibles?">
+
+Cinco piezas, todas opcionales:
+
+- **[Extensión de VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/vs_code_extension.md)**: salta de una clave `useIntlayer` al archivo de contenido que la declara, extrae contenido de un componente y ejecuta build, fill, test, push y pull desde la paleta de comandos o desde una pestaña de Intlayer dedicada.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**: el mismo conocimiento en cualquier editor que hable LSP, con ir a la definición, buscar todas las referencias, vistas previas al pasar el cursor de un valor traducido, autocompletado de claves y campos, y un aviso cuando una clave no está declarada en ninguna parte. También resuelve las llamadas a `i18next`, `react-i18next`, `next-intl` y `use-intl`, lo que ayuda durante la migración.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)**: expone la documentación y la CLI de Intlayer a Cursor, VS Code, Claude Desktop, Claude Code y ChatGPT, para que un asistente responda a partir de la documentación actual en lugar de adivinar, y pueda ejecutar comandos como `intlayer fill` por sí mismo.
+- **[Habilidades para agentes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**: habilidades específicas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, además de una por framework, que enseñan a un agente tu configuración de enrutamiento y los tipos de nodo de contenido.
+- **[Plugin de ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/eslint.md)**: `no-raw-text` marca las cadenas codificadas de forma fija, con reglas adicionales para claves de diccionario estáticas y contenido sin usar.
+
+</Question>
+
+<Question title="¿Qué es la carpeta .intlayer y debería incluirla en el control de versiones?">
+
+Es la salida generada: los diccionarios compilados y los tipos generados. Deriva de tus archivos de contenido, así que debería aparecer en `.gitignore` y reconstruirse en tu paso de build, exactamente igual que una carpeta `dist`.
+
+</Question>
+
+<Question title="¿Cómo se determina el idioma activo?">
+
+De las fuentes listadas en `routing.storage`, en este orden: el prefijo de la URL cuando `routing.mode` usa uno, luego una cookie, luego la cabecera `Accept-Language` y luego tu idioma por defecto. Un idioma que el usuario elige explícitamente se conserva, de modo que sobrevive a la siguiente visita. Consulta la [referencia de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+
+</Question>
+
+<Question title="¿Cuál es la diferencia entre los diccionarios locales y los remotos?">
+
+Un diccionario local se declara en tu base de código y se compila con tu aplicación. Un diccionario remoto se gestiona en el [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) y se resuelve en tiempo de ejecución, de modo que puede cambiar sin un despliegue. Ambos se leen a través de los mismos hooks, y el contenido remoto recurre a la declaración local cuando no está disponible.
+
+</Question>
+
+<Question title="¿Intlayer funciona sin TypeScript?">
+
+Sí. Los archivos de contenido se pueden escribir en TypeScript, JavaScript, ESM, CommonJS o JSON. TypeScript es lo que desbloquea los tipos generados y el autocompletado, así que es la configuración recomendada, pero no es obligatorio.
+
+</Question>
+
+<Question title="¿Cómo comparten el mismo contenido el renderizado en el servidor y el renderizado en el cliente?">
+
+El servidor resuelve el contenido de los componentes renderizados en el servidor directamente, así que no se envía ningún diccionario al cliente para ese marcado. Los componentes de cliente leen los mismos diccionarios a través del proveedor, que recibe el idioma resuelto en el servidor, de modo que el primer renderizado del cliente coincide con el HTML del servidor y no parpadea con un idioma distinto.
+
+</Question>
+
+<Question title="¿Cómo evita Intlayer una discrepancia de hidratación en el idioma?">
+
+El idioma se resuelve una sola vez en el servidor y se pasa al proveedor, en lugar de detectarse de nuevo en el navegador. Como el cliente parte del mismo idioma que renderizó el servidor, el marcado coincide, que es lo que suele romperse con la detección del idioma en el lado del cliente.
+
+</Question>
+
+<Question title="¿Necesito reconstruir cuando añado una traducción?">
+
+En desarrollo, no: el plugin vigila tus archivos de contenido y reconstruye los diccionarios afectados al guardar. En producción los diccionarios forman parte de la build, a menos que el contenido sea remoto, en cuyo caso el [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) y la [sincronización en vivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/live.md) aplican el cambio sin un despliegue.
+
+</Question>
+
+</FAQ>

package/docs/es/interest_of_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2026-05-31
+updatedAt: 2026-08-30
 title: Interés de Intlayer
 description: Descubre los beneficios y ventajas de usar Intlayer en tus proyectos. Comprende por qué Intlayer se destaca entre otros frameworks.
 keywords:
@@ -39,7 +39,6 @@ author: aymericzip
 En comparación con las soluciones principales como `next-intl` o `i18next`, Intlayer es una solución que viene con optimizaciones integradas como:
 
 <AccordionGroup>
-
 <Accordion header="Tamaño del bundle">
 
 En lugar de cargar archivos JSON masivos en tus páginas, carga solo el contenido necesario. Intlayer ayuda a **reducir el tamaño de tu bundle y de tus páginas hasta en un 50%**.
@@ -292,3 +291,99 @@ Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto
 Usando `intlayer`, puedes declarar tu contenido en el formato de tu biblioteca de i18n favorita, e intlayer generará tus espacios de nombres en la ubicación de tu elección (ejemplo: `/messages/{{locale}}/{{namespace}}.json`).
 
 Si deseas seguir usando la API de tu biblioteca i18n actual, `intlayer` también proporciona **adaptadores de compatibilidad (compat adapters)**: paquetes que exponen exactamente la misma API que `react-i18next`, `next-intl`, `react-intl`, `vue-i18n` y otras, pero servidas por los diccionarios de Intlayer. Esto te permite migrar progresivamente sin reescribir tu código. Consulta la [documentación de los adaptadores de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md).
+
+## Preguntas frecuentes
+
+<FAQ>
+
+<Question title="¿Qué soluciones existen para internacionalizar una aplicación JavaScript?">
+
+Coexisten tres generaciones:
+
+- **Bibliotecas de catálogo en tiempo de ejecución**: `i18next`, `react-i18next`, `next-i18next`, `vue-i18n`, `ngx-translate`, `svelte-i18n`. Espacios de nombres JSON cargados en tiempo de ejecución. Maduras, agnósticas al framework, sin tipado y entregadas completas a la página.
+- **Bibliotecas de mensajes en tiempo de compilación**: `Lingui`, `Paraglide`, y `next-intl` o `react-intl` con un paso de extracción. Mejor comportamiento de bundle y tipado parcial, pero siguen siendo un catálogo centralizado.
+- **Bibliotecas de capa de contenido**: `Intlayer`. El contenido se declara y se compila por componente, así que el tipado, el tree shaking, las herramientas de edición y la traducción con IA proceden de las mismas declaraciones.
+
+</Question>
+
+<Question title="¿Cuánto añade la i18n al tamaño de mi bundle?">
+
+Mucho menos que una configuración basada en espacios de nombres, porque una página nunca descarga un catálogo que no renderiza. El marcado renderizado en el servidor resuelve su contenido en el servidor, y el compilador de tiempo de compilación reemplaza las llamadas a `useIntlayer` por las entradas de diccionario exactas que usa un componente, de modo que se descartan las claves sin usar y los idiomas sin usar. Los [diccionarios dinámicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/index.md) reparten el resto por idioma. Frente a las alternativas habituales, Intlayer reduce el tamaño del bundle y de la página hasta en un 50%. Consulta la [optimización del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/bundle_optimization.md) y el [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/index.md).
+
+</Question>
+
+<Question title="¿Puedo migrar desde `i18next`, `next-intl` o `react-i18next` sin reescribir mis componentes?">
+
+Sí, y hay dos caminos. Puedes migrar el contenido de forma progresiva con la [guía de migración de i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_i18next_to_intlayer.md) o la [guía de migración de next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_next-intl_to_intlayer.md). O puedes mantener tu API actual por completo: los [adaptadores de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md) exponen exactamente la misma API que `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` y `Lingui`, pero servida por diccionarios de Intlayer, así que cambian los imports y el código de los componentes no.
+
+</Question>
+
+<Question title="¿Puedo conservar mis archivos de traducción JSON existentes?">
+
+Sí. El [plugin de sincronización JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-json.md) mantiene tus archivos `/messages/{locale}/{namespace}.json` como fuente de verdad y genera diccionarios de Intlayer a partir de ellos, en ambas direcciones. Un [plugin de sincronización PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-po.md) hace lo mismo para los catálogos gettext, y los [archivos por idioma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/per_locale_file.md) te permiten dividir el contenido por idioma en lugar de agrupar los idiomas en un solo archivo.
+
+</Question>
+
+<Question title="¿Tengo que trasladar mi contenido clave por clave?">
+
+No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae las cadenas visibles para el usuario y escribe un archivo `.content` junto a cada uno, así que revisas un diff en lugar de copiar cadenas a un catálogo una por una. Consulta el [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md).
+
+Para una canalización totalmente automatizada, el [compilador de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md) hace lo mismo en tiempo de compilación sobre código JSX, TSX, Vue y Svelte, generando los diccionarios en cada cambio para que no haya ninguna clave que mantener a mano. Funciona por análisis estático, así que las cadenas que solo existen en tiempo de ejecución quedan fuera de su alcance, y necesita unas pocas anotaciones para distinguir el texto visible para el usuario de la lógica de la aplicación.
+
+</Question>
+
+<Question title="¿Qué herramientas para editores y agentes de IA están disponibles?">
+
+Cinco piezas, todas opcionales:
+
+- **[Extensión de VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/vs_code_extension.md)**: salta de una clave `useIntlayer` al archivo de contenido que la declara, extrae contenido de un componente y ejecuta build, fill, test, push y pull desde la paleta de comandos o desde una pestaña de Intlayer dedicada.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**: el mismo conocimiento en cualquier editor que hable LSP, con ir a la definición, buscar todas las referencias, vistas previas al pasar el cursor de un valor traducido, autocompletado de claves y campos, y un aviso cuando una clave no está declarada en ninguna parte. También resuelve las llamadas a `i18next`, `react-i18next`, `next-intl` y `use-intl`, lo que ayuda durante la migración.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)**: expone la documentación y la CLI de Intlayer a Cursor, VS Code, Claude Desktop, Claude Code y ChatGPT, para que un asistente responda a partir de la documentación actual en lugar de adivinar, y pueda ejecutar comandos como `intlayer fill` por sí mismo.
+- **[Habilidades para agentes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**: habilidades específicas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, además de una por framework, que enseñan a un agente tu configuración de enrutamiento y los tipos de nodo de contenido.
+- **[Plugin de ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/eslint.md)**: `no-raw-text` marca las cadenas codificadas de forma fija, con reglas adicionales para claves de diccionario estáticas y contenido sin usar.
+
+</Question>
+
+<Question title="¿En qué se diferencia Intlayer de next-intl?">
+
+`next-intl` es una capa de mensajes para Next.js: mantienes archivos de mensajes JSON por idioma y los lees a través de `useTranslations`. Intlayer es una capa de contenido: las declaraciones viven junto al componente, se tipan a partir de la propia declaración y se compilan por componente para que una página entregue solo lo que renderiza. Intlayer también cubre lo que `next-intl` te deja a ti, es decir, la traducción con IA, un editor visual, un CMS y las comprobaciones de traducciones que faltan en CI. Si quieres mantener la API de `next-intl`, el [adaptador de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md) la sirve desde diccionarios de Intlayer.
+
+</Question>
+
+<Question title="¿En qué se diferencia Intlayer de i18next y react-i18next?">
+
+`i18next` resuelve claves de cadena frente a espacios de nombres en tiempo de ejecución, lo que significa que una clave renombrada o mal escrita falla en silencio y cada espacio de nombres que toca una página se descarga completo. Intlayer resuelve el contenido en tiempo de compilación frente a tipos generados, así que una clave incorrecta es un error de compilación, y solo las entradas que renderiza un componente llegan al bundle. `i18next` tiene el ecosistema de plugins más grande y una trayectoria más larga; Intlayer tiene el tipado, el tamaño del bundle y las herramientas de edición y automatización. Consulta la [guía de migración de i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_i18next_to_intlayer.md) o el [adaptador de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md).
+
+</Question>
+
+<Question title="¿Es Intlayer más rápido o más ligero que las alternativas?">
+
+En cuanto al tamaño del bundle y de la página, sí: no cargar catálogos que una página no renderiza recorta el tamaño del bundle y de la página hasta en un 50% frente a las configuraciones basadas en espacios de nombres. El [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/index.md) publica el método y las cifras por framework, incluidos [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/nextjs.md), [TanStack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/tanstack.md), [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/vue.md) y [Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/svelte.md), así que puedes reproducirlas en lugar de dar la afirmación por buena sin verificar.
+
+</Question>
+
+<Question title="¿Merece la pena migrar una aplicación existente?">
+
+Depende de qué te duela hoy. Si tu problema es el tamaño del bundle, las traducciones que faltan de forma silenciosa o los traductores que no pueden trabajar sin un desarrollador, la migración se amortiza sola. Si tus catálogos son pequeños y estables, la ganancia es menor. En cualquier caso, la migración no tiene por qué ser una reescritura: los [adaptadores de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md) mantienen tu API actual, y el [plugin de sincronización JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-json.md) mantiene tus archivos JSON existentes como fuente de verdad mientras ambas capas coexisten.
+
+</Question>
+
+<Question title="¿Qué ofrece Intlayer que otras bibliotecas de i18n no ofrecen?">
+
+[Contenido Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/markdown.md), [contenido obtenido de una fuente externa](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md), carga de contenido de archivos, [actualizaciones de contenido en vivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/live.md), un [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md), un [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md), un [compilador](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md) que extrae contenido de componentes existentes, [variantes de contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/variants.md) para pruebas A/B, [analíticas](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/analytics.md) sobre la exposición del contenido, un [servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md), un [LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md) y [habilidades para agentes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md).
+
+</Question>
+
+<Question title="¿Puedo usar Intlayer solo como gestor de traducciones y mantener mi biblioteca actual?">
+
+Sí. Intlayer puede generar tus espacios de nombres en el formato y la ubicación que espera tu biblioteca actual, por ejemplo `/messages/{locale}/{namespace}.json`, así que obtienes la traducción con IA, el editor y las comprobaciones de CI mientras el código de tu aplicación sigue usando su biblioteca de i18n existente.
+
+</Question>
+
+<Question title="¿Es Intlayer gratuito y de código abierto?">
+
+Sí, bajo la licencia Apache 2.0, uso comercial incluido. El CMS alojado es un servicio de pago opcional que también puede [autoalojarse](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md).
+
+</Question>
+
+</FAQ>

package/docs/es/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-07-08
+updatedAt: 2026-08-30
 title: Intlayer CMS | Externaliza tu contenido en el Intlayer CMS
 description: Externaliza tu contenido en el Intlayer CMS para delegar la gestión de tu contenido a tu equipo.
 keywords:
@@ -413,3 +413,95 @@ Si encuentras problemas con el CMS, verifica lo siguiente:
 - Asegúrate de que la configuración del proyecto se haya enviado al CMS de Intlayer.
 
 - El editor visual utiliza un iframe para mostrar tu sitio web. Asegúrate de que la Política de Seguridad de Contenidos (CSP) de tu sitio web permita la URL del CMS como `frame-ancestors` ('https://app.intlayer.org' por defecto). Verifica la consola del editor para cualquier error.
+
+## Preguntas frecuentes
+
+<FAQ>
+
+<Question title="¿Cuál es la diferencia entre el CMS de Intlayer y el editor visual?">
+
+El [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) edita diccionarios locales y escribe el cambio de vuelta en tu base de código, así que la aplicación se reconstruye y el cambio pasa por tu revisión y despliegue habituales. El CMS edita diccionarios remotos: el cambio no toca tu base de código y el sitio en ejecución lo recoge sin un despliegue. Los equipos suelen usar ambos, el editor para el contenido del que son responsables los desarrolladores y el CMS para el contenido que marketing cambia cada semana.
+
+</Question>
+
+<Question title="¿Cuánto añade la i18n al tamaño de mi bundle?">
+
+Mucho menos que una configuración basada en espacios de nombres, porque una página nunca descarga un catálogo que no renderiza. El marcado renderizado en el servidor resuelve su contenido en el servidor, y el compilador de tiempo de compilación reemplaza las llamadas a `useIntlayer` por las entradas de diccionario exactas que usa un componente, de modo que se descartan las claves sin usar y los idiomas sin usar. Los [diccionarios dinámicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/index.md) reparten el resto por idioma. Frente a las alternativas habituales, Intlayer reduce el tamaño del bundle y de la página hasta en un 50%. Consulta la [optimización del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/bundle_optimization.md) y el [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/index.md).
+
+</Question>
+
+<Question title="¿Puedo migrar desde `i18next`, `next-intl` o `react-i18next` sin reescribir mis componentes?">
+
+Sí, y hay dos caminos. Puedes migrar el contenido de forma progresiva con la [guía de migración de i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_i18next_to_intlayer.md) o la [guía de migración de next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_next-intl_to_intlayer.md). O puedes mantener tu API actual por completo: los [adaptadores de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md) exponen exactamente la misma API que `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` y `Lingui`, pero servida por diccionarios de Intlayer, así que cambian los imports y el código de los componentes no.
+
+</Question>
+
+<Question title="¿Puedo conservar mis archivos de traducción JSON existentes?">
+
+Sí. El [plugin de sincronización JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-json.md) mantiene tus archivos `/messages/{locale}/{namespace}.json` como fuente de verdad y genera diccionarios de Intlayer a partir de ellos, en ambas direcciones. Un [plugin de sincronización PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-po.md) hace lo mismo para los catálogos gettext, y los [archivos por idioma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/per_locale_file.md) te permiten dividir el contenido por idioma en lugar de agrupar los idiomas en un solo archivo.
+
+</Question>
+
+<Question title="¿Tengo que trasladar mi contenido clave por clave?">
+
+No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae las cadenas visibles para el usuario y escribe un archivo `.content` junto a cada uno, así que revisas un diff en lugar de copiar cadenas a un catálogo una por una. Consulta el [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md).
+
+Para una canalización totalmente automatizada, el [compilador de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md) hace lo mismo en tiempo de compilación sobre código JSX, TSX, Vue y Svelte, generando los diccionarios en cada cambio para que no haya ninguna clave que mantener a mano. Funciona por análisis estático, así que las cadenas que solo existen en tiempo de ejecución quedan fuera de su alcance, y necesita unas pocas anotaciones para distinguir el texto visible para el usuario de la lógica de la aplicación.
+
+</Question>
+
+<Question title="¿Qué herramientas para editores y agentes de IA están disponibles?">
+
+Cinco piezas, todas opcionales:
+
+- **[Extensión de VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/vs_code_extension.md)**: salta de una clave `useIntlayer` al archivo de contenido que la declara, extrae contenido de un componente y ejecuta build, fill, test, push y pull desde la paleta de comandos o desde una pestaña de Intlayer dedicada.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**: el mismo conocimiento en cualquier editor que hable LSP, con ir a la definición, buscar todas las referencias, vistas previas al pasar el cursor de un valor traducido, autocompletado de claves y campos, y un aviso cuando una clave no está declarada en ninguna parte. También resuelve las llamadas a `i18next`, `react-i18next`, `next-intl` y `use-intl`, lo que ayuda durante la migración.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)**: expone la documentación y la CLI de Intlayer a Cursor, VS Code, Claude Desktop, Claude Code y ChatGPT, para que un asistente responda a partir de la documentación actual en lugar de adivinar, y pueda ejecutar comandos como `intlayer fill` por sí mismo.
+- **[Habilidades para agentes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**: habilidades específicas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, además de una por framework, que enseñan a un agente tu configuración de enrutamiento y los tipos de nodo de contenido.
+- **[Plugin de ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/eslint.md)**: `no-raw-text` marca las cadenas codificadas de forma fija, con reglas adicionales para claves de diccionario estáticas y contenido sin usar.
+
+</Question>
+
+<Question title="¿Qué contenido debería trasladarse al CMS?">
+
+Contenido que cambia a menudo y que no pertenece a una publicación: los textos de la página de aterrizaje, la redacción de los precios, los anuncios, cualquier cosa de la que sea responsable un equipo de marketing. El contenido que forma parte de la interfaz, como las etiquetas de los botones y los errores de formulario, es mejor dejarlo como diccionarios locales, donde se revisa junto con el código que lo usa.
+
+</Question>
+
+<Question title="¿Qué ocurre si el CMS no está accesible?">
+
+La aplicación recurre a la declaración local del diccionario, así que un fallo de red o una caída degrada al contenido entregado con tu build en lugar de a una página vacía. Por eso importa mantener una declaración local para cada diccionario remoto.
+
+</Question>
+
+<Question title="¿Puedo autoalojar el CMS?">
+
+Sí. El CMS puede ejecutarse en tu propia infraestructura, que es la respuesta habitual cuando el contenido no debe salir de tu red. Consulta [autoalojar Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md).
+
+</Question>
+
+<Question title="¿Los editores de contenido necesitan a un desarrollador para publicar un cambio?">
+
+No. Ese es el objetivo de los diccionarios remotos: un editor cambia el texto en el CMS y el sitio lo refleja, con la [sincronización en vivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/live.md) aplicando la actualización en tiempo de ejecución en lugar de esperar a una build.
+
+</Question>
+
+<Question title="¿Puedo automatizar el CMS en lugar de usar la interfaz?">
+
+Sí. El SDK `@intlayer/api` expone los mismos endpoints que la interfaz, así que puedes obtener proyectos, leer diccionarios y enviar actualizaciones desde un script o una canalización. La sección anterior muestra el autenticador y los endpoints.
+
+</Question>
+
+<Question title="¿El CMS admite pruebas A/B de traducciones?">
+
+Sí. Los diccionarios remotos admiten [variantes de contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/variants.md), y las [analíticas](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/analytics.md) informan de cómo se expone cada variante, así que un cambio de redacción se puede medir en lugar de debatir.
+
+</Question>
+
+<Question title="¿El CMS es gratuito?">
+
+La biblioteca, la CLI, el compilador y el editor visual de Intlayer son gratuitos y de código abierto bajo la licencia Apache 2.0. El CMS alojado es un servicio de pago opcional, y en su lugar puede [autoalojarse](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md).
+
+</Question>
+
+</FAQ>

package/docs/es/intlayer_visual_editor.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2026-08-30
 title: Editor Visual Intlayer | Edita tu contenido utilizando un editor visual
 description: Descubre cómo usar el Editor Intlayer para gestionar tu sitio web multilingüe. Sigue los pasos en esta documentación en línea para configurar tu proyecto en pocos minutos.
 keywords:
@@ -210,4 +210,90 @@ Si encuentras algún problema con el editor visual, verifica lo siguiente:
   - Campos requeridos:
     - La URL de la aplicación debe coincidir con la que configuraste en la configuración del editor (`applicationURL`).
 
-- El editor visual utiliza un iframe para mostrar tu sitio web. Asegúrate de que la Política de Seguridad de Contenidos (CSP) de tu sitio web permita la URL del CMS como `frame-ancestors` ('http://localhost:8000' por defecto). Revisa la consola del editor para detectar cualquier error.
+- El editor visual utiliza un iframe para mostrar tu sitio web. Asegúrate de que la Política de Seguridad de Contenidos (CSP) de tu sitio web permita la URL del CMS como `frame-ancestors` (`http://localhost:8000` por defecto). Revisa la consola del editor para detectar cualquier error.
+
+## Preguntas frecuentes
+
+<FAQ>
+
+<Question title="¿Cuál es la diferencia entre el editor visual y el CMS?">
+
+El editor visual edita diccionarios locales y escribe el cambio de vuelta en tu base de código, así que pasa por tu revisión y despliegue habituales. El [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) edita diccionarios remotos, que cambian en el sitio en ejecución sin un despliegue. El editor encaja con el contenido del que son responsables los desarrolladores; el CMS encaja con el contenido del que es responsable un equipo de marketing.
+
+</Question>
+
+<Question title="¿Cuánto añade la i18n al tamaño de mi bundle?">
+
+Mucho menos que una configuración basada en espacios de nombres, porque una página nunca descarga un catálogo que no renderiza. El marcado renderizado en el servidor resuelve su contenido en el servidor, y el compilador de tiempo de compilación reemplaza las llamadas a `useIntlayer` por las entradas de diccionario exactas que usa un componente, de modo que se descartan las claves sin usar y los idiomas sin usar. Los [diccionarios dinámicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/index.md) reparten el resto por idioma. Frente a las alternativas habituales, Intlayer reduce el tamaño del bundle y de la página hasta en un 50%. Consulta la [optimización del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/bundle_optimization.md) y el [benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/benchmark/index.md).
+
+</Question>
+
+<Question title="¿Puedo migrar desde `i18next`, `next-intl` o `react-i18next` sin reescribir mis componentes?">
+
+Sí, y hay dos caminos. Puedes migrar el contenido de forma progresiva con la [guía de migración de i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_i18next_to_intlayer.md) o la [guía de migración de next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/migration_from_next-intl_to_intlayer.md). O puedes mantener tu API actual por completo: los [adaptadores de compatibilidad](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compat/index.md) exponen exactamente la misma API que `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` y `Lingui`, pero servida por diccionarios de Intlayer, así que cambian los imports y el código de los componentes no.
+
+</Question>
+
+<Question title="¿Puedo conservar mis archivos de traducción JSON existentes?">
+
+Sí. El [plugin de sincronización JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-json.md) mantiene tus archivos `/messages/{locale}/{namespace}.json` como fuente de verdad y genera diccionarios de Intlayer a partir de ellos, en ambas direcciones. Un [plugin de sincronización PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/plugins/sync-po.md) hace lo mismo para los catálogos gettext, y los [archivos por idioma](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/per_locale_file.md) te permiten dividir el contenido por idioma en lugar de agrupar los idiomas en un solo archivo.
+
+</Question>
+
+<Question title="¿Tengo que trasladar mi contenido clave por clave?">
+
+No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae las cadenas visibles para el usuario y escribe un archivo `.content` junto a cada uno, así que revisas un diff en lugar de copiar cadenas a un catálogo una por una. Consulta el [comando extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md).
+
+Para una canalización totalmente automatizada, el [compilador de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md) hace lo mismo en tiempo de compilación sobre código JSX, TSX, Vue y Svelte, generando los diccionarios en cada cambio para que no haya ninguna clave que mantener a mano. Funciona por análisis estático, así que las cadenas que solo existen en tiempo de ejecución quedan fuera de su alcance, y necesita unas pocas anotaciones para distinguir el texto visible para el usuario de la lógica de la aplicación.
+
+</Question>
+
+<Question title="¿Qué herramientas para editores y agentes de IA están disponibles?">
+
+Cinco piezas, todas opcionales:
+
+- **[Extensión de VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/vs_code_extension.md)**: salta de una clave `useIntlayer` al archivo de contenido que la declara, extrae contenido de un componente y ejecuta build, fill, test, push y pull desde la paleta de comandos o desde una pestaña de Intlayer dedicada.
+- **[Servidor LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**: el mismo conocimiento en cualquier editor que hable LSP, con ir a la definición, buscar todas las referencias, vistas previas al pasar el cursor de un valor traducido, autocompletado de claves y campos, y un aviso cuando una clave no está declarada en ninguna parte. También resuelve las llamadas a `i18next`, `react-i18next`, `next-intl` y `use-intl`, lo que ayuda durante la migración.
+- **[Servidor MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)**: expone la documentación y la CLI de Intlayer a Cursor, VS Code, Claude Desktop, Claude Code y ChatGPT, para que un asistente responda a partir de la documentación actual en lugar de adivinar, y pueda ejecutar comandos como `intlayer fill` por sí mismo.
+- **[Habilidades para agentes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**: habilidades específicas como `intlayer-config`, `intlayer-cli` e `intlayer-content`, además de una por framework, que enseñan a un agente tu configuración de enrutamiento y los tipos de nodo de contenido.
+- **[Plugin de ESLint](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/eslint.md)**: `no-raw-text` marca las cadenas codificadas de forma fija, con reglas adicionales para claves de diccionario estáticas y contenido sin usar.
+
+</Question>
+
+<Question title="¿Dónde se ejecuta el editor visual?">
+
+En tu propia infraestructura. Carga tu aplicación en un iframe y se comunica con un servidor de editor local, así que tu contenido nunca sale de tu entorno. Eso es lo que lo hace utilizable en proyectos que no pueden enviar textos a un servicio alojado.
+
+</Question>
+
+<Question title="¿Los editores necesitan saber programar?">
+
+No. Abren el sitio, hacen clic en un fragmento de texto y lo editan en su sitio. El editor resuelve qué entrada de diccionario respalda ese texto y escribe el cambio en el archivo de contenido correcto, así que un traductor no necesita encontrar el archivo ni conocer la clave.
+
+</Question>
+
+<Question title="¿Editar a través del editor visual cambia mis archivos fuente?">
+
+Sí, esa es la intención. El cambio aterriza en el archivo de declaración de contenido de tu base de código, así que aparece como un diff normal que puedes revisar y confirmar, y la aplicación se reconstruye para mostrarlo.
+
+</Question>
+
+<Question title="El editor muestra una página en blanco o se niega a cargar mi sitio. ¿Qué debería comprobar?">
+
+El editor muestra tu aplicación en un iframe, así que tu Content Security Policy tiene que permitir el origen del editor como `frame-ancestors`, que es `http://localhost:8000` por defecto. Confirma también que el `applicationURL` de tu configuración del editor coincide con la URL desde la que se sirve realmente tu aplicación. La consola del editor informa de ambos fallos.
+
+</Question>
+
+<Question title="¿Puedo usar el editor visual en producción?">
+
+Está diseñado para desarrollo y staging, donde es aceptable una recompilación tras una edición. Para editar contenido en un sitio en vivo sin un despliegue, usa el [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) y sus diccionarios remotos en su lugar.
+
+</Question>
+
+<Question title="¿El editor visual es gratuito?">
+
+Sí. El editor visual forma parte del proyecto de código abierto, bajo la licencia Apache 2.0, uso comercial incluido. Solo el [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) alojado es un servicio de pago, y también puede [autoalojarse](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md).
+
+</Question>
+
+</FAQ>