forked from Blendman974/faceclaw
56 lines
2.8 KiB
Markdown
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.
|