Migrar de i18next a Intlayer

Para un tutorial detallado paso a paso, por favor consulta nuestro Guía Completa de Migración de i18next.

Intlayer replica perfectamente las características de runtime principales de i18next. Al utilizar el paquete de compatibilidad, tus aplicaciones Vanilla o módulos internos pueden continuar aprovechando la sintaxis familiar.

Qué hacer

Para comenzar, inicializa Intlayer en tu proyecto:

npx intlayer init

Si estás usando Vite, incluye el plugin de Intlayer para enrutar importaciones a @intlayer/i18next:

import { defineConfig } from "vite";
import { i18nextVitePlugin } from "@intlayer/i18next/plugin";

export default defineConfig({
  plugins: [i18nextVitePlugin()],
});

Qué hace bajo el capó

El i18nextVitePlugin asigna importaciones de i18next a @intlayer/i18next, evitando la inflación del bundle de las inclusiones de archivos JSON.

Bajo el capó:

• Configuración de instancia: createInstance analiza correctamente y aplica fallbacks de namespace mientras aprovecha el pipeline de compilación de Intlayer para la recuperación de diccionarios.
• Interpolación: Soporte nativo para reemplazos de {{name}} y anidamiento $t(key) recursivamente.
• Contexto y plurales: Identifica y resuelve formatos de sufijo como key_male y key_one/key_other evaluando contra Intl.PluralRules estándar.
• Objetos de retorno: El modo returnObjects: true extrae de forma segura árboles de diccionarios de Intlayer.