@intlayer/docs 9.4.4 → 9.5.0

package/docs/es/configuration.md

@@ -122,14 +122,10 @@ author: aymericzip
 
 Los archivos de configuración de Intlayer le permiten personalizar diversos aspectos del complemento, como la internacionalización (internationalization), el middleware y el manejo de contenido. Esta documentación proporciona una descripción detallada de cada propiedad en la configuración.
 
----
-
 ## Tabla de Contenidos
 
 <TOC/>
 
----
-
 ## Formatos de archivos de configuración compatibles
 
 Intlayer acepta los formatos de archivo de configuración JSON, JS, MJS y TS:
@@ -143,8 +139,6 @@ Intlayer acepta los formatos de archivo de configuración JSON, JS, MJS y TS:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
----
-
 ## Ejemplo de archivo de configuración
 
 ````typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -699,14 +693,10 @@ const config: IntlayerConfig = {
 export default config;
 ````
 
----
-
 ## Referencia de Configuración
 
 En las siguientes secciones se describen las diversas opciones de configuración disponibles en Intlayer.
 
----
-
 ### Configuración de Internacionalización (Internationalization Configuration)
 
 Define los ajustes relacionados con la internacionalización, incluidas las localidades disponibles y la localidad predeterminada de la aplicación.
@@ -718,8 +708,6 @@ Define los ajustes relacionados con la internacionalización, incluidas las loca
 | `strictMode`      | Garantiza una implementación robusta del contenido internacionalizado mediante el uso de TypeScript.   | `string`   | `'inclusive'`       |                      | • Si es `"strict"`: la función `t` requiere que se defina cada localidad declarada; arroja un error si alguna de ellas falta o no está declarada.<br/>• Si es `"inclusive"`: advierte sobre las localidades que faltan pero acepta las localidades existentes no declaradas.<br/>• Si es `"loose"`: acepta cualquier localidad existente. |
 | `defaultLocale`   | Localidad predeterminada utilizada como recurso (fallback) si no se encuentra la localidad solicitada. | `string`   | `Locales.ENGLISH`   | `'en'`               | Se utiliza para determinar la localidad cuando no se especifica ninguna en la URL, galleta (cookie) o cabecera.                                                                                                                                                                                                                           |
 
----
-
 ### Configuración del Editor (Editor Configuration)
 
 Define los ajustes relacionados con el editor integrado, incluido el puerto del servidor y su estado de actividad.
@@ -751,8 +739,6 @@ Las analíticas son de exclusión voluntaria (opt-out): están habilitadas de fo
 | `flushInterval` | Milisegundos entre los envíos por lotes automáticos al backend.                                    | `number`  | `20000`        | `10000` |                                                                                                                                                                                                       |
 | `sampleRate`    | Fracción de sesiones a registrar, de `0` (ninguna) a `1` (todas).                                  | `number`  | `1`            | `0.5`   | El muestreo es determinista por sesión, por lo que una sesión registrada reporta todos sus eventos (sin embudos parciales).                                                                           |
 
----
-
 ### Configuración de Enrutamiento (Routing Configuration)
 
 Ajustes que controlan el comportamiento del enrutamiento, incluida la estructura de la URL, el almacenamiento de localidades y el manejo del middleware.
@@ -953,8 +939,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ### Configuración de Contenido (Content Configuration)
 
 Ajustes relacionados con el procesamiento de contenido dentro de la aplicación (nombres de directorio, extensiones de archivo y configuraciones derivadas).
@@ -968,8 +952,6 @@ Ajustes relacionados con el procesamiento de contenido dentro de la aplicación
 | `excludedPath`   | Directorios excluidos de la búsqueda de contenido.                                                                         | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | Todavía no se utiliza; previsto para implementación futura.                                                                                                |
 | `formatCommand`  | Comando para dar formato a los archivos de contenido cuando Intlayer los escribe localmente.                               | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • `{{file}}` se reemplaza por la ruta del archivo.<br/>• Si no se define, Intlayer lo detecta automáticamente (prueba prettier, biome, eslint).            |
 
----
-
 ### Configuración del Sistema
 
 Configuración relacionada con rutas internas y resultados de salida de Intlayer. Estas configuraciones son típicamente internas y normalmente no deberían necesitar ser modificadas por el usuario.
@@ -1024,8 +1006,6 @@ dictionary: {
 };
 ```
 
----
-
 ### Configuración del Registrador (Logger Configuration)
 
 Parámetros para personalizar la salida de registros (logs) de Intlayer.
@@ -1096,8 +1076,6 @@ Las opciones de compilación se aplican a los complementos `@intlayer/babel` y `
 | `outputFormat`        | Controla el formato de salida de los diccionarios.                                                                                      | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | `traversePattern`     | Patrones que definen qué archivos recorrer durante la optimización.                                                                     | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Limite la optimización a los archivos relevantes para mejorar el rendimiento de compilación.<br/>• Se ignora si `optimize` está desactivado.<br/>• Usa patrones glob (glob patterns).                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 
----
-
 ### Configuración del Compilador (Compiler Configuration)
 
 Ajustes que controlan el compilador de Intlayer, que extrae diccionarios directamente de sus componentes.
@@ -1117,8 +1095,6 @@ Ajustes que controlan el compilador de Intlayer, que extrae diccionarios directa
 | --------- | --------------------------------------------------------------------------------- | --------------------------- |
 | `schemas` | Permet de definir des schémas Zod pour valider la structure de vos dictionnaires. | `Record<string, ZodSchema>` |
 
----
-
 ### Plugins
 
 | Campo     | Descripción                           | Tipo               |
@@ -1134,25 +1110,21 @@ Ajustes que controlan el compilador de Intlayer, que extrae diccionarios directa
 En la raíz de tu proyecto, junto a `package.json`. Intlayer también acepta `intlayer.config.js`, `intlayer.config.mjs`, `intlayer.config.cjs` y JSON, de modo que el archivo se adapta al sistema de módulos que use tu proyecto.
 
 </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).
@@ -1160,7 +1132,6 @@ No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae la
 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:
@@ -1172,49 +1143,41 @@ Cinco piezas, todas opcionales:
 - **[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="¿Cómo añado un nuevo idioma a mi aplicación?">
 
 Añade el idioma a `internationalization.locales` y luego ejecuta `npx intlayer fill` para traducir a él el contenido existente. Los tipos generados se actualizan al mismo tiempo, así que cualquier archivo de contenido al que le falte el nuevo idioma se convierte en un error de tipo en lugar de un fallback silencioso.
 
 </Question>
-
 <Question title="¿Cómo elimino el prefijo de idioma de mis URL?">
 
 Establece `routing.mode`. El valor por defecto `"prefix-no-default"` da `/about` para el idioma por defecto y `/fr/about` para los demás. `"prefix-all"` pone prefijo a todos los idiomas. `"no-prefix"` mantiene el idioma completamente fuera de la ruta y lo resuelve a partir de una cookie, una cabecera o un dominio. `"search-params"` lo pone en la cadena de consulta como `/about?locale=fr`.
 
 </Question>
-
 <Question title="¿Puedo servir cada idioma desde su propio dominio?">
 
 Sí. `routing.domains` asigna un idioma a un nombre de host, por ejemplo `{ fr: 'example.fr', en: 'example.com' }`. El dominio identifica el idioma, así que no se añade prefijo a la ruta, y `getLocalizedUrl` devuelve una URL absoluta en el dominio correcto.
 
 </Question>
-
 <Question title="¿Cómo se detecta el idioma del usuario?">
 
 A través de `routing.storage`, que lista las fuentes que leer en orden, normalmente la URL, luego una cookie y luego la cabecera `Accept-Language`. Una elección explícita del usuario se conserva para que prevalezca en la siguiente visita.
 
 </Question>
-
 <Question title="¿Qué hace routing.enableProxy?">
 
 Controla el proxy de enrutamiento por idioma, el middleware que resuelve los prefijos y las redirecciones. Si no se establece, el proxy se ejecuta pero los servidores de desarrollo y de vista previa ignoran el idioma almacenado como fuente de redirección, lo que evita que te reboten a un idioma que no estás probando; en producción se comporta como si fuera `true`. Ponlo en `false` para gestionar tú mismo el enrutamiento por idioma.
 
 </Question>
-
 <Question title="¿Cuál es la diferencia entre importMode static, dynamic y fetch?">
 
 `"static"`, el valor por defecto, importa los diccionarios de forma estática para que se empaqueten y se lean de forma síncrona. `"dynamic"` los importa a través de Suspense, así que un idioma se descarga solo cuando un componente lo renderiza, que es lo que quieres para conjuntos de contenido grandes. `"fetch"` los recupera de la API de sincronización en vivo y recurre a `"dynamic"` si falla. Consulta la [optimización del bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/bundle_optimization.md) y los [diccionarios dinámicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/index.md).
 
 </Question>
-
 <Question title="¿Dónde configuro el proveedor de IA y la clave de API para la traducción automática?">
 
 Ya sea en el archivo de configuración o en la línea de comandos con `--provider`, `--model` y `--api-key`. La clave sigue siendo tuya: las llamadas de traducción van desde tu máquina o tu runner de CI al proveedor que elijas, así que nada se enruta a través de un tercero. Consulta el [comando fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/fill.md).
 
 </Question>
-
 <Question title="¿Necesito reiniciar el servidor de desarrollo tras cambiar la configuración?">
 
 Normalmente no. El watcher de Intlayer vigila el propio `intlayer.config.ts`: al guardar recarga la configuración y vuelve a preparar los diccionarios, así que añadir un idioma o cambiar un modo de enrutamiento se recoge como un cambio de contenido. Sin embargo, la configuración puede quedar cacheada por los sistemas. Reiniciar tu aplicación puede ser una buena solución.

package/docs/es/dictionary/html.md

@@ -119,8 +119,6 @@ const myContent = html(
 
 Al utilizar el método `.use()` en un nodo HTML, los componentes que proporcione se cotejarán con la definición proporcionada en la función `html()` (si está disponible).
 
----
-
 ## Renderizado de HTML
 
 El renderizado puede ser gestionado automáticamente por el sistema de contenido de Intlayer o manualmente mediante herramientas especializadas.
@@ -474,8 +472,6 @@ Puedes configurar el renderizado de HTML de forma global para toda tu aplicació
   </Tab>
 </Tabs>
 
----
-
 ### Renderizado Manual y Herramientas Avanzadas
 
 Si necesitas renderizar cadenas de HTML sin procesar o tener más control sobre el mapeo de componentes, utiliza las siguientes herramientas.
@@ -648,8 +644,6 @@ Si necesitas renderizar cadenas de HTML sin procesar o tener más control sobre
   </Tab>
 </Tabs>
 
----
-
 ## Referencia de Opciones
 
 Estas opciones se pueden pasar a `HTMLProvider`, `HTMLRenderer`, `useHTMLRenderer` y `renderHTML`.

package/docs/es/dictionary/markdown.md

@@ -1172,8 +1172,6 @@ export class MyComponent {
   </Tab>
 </Tabs>
 
----
-
 ## Renderizado en el Lado del Servidor (SSR) e Hidratación
 
 En comparación con otros analizadores de Markdown como remark / rehype, Intlayer Markdown no tiene dependencias y se ejecuta tanto en el cliente como en el servidor.

package/docs/es/how_works_intlayer.md

@@ -268,25 +268,21 @@ El paquete `@intlayer/backend` exporta tipos de backend y eventualmente ofrecer
 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).
@@ -294,7 +290,6 @@ No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae la
 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:
@@ -306,43 +301,36 @@ Cinco piezas, todas opcionales:
 - **[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.

package/docs/es/interest_of_intlayer.md

@@ -44,43 +44,36 @@ En comparación con las soluciones principales como `next-intl` o `i18next`, Int
 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%**.
 
 </Accordion>
-
 <Accordion header="Mantenibilidad">
 
 Delimitar el contenido de tu aplicación **facilita el mantenimiento** para aplicaciones a gran escala. Puedes duplicar o eliminar una sola carpeta de funciones sin la carga mental de revisar toda tu base de código de contenido. Además, Intlayer está **completamente tipado** para garantizar la precisión de tu contenido.
 
 </Accordion>
-
 <Accordion header="Agente de IA">
 
 Co-localizar el contenido **reduce el contexto necesario** para los modelos de lenguaje grande (LLM). Intlayer también viene con una suite de herramientas, como una **CLI** para probar traducciones faltantes, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md)** y **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/agent_skills.md)**, para hacer que la experiencia del desarrollador (DX) sea aún más fluida para los agentes de IA.
 
 </Accordion>
-
 <Accordion header="Funcionalidades">
 
 Intlayer ofrece una serie de características adicionales que otras soluciones de i18n no tienen, como [soporte de Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/markdown.md), [obtención de contenido externo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/function_fetching.md), [carga de contenido de archivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/file.md), [actualización de contenido en vivo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/live.md), [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) y más.
 
 </Accordion>
-
 <Accordion header="Automatización">
 
 Usa la automatización para traducir en tu pipeline de CI/CD utilizando el LLM de tu elección al costo de tu proveedor de IA. Intlayer también ofrece un **compilador** para automatizar la extracción de contenido, así como una [plataforma web](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md) para ayudar a **traducir en segundo plano**.
 
 </Accordion>
-
 <Accordion header="Rendimiento">
 
 Conectar archivos JSON masivos a componentes puede generar problemas de rendimiento y reactividad. Intlayer optimiza la carga de tu contenido en tiempo de compilación.
 
 </Accordion>
-
 <Accordion header="Escalar con perfiles no técnicos">
 
 Más que una simple solución de i18n, Intlayer proporciona un **[editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) auto-hospedado** y un **[CMS completo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)** para ayudarte a administrar tu contenido multilingüe en **tiempo real**, haciendo que la colaboración con traductores, redactores y otros miembros del equipo sea fluida. El contenido se puede almacenar localmente y/o de forma remota.
 
 </Accordion>
-
 <Accordion header="Diseño multi-framework">
 
 Si usas diferentes frameworks para diferentes partes de tu aplicación (por ejemplo, React, React-native, Vue, Angular, Svelte, etc.), Intlayer proporciona una forma de **usar una sintaxis e implementación común en todos los principales frameworks de frontend**. También podrás compartir tu declaración de contenido en tu sistema de diseño, aplicaciones, backend, etc.
@@ -282,8 +275,6 @@ Las estrellas de GitHub son un fuerte indicador de la popularidad de un proyecto
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 
----
-
 ## Interoperabilidad
 
 `intlayer` también puede ayudar a gestionar tus espacios de nombres para `react-intl`, `react-i18next`, `next-intl`, `next-i18next` y `vue-i18n`.
@@ -305,25 +296,21 @@ Coexisten tres generaciones:
 - **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).
@@ -331,7 +318,6 @@ No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae la
 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:
@@ -343,43 +329,36 @@ Cinco piezas, todas opcionales:
 - **[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).

package/docs/es/intlayer_CMS.md

@@ -50,8 +50,6 @@ Para ello, Intlayer introduce el concepto de 'diccionarios distantes'.
 
 <TOC/>
 
----
-
 ## Entendiendo los diccionarios distantes
 
 Intlayer diferencia entre diccionarios 'locales' y 'distantes'.
@@ -397,8 +395,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Para la guía de configuración completa, referencia de variables de entorno, instrucciones de actualización y procedimientos de copia de seguridad/restauración, consulta la [Guía de Auto-hospedaje](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/self_hosting.md).
 
----
-
 ## Depuración
 
 Si encuentras problemas con el CMS, verifica lo siguiente:
@@ -423,25 +419,21 @@ Si encuentras problemas con el CMS, verifica lo siguiente:
 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).
@@ -449,7 +441,6 @@ No. Ejecuta `npx intlayer extract` e Intlayer lee tus archivos fuente, extrae la
 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:
@@ -461,43 +452,36 @@ Cinco piezas, todas opcionales:
 - **[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).