Luigit
repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by admin

quickshell/nuguland/.system/specs/NL-SPEC-38AED50A-popup-interaction-language/index.md

Raw
Rendered preview

id: NL-SPEC-38AED50A type: spec title: Nuguland popup interaction language

Nuguland popup interaction language

Visual language: Zen of Nugu. Host/panel lifecycle fields: FeatureEntry.qml.

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.

State and lifecycle

  • Dismissal is not discard. Ordinary search, selection, expansion, scroll and unsent replies live in shell-lifetime memory, not disposable Loader/delegate instances. Reopen and switching restore them; successful completion or explicit clear/discard may clear their own state. Never persist ordinary drafts to disk or blanket-cache credentials/panels. Passwords and authorization state retain their specified security lifetimes. Destructive confirmation cancels on every dismissal/switch.
  • Service state remains reactive after commands; never replace bindings with returned JSON snapshots. Live updates preserve row identity while dragging/editing. Clipboard actions retain filtering; failed replies retain retryable drafts.
  • Explicit activation opens/switches; same-chip activation closes; hover never switches tasks. Escape, outside click and switching share cleanup. Initial focus starts the task; dismissal returns focus. Clipboard paste must release popup focus and establish the captured destination's focus before typing.
  • Pointer and keyboard actions have equal meaning and feedback. Held activation keys never repeatedly dispatch; Tab/Shift+Tab traverse enabled actions, arrows traverse lists/grids, focused actions stay visible. Field padding/icons focus the editor; focused empty fields retain hints. Sliders preserve bindings and thumb geometry throughout dragging. Tooltips never reveal credentials. Authentication traversal never continuously steals focus; tests use isolated synthetic requests, never real authentication.
  • Async work exposes pending/success/actionable failure without fabricated completion. Unsupported capabilities are absent, not disabled explanations; transiently unavailable controls follow the zen. Long content remains reachable by scrolling/disclosure.

Constraints

  • Public IPC and owner-approved API cleanup follow SYSTEM and NL-SPEC-86A037A0; panels use typed service intents.
  • 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.

Verification obligations

Changed flows require pointer/keyboard exactly-once writes and disabled rejection; retained edits/selection across close/reopen/switch; external updates after local commands; pending/failure/empty/long-content states; reviewed pixels at tested geometry and complete logs. Do not credit unrelated shared-control or feature suites with unexercised behavior. Broad repair completion requires unresolved inventory to be fixed or explicitly reconciled with the owner, not merely passing demonstration suites. The recorded live-service and hardware gaps remain open: vault authentication/MFA/re-prompt, wireless/Bluetooth, audio routes/profiles, real media/CalDAV/speech, backend-dependent action variants and physical multi-output/hotplug. The old DDC implementation gap is separately closed by recorded owner review; the deleted screenshot-helper popup is retired, not an outstanding repair. Historical evidence links with no retained targets establish no proof; no missing evidence is represented as a pass.

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

Visual language: [Zen of Nugu](../NL-SPEC-VQXGUHYK-zen-of-nugu/index.md).
Host/panel lifecycle fields: [FeatureEntry.qml](../../../FeatureEntry.qml).

## 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.

## State and lifecycle

- Dismissal is not discard.
  Ordinary search, selection, expansion, scroll and unsent replies live in shell-lifetime memory, not disposable Loader/delegate instances.
  Reopen and switching restore them; successful completion or explicit clear/discard may clear their own state.
  Never persist ordinary drafts to disk or blanket-cache credentials/panels.
  Passwords and authorization state retain their specified security lifetimes.
  Destructive confirmation cancels on every dismissal/switch.
- Service state remains reactive after commands; never replace bindings with returned JSON snapshots.
  Live updates preserve row identity while dragging/editing.
  Clipboard actions retain filtering; failed replies retain retryable drafts.
- Explicit activation opens/switches; same-chip activation closes; hover never switches tasks.
  Escape, outside click and switching share cleanup.
  Initial focus starts the task; dismissal returns focus.
  Clipboard paste must release popup focus and establish the captured destination's focus before typing.
- Pointer and keyboard actions have equal meaning and feedback.
  Held activation keys never repeatedly dispatch; Tab/Shift+Tab traverse enabled actions, arrows traverse lists/grids, focused actions stay visible.
  Field padding/icons focus the editor; focused empty fields retain hints.
  Sliders preserve bindings and thumb geometry throughout dragging.
  Tooltips never reveal credentials.
  Authentication traversal never continuously steals focus; tests use isolated synthetic requests, never real authentication.
- Async work exposes pending/success/actionable failure without fabricated completion.
  Unsupported capabilities are absent, not disabled explanations; transiently unavailable controls follow the zen.
  Long content remains reachable by scrolling/disclosure.

## Constraints

- Public IPC and owner-approved API cleanup follow SYSTEM and `NL-SPEC-86A037A0`; panels use typed service intents.
- 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.

## Verification obligations

Changed flows require pointer/keyboard exactly-once writes and disabled rejection; retained edits/selection across close/reopen/switch; external updates after local commands; pending/failure/empty/long-content states; reviewed pixels at tested geometry and complete logs.
Do not credit unrelated shared-control or feature suites with unexercised behavior.
Broad repair completion requires unresolved inventory to be fixed or explicitly reconciled with the owner, not merely passing demonstration suites.
The recorded live-service and hardware gaps remain open: vault authentication/MFA/re-prompt, wireless/Bluetooth, audio routes/profiles, real media/CalDAV/speech, backend-dependent action variants and physical multi-output/hotplug.
The old DDC implementation gap is separately closed by recorded owner review; the deleted screenshot-helper popup is retired, not an outstanding repair.
Historical evidence links with no retained targets establish no proof; no missing evidence is represented as a pass.

## 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.