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

71 lines
3.7 KiB
Markdown

# Notification focus and selected-label readability
Feature branch: `feat/notification-focus-marquee`.
## Notification backdrop
Notification popups hide the whole glasses interface only when the notification
arrived with the screen off and woke it. If the screen was already on, the usual
overlay keeps the app and chrome visible behind the box. This arrival-time choice
is preserved per queued notification, separately from the existing inherited
return-to-sleep state. For wake popups the shell omits lower chrome layers. 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.
## Wake-only backdrop correction
- A screen-off arrival masks app/chrome; an already-on arrival preserves them.
- Queued arrivals preserve their own mask flag, while the original wake still
restores sleep after the last popup. Closing a popup does not close its app.
- RED: the new overlay and queue assertions failed before implementation.
- GREEN: all 24 focused queue/backdrop/menu display-list tests passed.
- Full standalone suite: 1,235 tests, 1,230 passed, 2 known onboarding failures,
3 skipped. No new failures. TypeScript and lint passed.
- Combined build: 1,332 tests, 1,329 passed, 0 failed, 3 skipped; TypeScript and
lint passed. Independent review found no blocking issues.
## 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.