Saltar al contenido principal

REQ-DSG-02 — Borde visible en componentes select

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación del requerimiento REQ-DSG-02 (Borde visible en componentes select), dentro de Diseño y con prioridad Media. Antes, el disparador central de los selects usaba un color de borde fijo (border-gray-400) —no un token del sistema visual— y los <select> nativos dependían del estilo del navegador, así que el contorno del componente no era ni del todo visible ni consistente entre componentes y temas.


📋 Alcance​

Criterio de aceptaciónEntregable
CA1 · El componente central de los selects muestra un borde visible que denota su contornoSelectTrigger (registry/new-york/ui/select.tsx) con border border-select-border
CA2 · La propiedad se aplica a los selects de la aplicaciónRegla global en globals.css sobre select (nativo) y [role="combobox"] (Radix)
CA3 · El estilo es consistente en todos los selectsUn único token --select-border (1 px) alimenta componente y normalización

⚙️ Cómo funciona​

  • Un token, no un color fijo. El borde nace del token semántico --select-border (y --select-border-hover), declarado en app/globals.css y expuesto en tailwind.config.ts como el color select-border. Al ser variable por tema, el contorno se adapta a claro y oscuro sin duplicar estilos.
  • Componente central. El disparador de shadcn/Radix ahora usa border-select-border (reposo) y hover:border-select-border-hover, sustituyendo el border-gray-400 fijo.
  • Cobertura total. La normalización global de selects —que ya unificaba el texto— añade el borde, de modo que también los <select> nativos y cualquier disparador Radix fuera del componente central quedan con el mismo contorno.

🎨 Valores del token​

ModoReposoHover
Claro220 9% 46% (equivale a gray-500, más visible que el gray-400 previo)220 9% 30%
Oscuro215 20% 55%215 20% 72%

🧩 Detalles de implementación​

PiezaRol
registry/new-york/ui/select.tsxBorde del disparador central vía token
app/globals.cssDeclaración de tokens (claro/oscuro) + regla global select / [role="combobox"]
tailwind.config.tsColor select-border (DEFAULT + hover)
design.mdDocumenta el token (§1) y la convención (§7)

Se conserva el borde de énfasis deliberado de «cargar stock» en stock-loading.tsx (border-2 !border-blue-400): es un resaltado intencional, no un select estándar.

🧪 Pruebas​

  • ccf-almacen-web/src/components/__tests__/req-dsg-02-borde-select.test.tsx — 2 casos: el SelectTrigger lleva la clase del token (border-select-border) y globals.css declara los tokens y aplica el borde a select y [role="combobox"].
  • npx tsc --noEmit: limpio salvo un error preexistente en stock-loading.tsx, ajeno a este requerimiento (se comprobó excluyendo ese archivo: 0 errores).

📚 Documentación​