# Sistema de diseño institucional

Este documento define los componentes visuales y de interacción del sistema educativo. Las vistas nuevas deben utilizar estos componentes y las vistas existentes se migran mediante los componentes compartidos.

## Principios

- Una acción primaria por bloque; las demás son secundarias o de bajo énfasis.
- Rojo se reserva para acciones destructivas y errores.
- Ámbar comunica advertencias o decisiones pendientes.
- Verde comunica éxito o vigencia, nunca una acción principal.
- Todo control debe funcionar con teclado, tener nombre accesible y foco visible.
- Los textos de botones describen la acción: “Guardar cambios”, no “Aceptar”.

## Componentes Blade

- `x-ui.button`: variantes `primary`, `secondary`, `danger`, `warning` y `ghost`; tamaños `sm`, `md`, `lg`.
- `x-ui.field`: etiqueta, ayuda, obligatoriedad y error de validación.
- `x-ui.table`: región desplazable y accesible para tablas operativas.
- `x-ui.badge`: estados `neutral`, `success`, `warning`, `danger` e `info`.
- `x-ui.alert`: mensajes accesibles de éxito, error, advertencia e información.
- `x-ui.tabs`, `x-ui.tab` y `x-ui.tab-panel`: navegación por pestañas con teclado.
- `x-ui.empty`: pantalla vacía con explicación y acción opcional.
- `x-ui.skeleton`: indicador de carga sin bloquear lectores de pantalla.
- `x-ui.icon`: iconografía institucional consistente.
- `x-modal`: diálogo adaptable, foco contenido y retorno al disparador.

## Confirmaciones y cargas

Agrega `data-confirm="Mensaje claro"` al formulario, enlace o botón que necesite confirmación. El diálogo institucional reemplaza `window.confirm`.

Todos los formularios evitan el doble envío, publican `aria-busy`, muestran la barra superior de progreso y anuncian “Procesando solicitud”.

## Ejemplo

```blade
<x-ui.field name="nombre" label="Nombre completo" required>
    <input id="nombre" name="nombre" class="ui-control" required>
</x-ui.field>

<x-ui.button type="submit">Guardar cambios</x-ui.button>
<x-ui.button variant="danger" data-confirm="¿Confirmas eliminar el registro?">Eliminar</x-ui.button>
```

## Criterios de aceptación

- No usar `window.confirm`, `alert()` ni colores hexadecimales aislados en vistas nuevas.
- No crear botones sin `ui-button` o `x-ui.button`.
- Toda tabla debe usar `x-ui.table` o permitir la mejora automática global.
- Todo estado debe expresarse con texto además del color.
- Toda operación sin resultados debe mostrar `x-ui.empty`.
- Cargas asíncronas deben usar `x-ui.skeleton` y una región de estado.
