fix(client): stabilize HUD and anchor draggable panels
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (network) (push) Successful in 5s
Foundation / checks (postgres) (push) Successful in 4s
Foundation / checks (tsan) (push) Successful in 4s
Foundation / checks (deploy) (push) Successful in 4m29s
Foundation / postgres-tools (push) Successful in 20s
Foundation / server-image (push) Canceled after 1m43s
Foundation / image (push) Canceled after 1m43s

This commit is contained in:
dingo
2026-10-26 15:13:15 -04:00
parent 840816c541
commit d057374148
9 changed files with 334 additions and 31 deletions
+8
View File
@@ -1,5 +1,13 @@
# Project status and next steps
## Stable and movable cellular panels - 2026-10-26
The client HUD now uses stable card dimensions and scrolling content, keeping
headings and action buttons fixed as live messages change. Field notes, Vitals
and Nearby have a dedicated drag handle, session anchoring, viewport clamping
and double-click position reset. See [controls](engineering/CLIENT_VISUAL_REFRESH.md)
and [executed validation](engineering/VALIDATION.md). No biological or wire rule changed.
## DEV startup wildlife and Bud controls - 2026-10-26
[ADR-0180](adr/0180-dev-starting-wildlife.md) implements opt-in, nursery-funded
+15
View File
@@ -131,3 +131,18 @@ at 13 px.
- **Applying it.** The scale goes to ImGui's `FontScaleMain` and to `ScaleAllSizes`,
taken from the unscaled style. Panel sizes are given in logical units at that scale.
Movable panels return to their default place and size once, at each new scale.
## Amendment (2026-10-26): stable, anchored cellular HUD cards
At the maintainer's request, Field notes, Vitals and Nearby use a distinct drag
handle beside minimize. Client-session normalized positions remain anchored on
release, including through viewport/UI-scale changes, and clamp inside the new
viewport. Double-clicking the handle resets its position. This supersedes the
scale-reset behavior above for these three cards; no layout is saved to disk.
Their expanded outer sizes and the action dock size depend only on viewport and
UI scale. Scrollable bodies reserve scrollbar gutters and wrap live text; the
headings and action buttons stay outside those bodies. Thus temporary text and
scrollbar thresholds cannot resize/reposition the outer panels. This reuses the
pinned toolkit and existing pointer-capture boundary; biological authority,
protocols, dependencies and headless APIs are unchanged.
+9
View File
@@ -117,3 +117,12 @@ uses the current server-projected charge, including the inherited plan and fee.
Insufficient funding disables it, with a hover tooltip listing required and held
energy, carbon, nitrogen, phosphorus and other matter. Internal-cell litter shows
the maximum possible charge. The server remains authoritative at execution time.
The cellular HUD cards use client-owned session placement in `FormBuffers`.
Only each heading's drag handle moves its card; normalized anchors are retained
through redraws, collapse/restore and viewport/scale changes, with on-screen
clamping and a double-click reset. Fixed outer dimensions and scrollable bodies
with reserved gutters prevent live text from feeding back into panel geometry.
The action dock's button row stays outside its scrolling details. This state is
presentation-only and is neither persisted nor sent to the server; see the
[visual refresh controls](../engineering/CLIENT_VISUAL_REFRESH.md).
+14 -3
View File
@@ -37,9 +37,20 @@ violet for budding. Labels and authoritative enable/disable logic remain intact;
color alone does not communicate affordability or success. Existing bindings
remain authoritative; decorative shortcut numbers are not invented.
Field notes, Vitals and Nearby have explicit minus/plus buttons. Collapsing
Vitals retains energy. State lasts for the client session; it is not saved.
The responsive compact layout keeps the dock and map within the viewport.
Field notes, Vitals and Nearby have explicit minus/plus buttons and a separate
`::` drag handle. Drag the handle to place a card; releasing anchors its position.
Double-click the handle to restore the responsive default. Collapsing Vitals
retains energy. Placement and collapse state last for the client session and are
not saved to disk. Anchors use normalized viewport coordinates and are clamped
inside the window when it is resized or the UI scale changes.
Expanded card sizes depend on viewport/scale, not the current text. Overflow
scrolls inside a body with a reserved vertical scrollbar gutter; headings stay
fixed and long text wraps at the body width. Minimize/restore intentionally
changes a card's height. The action dock likewise keeps its buttons fixed above
a scrollable details area. Changing nutrient values, growth warnings, pending
results, region-edge notices and stale observations cannot resize or re-anchor
these panels. The responsive compact layout keeps the dock and map within the viewport.
Nearby is a camera-centred observation map with a fixed six-millimetre radius.
It reads the received food and organism views only, including observations
+44
View File
@@ -10249,3 +10249,47 @@ Publication limit: the scoped commit was created locally, but the configured HTT
remote rejected git push with an authentication failure. Git Credential Manager
is configured; no stored credential was deleted or changed. A user-authorized retry uses credentials supplied outside the repository. Unrelated drafts and untracked files
remain outside the commit.
## 2026-10-26 - Stable HUD geometry and anchored panel dragging
Scope: apps/evo-client panel drawing/state and native panel regression, with the
ADR-0084 presentation amendment. No simulation, server, wire, dependency or
persistent-settings format changed. Unrelated drafts and untracked work remain
untouched.
Executed:
- GCC 14.2 Release/NDEBUG in the existing release-preset build/playtest-release:
rebuilt evo-client, panel and UI-model targets; client CTests excluding the
panel test passed 9/9. The final production panel executable passed separately
with SDL_VIDEO_DRIVER=dummy, SDL_RENDER_DRIVER=software and review output in
ignored build/hud-review. Earlier panel CTest runs also passed during iteration.
- MSVC 19.44: tools/windows-check.ps1 -Preset client -Action check passed; all
10/10 client CTests passed with TMP/TEMP in ignored build/playtest-windows-tmp.
- Clang 19 analysis-preset build/playtest-analysis: rebuilt evo-client and its
panel regression with clang-tidy and warnings as errors; build passed.
- Clang 19 ASan+UBSan, existing asan-preset build/client-asan: rebuilt the final
native panel test and its production panels; focused CTest passed 1/1.
- Repository format-check passed with clang-format 19, including a dry run of
the changed app header through the same formatter; git diff --check passed.
- Native coverage at 640x480, 960x640 and 1280x800 changes diagnostics/membership,
growth warnings, sunlight, edge/stale/census text and expanded notes on each
of 16 consecutive frames. Outer position/size and child content width must
remain identical, with zero horizontal overflow. Action details exercise both
fitting and vertically overflowing content without changing the button row.
- Real SDL pointer events drag all three card handles, release and retain their
anchors, minimize/restore a moved card, resize the viewport, drag far outside
bounds and double-click the reset handle. Bounds and pointer capture prevent
world clicks. Existing Bud/tooltip, evolution, death/restart and panel capture
checks remain in the same native regression.
- Generated native BMPs for normal, overflowing and moved panels in
build/hud-review. Reviewed PNG conversions at 640x480, 960x640 and 1280x800.
The first review showed the nutrient legend breaking a word in its narrower
scrolling body; a tighter two-column legend with unwrapped names fixed it,
followed by the final Release, Windows, analysis and sanitizer checks above.
Limits: positions/collapse state are client-session preferences, not saved across
application restarts. Hardware DPI, accessibility, touch interaction and motion
comfort still need interactive review. No deployment, live session, World0 change,
reset or prune occurred. The required pre-push session-window refresh is desired
Git configuration only.