Guías
Cuando algo falla
Empieza por npx verbaly doctor. Inspecciona el setup entero e imprime el arreglo exacto al lado de cada hallazgo, así que casi toda esta página es lo que te habría dicho él.
El comando verbaly no existe
El comando vive en @verbaly/compiler. Los plugins dependen de él, pero un gestor de paquetes solo enlaza el comando de un paquete que instalaste tú, así que no basta con que un plugin se lo traiga. Añádelo a tus dependencias de desarrollo:
Apareció un idioma que yo nunca pedí
Si no listas locales, cada fichero JSON de tu carpeta de catálogos cuenta como un idioma, así que uno que dejó una ejecución anterior también lo es, y el build empieza a pedir sus traducciones. Lista tus idiomas y la lista queda completa:
wrap reportó ficheros que no escribió
Un fichero donde t no está disponible se lista y se deja intacto, porque envolver texto ahí dejaría tu proyecto sin compilar. El informe dice cuántos textos esperan en cada uno y si es un componente de cliente, para que sepas qué línea añadir. Añádela y vuelve a ejecutarlo.
El build dice que una traducción está rota
No falta, está rota: la traducción existe y no puede renderizar lo que renderiza su fuente. Perdió un {valor}, se dejó un caso del plural o cambió una etiqueta. Ejecuta npx verbaly check para ver el motivo exacto de cada mensaje. failOnMissing: false no las silencia a propósito, porque renderizan mal.
Sale una key en pantalla en vez del texto
Un mensaje que no resuelve en ningún sitio se renderiza como su propia key. Normalmente el catálogo de ese idioma todavía no ha llegado, o el grupo es uno que excluiste del navegador con bundle.exclude y algo lo pide en runtime. El build avisa del segundo caso por su nombre.
Mis keys no están tipadas, o los tipos están viejos
Los tipos los genera extract desde tu catálogo fuente, así que son tan viejos como tu última ejecución. Si tu editor no los ve en absoluto, comprueba que el fichero generado está dentro de tu tsconfig, o apunta dts a un sitio donde lo esté.
No se puede importar t desde verbaly
Ningún paquete exporta t. Sale del módulo propio de tu proyecto, virtual:verbaly, o del hook de tu framework. doctor reporta este como error porque ningún bundler puede resolverlo.