TypeScript

Traduce valores literales en módulos de idioma con una exportación predeterminada estática sin alterar la sintaxis de TypeScript que los rodea.

Un módulo de idioma de TypeScript permite mantener los mensajes junto a los tipos que los describen. El procesador de archivos typescript traduce los valores literales de una exportación predeterminada estática y sustituye el texto en su ubicación original, conservando las claves, las importaciones, los comentarios y la sintaxis de tipos que lo rodea. Lee el código fuente sin ejecutar el módulo.

Proporciona al procesador un catálogo estático #

Usa un objeto o un array definido directamente como exportación predeterminada:

typescript
export default {
  checkout: {
    title: "Complete your order",
    retries: 3,
  },
  steps: ["Review", "Confirm"],
} as const;

Las unidades de texto incluyen checkout.title, steps[0] y steps[1]. El valor numérico no cambia. as const, satisfies y los paréntesis que rodean las expresiones compatibles pueden mantenerse en el código fuente.

Mantén los valores traducibles como literales. El procesador no resuelve los identificadores exportados buscando su declaración ni evalúa llamadas a funciones de fábrica. Omite las claves de propiedad calculadas, las expansiones, los métodos y los valores generados por expresiones. Los literales de plantilla solo funcionan si no contienen expresiones interpoladas. Si un módulo válido no genera ninguna tarea de traducción, revisa la estructura de la exportación predeterminada antes de buscar un fallo de traducción.

Decide qué valores aceptados conservar #

La versión anterior del código fuente permite identificar los cambios por ruta del catálogo. El destino existente aporta los valores aceptados para las cadenas que no han cambiado o que siguen sin resolverse por otros medios. Las rutas bloqueadas conservan el literal actual del origen; las rutas preservadas conservan el valor existente en el destino, si lo hay. Estos controles no ejecutan el código para encontrar texto adicional.

Las sustituciones usan el mismo delimitador de comillas que el literal de origen y aplican al contenido traducido las secuencias de escape necesarias para ese delimitador. Una actualización de claves conserva los valores del destino que no se hayan seleccionado. Las entradas del origen que falten en ese resultado parcial pueden eliminarse, incluidos los elementos de los arrays, así que revisa las claves resultantes y los elementos que quedan en los arrays antes de cargar el módulo.

Configura la selección de archivos #

La CLI infiere typescript para .ts, .mts y .cts, pero no para .js ni .tsx. Selecciona los módulos de idioma mediante la configuración de la CLI o GitHub.

Carga el módulo traducido #

Este formato es independiente de la extracción de mensajes de React. La extracción lee las llamadas compatibles en el código fuente .ts y .tsx de la aplicación para crear un catálogo; este procesador traduce un módulo de idioma ya estructurado. Consulta Catálogos y tipos de React para conocer ese ciclo de trabajo.

Tras recuperar el módulo, comprueba sus tipos y cárgalo mediante el cargador de catálogos de la aplicación. Compara las claves seleccionadas con los mensajes que usa la pantalla y, después, prueba los marcadores de posición. Estas comprobaciones detectan problemas distintos: un módulo no válido no se puede cargar, un valor dinámico no seleccionado queda sin traducir y una traducción válida puede transmitir un significado incorrecto.