<!-- Generado automáticamente por scripts/generate-docs.mjs. No editar a mano. -->
<!-- Fuente: src/app/componentes/menu/page.tsx -->

# Menu

Una lista de acciones u opciones que aparece al activar un disparador. Mantiene la interfaz compacta y agrupa acciones secundarias relacionadas con el contexto actual.

```tsx
<Popover content={(
  <>
    <Popover.Item><FilePlus size={14} /> Nuevo documento</Popover.Item>
    <Popover.Item><FolderPlus size={14} /> Nueva carpeta</Popover.Item>
  </>
)}>
  <Button>Nuevo</Button>
</Popover>
```

## Default

### Disparador y lista

El menú combina un trigger visible (botón o icono) con una lista flotante de acciones. Se abre con clic, Enter o Espacio y se cierra al elegir una opción, al perder foco o con Esc.

## Secciones

### Grupos y separadores

Cuando el menú agrupa acciones de distinto tipo, usa títulos cortos en mayúsculas pequeñas y separadores entre grupos. Mantén máximo dos o tres secciones por menú.

```tsx
<Popover content={(
  <>
    <Popover.Item title>Crear</Popover.Item>
    <Popover.Item>Documento</Popover.Item>
    <Popover.Item>Carpeta</Popover.Item>
    <Popover.Item line />
    <Popover.Item title>Acciones</Popover.Item>
    <Popover.Item>Duplicar</Popover.Item>
  </>
)}>
  <Button>Más opciones</Button>
</Popover>
```

## Destructiva

### Acciones que no se pueden deshacer

Pon las acciones destructivas al final de la lista, separadas por una línea, y márcalas en rojo. Si la acción es irrecuperable, abre un Modal de confirmación al elegirla.

```tsx
<Popover content={(
  <>
    <Popover.Item>Renombrar</Popover.Item>
    <Popover.Item>Mover</Popover.Item>
    <Popover.Item line />
    <Popover.Item className="text-error">Eliminar</Popover.Item>
  </>
)}>
  <Button>Acciones</Button>
</Popover>
```

## Accesibilidad

### Roles y teclado

- El disparador usa aria-haspopup="menu" y aria-expanded.
- La lista usa role="menu" y cada opción role="menuitem".
- Las flechas arriba y abajo navegan; Enter o Espacio activa; Esc cierra y devuelve el foco al disparador.
- No anides menús a más de un nivel: pasa a un Modal o página dedicada.

