@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/es/releases/v7.md

@@ -18,12 +18,17 @@ slugs:
   - doc
   - releases
   - v7
+author: aymericzip
 ---
 
 # Nueva Intlayer v7 - ¿Qué hay de nuevo?
 
 ¡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
@@ -259,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:
@@ -406,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/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: Nuevo Intlayer v8 - ¿Qué hay de nuevo?
 description: Descubre qué hay de nuevo en Intlayer v8. Mejoras importantes en la experiencia del desarrollador, validación de contenido y gestión de diccionarios.
 keywords:
@@ -17,6 +17,7 @@ slugs:
   - doc
   - releases
   - v8
+author: aymericzip
 ---
 
 # Nuevo Intlayer v8 - ¿Qué hay de nuevo?
@@ -408,6 +409,16 @@ Para más detalles, consulte la [Documentación de Contenido HTML](https://githu
 
 ---
 
+## Archivos de Contenido YAML y Markdown (v8.10.0)
+
+Ahora puede declarar contenido directamente utilizando las extensiones de archivo `.content.md` y `.content.yaml`. Esto es perfecto para contenido de formato largo, blogs, documentación y políticas de privacidad.
+
+Estos archivos son completamente editables desde el Editor Visual, lo que proporciona un flujo de trabajo optimizado para los miembros del equipo no técnicos.
+
+Para más detalles, consulte la [Documentación de Archivos de Contenido YAML](https://intlayer.org/doc/concept/content#yaml-content-file) y la [Documentación de Archivos de Contenido Markdown](https://intlayer.org/doc/concept/content/markdown).
+
+---
+
 ## Reescrituras de URL personalizadas
 
 Intlayer v8 introduce el soporte para **Reescrituras de URL personalizadas**, lo que le permite definir rutas específicas de locale que difieren de la estructura estándar `/locale/path`. Esta es una característica poderosa para mejorar el SEO local y proporcionar una experiencia de usuario más natural para los hablantes no ingleses.
@@ -752,6 +763,58 @@ export default {
   </Tab>
 </Tabs>
 
+## Reglas de Pluralización Unicode CLDR (v8.8.0)
+
+Se ha introducido un nuevo helper de nodo `plural` basado en las reglas de pluralización definidas por el Proyecto Unicode CLDR, mejorando el soporte para idiomas complejos.
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+Luego puede pasar el conteo dinámicamente en el componente de su framework:
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* En inglés:                                  */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+Para más información, consulte la [Documentación de Pluralización](https://intlayer.org/doc/concept/content/plural).
+
+---
+
 ## Validación del esquema de contenido
 
 Intlayer v8 introduce la validación de esquemas para diccionarios. Ahora puede definir esquemas de validación reutilizables en su configuración utilizando Zod y aplicarlos a sus archivos de contenido. Esto garantiza que su contenido siempre se adhiera a la estructura esperada, detectando errores en el momento de la construcción.
@@ -796,6 +859,34 @@ Si el contenido no coincide con el esquema (por ejemplo, el título es demasiado
 
 ---
 
+## TypeScript: Accesores Primitivos de IntlayerNode
+
+El tipo `IntlayerNode` ha sido actualizado para permitir llamar métodos primitivos de JavaScript directamente en los nodos de contenido. Esto hace posible interactuar con su contenido localizado directamente como si fuera un primitivo estándar de cadena, número, booleano o array.
+
+Compatible con React, Preact, Solid, Svelte, Vue y Angular.
+
+### Ejemplo de Cadena
+
+```typescript
+content.placeholder; // Returns IntlayerNode<string>
+content.placeholder.value; // Returns string
+content.placeholder.toString(); // Returns string
+content.placeholder.toLowerCase(); // Returns string
+String(content.placeholder); // Returns string
+content.placeholder.toUpperCase(); // Returns uppercased string
+content.placeholder.replace("a", "b"); // Returns modified string
+```
+
+### Ejemplo de Array
+
+```typescript
+content.myArrayOfString             // Returns IntlayerNode<Array<string>>
+content.myArrayOfString.find(...)   // Returns element
+content.myArrayOfString.join(', ')  // Returns joined string
+```
+
+---
+
 ### Detección automática de contenido mejorada
 
 En la v8, Intlayer detecta inteligentemente la sintaxis Markdown, las etiquetas HTML y las inserciones de variables en sus cadenas de contenido. Esto significa que a menudo puede omitir funciones auxiliares como `md()`, `html()` o `insert()`.
@@ -1001,6 +1092,17 @@ La extensión de Intlayer para VSCode recibe actualizaciones importantes en la v
 
 ---
 
+## Herramientas: Watcher de C++ y LSP basado en OXC (v8.12.0)
+
+Intlayer v8.12.0 trae importantes mejoras a la experiencia del desarrollador:
+
+- **Parcel Watcher**: El observador de contenido ha sido migrado de `chokidar` a `@parcel/watcher`, aprovechando la observación de archivos nativa de C++ para proporcionar actualizaciones más rápidas y un consumo de memoria significativamente menor.
+- **Nuevo Protocolo de Servidor de Lenguaje (LSP)**: Un LSP completamente nuevo ya está disponible. Construido con parsing basado en OXC, ayuda a su IDE y agentes de IA a vincular sin problemas las llamadas a `useIntlayer('my-key')` con sus archivos `.content` correspondientes, y viceversa.
+
+Para más detalles, consulte la [Documentación de LSP](https://intlayer.org/doc/lsp).
+
+---
+
 ## Optimizaciones del compilador
 
 Intlayer v8 incluye una nueva capa de almacenamiento en caché para el compilador de Markdown y HTML. Esto garantiza que las cadenas de contenido idénticas con la misma configuración solo se analicen una vez, lo que reduce significativamente la sobrecarga durante los re-renderizados o cuando se utiliza el mismo contenido en varios lugares.
@@ -1056,6 +1158,48 @@ Intlayer v8 incluye una nueva capa de almacenamiento en caché para el compilado
 
 ---
 
+## Optimizaciones Experimentales de Construcción: Minify y Purge (v8.7.0)
+
+Intlayer v8.7.0 introduce nuevas características experimentales de construcción en su `intlayer.config.ts` diseñadas para optimizar su bundle de producción:
+
+- **Minificación de Diccionarios**: Minifica los archivos de diccionario para reducir su tamaño.
+- **Purga de Claves No Utilizadas**: Escanea y elimina las claves de traducción no utilizadas de los diccionarios, renombrando las claves activas a caracteres cortos (por ejemplo, `"products" -> "a"`, `"pricing" -> "b"`). Esto reduce el tamaño del bundle hasta en un 5%.
+- **Deshabilitar Verificaciones de TypeScript**: Acelera las construcciones deshabilitando la verificación de tipos de TypeScript durante el paso de compilación.
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * Minify the dictionaries to reduce the bundle size.
+     */
+    minify: true,
+
+    /**
+     * Purge the unused keys in dictionaries
+     */
+    purge: true,
+
+    /**
+     * Indicates if the build should check TypeScript types
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## Flexibilidad: Modo de Importación Unificado
 
 La propiedad booleana `live` ha sido marcada como obsoleta en favor de una propiedad `importMode` más completa. Esto permite una definición explícita de cómo deben cargarse los diccionarios: de forma estática, dinámica o mediante sincronización en vivo.
@@ -1203,6 +1347,49 @@ El contenido Markdown y HTML en Svelte ahora se analiza automáticamente a HTML
 
 ---
 
+## Soporte para Angular: Bundler Vite (v8.11.0)
+
+Para los usuarios de Angular, Intlayer ahora soporta de forma nativa el bundler Vite a través de un nuevo plugin personalizado de esbuild, acelerando los tiempos de desarrollo y construcción.
+
+Para detalles sobre la configuración, consulte la [Documentación del Entorno de Angular](https://intlayer.org/doc/environment/angular).
+
+---
+
+## Generación de Sitemap (v8.6.0)
+
+Intlayer ahora genera sitemaps automáticamente basándose en sus locales y modo de enrutamiento. Esto es particularmente útil para la optimización SEO en arquitecturas de enrutadores como TanStack Router:
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## Notas de migración desde v7
 
 ### Cambios en la configuración