fix(web): show sidebar hints only on the icon rail, above the main area (UF-042)
With the full-width sidebar every item showed a hover hint that repeated its visible label, and the part of the hint that reached past the sidebar was hidden wherever the main area had content: the hint rendered inside the nav, and the nav and <main> are sibling z-10 layers. Sidebar hints now show only on the icon rail below lg, where they are the only label, and render in document.body through a new opt-in `portal` flag on HintTooltip. Other hints keep rendering in place, since several sit in overlays above z-50 where a portaled hint would end up underneath.
This commit is contained in:
@@ -70,6 +70,7 @@ Baseline: commit `b20b138` of `git.os-dev.tech/oleg.m/waggle-os`.
|
||||
| UF-039 | A memory saved to an unknown workspace lands in personal memory | Fixed | Sidecar, memory, privacy |
|
||||
| UF-040 | The support bundle never includes recent installs | Fixed | Sidecar, support |
|
||||
| UF-041 | The CLI server does not exit on Ctrl+C or SIGTERM | Fixed | Sidecar, CLI |
|
||||
| UF-042 | Sidebar hints repeat the visible labels and are partly hidden behind the main area | Fixed | Web UI |
|
||||
|
||||
## Entries
|
||||
|
||||
@@ -415,3 +416,12 @@ Entries UF-010 to UF-019 come from the UI audit `anti-slop/audit-001-2026-10-14.
|
||||
- Cause: the OAuth routes start a cleanup interval when the module loads and never clear or unref it. The service installs SIGTERM and SIGINT handlers, which replace Node's default exit, closes the server, and relies on the event loop going empty; the interval keeps it alive.
|
||||
- What we did: the interval is unref'd. A launcher test checks that the built CLI exits by itself after SIGTERM, and the launcher tests now stop `npx` and the `waggle` process it starts as one process group.
|
||||
- Recommendation: unref housekeeping timers or clear them when the server closes, and consider ending the signal handler with an explicit exit.
|
||||
|
||||
### UF-042. Sidebar hints repeat the visible labels and are partly hidden behind the main area
|
||||
- Status: Fixed
|
||||
- Found: 2026-10-25
|
||||
- Where: at commit `b20b138`, `apps/web/src/components/os/Sidebar.tsx:76-78`, 129, 165, 181, 196 (a `HintTooltip` on every item, unportaled per `apps/web/src/components/ui/tooltip.tsx`), with the sidebar at `Sidebar.tsx:126` and `<main>` at `AppShell.tsx:497`, both `relative z-10`
|
||||
- Symptom: with the full-width sidebar every item shows a hover hint that only repeats its visible label, for example "New Agent" next to the "New Agent" button. The hint is cut off where the main area has content to the right of the sidebar.
|
||||
- Cause: the sidebar shows the same hints at every width, although they are only needed on the icon rail below `lg`, as a code comment already noted. The hint renders inside the nav, and the nav and `<main>` are sibling `z-10` layers, so `<main>`, later in the DOM, paints over the part of the hint that reaches into it.
|
||||
- What we did: sidebar hints show only on the icon rail (`lg:hidden`) and render in `document.body` through a new opt-in `portal` flag on `HintTooltip`, so `<main>` no longer covers them. Other hints are unchanged, because several of them sit inside overlays above `z-50`, where a portaled hint would end up under the overlay. A test checks both properties.
|
||||
- Recommendation: apply the same change in the main project, and review other hints that repeat a visible label.
|
||||
|
||||
Reference in New Issue
Block a user