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 cerca de los tipos que los describen. El controlador de archivos typescript traduce los valores literales de una exportación predeterminada estática y reemplaza el texto en su lugar, sin alterar las claves, las importaciones, los comentarios ni la sintaxis de tipos que lo rodea. Lee el código fuente sin ejecutar el módulo.
Proporciona al controlador un catálogo estático #
Usa un objeto o un arreglo definido directamente en la exportación predeterminada:
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 permanecer en el código fuente.
Mantén los valores traducibles como literales. El controlador no busca la declaración de un identificador exportado ni evalúa llamadas a funciones de fábrica. Omite las claves de propiedad calculadas, las operaciones de propagación, 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 tareas de traducción, revisa la estructura de la exportación predeterminada antes de buscar un error de traducción.
Conserva los valores aceptados de forma deliberada #
El código fuente anterior permite identificar los cambios por ruta del catálogo. El archivo de destino existente aporta los valores aceptados para las cadenas que no cambiaron o que no se resolvieron por otros medios. Las rutas bloqueadas conservan el literal actual del código fuente; las rutas preservadas conservan el valor de destino existente, si está disponible. Estos controles no ejecutan el código para detectar texto adicional.
Los reemplazos usan el mismo tipo de comillas que el literal de origen y aplican las secuencias de escape correspondientes al contenido traducido. Una actualización de claves conserva los valores de destino no seleccionados. Las entradas de origen que no aparezcan en ese resultado parcial pueden eliminarse, incluidos los elementos de los arreglos. Por eso, antes de cargar el módulo, revisa las claves resultantes y los elementos que quedaron en los arreglos.
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 controlador traduce un módulo de idioma ya estructurado. Consulta Catálogos y tipos de React para conocer ese ciclo de vida.
Después de obtener el módulo, verifica 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 luego prueba los marcadores de posición. Estas comprobaciones permiten detectar distintos problemas: 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, aun así, expresar un significado incorrecto.