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