feat(D.2b): vitals numbers as UiText (widget-generalization Task 8)

The vitals cur/max numbers now render through the generic UiText widget — retail
gmVitalsUI uses UIElement_Text for them, not a meter-internal label. VitalsController
attaches a centered, non-interactive UiText child to each meter and stops the meter
drawing its own label (UiMeter.Label -> null). New UiText.Centered draws the first line
centered H+V with the SAME formula UiMeter's overlay used, so the numbers are
pixel-identical — user-confirmed in the live client.

This completes the D.2b widget-generalization pass: every chat + vitals widget is now
built generically and registered to its retail Type (Button/Field*/Menu/Meter/Scrollbar/
Text), with thin find-by-id controllers. (*Field is controller-placed; Type 3 stays
UiDatElement for chrome.)

Divergence register: AP-37 vitals-numbers-via-UiMeter.Label clause retired. Full suite:
404 passed, 2 skipped, 0 failed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/architecture/retail-divergence-register.md

@@ -134,7 +134,7 @@ accepted-divergence entries (#96, #49, #50).
 | AP-34 | Landscape-stage alpha deferral is a TWO-PHASE slice split (statics-early / dynamics+particles+weather-late around the **#124** look-ins) + outdoor-root attached scene emitters moved to the post-frame pass, not retail's single deferred alpha flush. Residual: building exteriors' / outside-stage dynamics' own translucent MESH batches still draw within their stage draw call (before later stage content) | `src/AcDream.App/Rendering/RetailPViewRenderer.cs` (`DrawLandscapeThroughOutsideView` late loop) + `GameWindow` post-frame Scene pass | The MDI dispatcher draws translucency inside each Draw call; a faithful FlushAlphaList port needs a global deferred alpha list across all landscape draws — the split covers the user-visible cases (#131 portal swirl, #132 candle flame indoors + outdoors) | Translucent landscape content drawn early and screen-overlapped by content drawn later in the stage gets overpainted (no depth self-protection) — the portal-swirl/candle-flame class re-appears in the residual configurations | `D3DPolyRender::FlushAlphaList` (DrawCells pc:432722) |
 | AP-36 | Dungeon streaming gate triggers on the player's CURRENT cell being a sealed EnvCell (`CurrCell.IsEnv && !SeenOutside`), an approximation of ACE's full landblock `IsDungeon` (all-heights-zero + NumCells>0 + Buildings.Count==0). The retail BEHAVIOR (a dungeon loads no adjacent landblocks) is faithful — only the runtime TRIGGER is the cheap cell predicate instead of classifying the center landblock. **#135 pre-collapse:** at login/teleport the same collapse is triggered EARLY (the instant the streaming center is recentered onto the spawn/dest cell) via `IsSealedDungeonCell` reading the EnvCell **dat** `SeenOutside` flag — because the physics `CurrCell` is null until placement, which waits for hydration; without the early trigger the full 25×25 ocean-grid window loads then unloads (the ~30 s login FPS ramp) | `src/AcDream.App/Rendering/GameWindow.cs:6895` (per-frame predicate) + `:IsSealedDungeonCell` + `:OnLiveEntitySpawnedLocked`/`:OnLivePositionUpdated` (login/teleport pre-collapse hooks) + `src/AcDream.App/Streaming/StreamingController.cs` (collapse/expand/`PreCollapseToDungeon`) | The predicate is already computed for sun/sky gating (playerInsideCell) and exactly matches for sealed dungeons vs windowed building interiors (SeenOutside=true → not gated); no landblock re-classification needed. The dat-flag read is the same `EnvCellFlags.SeenOutside` the hydrated `ObjCell.SeenOutside` is built from (`EnvCell.cs:72`/`PhysicsDataCache.cs:224`), so the pre-collapse decision matches the eventual per-frame gate exactly | A dungeon cell that reports SeenOutside (an entrance cell open to the surface) briefly un-collapses and re-streams the window; a hypothetical windowless building back-room (IsEnv && !SeenOutside but HasBuildings) would wrongly collapse its outdoor neighbors; a sealed-dungeon entrance cell that is itself SeenOutside is simply MISSED by the early trigger and falls back to the existing late collapse (no worse than before #135) | ACE `LandblockManager.GetAdjacentIDs` (dungeons→empty) Landblock.cs:577-582; `IsDungeon` Landblock.cs:1264-1277 |
 | AP-35 | Point/spot lights use a single PER-PIXEL accumulation that ports `calc_point_light`'s `(1 − dist/falloff_eff)` LINEAR ramp (falloff_eff = Falloff × static_light_factor 1.3) + standard Lambert `N·L`; retail's path is PER-VERTEX Gouraud and additionally applies a half-Lambert wrap (`0.5·dist + N·L_vec`, lights surfaces down to `N·L ≥ −0.5`) and an x87-obscured normalization factor, neither ported | `src/AcDream.App/Rendering/Shaders/mesh_modern.frag:52` (+ `mesh.frag`; `LightInfoLoader.cs:81` folds 1.3 into Range) | The linear ramp is the user-visible fix (kills the hard-disc "spotlight" edge, #133 A7); the dropped wrap/normalization only re-shade the gradient slightly, and per-pixel vs per-vertex Gouraud chiefly differs on coarse geometry. Half-Lambert wrap + factor are an x87-decompile refinement (same artifact class as GetPowerBarLevel AP-24) | Surfaces facing slightly away from a torch (`−0.5 ≤ N·L < 0`) stay dark where retail's wrap lights them faintly; near-light gradient shading differs subtly from retail's per-vertex bake | `calc_point_light` 0x0059c8b0 (line 0x0059c9a2 ramp; 0x0059c925 wrap); static_light_factor 0x00820e24 |
-| AP-37 | LayoutDesc importer collapses the dat's nested meter structure (Type-7 meter → two Type-3 container children → three Type-3 image-slice grandchildren each) into `UiMeter`'s programmatic 3-slice fields (`BackLeft..FrontRight`) + reuses `UiMeter.DrawHBar`'s scissor-fill, instead of building those child nodes generically and porting `UIElement_Meter::DrawChildren`. Vitals number elements are meter children (not recursed) and continue to render via `UiMeter.Label` bound by the controller (Task 8). The inheritance `Merge` treats Width/Height==0 as "inherit from base", diverging from format-doc §12 rule 2 (documented inline in `ElementReader.cs`) | `src/AcDream.App/UI/Layout/DatWidgetFactory.cs` (`BuildMeter`/`SliceIds`) + `src/AcDream.App/UI/Layout/LayoutImporter.cs` (`BuildWidget` meter-child skip) | Reuses the tested `UiMeter` render that already visually matches retail's stacked vitals bars; the full nested-element + `DrawChildren` scissor port is deferred to Plan 2. Locked by the conformance fixture (`tests/AcDream.App.Tests/UI/Layout/fixtures/vitals_2100006C.json`) | A LayoutDesc whose meter structure differs from the vitals 2-container/3-slice shape renders an empty/wrong meter — no oracle diff until the Plan-2 port lands | `UIElement_Meter::DrawChildren` @0x46fbd0; `docs/research/2026-06-15-layoutdesc-format.md` |
+| AP-37 | LayoutDesc importer collapses the dat's nested meter structure (Type-7 meter → two Type-3 container children → three Type-3 image-slice grandchildren each) into `UiMeter`'s programmatic 3-slice fields (`BackLeft..FrontRight`) + reuses `UiMeter.DrawHBar`'s scissor-fill, instead of building those child nodes generically and porting `UIElement_Meter::DrawChildren`. Vitals number elements are meter children (not recursed); `VitalsController` attaches a centered `UiText` child for the cur/max number (Task 8 landed — retail `gmVitalsUI` uses `UIElement_Text`), so `UiMeter.Label` is no longer used for vitals (`UiText.Centered` reuses the meter's former centering formula → pixel-identical, user-confirmed). The inheritance `Merge` treats Width/Height==0 as "inherit from base", diverging from format-doc §12 rule 2 (documented inline in `ElementReader.cs`) | `src/AcDream.App/UI/Layout/DatWidgetFactory.cs` (`BuildMeter`/`SliceIds`) + `src/AcDream.App/UI/Layout/LayoutImporter.cs` (`BuildWidget` meter-child skip) | Reuses the tested `UiMeter` render that already visually matches retail's stacked vitals bars; the full nested-element + `DrawChildren` scissor port is deferred to Plan 2. Locked by the conformance fixture (`tests/AcDream.App.Tests/UI/Layout/fixtures/vitals_2100006C.json`) | A LayoutDesc whose meter structure differs from the vitals 2-container/3-slice shape renders an empty/wrong meter — no oracle diff until the Plan-2 port lands | `UIElement_Meter::DrawChildren` @0x46fbd0; `docs/research/2026-06-15-layoutdesc-format.md` |
 | AP-38 | Chat transcript renders pre-split `ChatLog` lines 1:1; no in-element word-wrap at the panel's current pixel width | `src/AcDream.App/UI/UiText.cs` | Retail does in-element wrap via `UIElement_Text::SizeToFit`; our pre-split lines are always shorter than 440 px in practice; a line that overflows clips at the edge rather than wrapping | Very long server system messages (server shutdowns, broadcast announcements) clip rather than wrapping — no information loss, just visual truncation | `UIElement_Text::SizeToFit` @0x467980; `gmMainChatUI` layout |
 | AP-39 | Chat lines carry one color per `ChatKind` (per-line solid color); retail `UIElement_Text` supports per-glyph styled runs (bold, different hue per segment) | `src/AcDream.App/UI/UiText.cs:13` | Retail glyph-run parsing lives inside keystone.dll with no PDB/decomp; per-line per-kind coloring is the correct tonal palette and covers all existing chat types | Chat lines retail renders with multiple colors or bold names (e.g. "PlayerName says: text") render as one flat color; subtle visual difference but functionally complete | `UIElement_Text` glyph-run styling (keystone.dll, no decomp) |
 | AP-40 | Single default translucency for the chat window chrome; no focused/unfocused opacity transition; dat font face/size taken from the vitals `vitalsDatFont` (same dat font, not a chat-specific size lookup) | `src/AcDream.App/Rendering/GameWindow.cs` (chatController binding line) | Retail fades the chat window to ~80% alpha when unfocused (`gmMainChatUI::UpdateAlpha @0x4cdea0`); the opacity animation deferred to the Plan-2 window-manager input integration; sharing `vitalsDatFont` is safe — retail uses the same AC-default font for both | The chat window is always fully opaque/same-font rather than subtly fading when idle; no wrong text, but the focused/unfocused breathing rhythm is absent | `gmMainChatUI::UpdateAlpha` @0x4cdea0; `UCF::SetAceFont @0x4d3940` |

src/AcDream.App/UI/Layout/VitalsController.cs

@@ -1,4 +1,6 @@
 using System;
+using System.Numerics;
+using AcDream.App.UI;
 
 namespace AcDream.App.UI.Layout;
 
@@ -53,16 +55,44 @@ public static class VitalsController
         BindMeter(layout, Mana,    manaPct,    manaText);
     }
 
+    /// <summary>White cur/max numbers — matches the former <c>UiMeter.LabelColor</c> default.</summary>
+    private static readonly Vector4 NumberColor = new(1f, 1f, 1f, 1f);
+
     private static void BindMeter(
         ImportedLayout layout, uint id,
         Func<float>  pct,
         Func<string> text)
     {
-        if (layout.FindElement(id) is UiMeter m)
+        // Silently skip if the id is absent — missing meters are not an error (partial layouts).
+        if (layout.FindElement(id) is not UiMeter m) return;
+
+        m.Fill = () => pct();
+
+        // Retail gmVitalsUI renders the cur/max as a real UIElement_Text centered over the
+        // bar — NOT a meter-internal label. Attach a centered UiText (non-interactive
+        // decoration) that fills + stretches with the meter, and stop the meter drawing its
+        // own label. UiText.Centered uses the SAME centering formula the meter's overlay did,
+        // so the numbers stay pixel-identical (locked by the visual gate).
+        m.Label = () => null;
+
+        var number = new UiText
         {
-            m.Fill  = () => pct();
+            Left = 0f, Top = 0f, Width = m.Width, Height = m.Height,
-            m.Label = () => text();
+            Anchors = AnchorEdges.Left | AnchorEdges.Top | AnchorEdges.Right | AnchorEdges.Bottom,
-        }
+            Centered = true,
-        // Silently skip if the id is absent — missing meters are not an error.
+            DatFont  = m.DatFont,        // the same dat font the meter used for its label
+            ClickThrough = true,         // decoration: no focus / selection / drag
+            AcceptsFocus = false,
+            IsEditControl = false,
+            CapturesPointerDrag = false,
+            LinesProvider = () =>
+            {
+                var s = text();
+                return string.IsNullOrEmpty(s)
+                    ? Array.Empty<UiText.Line>()
+                    : new[] { new UiText.Line(s, NumberColor) };
+            },
+        };
+        m.AddChild(number);
     }
 }

src/AcDream.App/UI/UiText.cs

@@ -63,6 +63,14 @@ public sealed class UiText : UiElement
     /// <summary>Inner text inset from the view edges, px.</summary>
     public float Padding { get; set; } = 4f;
 
+    /// <summary>Static centered single-line mode (retail <c>UIElement_Text</c> center
+    /// justification): draws the FIRST line centered horizontally AND vertically in the
+    /// element rect, with NO scroll/selection machinery. Used for static labels such as
+    /// the vitals cur/max numbers. The centering formula is IDENTICAL to
+    /// <see cref="UiMeter"/>'s former number overlay so those numbers stay pixel-identical
+    /// after the rewire. Pair with <c>ClickThrough = true</c> for non-interactive labels.</summary>
+    public bool Centered { get; set; }
+
     /// <summary>The scroll model — also read by the linked UiScrollbar.</summary>
     public UiScrollable Scroll { get; } = new();
 
@@ -122,6 +130,29 @@ public sealed class UiText : UiElement
         // submitted first → text on top.
         ctx.DrawFill(0, 0, Width, Height, BackgroundColor);
 
+        // Static centered single-line mode (vitals cur/max numbers etc.): draw the first
+        // line centered H+V with the SAME formula UIElement_Meter used for its label, then
+        // skip the scroll/selection machinery entirely.
+        if (Centered)
+        {
+            var cLines = LinesProvider();
+            if (cLines.Count == 0) return;
+            var line0 = cLines[0];
+            if (DatFont is { } cdf)
+            {
+                float cx = (Width - cdf.MeasureWidth(line0.Text)) * 0.5f;
+                float cy = (Height - cdf.LineHeight) * 0.5f;
+                ctx.DrawStringDat(cdf, line0.Text, cx, cy, line0.Color);
+            }
+            else if ((Font ?? ctx.DefaultFont) is { } cbf)
+            {
+                float cx = (Width - cbf.MeasureWidth(line0.Text)) * 0.5f;
+                float cy = (Height - cbf.LineHeight) * 0.5f;
+                ctx.DrawString(line0.Text, cx, cy, line0.Color, cbf);
+            }
+            return;
+        }
+
         // Prefer the retail dat font when set; fall back to BitmapFont.
         var datFont = DatFont;
         var bitmapFont = datFont is null ? (Font ?? ctx.DefaultFont) : null;

tests/AcDream.App.Tests/UI/Layout/VitalsBindingTests.cs

@@ -28,7 +28,9 @@ public class VitalsBindingTests
             manaText:     () => "");
 
         Assert.Equal(0.42f, health.Fill()!.Value);
-        Assert.Equal("42/100", health.Label());
+        // The meter no longer draws its own label; the cur/max is a centered UiText child.
+        Assert.Null(health.Label());
+        Assert.Equal("42/100", NumberText(health));
     }
 
     // ── Test 2: All three meters wired to distinct providers ──────────────────
@@ -54,13 +56,13 @@ public class VitalsBindingTests
 
         // Each meter should reflect its own provider, not another's.
         Assert.Equal(0.25f, health.Fill()!.Value);
-        Assert.Equal("25/100", health.Label());
+        Assert.Equal("25/100", NumberText(health));
 
         Assert.Equal(0.50f, stamina.Fill()!.Value);
-        Assert.Equal("50/100", stamina.Label());
+        Assert.Equal("50/100", NumberText(stamina));
 
         Assert.Equal(0.75f, mana.Fill()!.Value);
-        Assert.Equal("75/100", mana.Label());
+        Assert.Equal("75/100", NumberText(mana));
     }
 
     // ── Test 3: Missing meter ids are silently skipped (no throw) ─────────────
@@ -87,6 +89,16 @@ public class VitalsBindingTests
 
     // ── Helpers ───────────────────────────────────────────────────────────────
 
+    /// <summary>The cur/max text from the centered <see cref="UiText"/> number that
+    /// <see cref="VitalsController"/> attaches as the meter's child.</summary>
+    private static string NumberText(UiMeter m)
+    {
+        var num = Assert.IsType<UiText>(m.Children[0]);
+        Assert.True(num.Centered);
+        var lines = num.LinesProvider();
+        return lines.Count > 0 ? lines[0].Text : "";
+    }
+
     private static ImportedLayout FakeLayout(params (uint id, UiElement e)[] items)
     {
         var dict = new Dictionary<uint, UiElement>();