@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.5

package/docs/es/packages/intlayer/getLocalizedUrl.md

@@ -29,6 +29,38 @@ author: aymericzip
 
 ## Descripción
 
+La función `getLocalizedUrl` genera una URL localizada añadiendo un prefijo de locale a la URL proporcionada. Maneja tanto URLs absolutas como relativas, asegurando que el prefijo de locale correcto se aplique basándose en la configuración.
+
+**Características clave:**
+
+- Solo se requieren 2 parámetros: `url` y `currentLocale`
+- Objeto `options` opcional con `locales`, `defaultLocale` y `mode`
+- Utiliza la configuración de internacionalización de tu proyecto como valores por defecto
+- Puede utilizarse con parámetros mínimos para casos simples o completamente personalizado para escenarios complejos
+- Soporta múltiples modos de enrutamiento: `prefix-no-default`, `prefix-all`, `no-prefix` y `search-params`
+
+---
+
+## Firma de Función
+
+```typescript
+getLocalizedUrl(
+  url: string,                   // Requerido
+  currentLocale: Locales,        // Requerido
+  options?: {                    // Opcional
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): string
+```
+
+---
+
+## Parámetros
+
+## Descripción
+
 La función `getLocalizedUrl` genera una URL localizada anteponiendo la URL dada con el locale especificado. Maneja tanto URLs absolutas como relativas, asegurando que se aplique el prefijo de locale correcto según la configuración.
 
 ---
@@ -67,6 +99,25 @@ La función `getLocalizedUrl` genera una URL localizada anteponiendo la URL dada
 
 ## Ejemplo de Uso
 
+### Uso Básico (Solo Parámetros Requeridos)
+
+Cuando hayas configurado tu proyecto con configuraciones de internacionalización, puedes usar la función con solo los parámetros requeridos:
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Usa la configuración de tu proyecto para locales, defaultLocale, y mode
+getLocalizedUrl("/about", Locales.FRENCH);
+// Output: "/fr/about" (asumiendo que francés es soportado y mode es 'prefix-no-default')
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// Output: "/about" o "/en/about" (dependiendo de tu configuración de mode)
+```
+
+### Uso Avanzado (Con Parámetros Opcionales)
+
+Puedes anular la configuración predeterminada proporcionando el parámetro `options` opcional:
+
 ### URLs Relativas
 
 ```typescript codeFormat={["typescript", "esm"]}
@@ -114,6 +165,30 @@ getLocalizedUrl(
 // Salida: "/about" para el locale por defecto (inglés)
 ```
 
+### Anulación Parcial de Configuración
+
+También puede proporcionar solo algunos de los parámetros opcionales. La función utilizará la configuración de su proyecto para los parámetros que no especifique:
+
+```typescript codeFormat="typescript"
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// Solo anular los locales, usar la configuración del proyecto para defaultLocale y mode
+getLocalizedUrl("/about", Locales.SPANISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+});
+
+// Solo anular mode, usar la configuración del proyecto para locales y defaultLocale
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  mode: "prefix-all", // Forzar prefijo para todos los locales incluyendo el predeterminado
+});
+
+// Anular múltiples opciones
+getLocalizedUrl("/about", Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params", // Usar parámetros de consulta: /about?locale=fr
+});
+```
+
 ### URLs Absolutas
 
 ```typescript

package/docs/es/packages/intlayer/getMultilingualUrls.md

@@ -33,6 +33,23 @@ La función `getMultilingualUrls` genera un mapeo de URLs multilingües anteponi
 
 ---
 
+## Firma de función
+
+```typescript
+getMultilingualUrls(
+  url: string,                   // Requerido
+  options?: {                    // Opcional
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): StrictModeLocaleMap<string>
+```
+
+---
+
+## Parámetros
+
 ## Parámetros
 
 - `url: string`
@@ -54,6 +71,33 @@ La función `getMultilingualUrls` genera un mapeo de URLs multilingües anteponi
   - **Tipo**: `boolean`
   - **Por defecto**: `prefixDefaultDefault`
 
+### Parámetros Opcionales
+
+- `options?: object`
+  - **Description**: Objeto de configuración para el comportamiento de localización de URL.
+  - **Type**: `object`
+  - **Required**: No (Opcional)
+
+  - `options.locales?: Locales[]`
+    - **Description**: Array de locales soportados. Si no se proporciona, utiliza los locales configurados desde la configuración de tu proyecto.
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: El locale por defecto para la aplicación. Si no se proporciona, utiliza el locale por defecto configurado desde la configuración de tu proyecto.
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: El modo de enrutamiento de URL para el manejo de locales. Si no se proporciona, utiliza el modo configurado desde la configuración de tu proyecto.
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Sin prefijo para el locale por defecto, con prefijo para los demás
+      - `prefix-all`: Prefijo para todos los locales incluyendo el por defecto
+      - `no-prefix`: Sin prefijo de locale en la URL
+      - `search-params`: Usar parámetros de consulta para el locale (ej: `?locale=fr`)
+
 ### Retorna
 
 - **Tipo**: `IConfigLocales<string>`
@@ -63,6 +107,20 @@ La función `getMultilingualUrls` genera un mapeo de URLs multilingües anteponi
 
 ## Ejemplo de Uso
 
+### Uso Básico (Usa la Configuración del Proyecto)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// Usa la configuración de tu proyecto para locales, defaultLocale y mode
+getMultilingualUrls("/dashboard");
+// Output (assuming project config has en, fr with mode 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### URLs Relativas
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +155,60 @@ getMultilingualUrls(
 
 ---
 
+### Diferentes modos de enrutamiento
+
+```typescript
+// prefix-no-default: Sin prefijo para la configuración regional predeterminada
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Salida: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: Prefijo para todas las configuraciones regionales
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// Salida: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: Sin prefijo de configuración regional en las URLs
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// Salida: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: Configuración regional como parámetro de consulta
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// Salida: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## Casos Especiales
 
 - **Sin Segmento de Localización:**

package/docs/es/packages/react-intlayer/useDictionary.md

@@ -28,96 +28,6 @@ author: aymericzip
 
 Esta sección proporciona una guía detallada sobre el uso del hook `useDictionary` en aplicaciones React, permitiendo un manejo eficiente del contenido localizado sin un editor visual.
 
-## Importando `useDictionary` en React
-
-El hook `useDictionary` puede integrarse en aplicaciones React importándolo según el contexto:
-
-- **Componente Cliente:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer"; // Usado en componentes React del lado cliente
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer"; // Usado en componentes React del lado cliente
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer"); // Usado en componentes React del lado cliente
-  ```
-
-- **Componente Servidor:**
-
-  ```typescript codeFormat="typescript"
-  import { useDictionary } from "react-intlayer/server"; // Usado en componentes React del lado servidor
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useDictionary } from "react-intlayer/server"; // Usado en componentes React del lado servidor
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useDictionary } = require("react-intlayer/server"); // Usado en componentes React del lado servidor
-  ```
-
-## Parámetros
-
-El hook acepta dos parámetros:
-
-1. **`dictionary`**: Un objeto diccionario declarado que contiene contenido localizado para claves específicas.
-2. **`locale`** (opcional): La configuración regional deseada. Por defecto es la configuración regional del contexto actual si no se especifica.
-
-## Diccionario
-
-Todos los objetos diccionario deben ser declarados en archivos de contenido estructurado para garantizar la seguridad de tipos y prevenir errores en runtime. Puedes encontrar las [instrucciones de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md). Aquí tienes un ejemplo de declaración de contenido:
-
-```typescript fileName="./component.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-const componentContent = {
-  key: "component-example",
-  content: {
-    title: t({
-      en: "Client Component Example",
-      fr: "Exemple de composant client",
-      es: "Ejemplo de componente cliente",
-    }),
-    content: t({
-      en: "This is the content of a client component example",
-      fr: "Ceci est le contenu d'un exemple de composant client",
-      es: "Este es el contenido de un ejemplo de componente cliente",
-    }),
-  },
-} satisfies Dictionary;
-
-export default componentContent;
-```
-
-```json fileName="./component.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "component-example",
-  "content": {
-    "title": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "Client Component Example",
-        "fr": "Exemple de composant client",
-        "es": "Ejemplo de componente cliente"
-      }
-    },
-    "content": {
-      "nodeType": "translation",
-      "translation": {
-        "en": "This is the content of a client component example",
-        "fr": "Ceci est le contenu d'un exemple de composant client",
-        "es": "Este es el contenido de un ejemplo de componente cliente"
-      }
-    }
-  }
-}
-```
-
 ## Ejemplo de uso en React
 
 A continuación se muestra un ejemplo de cómo usar el hook `useDictionary` en un componente React:
@@ -139,35 +49,6 @@ const ComponentExample: FC = () => {
 };
 ```
 
-## Integración en el Servidor
-
-Si utilizas el hook `useDictionary` fuera del `IntlayerProvider`, el locale debe proporcionarse explícitamente como parámetro al renderizar el componente:
-
-```tsx fileName="./ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useDictionary } from "react-intlayer/server";
-import clientComponentExampleContent from "./component.content";
-
-const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
-  const { content } = useDictionary(clientComponentExampleContent, locale);
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.content}</p>
-    </div>
-  );
-};
-```
-
-## Notas sobre los Atributos
-
-A diferencia de las integraciones que usan editores visuales, atributos como `buttonTitle.value` no se aplican aquí. En su lugar, accede directamente a las cadenas localizadas tal como están declaradas en tu contenido.
-
-```jsx
-<button title={content.title}>{content.content}</button>
-```
-
 ## Consejos Adicionales
 
 - **Seguridad de Tipos**: Siempre usa `Dictionary` para definir tus diccionarios y asegurar la seguridad de tipos.

package/docs/es/packages/react-intlayer/useIntlayer.md

@@ -29,49 +29,6 @@ author: aymericzip
 
 Esta sección proporciona una guía detallada sobre cómo usar el hook `useIntlayer` dentro de aplicaciones React, permitiendo una localización eficiente del contenido.
 
-## Importando `useIntlayer` en React
-
-El hook `useIntlayer` puede integrarse en aplicaciones React importándolo según el contexto:
-
-- **Componente Cliente:**
-
-  ```typescript codeFormat="typescript"
-  import { useIntlayer } from "react-intlayer"; // Usado en componentes React del lado del cliente
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer"; // Usado en componentes React del lado del cliente
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer"); // Usado en componentes React del lado del cliente
-  ```
-
-- **Componente Servidor:**
-
-  ```typescript codeFormat="commonjs"
-  import { useIntlayer } from "react-intlayer/server"; // Usado en componentes React del lado del servidor
-  ```
-
-  ```javascript codeFormat="esm"
-  import { useIntlayer } from "react-intlayer/server"; // Usado en componentes React del lado del servidor
-  ```
-
-  ```javascript codeFormat="commonjs"
-  const { useIntlayer } = require("react-intlayer/server"); // Usado en componentes React del lado del servidor
-  ```
-
-## Parámetros
-
-El hook acepta dos parámetros:
-
-1. **`key`**: La clave del diccionario para obtener contenido localizado.
-2. **`locale`** (opcional): La configuración regional deseada. Por defecto, usa la configuración regional del contexto si no se especifica.
-
-## Diccionario
-
-Todas las claves del diccionario deben declararse dentro de archivos de declaración de contenido para mejorar la seguridad de tipos y evitar errores. Puedes encontrar las [instrucciones de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_file.md).
-
 ## Ejemplo de uso en React
 
 Demostración del hook `useIntlayer` dentro de un componente React:
@@ -132,14 +89,6 @@ const ServerComponentExample = () => {
 };
 ```
 
-## Manejo de Atributos
-
-Al localizar atributos, accede a los valores del contenido de manera adecuada:
-
-```jsx
-<button title={content.buttonTitle.value}>{content.buttonText}</button>
-```
-
 ## Recursos Adicionales
 
 - **Editor Visual de Intlayer**: Para una experiencia de gestión de contenido más intuitiva, consulta la documentación del editor visual [aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md).

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

package/docs/es/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-14
+updatedAt: 2026-06-23
 title: Nuevo Intlayer v9 - ¿Qué hay de nuevo?
 description: Descubre las novedades de Intlayer v9. Presentamos paquetes de compatibilidad directos para librerías i18n populares y soporte para Colecciones, Variantes y Registros Dinámicos.
 keywords:
@@ -212,6 +212,42 @@ En tiempo de compilación, `@intlayer/swc` y `@intlayer/babel` escanean tus arch
 
 ---
 
+## Plugin de Vite: Compilador Integrado y Proxy
+
+El plugin de Vite `intlayer()` ahora integra el **compilador** y el **proxy de enrutamiento de locales** directamente, por lo que la mayoría de proyectos solo necesitan un único plugin en `vite.config.ts`:
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compilador**: Se activa automáticamente cuando `compiler.enabled` está configurado y se define una ruta `compiler.output`. Ya no necesitas registrar `intlayerCompiler()` por separado.
+- **Proxy**: Se activa automáticamente basado en la nueva opción `routing.enableProxy` (`true` por defecto). Conecta el middleware de detección de locales / redirección / reescritura en desarrollo, vista previa y SSR de producción. Ya no necesitas registrar `intlayerProxy()` por separado.
+
+### Opción `routing.enableProxy`
+
+Una nueva opción `routing.enableProxy` controla si el proxy de enrutamiento de locales está activado. Por defecto es `true`. Desactívalo cuando quieras manejar el enrutamiento de locales por tu cuenta:
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // Por defecto: true
+  },
+};
+
+export default config;
+```
+
+Los plugins independientes `intlayerCompiler()` e `intlayerProxy()` siguen siendo exportados para configuraciones avanzadas. Registrarlos junto con `intlayer()` es seguro — cada plugin se deduplica a sí mismo y se ejecuta solo una vez.
+
+---
+
 ## Notas de migración desde v8
 
 Si estás actualizando desde v8, ten en cuenta que la v9 no incluye cambios disruptivos. Pero aquí están los cambios clave: