@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.21

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-12-13
+updatedAt: 2026-06-21
 title: Plugin de sincronización JSON
 description: Sincroniza los diccionarios de Intlayer con archivos JSON i18n de terceros (i18next, next-intl, react-intl, vue-i18n y más). Mantén tu i18n existente mientras usas Intlayer para gestionar, traducir y probar tus mensajes.
 keywords:
@@ -24,6 +24,9 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 9.0.0
+    date: 2026-06-21
+    changes: "Añadida opción splitKeys (un diccionario por clave de espacio de nombres de nivel superior) para diseños de archivo único de next-intl / react-intl"
   - version: 7.5.0
     date: 2025-12-13
     changes: "Añadido soporte para formatos ICU e i18next"
@@ -62,7 +65,62 @@ pnpm add -D @intlayer/sync-json-plugin
 npm i -D @intlayer/sync-json-plugin
 ```
 
-## Inicio rápido
+## Plugins
+
+Este paquete proporciona dos plugins:
+
+- `loadJSON`: Carga archivos JSON en diccionarios de Intlayer.
+  - Este plugin se utiliza para cargar archivos JSON desde una fuente y se cargará en los diccionarios de Intlayer. Puede escanear toda la base de código y buscar archivos JSON específicos.
+    Este plugin se puede utilizar
+    - si utilizas una biblioteca i18n que impone una ubicación específica para que se carguen tus JSON (ej: `next-intl`, `i18next`, `react-intl`, `vue-i18n`, etc.), pero quieres colocar tu declaración de contenido donde quieras en tu base de código.
+    - También se puede utilizar si quieres obtener tus mensajes de una fuente remota (ej: un CMS, una API, etc.) y almacenar tus mensajes en archivos JSON.
+
+  > Bajo el capó, este plugin escaneará toda la base de código y buscará archivos JSON específicos y los cargará en los diccionarios de Intlayer.
+  > Ten en cuenta que este plugin no escribirá la salida y las traducciones de vuelta a los archivos JSON.
+
+- `syncJSON`: Sincroniza archivos JSON con diccionarios de Intlayer.
+  - Este plugin se utiliza para sincronizar archivos JSON con diccionarios de Intlayer. Puede escanear la ubicación dada y cargar los JSON que coincidan con el patrón para archivos JSON específicos. Este plugin es útil si quieres obtener los beneficios de Intlayer mientras usas otra biblioteca i18n.
+
+## Usando ambos plugins
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mantén tus archivos JSON actuales sincronizados con los diccionarios de Intlayer
+  plugins: [
+    /**
+     * Cargará todos los archivos JSON en src que coincidan con el patrón {key}.i18n json
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Asegura que estos archivos JSON tengan precedencia sobre los archivos en `./locales/en/${key}.json`
+      format: "intlayer", // Formato del contenido JSON
+    }),
+    /**
+     * Cargará y escribirá la salida y las traducciones de vuelta a los archivos JSON en el directorio locales
+     */
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      priority: 0,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
+```
+
+## `syncJSON` plugin
+
+### Inicio rápido
 
 Agrega el plugin a tu `intlayer.config.ts` y apúntalo a tu estructura JSON existente.
 
@@ -81,6 +139,7 @@ const config: IntlayerConfig = {
     syncJSON({
       // Diseño por idioma, por espacio de nombres (por ejemplo, next-intl, i18next con espacios de nombres)
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      format: "icu",
     }),
   ],
 };
@@ -91,14 +150,27 @@ export default config;
 Alternativa: archivo único por idioma (común en configuraciones i18next/react-intl):
 
 ```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "i18next",
+      source: ({ locale }) => `./locales/${locale}.json`,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
 ```
 
-### Cómo funciona
+#### Cómo funciona
 
 - Lectura: el plugin descubre archivos JSON desde tu generador `source` y los carga como diccionarios de Intlayer.
 - Escritura: después de las compilaciones y llenados, escribe los JSON localizados de vuelta en las mismas rutas (con una nueva línea final para evitar problemas de formato).
@@ -112,6 +184,7 @@ syncJSON({
   location?: string, // etiqueta opcional, por defecto: "plugin"
   priority?: number, // prioridad opcional para resolución de conflictos, por defecto: 0
   format?: 'intlayer' | 'icu' | 'i18next', // formateador opcional, usado para compatibilidad con el runtime de Intlayer
+  splitKeys?: boolean, // opcional, divide un solo archivo en un diccionario por clave de espacio de nombres de nivel superior (autodetectado)
 });
 ```
 
@@ -136,17 +209,49 @@ syncJSON({
 }),
 ```
 
-## Múltiples fuentes JSON y prioridad
+#### `splitKeys` (boolean)
+
+Controla si un único archivo JSON cuyas **claves de primer nivel son espacios de nombres** debe convertirse en un diccionario por cada clave de nivel superior, en lugar de un único diccionario que contenga todo el archivo.
+
+Esto coincide con el modelo de espacio de nombres de bibliotecas como `next-intl` y `react-intl`, donde un archivo `messages/{locale}.json` agrupa varios espacios de nombres por sus claves de primer nivel, cada uno abordado de forma independiente (por ejemplo, `useTranslations('Hero')` se resuelve en el diccionario `Hero`).
+
+- `undefined` (por defecto): **autodetectado** — el archivo se divide cuando el patrón `source` no tiene un segmento `{key}` (un archivo contiene todos los espacios de nombres), y se mantiene como un único diccionario en caso contrario (un archivo por clave).
+- `true`: siempre divide cada clave de nivel superior en su propio diccionario.
+- `false`: nunca divide; todo el archivo se convierte en un único diccionario.
+
+Dado un único archivo `messages/{locale}.json`:
+
+```json fileName="messages/en.json"
+{
+  "Hero": { "title": "Full-stack developer" },
+  "Nav": { "work": "Work", "about": "About" },
+  "About": { "lead": "I build apps end to end." }
+}
+```
+
+```ts fileName="intlayer.config.ts"
+syncJSON({
+  format: "icu",
+  source: ({ locale }) => `./messages/${locale}.json`,
+  // splitKeys: true, // implícito porque el patrón no tiene un segmento `{key}`
+}),
+```
+
+Esto produce tres diccionarios — `Hero`, `Nav` y `About` — por lo que `useTranslations('Hero')` (next-intl) se resuelve correctamente. Al volver a escribir, todos los espacios de nombres se reensamblan en el mismo archivo por localidad.
+
+> Cuando mantienes el segmento `{key}` explícito en tu `source` (por ejemplo, `./locales/${locale}/${key}.json`), cada archivo ya es un espacio de nombres, por lo que la división está deshabilitada por defecto.
+
+### Múltiples fuentes JSON y prioridad
 
 Puedes agregar múltiples plugins `syncJSON` para sincronizar diferentes fuentes JSON. Esto es útil cuando tienes múltiples bibliotecas i18n o diferentes estructuras JSON en tu proyecto.
 
-### Sistema de prioridad
+#### Sistema de prioridad
 
 Cuando múltiples plugins apuntan a la misma clave del diccionario, el parámetro `priority` determina qué plugin tiene precedencia:
 
 - Los números de prioridad más altos ganan sobre los más bajos
 - La prioridad por defecto de los archivos `.content` es `0`
-- La prioridad por defecto de los archivos de contenido de plugins es `-1`
+- La prioridad por defecto de los plugins es `0`
 - Los plugins con la misma prioridad se procesan en el orden en que aparecen en la configuración
 
 ```ts fileName="intlayer.config.ts"
@@ -189,73 +294,140 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### Resolución de conflictos
+## Load JSON plugin
 
-Cuando la misma clave de traducción existe en múltiples fuentes JSON:
+### Inicio rápido
 
-1. El plugin con la prioridad más alta determina el valor final
-2. Las fuentes con menor prioridad se usan como respaldo para claves faltantes
-3. Esto permite mantener traducciones heredadas mientras se migra gradualmente a nuevas estructuras
+Agrega el plugin a tu `intlayer.config.ts` para ingerir archivos JSON existentes como diccionarios de Intlayer. Este plugin es de solo lectura (no escribe en disco):
 
-## Integraciones
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-A continuación se muestran mapeos comunes. Mantén tu entorno de ejecución sin cambios; solo agrega el plugin.
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
 
-### i18next
+  plugins: [
+    // Ingerir mensajes JSON ubicados en cualquier parte de tu árbol de código fuente
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      // Cargar una sola localidad por instancia de plugin (por defecto a la localidad predeterminada de la configuración)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
 
-Disposición típica de archivos: `./public/locales/{locale}/{namespace}.json` o `./locales/{locale}/{namespace}.json`.
+export default config;
+```
+
+Alternativa: diseño por localidad, aún de solo lectura (solo se carga la localidad seleccionada):
 
 ```ts fileName="intlayer.config.ts"
-import { syncJSON } from "@intlayer/sync-json-plugin";
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-export default {
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
   plugins: [
-    syncJSON({
-      format: "i18next",
+    loadJSON({
+      // Solo los archivos para Locales.FRENCH se cargarán desde este patrón
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      locale: Locales.FRENCH,
     }),
   ],
 };
+
+export default config;
 ```
 
-### next-intl
+### Cómo funciona
 
-Mensajes JSON por localidad (a menudo `./messages/{locale}.json`) o por espacio de nombres.
+- Descubrir: construye un glob a partir de tu generador `source` y recopila los archivos JSON coincidentes.
+- Ingerir: carga cada archivo JSON como un diccionario de Intlayer con la `locale` proporcionada.
+- Solo lectura: no escribe ni formatea archivos de salida; usa `syncJSON` si necesitas sincronización de ida y vuelta.
+- Listo para auto‑relleno: define un patrón `fill` para que `intlayer content fill` pueda rellenar las claves faltantes.
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
-  }),
-];
+### API
+
+```ts
+loadJSON({
+  // Construye rutas a tu JSON. `locale` es opcional si tu estructura no tiene un segmento de localidad
+  source: ({ key, locale }) => string,
+
+  // Localidad objetivo para los diccionarios cargados por esta instancia de plugin
+  // Por defecto a configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // Etiqueta opcional para identificar la fuente
+  location?: string, // default: "plugin"
+
+  // Prioridad utilizada para la resolución de conflictos contra otras fuentes
+  priority?: number, // default: 0
+
+  // Formateador opcional para el contenido JSON
+  format?: 'intlayer' | 'icu' | 'i18next', // default: 'intlayer'
+
+  // Divide un solo archivo en un diccionario por clave de nivel superior (autodetectado)
+  splitKeys?: boolean,
+});
 ```
 
-Véase también: `docs/es/intlayer_with_next-intl.md`.
+#### `format` ('intlayer' | 'icu' | 'i18next')
 
-### react-intl
+Especifica el formateador a utilizar para el contenido del diccionario al cargar archivos JSON. Esto permite usar diferentes sintaxis de formateo de mensajes compatibles con varias bibliotecas i18n.
 
-Es común un único JSON por localidad:
+- `'intlayer'`: El formateador Intlayer por defecto (por defecto).
+- `'icu'`: Usa el formateo de mensajes ICU (compatible con bibliotecas como react-intl, vue-i18n).
+- `'i18next'`: Usa el formateo de mensajes i18next (compatible con i18next, next-i18next, Solid-i18next).
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+**Ejemplo:**
+
+```ts
+loadJSON({
+  source: ({ key }) => `./src/**/${key}.i18n.json`,
+  locale: Locales.ENGLISH,
+  format: "icu", // Usar formateo ICU para compatibilidad
+}),
 ```
 
-### vue-i18n
+#### `splitKeys` (boolean)
 
-Puede ser un solo archivo por locale o por namespace:
+Mismo comportamiento que en [`syncJSON`](#splitkeys-boolean): cuando un único archivo JSON agrupa varios espacios de nombres por sus claves de primer nivel, cada clave de nivel superior se convierte en su propio diccionario.
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,
-  }),
-];
+- `undefined` (por defecto): **autodetectado** — se divide cuando el patrón `source` no tiene un segmento `{key}`, un único diccionario en caso contrario.
+- `true` / `false`: fuerza o deshabilita la división.
+
+```ts
+loadJSON({
+  source: ({ locale }) => `./messages/${locale}.json`,
+  format: "icu",
+  // splitKeys auto-enabled: `Hero`, `Nav`, `About`, … cada uno se convierte en un diccionario
+}),
 ```
 
+### Comportamiento y convenciones
+
+- Si tu máscara `source` incluye un marcador de posición de localidad, solo se ingieren los archivos para la `locale` seleccionada.
+- Si no hay un segmento `{key}` en tu máscara, cada clave de nivel superior del archivo se convierte en su propio diccionario por defecto (ver [`splitKeys`](#splitkeys-boolean)). Establece `splitKeys: false` para cargar en su lugar todo el archivo como un único diccionario `index`.
+- Las claves se derivan de las rutas de los archivos sustituyendo el marcador de posición `{key}` en tu generador `source`.
+- El plugin solo utiliza los archivos descubiertos y no fabrica localidades o claves faltantes.
+- La ruta `fill` se infiere de tu `source` y se utiliza para actualizar los valores faltantes a través de la CLI cuando optas por ello.
+
+## Resolución de conflictos
+
+Cuando la misma clave de traducción existe en múltiples fuentes JSON:
+
+1. El plugin con la prioridad más alta determina el valor final
+2. Las fuentes con menor prioridad se usan como respaldo para claves faltantes
+3. Esto permite mantener traducciones heredadas mientras se migra gradualmente a nuevas estructuras
+
 ## CLI
 
 Los archivos JSON sincronizados serán considerados como otros archivos `.content`. Eso significa que todos los comandos de intlayer estarán disponibles para los archivos JSON sincronizados. Incluyendo:

package/docs/es/releases/v6.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 ¡Bienvenido a Intlayer v6! Esta versión se centra en el rendimiento, la experiencia del desarrollador y la fiabilidad. A continuación, los aspectos más destacados, con notas de migración y ejemplos para copiar y pegar.
 
+## Tabla de contenidos
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Aspectos destacados
 
 - Nuevo comando: `npx intlayer content test` para detectar traducciones faltantes
@@ -295,6 +299,24 @@ Consulta [CMS y sincronización en vivo](https://github.com/aymericzip/intlayer/
 
 ---
 
+## Proceso paralelo para monitorear archivos en turbopack
+
+Al usar Turbopack en Next.js 14 y superior como tu servidor de desarrollo con el comando `next dev --turbopack`, los cambios en el diccionario no se detectarán automáticamente de forma predeterminada.
+
+Esta limitación ocurre porque Turbopack no puede ejecutar plugins de webpack en paralelo para monitorear cambios en tus archivos de contenido.
+
+Para solucionar esto, utilizamos el comando `intlayer watch`, usando la opción `--with` para ejecutar tanto el servidor de desarrollo como el observador de compilación de Intlayer simultáneamente.
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
 ## Notas de migración
 
 - Eliminado: `dictionaryOutput` (anteriormente `i18next` o `next-intl`). Esto volverá como adaptadores enchufables en versiones futuras. Elimina este campo de tu configuración.
@@ -313,6 +335,12 @@ Consulta [CMS y sincronización en vivo](https://github.com/aymericzip/intlayer/
 
 ---
 
+## Notas de migración de v6 a v7
+
+Consulta las [notas de migración de v6 a v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/releases/v7.md) para más información.
+
+---
+
 ## Enlaces útiles
 
 - [Referencia CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/index.md)

package/docs/es/releases/v7.md

@@ -25,6 +25,10 @@ author: aymericzip
 
 ¡Bienvenido a Intlayer v7! Esta versión mayor introduce mejoras significativas en rendimiento, seguridad de tipos y experiencia del desarrollador. A continuación, los aspectos destacados, con notas de migración y ejemplos prácticos.
 
+## Tabla de contenidos
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## Aspectos destacados
 
 - Estrategia de caché para compilaciones más rápidas
@@ -260,6 +264,126 @@ Esto se traduce en tiempos de descarga más rápidos y un mejor rendimiento en r
 
 ---
 
+## Formateo automático de código: configuración de formatCommand
+
+v7 introduce la opción `formatCommand` en la configuración del editor, permitiéndote formatear automáticamente los archivos de contenido cuando son escritos por Intlayer. Esto asegura un estilo de código consistente y formato uniforme en tus archivos de declaración de contenido.
+
+Si no está configurado, Intlayer intentará detectar el comando de formato automáticamente. Probando resolver los siguientes comandos: prettier, biome, eslint.
+
+### Configuración
+
+La opción `formatCommand` acepta una plantilla de cadena donde `{{file}}` será reemplazado con la ruta del archivo real:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### Formateadores soportados
+
+Puedes usar cualquier formateador de código que acepte rutas de archivo como argumentos:
+
+**Usando Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**Usando Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**Usando ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**Usando el formateador integrado de Bun:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### Beneficios
+
+- **Formato consistente**: Todos los archivos de contenido se formatean automáticamente según las guías de estilo de tu proyecto
+- **Experiencia del desarrollador**: No hay necesidad de formatear archivos manualmente después de que Intlayer los escriba
+- **Consistencia del equipo**: Garantiza que todos los miembros del equipo tengan el mismo formato aplicado a los archivos de contenido
+- **Integración CI/CD**: Los archivos de contenido mantienen un formato consistente en flujos de trabajo automatizados
+
+### Cómo funciona
+
+Cuando Intlayer escribe o actualiza un archivo de declaración de contenido (`.content.ts`, `.content.js`, etc.), ejecuta automáticamente el comando de formato especificado en el archivo. El marcador `{{file}}` se reemplaza con la ruta de archivo real, y el comando se ejecuta en el directorio base del proyecto.
+
+---
+
+## Configuración de Dictionary: Mejor organización y estructura
+
+v7 introduce una nueva sección de configuración dedicada a `dictionary` que proporciona una mejor organización para la configuración relacionada con el diccionario y una gestión mejorada del contenido.
+
+### Nueva estructura de configuración del diccionario
+
+La propiedad `fill` ha sido movida de la sección `content` a una nueva sección `dictionary`, proporcionando una separación más clara de responsabilidades:
+
+**Configuración v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**Configuración v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### Beneficios de la nueva estructura
+
+- **Organización más clara**: La configuración específica del diccionario ahora está agrupada
+- **Mejor separación de responsabilidades**: El descubrimiento de contenido frente a las operaciones del diccionario están claramente separados
+- **Mantenibilidad mejorada**: Más fácil de entender y modificar las configuraciones relacionadas con el diccionario
+- **Extensibilidad futura**: La sección del diccionario puede acomodar configuraciones adicionales específicas del diccionario
+- **Gestión completa del diccionario**: Incluye propiedades como `title`, `live`, `priority`, `tags`, `version` y `description` para crear y gestionar nuevos diccionarios
+
+### Uso de la configuración
+
+La configuración del diccionario tiene dos propósitos principales:
+
+1. **Valores por defecto**: Definir valores por defecto al crear archivos de declaración de contenido
+2. **Comportamiento de reserva**: Proporcionar valores de reserva cuando campos específicos no están definidos, permitiéndote definir el comportamiento de operación del diccionario globalmente
+
+La sección del diccionario incluye propiedades completas para la gestión del diccionario:
+
+- **`fill`**: Comportamiento de auto-relleno para la generación de contenido
+- **`title`**: Título por defecto para nuevos diccionarios
+- **`live`**: Configuración de sincronización en directo para actualizaciones en tiempo real
+- **`priority`**: Configuración de prioridad para la resolución del diccionario
+- **`tags`**: Etiquetas por defecto para la organización del contenido
+- **`version`**: Gestión de versiones para actualizaciones del diccionario
+- **`description`**: Descripción por defecto para nuevo contenido
+
+Para más información sobre archivos de declaración de contenido y cómo se aplican los valores de configuración, consulta la [Documentación de archivo de contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md).
+
+---
+
 ## Comando fill: comportamiento actualizado para una mejor gestión de contenido
 
 v7 introduce un comportamiento mejorado para el comando `fill`, proporcionando una gestión de contenido más predecible y flexible:
@@ -407,6 +531,10 @@ El sistema automáticamente:
 - **`middleware.prefixDefault`**: Reemplazado por `routing.mode`
 - **`middleware.noPrefix`**: Reemplazado por `routing.mode`
 
+### Nuevas configuraciones
+
+- **`editor.formatCommand`**: Nueva opción para formateo automático de código en archivos de contenido
+
 ### Mapeo de migración
 
 #### Mapeo de configuración