Arnés de pruebas — utilidades de Radix y taxonomía del blog al día
Dos ajustes que salieron de escribir las suites de veterinaria: los detalles del entorno de Radix dejan de repetirse en cada archivo de pruebas, y la taxonomía del blog vuelve a pasar su verificador, que llevaba doce avisos acumulados.
1. Utilidades de prueba compartidas
Nuevo módulo ccf-almacen-web/src/test-utils/radix.ts, usado ya por las suites de
Agenda y de Clientes y mascotas:
| Utilidad | Qué resuelve |
|---|---|
anularFocoProgramatico() | El ciclo de FocusScope entre diálogo y Select en jsdom (dos copias del paquete que se reenfocan mutuamente hasta desbordar la pila) |
abrirPestana(nombre) | Radix activa la pestaña en mouseDown; dispara el gesto y espera a data-state="active" |
elegirEnCombo(modal, indice, nombre) y combo(...) | Abrir un Select y elegir una opción del portal |
campo(id) y elementosConAncla(ancla) | Acceso a los formularios y a los anclajes data-tour |
Antes, el bloqueo del foco programático vivía copiado en cada suite, con el mismo comentario. Ahora el motivo está escrito una sola vez y la próxima pantalla del módulo lo hereda sin redescubrirlo.
Estas utilidades no sustituyen a las pruebas de accesibilidad: la navegación por teclado necesita foco real y se valida con Playwright (ADR-009).
2. Taxonomía del blog
npm run verificar:etiquetas volvía con 12 problemas: posts que usaban
etiquetas no declaradas o variantes de una ya existente (POS frente a pos,
menú frente a menu, panel lateral frente a panel-lateral).
- Seis etiquetas nuevas declaradas en
blog/tags.yml:REQ-DOC-02,TEC-010,TEC-016,estadisticas,offline,panel-lateral,pwa,service-workeryv2-3, con sulabelen la grafía correcta y supermalink. - Tres posts corregidos para usar la clave existente:
2026-11-06-almacenes-formulario-completo(POS→pos),2026-11-11-menu-solicitudes-listado(menú→menu,panel lateral→panel-lateral) y2026-11-11-tooltip-solicitudes-se-cierra(panel lateral→panel-lateral), además de2026-11-11-sala-de-continuidad(PWA→pwa). - Resultado:
Taxonomía del blog correcta: 247 etiquetas en uso, 249 declaradas, 2 autores. Solo quedan dos declaradas sin uso (docusaurus,tecnologia), que el verificador informa y no consideran error.
Cómo verificarlo
cd ccf-almacen-web
npx jest src/components/__tests__/veterinaria-agenda.test.tsx src/components/__tests__/veterinaria-pacientes.test.tsx
# Tests: 94 passed, 94 total
cd ../ccf-almacen-wiki
npm run verificar:etiquetas
# Taxonomía del blog correcta
npx tsc --noEmit y npx eslint siguen limpios en el web.
Archivos clave
ccf-almacen-web/src/test-utils/radix.ts— utilidades nuevas.ccf-almacen-web/src/components/__tests__/veterinaria-agenda.test.tsxyveterinaria-pacientes.test.tsx— usan las utilidades (sin los bloques copiados).ccf-almacen-wiki/blog/tags.yml— etiquetas declaradas.ccf-almacen-wiki/blog/2026-11-06-almacenes-formulario-completo.md,2026-11-11-menu-solicitudes-listado.md,2026-11-11-tooltip-solicitudes-se-cierra.md,2026-11-11-sala-de-continuidad.md— claves corregidas.
