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

package/docs/es/compat/svelte-i18n.md

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Svelte I18n a Intlayer"
+description: "Aprende cómo migrar tu aplicación Svelte desde svelte-i18n a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Svelte I18n a Intlayer
+
+Mover tu aplicación Svelte desde `svelte-i18n` a Intlayer toma solo un momento usando el adaptador de compatibilidad.
+
+## Qué hacer
+
+Simplemente ejecuta el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Esto genera `intlayer.config.ts`. Asegúrate de que tus plugins de SvelteKit / Vite estén envueltos con el plugin de alias de Intlayer para mapear sin problemas `svelte-i18n` a `@intlayer/svelte-i18n`.
+
+## Qué hace bajo el capó
+
+Svelte-i18n se basa en stores muy utilizados (`$_`, `$t`, `$format`, etc.) e ICU MessageFormat.
+
+Bajo el capó:
+
+- **Stores:** Intlayer proxies los stores de `svelte-i18n`. `$_` se convierte en un store derivado del locale actual que devuelve un resolvedor de Intlayer.
+- **Claves:** Tus claves planas (p. ej. `$_('home.title')`) se evalúan de modo que el primer segmento de ruta representa el diccionario de Intlayer.
+- **Sintaxis ICU:** Completamente manejada por el resolvedor ICU compartido (análisis equivalente de `intl-messageformat`).
+- **Formateadores:** Las llamadas `$date`, `$time`, `$number` se redireccionan de forma segura a los formateadores de núcleo nativos de Intlayer.
+- **Análisis Babel/SWC:** El analizador de Intlayer lee los llamadores de stores de Svelte (`$_`) dentro de tus archivos fuente `.svelte` antes de la compilación para construir automáticamente los fragmentos de diccionario relevantes.

package/docs/es/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Transloco a Intlayer"
+description: "Aprende cómo migrar tu aplicación Angular desde Transloco a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Transloco a Intlayer
+
+Si tu aplicación Angular actualmente usa `@jsverse/transloco`, puedes migrar a Intlayer usando nuestro adaptador de compatibilidad. Esta transición te permite mantener tu sintaxis de plantilla existente mientras utilizas la poderosa estructura de diccionarios de Intlayer.
+
+## Qué hacer
+
+Simplemente ejecuta el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Esto generará la configuración necesaria de `intlayer.config.ts`. Entonces reemplazarás tus importaciones de Transloco con módulos de `@intlayer/transloco` o confiarás en los aliases de compilación.
+
+## Qué hace bajo el capó
+
+Transloco utiliza scopes y un `TranslocoService` (`translate`, `selectTranslate`), junto con directivas estructurales (`*transloco="let t"`) y pipes (`| transloco`).
+
+Bajo el capó:
+
+- **Scopes:** Se asignan naturalmente a claves de diccionarios de Intlayer, proporcionando una gran historia de poda para optimización de bundle.
+- **Servicio y directivas:** El adaptador de Angular de Intlayer reemplaza sin problemas los proveedores, permitiendo que tus pipes y directivas de plantilla existentes resuelvan cadenas contra diccionarios de Intlayer.
+- **Análisis en tiempo de compilación:** El analizador de TypeScript reconoce llamadas `instant/get`, y la poda de fallback asegura correctitud incluso cuando el uso de plantilla no es estáticamente rastreable.

package/docs/es/compat/vue-i18n.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: "Migrar de Vue I18n a Intlayer"
+description: "Aprende cómo migrar tu aplicación Vue desde vue-i18n a Intlayer usando el adaptador de compatibilidad."
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - migración
+  - compat
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "Inicializar historial"
+author: aymericzip
+---
+
+# Migrar de Vue I18n a Intlayer
+
+Si tu aplicación Vue actualmente usa `vue-i18n`, puedes migrar a Intlayer sin reescribir tus componentes ni tus hooks de traducción. Intlayer proporciona un adaptador de compatibilidad que refleja perfectamente la API de `vue-i18n` mientras aprovecha las poderosas características de Intlayer bajo el capó.
+
+## Qué hacer
+
+Para comenzar, simplemente ejecuta el comando de inicialización en tu proyecto:
+
+```bash
+npx intlayer init
+```
+
+Durante la inicialización, Intlayer configurará tu archivo de configuración (`intlayer.config.ts`) y preparará tu proyecto para la migración. Solo necesitarás agregar el plugin de Intlayer a tu configuración de Vite para asignar automáticamente las importaciones de `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## Qué hace bajo el capó
+
+El `vueI18nVitePlugin` inyecta un alias de módulo en tu empaquetador. Cualquier importación de `vue-i18n` en tu base de código será transparentemente redireccionada a `@intlayer/vue-i18n`.
+
+**Bajo el capó, el adaptador maneja la sintaxis compleja de `vue-i18n` nativamente:**
+
+- **Interpolación y plurales:** Resuelve interpolaciones `{name}` y lista `{0}`. Los plurales de tubería (`"car | cars"`) se convierten en nodos de enumeración/plural de Intlayer basados en semántica posicional.
+- **Formatos:** Funciones como `d()` y `n()` envuelven `Intl` bajo el capó, honrando los `datetimeFormats` y `numberFormats` definidos en tus opciones.
+- **Estado global y local:** `global.locale` se asigna a una `WritableComputedRef` respaldada por el cliente de Intlayer, por lo que la reactividad se comporta exactamente como se esperaba (p. ej. `locale.value = 'fr'`).
+- **Directivas:** La directiva `v-t` se registra y funciona normalmente.
+
+Tu aplicación continúa renderizando exactamente como antes, pero el contenido está impulsado por tus diccionarios de Intlayer, dándote seguridad de tipos, mejor optimización de bundle e integración perfecta de CMS.

package/docs/es/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: Intlayer Compiler | Extracción Automática de Contenido para i18n
 description: Automatiza tu proceso de internacionalización con el Intlayer Compiler. Extrae contenido directamente de tus componentes para una i18n más rápida y eficiente en Vite, Next.js y más.
 keywords:
@@ -60,6 +60,8 @@ Como alternativa, para automatizar tu proceso i18n mientras mantienes el control
 
 ## Uso
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -79,12 +81,15 @@ Actualiza tu `vite.config.ts` para incluir el plugin `intlayerCompiler`:
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // Añade el plugin del compilador
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/es/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: Configuración (Configuration)
 description: Aprenda a configure Intlayer para su aplicación. Entienda los diversos ajustes y opciones disponibles para personalizar Intlayer según sus necesidades.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "Se añadió la configuración `analytics`"
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "Añadida la opción `format` a la configuración del diccionario"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * Configuración de analíticas (analytics).
+   */
+  analytics: {
+    /**
+     * Si la recopilación de analíticas está habilitada (vistas de página, exposiciones de contenido, eventos A/B).
+     * Requiere que `editor.clientId` esté configurado para la atribución.
+     * Predeterminado: false
+     */
+    enabled: true,
+
+    /**
+     * Milisegundos entre los envíos por lotes automáticos al backend.
+     * Predeterminado: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * Fracción de sesiones a registrar, de 0 (ninguna) a 1 (todas).
+     * Predeterminado: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * Ajustes de traducción y construcción basados en IA.
    */
@@ -668,6 +698,20 @@ Define los ajustes relacionados con el editor integrado, incluido el puerto del
 
 ---
 
+### Configuración de Analíticas (Analytics Configuration)
+
+Define los ajustes relacionados con las analíticas de Intlayer: la recopilación de qué contenido se muestra realmente a los usuarios (vistas de página, exposiciones de contenido) y el soporte de pruebas A/B sobre el contenido.
+
+Las analíticas son estrictamente opcionales (opt-in): no se recopila nada a menos que `analytics.enabled` esté explícitamente establecido en `true` **y** se configure una clave de proyecto (`editor.clientId`) para la atribución. Cuando está deshabilitada (predeterminado), toda la integración de analíticas se elimina del paquete (bundle) de su aplicación (dead-code elimination).
+
+| Campo           | Descripción                                                                                        | Tipo      | Predeterminado | Ejemplo | Nota                                                                                                                                                       |
+| --------------- | -------------------------------------------------------------------------------------------------- | --------- | -------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Habilita la recopilación de analíticas (vistas de página, exposiciones de contenido, eventos A/B). | `boolean` | `false`        | `true`  | Requiere que `editor.clientId` esté configurado para la atribución; de lo contrario, las analíticas permanecen deshabilitadas aunque `enabled` sea `true`. |
+| `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.
@@ -884,6 +928,21 @@ Ajustes relacionados con el procesamiento de contenido dentro de la aplicación
 
 ---
 
+### 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.
+
+| Field                     | Description                                                                                          | Type     | Default                           | Example              | Note                                                                      |
+| ------------------------- | ---------------------------------------------------------------------------------------------------- | -------- | --------------------------------- | -------------------- | ------------------------------------------------------------------------- |
+| `baseDir`                 | El directorio base del proyecto.                                                                     | `string` | `process.cwd()`                   | `'/path/to/project'` | Se utiliza para resolver todos los directorios relacionados con Intlayer. |
+| `dictionariesDir`         | La ruta del directorio para almacenar diccionarios de localización.                                  | `string` | `'.intlayer/dictionary'`          |                      |                                                                           |
+| `moduleAugmentationDir`   | Directorio para aumento de módulos, permitiendo mejores sugerencias del IDE y verificación de tipos. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | Asegúrate de incluir esto en `tsconfig.json`.                             |
+| `unmergedDictionariesDir` | El directorio para almacenar diccionarios sin fusionar.                                              | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                                           |
+| `typesDir`                | El directorio para almacenar tipos de diccionarios.                                                  | `string` | `'.intlayer/types'`               |                      |                                                                           |
+| `mainDir`                 | El directorio donde se almacenan los archivos principales de la aplicación.                          | `string` | `'.intlayer/main'`                |                      |                                                                           |
+| `configDir`               | El directorio donde se almacenan los archivos de configuración.                                      | `string` | `'.intlayer/config'`              |                      |                                                                           |
+| `cacheDir`                | El directorio donde se almacenan los archivos de caché.                                              | `string` | `'.intlayer/cache'`               |                      |                                                                           |
+
 ### Configuración del Diccionario (Dictionary Configuration)
 
 Parámetros que controlan las operaciones de diccionarios, incluido el comportamiento de relleno automático y la generación de contenido.
@@ -992,22 +1051,6 @@ Las opciones de compilación se aplican a los complementos `@intlayer/babel` y `
 
 ---
 
-### Configuración del Sistema (System Configuration)
-
-Estos ajustes son para casos de uso avanzados y configuración interna de Intlayer.
-
-| Campo                     | Descripción                                         | Tipo     | Predeterminado                    | Ejemplo | Nota |
-| ------------------------- | --------------------------------------------------- | -------- | --------------------------------- | ------- | ---- |
-| `dictionariesDir`         | Directorio de diccionarios compilados.              | `string` | `'.intlayer/dictionary'`          |         |      |
-| `moduleAugmentationDir`   | Directorio de aumento de módulos TypeScript.        | `string` | `'.intlayer/types'`               |         |      |
-| `unmergedDictionariesDir` | Directorio de diccionarios no fusionados.           | `string` | `'.intlayer/unmerged_dictionary'` |         |      |
-| `typesDir`                | Directorio de tipos generados.                      | `string` | `'.intlayer/types'`               |         |      |
-| `mainDir`                 | Directorio del archivo principal de Intlayer.       | `string` | `'.intlayer/main'`                |         |      |
-| `configDir`               | Directorio de archivos de configuración compilados. | `string` | `'.intlayer/config'`              |         |      |
-| `cacheDir`                | Directorio de archivos de caché.                    | `string` | `'.intlayer/cache'`               |         |      |
-
----
-
 ### Configuración del Compilador (Compiler Configuration)
 
 Ajustes que controlan el compilador de Intlayer, que extrae diccionarios directamente de sus componentes.

package/docs/es/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: Dominios personalizados
 description: Aprenda a configurar el enrutamiento por locales basado en dominios en Intlayer para servir diferentes locales desde nombres de host dedicados.
 keywords:
@@ -172,10 +172,16 @@ El complemento Vite `intlayerProxy` aplica la misma lógica durante el desarroll
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/es/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: Reescrituras de URL personalizadas
 description: Aprende cómo configurar y usar reescrituras de URL personalizadas en Intlayer para definir rutas específicas por locale.
 keywords:
@@ -342,10 +342,16 @@ Para SolidJS, Vue y Svelte, el plugin de Vite `intlayerProxy` gestiona las reesc
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/es/dictionary/content_file.md

@@ -581,6 +581,10 @@ Esquema JSON utilizado para la validación de la estructura del diccionario. Añ
 
 Para diccionarios remotos, este es el identificador único del diccionario en el servidor remoto. Se usa para obtener y gestionar contenido remoto.
 
+##### `projectIds` (string[])
+
+Para diccionarios remotos, este array contiene los IDs de los proyectos que pueden usar este diccionario. Un diccionario remoto puede ser compartido entre múltiples proyectos.
+
 ##### `localId` (LocalDictionaryId)
 
 Identificador único para diccionarios locales. Generado automáticamente por Intlayer para ayudar a identificar el diccionario y determinar si es local o remoto, junto con su ubicación.

package/docs/es/dictionary/file.md

@@ -255,6 +255,14 @@ export default myMultilingualContent;
 
 Esta configuración permite que el contenido se recupere dinámicamente según la preferencia de idioma del usuario. Cuando se utiliza en el Editor Visual de Intlayer o en el CMS, el sistema reconocerá que el contenido proviene de los archivos Markdown especificados y garantizará que permanezcan editables.
 
+## Diferentes tipos de rutas
+
+Cuando uses la función `file`, puedes usar diferentes tipos de rutas para especificar el archivo a incrustar.
+
+- `file("./path/to/file.txt")` - Ruta relativa al archivo actual
+- `file("path/to/file.txt")` - Ruta relativa al directorio raíz del proyecto
+- `file("/users/username/path/to/file.txt")` - Ruta absoluta
+
 ## Cómo Intlayer Maneja el Contenido de Archivos
 
 La función `file` se basa en el módulo `fs` de Node.js para leer el contenido del archivo especificado e insertarlo en el diccionario. Cuando se usa junto con el Editor Visual de Intlayer o el CMS, Intlayer puede rastrear la relación entre el diccionario y el archivo. Esto permite a Intlayer:

package/docs/es/dictionary/nesting.md

@@ -25,6 +25,45 @@ author: aymericzip
 
 En Intlayer, la anidación se logra a través de la función `nest`, que permite referenciar y reutilizar contenido de otro diccionario. En lugar de duplicar contenido, puedes apuntar a un módulo de contenido existente mediante su clave.
 
+## Configurar Anidamiento
+
+Para configurar anidamiento en tu proyecto de Intlayer, primero defines el contenido base que deseas reutilizar. Luego, en un módulo de contenido separado, utilizas la función `nest` para importar ese contenido.
+
+### Diccionario Base
+
+A continuación se muestra un ejemplo de un diccionario base para anidar en otro diccionario:
+
+```typescript fileName="firstDictionary.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import { type Dictionary } from "intlayer";
+
+const firstDictionary = {
+  key: "key_of_my_first_dictionary",
+  content: {
+    content: "content",
+    subContent: {
+      contentNumber: 0,
+      contentString: "string",
+    },
+  },
+} satisfies Dictionary;
+
+export default firstDictionary;
+```
+
+```json fileName="firstDictionary.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "key_of_my_first_dictionary",
+  "content": {
+    "content": "content",
+    "subContent": {
+      "contentNumber": 0,
+      "contentString": "string"
+    }
+  }
+}
+```
+
 ## Configuración de la Anidación
 
 <Tabs group="framework">

package/docs/es/dictionary/translation.md

@@ -259,64 +259,3 @@ document.getElementById("welcome-message")!.textContent = String(
 
   </Tab>
 </Tabs>
-
-## Objetos de Contenido Personalizados
-
-`intlayer` soporta objetos de contenido personalizados para la traducción, permitiéndole definir estructuras más complejas mientras asegura la seguridad de tipos. Aquí hay un ejemplo con un objeto personalizado:
-
-```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
-import { t, type Dictionary } from "intlayer";
-
-interface ICustomContent {
-  title: string;
-  content: string;
-}
-
-const customContent = {
-  key: "custom_content",
-  content: {
-    profileText: t<ICustomContent>({
-      en: {
-        title: "Page Title",
-        content: "Page Content",
-      },
-      fr: {
-        title: "Titre de la Page",
-        content: "Contenu de la Page",
-      },
-      es: {
-        title: "Título de la Página",
-        content: "Contenido de la Página",
-      },
-    }),
-  },
-} satisfies Dictionary;
-
-export default customContent;
-```
-
-```json fileName="**/*.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "custom_content",
-  "content": {
-    "profileText": {
-      "nodeType": "translation",
-      "translation": {
-        "en": {
-          "title": "Título de la Página",
-          "content": "Contenido de la Página"
-        },
-        "fr": {
-          "title": "Titre de la Page",
-          "content": "Contenu de la Page"
-        },
-        "es": {
-          "title": "Título de la Página",
-          "content": "Contenido de la Página"
-        }
-      }
-    }
-  }
-}
-```

package/docs/es/dynamic_dictionaries/index.md

@@ -1,13 +1,12 @@
 ---
 createdAt: 2026-06-12
-updatedAt: 2026-06-12
-title: Diccionarios Dinámicos
-description: Descripción general de las tres funciones de diccionario dinámico de Intlayer — colecciones, variantes y registros dinámicos — para crear contenido i18n flexible y controlado en tiempo de ejecución.
+updatedAt: 2026-06-26
+title: Diccionarios dinámicos
+description: Resumen de las funciones de diccionarios dinámicos de Intlayer — colecciones y variantes — para crear contenido i18n flexible y dirigido en tiempo de ejecución.
 keywords:
-  - Diccionarios Dinámicos
+  - Diccionarios dinámicos
   - Colecciones
   - Variantes
-  - Registros Dinámicos
   - Intlayer
   - Internacionalización
 slugs:
@@ -18,31 +17,38 @@ history:
   - version: 9.0.0
     date: 2026-06-12
     changes: "Lanzamiento de la función de diccionarios dinámicos"
+  - version: 9.1.0
+    date: 2026-06-26
+    changes: "Fusión de los registros dinámicos en las variantes — `variant` ahora acepta una cadena o un objeto"
 author: aymericzip
 ---
 
-# Diccionarios Dinámicos
+# Diccionarios dinámicos
 
-Intlayer admite tres mecanismos para expresar contenido que va más allá de un único diccionario estático por clave. Cada uno se declara a través de un **campo de metadatos de nivel superior** en el archivo de contenido; no se necesita ninguna función contenedora (wrapper).
+Intlayer admite dos mecanismos para expresar contenido que va más allá de un único diccionario estático por clave. Cada uno se declara mediante un **campo de metadatos de nivel superior** en el archivo de contenido; no se necesita ninguna función envolvente.
 
-| Característica                                                                                                               | Campo de metadatos | Selector en `useIntlayer` |
-| ---------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------- |
-| [Colecciones](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/collections.md)             | `item: N`          | `{ item: N }`             |
-| [Variantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/variants.md)                  | `variant: "name"`  | `{ variant: "name" }`     |
-| [Registros Dinámicos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/dynamic_content.md) | `meta: { id, … }`  | `{ id, … }`               |
+| Función                                                                                                          | Campo de metadatos                     | Selector en `useIntlayer`                      |
+| ---------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------- |
+| [Colecciones](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/collections.md) | `item: N`                              | `{ item: N }`                                  |
+| [Variantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dynamic_dictionaries/variants.md)      | `variant: "name"` _o_ `variant: { … }` | `{ variant: "name" }` _o_ `{ variant: { … } }` |
 
-Los tres se componen con el argumento de configuración regional y admiten la carga selectiva / diferida mediante `importMode`.
+Ambos se combinan con el argumento de locale y admiten la carga selectiva / diferida mediante `importMode`.
 
 ## Cuándo usar cada uno
 
-- **Colecciones**: lista ordenada de elementos gestionados en archivos separados (entradas de preguntas frecuentes, publicaciones de blog, productos).
-- **Variantes**: alternativas de contenido nombradas para pruebas A/B, banners estacionales o indicadores de funciones (feature flags).
-- **Registros dinámicos**: contenido obtenido en tiempo de ejecución mediante un ID opaco (registros de CMS, copia específica del usuario).
+- **Colecciones** — lista ordenada de elementos gestionados en archivos separados (entradas de FAQ, artículos de blog, productos).
+- **Variantes** — alternativas de contenido con nombre o estructuradas:
+  - una variante de **cadena** para pruebas A/B, banners de temporada o feature flags;
+  - una variante de **objeto** para registros de CMS, contenido específico de usuario o cualquier contenido direccionado por un conjunto de campos (los antiguos «registros dinámicos»).
 
-## Desambiguación de selectores
+> Las versiones anteriores exponían un campo `meta` separado para el contenido indexado por registro. Se ha fusionado en `variant`: pase un **objeto** a `variant` en lugar de usar `meta`.
 
-Cuando hay múltiples selectores presentes en un diccionario, el orden de resolución es:
+## Desambiguación del selector
+
+Una clave puede declarar ambas dimensiones a la vez (p. ej. una colección cuyos elementos tienen cada uno una variante). Se resuelven en el orden:
 
 ```
-variant → meta → item
+variant → item
 ```
+
+Así, `{ variant: "promo" }` en una clave variante × item devuelve todos los elementos promo como un array, y añadir `{ item: 2 }` lo reduce a una sola entrada.