lingo extract

Genera JSONC de origen y declaraciones de TypeScript a partir de llamadas explícitas de traducción.

lingo extract asigna una identidad dentro del catálogo a los mensajes explícitos de React. Analiza llamadas de TypeScript/TSX, escribe JSONC de origen y declaraciones de forma local, y conserva los metadatos que vinculan cada entrada con su origen. No reescribe JSX arbitrario ni solicita traducciones.

En un componente de React ya configurado, una llamada compatible se ve así:

tsx
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });

Ejecuta la extracción desde la raíz del proyecto:

sh
lingo extract --src src --source-locale en

Si usas las rutas predeterminadas, revisa locales/en.jsonc y lingo.d.ts. El catálogo de origen registra los valores de los mensajes, el contexto y las ubicaciones en el código fuente. La guía de inicio rápido de React incluye las importaciones y la configuración del proveedor para el componente.

Opciones #

OpciónValor predeterminado o efecto
--src <path>Directorio que se analizará; valor predeterminado: src.
--source-locale <locale>Idioma de origen de la salida; valor predeterminado: en.
--out <path>Tiene prioridad sobre el valor configurado de i18n.messagesPath y, en su defecto, sobre el valor predeterminado locales.
--types <path>Tiene prioridad sobre el valor configurado de i18n.typesPath y, en su defecto, sobre el valor predeterminado lingo.d.ts.
--checkCompara los bytes generados con los del disco sin escribir.

Las rutas se resuelven a partir de la raíz del proyecto más cercana. El idioma de origen no hereda sourceLocale de la configuración de localización; especifica otro idioma de forma explícita. Las operaciones de escritura normales crean los directorios de declaraciones.

Qué reconoce el analizador #

El analizador reconoce text, rich, plural y select en variables asignadas a partir de useLingo o createLingo, además de los receptores convencionales l y .l. Acepta literales de cadena, plantillas sin expresiones y objetos de formulario estáticos.

Los mensajes dinámicos no tienen un origen estable que se pueda extraer. Al desestructurar el resultado de una función de fábrica, se pierde la estructura del receptor que el analizador rastrea y se genera una advertencia. Se excluyen los archivos de declaraciones, los archivos y directorios cuyos nombres comienzan con un punto, y node_modules. Si no hay archivos TS/TSX, la extracción lo informa y termina sin un resultado; que el proceso finalice correctamente no significa que se hayan encontrado mensajes.

Revisión de la identidad y del comportamiento de combinación #

Las claves se derivan del origen y del contexto. Un cambio en la redacción o en el contexto puede crear una nueva identidad; los valores sustituidos en tiempo de ejecución no. Las colisiones hacen que la extracción falle y requieren un contexto que permita distinguir las entradas.

La extracción combina los resultados con el catálogo de origen existente: conserva los valores actuales, actualiza los metadatos de contexto y origen, agrega nuevas entradas y marca los mensajes ausentes como huérfanos. La salida ordenada es determinista. Revisa las advertencias antes de asumir que un mensaje huérfano se eliminó intencionalmente de la aplicación.

Verifica o traduce el catálogo #

lingo extract --check compara los bytes tanto del catálogo como de las declaraciones sin escribir. lingo check también examina el contexto, los mensajes huérfanos y los destinos detectados.

Para traducir, agrega la ruta real de .jsonc a files[], autentícate, vincula el proyecto y usa lingo push --backfill-missing --wait la primera vez. Para los cambios posteriores, usa push sin opciones adicionales. Cambiar las rutas de extracción no actualiza automáticamente la configuración de archivos.

Carga el resultado con un cargador compatible con JSONC y la política de metadatos del catálogo. El proveedor espera un mapa de cadenas; ni una ruta de archivo sin procesar ni una importación JSON convencional completan esa conversión.