Every registered popup uses one common outer surface.
Matching UI roles use common sections, cards, buttons, toggles, separators, sliders, badges, and text fields.
Controls visibly distinguish hover, press, focus, selected or toggled, and disabled states.
Status is never communicated by color alone.
Cards provide large targets, visible status, and optional secondary detail.
Spacing and common regions provide grouping; dividers separate only unrelated groups.
All UI labels are lowercase.
Tray cards expose all nonempty documented metadata.
Tray left click activates, or opens the menu for menu-only items.
Tray right click opens an available native menu; middle click invokes secondary activation.
The launcher has no decorative bottom stripe.
Audio cards have no exposed left accent sliver.
Constraints
Service APIs remain stable except for specified notification and tray routes.
iwd remains the single Wi-Fi row and write authority.
No lockscreen, bar, palette, or dependency redesign is included.
Bespoke data visualization may remain bespoke.
Shared controls are keyboard accessible and expose appropriate accessibility roles and names.
Acceptance
DND, toast dismissal, Wi-Fi refresh and interaction, and all three tray pointer routes behave as specified.
Every registered popup uses the common surface and matching shared controls.
All popup labels are lowercase.
The full popup test suite and zero-warning lint gate pass.
---
id: NL-SPEC-38AED50A
type: spec
title: Nuguland popup interaction language
---
# Nuguland popup interaction language
Follow-up: [UI/UX repair contract](ux-repair.md) and [repair progress with evidence](repair-progress.md).
## Behavior
- Every registered popup uses one common outer surface.
- Matching UI roles use common sections, cards, buttons, toggles, separators, sliders, badges, and text fields.
- Controls visibly distinguish hover, press, focus, selected or toggled, and disabled states.
- Status is never communicated by color alone.
- Cards provide large targets, visible status, and optional secondary detail.
- Spacing and common regions provide grouping; dividers separate only unrelated groups.
- All UI labels are lowercase.
- Tray cards expose all nonempty documented metadata.
- Tray left click activates, or opens the menu for menu-only items.
- Tray right click opens an available native menu; middle click invokes secondary activation.
- The launcher has no decorative bottom stripe.
- Audio cards have no exposed left accent sliver.
## Constraints
- Service APIs remain stable except for specified notification and tray routes.
- iwd remains the single Wi-Fi row and write authority.
- No lockscreen, bar, palette, or dependency redesign is included.
- Bespoke data visualization may remain bespoke.
- Shared controls are keyboard accessible and expose appropriate accessibility roles and names.
## Acceptance
- DND, toast dismissal, Wi-Fi refresh and interaction, and all three tray pointer routes behave as specified.
- Every registered popup uses the common surface and matching shared controls.
- All popup labels are lowercase.
- The full popup test suite and zero-warning lint gate pass.