Files
faceclaw/docs/validation-notification-focus-marquee.md
T

56 lines
2.8 KiB
Markdown

# Notification focus and selected-label readability
Feature branch: `feat/notification-focus-marquee`.
## Notification backdrop
Notification popups hide the whole glasses interface, not only the small box.
The shell does not repaint lower chrome layers while the popup is visible. The
box is an opaque cropped image below the firmware's 64 KiB resource limit;
resource-free retained CLEAR calls black out its outside margins over separate
app surfaces. No oversized full-screen image is uploaded. The notification's
contents and retained inner selection animations remain visible. Closing the
modal restores the existing interface; apps are not closed. The mask follows
display-size and window-band changes rather than assuming G2 dimensions.
Automated coverage crosses the real shell scene encoder and presentation replay,
checking external app pixels, chrome, margins, resource bounds, content, dismissal
restoration, resizing, band position and retained selection order.
## Selected menu labels
Common menu rows, submenu labels, toggle labels, right-value labels and Settings
panel section/option labels scroll when selected, focused and too wide. A reading
pass pauses for 900 ms, moves at approximately 30 pixels/second at Normal animation
speed, pauses at the end, returns, then stays still. Reselecting or changing the
label/geometry restarts the pass. No JavaScript frame timers are used.
The label is clipped to the available space; right-side values, arrows and toggles
stay fixed. Disabled menu animations use a static clipped fallback. Oversized
labels requiring more than 32 bounded image tiles also use the static fallback.
Custom application renderers that draw text directly are not automatically covered.
## Test baseline
The unmodified source branch at `b4a2b293` was tested separately with `npm test`:
1,218 tests, 1,213 passed, 2 failed, 3 skipped. Both existing failures are in
`tests/onboarding-devices.test.cjs`: its expectations still include the RayNeo iO
picker entry that upstream intentionally hid. Keep this independent feature free
of unrelated onboarding changes. The combined build integration updates those
assertions to the actual upstream UI.
## Feature validation
- Full standalone suite: 1,233 tests, 1,228 passed, 2 failed, 3 skipped. The only
failures are the same two independently reproduced onboarding baseline failures.
- New behavioral tests: 11 marquee tests and 4 production-encoding notification
backdrop tests passed.
- Existing menu display-list regression suite: 11 passed.
- TypeScript (`tsc --noEmit`) and lint passed; existing lint warnings remain.
## Hardware limitation
No phone, glasses or ring is attached to this development environment. No firmware
is flashed and no APK is installed. Automated renderer tests cannot establish
physical-glasses performance or perceived animation smoothness.