using System; using System.Collections.Generic; using System.IO; using System.Linq; using AcDream.App.UI; using AcDream.App.UI.Layout; using AcDream.Content; using DatReaderWriter; using DatReaderWriter.DBObjs; using DatReaderWriter.Options; namespace AcDream.App.Tests.UI.Layout; /// /// #409 (client-wide retail tooltip system) installed-DAT acceptance gate. /// Opt in with ACDREAM_PROBE_LIVE_MOUNT=1; ACDREAM_DAT_DIR can /// override the ordinary Documents/Asheron's Call location. Pins retail's /// tooltip popup LayoutDesc 0x21000041 structure and a client-wide /// sweep landmark, mirroring 's /// pattern. /// public sealed class TooltipLiveDatTests { private static string DatDirectory => System.Environment.GetEnvironmentVariable("ACDREAM_DAT_DIR") ?? Path.Combine( System.Environment.GetFolderPath(System.Environment.SpecialFolder.UserProfile), "Documents", "Asheron's Call"); /// The tooltip popup catalog LayoutDesc — every probed /// tooltip-bearing element's P0x48 resolves here (with one exception, /// 0x21000026, an alternate skin used by a handful of elements — /// RetailTooltipPresenter is data-driven off each element's OWN P0x48 /// so neither this constant nor 0x21000026 is hardcoded in production /// code; it is cited here only to pin the probe's own finding). private const uint TooltipCatalogLayoutId = 0x21000041u; /// The four popup "skin" root element ids live-DAT-probed inside /// . Each is a 30x30 four-piece bevel /// frame around the SAME text child id (). private static readonly uint[] PopupSkinRootIds = [0x10000487u, 0x10000395u, 0x10000397u, 0x10000398u]; private const uint TooltipTextChildId = 0x10000396u; [InstalledDatFact] public void TooltipCatalog_EveryPopupSkin_SharesTheSameTextChild() { using var dats = new DatCollection(DatDirectory, DatAccessType.Read); ElementInfo? root = LayoutImporter.ImportInfos(dats, TooltipCatalogLayoutId); Assert.NotNull(root); Assert.Equal(0u, root!.Id); Assert.Equal(800f, root.Width); Assert.Equal(600f, root.Height); foreach (uint skinRootId in PopupSkinRootIds) { ElementInfo skin = Assert.Single(root.Children, c => c.Id == skinRootId); // UIElementManager::StartTooltip @0x0045DE90's own fallback read: // GetAttribute_Enum(tooltipRootElement, 0x4a, &textChildId) off the // freshly-instantiated POPUP root itself. Assert.Equal(TooltipTextChildId, skin.TooltipTextChildElementId); ElementInfo textChild = Assert.Single( AllDescendants(skin), e => e.Id == TooltipTextChildId); Assert.Equal(12u, textChild.Type); // UIElement_Text } } [InstalledDatFact] public void TooltipCatalog_ImportsThroughLayoutImporter_WithTextChildResolvable() { using var dats = new DatCollection(DatDirectory, DatAccessType.Read); ImportedLayout? popup = LayoutImporter.Import( dats, TooltipCatalogLayoutId, 0x10000487u, _ => (0u, 0, 0), null); Assert.NotNull(popup); Assert.Equal(30f, popup!.Root.Width); Assert.Equal(30f, popup.Root.Height); Assert.Equal(TooltipTextChildId, popup.Root.AuthoredTooltipTextChildElementId); UiElement? textChild = popup.FindElement(TooltipTextChildId); Assert.IsType(textChild); } /// /// A known tooltip-bearing element (the Appearance page's left rotate /// button, live-DAT-probed) authors all five trigger properties with /// literal StringInfo text — the "core" case /// can show end to end. /// [InstalledDatFact] public void KnownElement_AuthorsAllFiveTooltipProperties_WithResolvableText() { using var dats = new DatCollection(DatDirectory, DatAccessType.Read); ElementInfo? tree = LayoutImporter.ImportInfos(dats, 0x21000005u); Assert.NotNull(tree); ElementInfo rotateLeft = Assert.Single(AllDescendants(tree!), e => e.Id == 0x100005A4u); Assert.True(rotateLeft.TooltipEnabled); Assert.Equal(0x10000487u, rotateLeft.TooltipRootElementId); Assert.Equal(TooltipCatalogLayoutId, rotateLeft.TooltipLayoutDid); Assert.NotNull(rotateLeft.TooltipText); var strings = new DatStringResolver(dats); string? resolved = DatWidgetFactory.ResolveTooltipText(rotateLeft, strings.Resolve); Assert.Equal("Rotate left.", resolved); } /// /// Landmark client-wide sweep (mirrors /// 's own shape): /// every installed LayoutDesc, counting elements authoring at least one /// of the five tooltip-trigger properties. Asserts landmarks + a floor, /// not a brittle exact total, so the gate survives a future DAT /// revision. /// [InstalledDatFact] public void ClientWideSweep_FindsKnownLandmarksAndAFloorCount() { using var dats = new DatCollection(DatDirectory, DatAccessType.Read); var withProperties = new List<(uint LayoutId, uint ElementId, bool HasText)>(); foreach (uint layoutId in dats.GetAllIdsOfType()) { ElementInfo? tree; try { tree = LayoutImporter.ImportInfos(dats, layoutId); } catch { continue; } if (tree is null) continue; foreach (ElementInfo e in AllDescendants(tree)) { bool any = e.TooltipRootElementId != 0 || e.TooltipLayoutDid != 0 || e.TooltipText.HasValue || e.TooltipEnabled || e.TooltipDelaySeconds.HasValue; if (any) withProperties.Add((layoutId, e.Id, e.TooltipText.HasValue)); } } Console.WriteLine($"[409-DAT] {withProperties.Count} elements author >=1 tooltip property " + $"({withProperties.Count(f => f.HasText)} with literal StringInfo text)."); // #409 investigation landmark (main game UI, Appearance rotate button). Assert.Contains(withProperties, f => f.LayoutId == 0x21000005u && f.ElementId == 0x100005A4u); // Floor: the live-DAT sweep found 434 total / 243 with literal text at // filing time — assert comfortably below both so a future content // patch that only ADDS tooltip authoring cannot flake this gate. Assert.True(withProperties.Count >= 400, $"expected at least 400 tooltip-property-authoring elements, found {withProperties.Count}."); Assert.True(withProperties.Count(f => f.HasText) >= 200, $"expected at least 200 elements with literal tooltip text, found {withProperties.Count(f => f.HasText)}."); } private static IEnumerable AllDescendants(ElementInfo root) { yield return root; foreach (ElementInfo child in root.Children) foreach (ElementInfo descendant in AllDescendants(child)) yield return descendant; } }