Qualify pinned Dear ImGui toolkit for M9.8a
This commit is contained in:
@@ -1,10 +1,14 @@
|
||||
# ADR-0084: Engineering UI toolkit and ownership boundary
|
||||
|
||||
## Status
|
||||
Proposed, 2026-10-02. User authorized evaluating/adopting a maintained framework.
|
||||
Preferred candidate: Dear ImGui for the engineering client only. Adoption requires
|
||||
an exact source pin, licence inventory and Windows/Linux compatibility probe in
|
||||
M9.8a. No dependency has been added by this ADR. Final player UI remains undecided.
|
||||
Accepted for the isolated M9.8a engineering UI probe, 2026-10-02. User delegated
|
||||
UI selection. Dear ImGui 1.92.9b, MIT, upstream commit
|
||||
`f1cc2ae15e53a861a874c3034aae6798fde194ab`; archive SHA-256
|
||||
`21d8a0a565e85dce943e375db00812c2f3f0ab21f3f0f7964e364a63422d7f99`.
|
||||
Published 2026-07-31; upstream latest-release API and tag checked 2026-10-02.
|
||||
Checksum is locally measured over the upstream HTTPS archive, not an independent
|
||||
signature. The pin is in tools/imgui-pin.cmake. Broader application integration
|
||||
follows the probe. Final player UI remains undecided.
|
||||
|
||||
## Context
|
||||
M9.4/M9.5 intentionally used rectangles and unlabelled gauges. M9.8 now requires
|
||||
@@ -12,7 +16,7 @@ readable text, a launcher, dialogs, dismissible notifications, click selection a
|
||||
control rebinding. The existing client uses SDL3 and SDL_Renderer. The headless
|
||||
libraries and immutable biological views must remain toolkit-independent.
|
||||
|
||||
## Decision proposed
|
||||
## Decision
|
||||
Use Dear ImGui's upstream SDL3 platform and SDL_Renderer3 rendering adapters behind
|
||||
the private native client boundary. Implement owned application state for toasts,
|
||||
selection, dialogs and action bindings; do not equate toolkit widget state with
|
||||
@@ -57,12 +61,21 @@ segment, not inferred from this high-level comparison.
|
||||
|
||||
## Consequences
|
||||
Revisits ADR-0081's scoped decision to defer ImGui once labelled engineering UI is
|
||||
needed. M9.8a must change this status to accepted only with the pin and probe evidence.
|
||||
needed. M9.8a records the pin and executed probe evidence in VALIDATION.md.
|
||||
M9.8 delivery is tracked in ../engineering/M9_8_DELIVERY_PLAN.md.
|
||||
|
||||
## Primary-source evidence reviewed 2026-10-02
|
||||
- https://github.com/ocornut/imgui/blob/master/docs/BACKENDS.md — upstream SDL3 and SDL_Renderer3 adapters; platform/render separation.
|
||||
- https://github.com/ocornut/imgui/blob/master/LICENSE.txt — MIT licence; pin-time notice audit still required.
|
||||
- https://github.com/ocornut/imgui/blob/master/LICENSE.txt — MIT licence; notice inventory in third_party/imgui/README.md.
|
||||
- https://github.com/ocornut/imgui/blob/master/docs/FAQ.md — input capture guidance and integration responsibilities.
|
||||
- https://github.com/ocornut/imgui/releases — release/maintenance evidence; no version selected here.
|
||||
- https://github.com/ocornut/imgui/releases — release/maintenance evidence; v1.92.9b selected above.
|
||||
- https://mikke89.github.io/RmlUiDoc/pages/cpp_manual/integrating.html — context and rendering integration requirements for the alternative.
|
||||
|
||||
|
||||
The probe compiles core, draw, tables, widgets and the SDL3/SDL_Renderer3 backends;
|
||||
no demo, docking, multi-viewport, FreeType or external font dependency is introduced.
|
||||
Use the embedded ProggyClean bitmap font explicitly for the probe. Retain LICENSE.txt,
|
||||
docs/FONTS.md, imgui_draw.cpp and the stb headers' embedded notices at
|
||||
packaging. The bundled ProggyForever data also carries notices in imgui_draw.cpp;
|
||||
include the source notice inventory even when that font is not selected.
|
||||
Normal headless/client configuration does not require ImGui until explicitly enabled.
|
||||
|
||||
+1
-1
@@ -96,4 +96,4 @@ design. No unadopted candidate is a link dependency of the proof.
|
||||
- [ADR-0082: Dev session transport](0082-dev-session-transport.md) - TLS 1.3-only Mbed TLS 4.1.1 LTS (pinned, compiled-down), dev-only HMAC grants, versioned bounded protocol v1 and session admission for M9.
|
||||
- [ADR-0083: Dev region sessions](0083-dev-region-sessions.md) - session server in evo-server, durable no-effect intentions on synthetic carriers, empty organism presentation, reconnect with fresh baselines, loopback-only drill-time dev deployment.
|
||||
|
||||
- [ADR-0084: Engineering UI toolkit](0084-engineering-ui-toolkit.md) - proposed Dear ImGui boundary; adoption waits for the exact pin and compatibility probe.
|
||||
- [ADR-0084: Engineering UI toolkit](0084-engineering-ui-toolkit.md) - accepted for the isolated M9.8a Dear ImGui 1.92.9b compatibility probe; application UI follows.
|
||||
|
||||
Reference in New Issue
Block a user