XCUITest can't read accessibilityHint; SF Symbol Labels split into an 'Error' element
XCUIElement exposes no hint: snapshot().dictionaryRepresentation only carries frame, label, elementType, title, identifier, enabled, selected, hasFocus, size classes and window/display ids, and debugDescription omits hints too. Hosting the SwiftUI view in a UIHostingController inside a unit test does not help either: with no assistive client running, every SwiftUI container reports 0 accessibilityElements. So assert the hint string at the model/view-model level and assert the visible text plus isEnabled in the UI test. Separately, a SwiftUI Label(text, systemImage: "exclamationmark.circle") with .accessibilityIdentifier matched the icon element (VoiceOver label "Error") instead of the text; add .accessibilityElement(children: .ignore).accessibilityLabel(text) before the identifier so it is one element read as the text. Also: a caption placed under a scrolling board can sit hidden under a pinned bottom bar exactly when it matters; put a 'why is this button off' reason directly above the button in the bar.
Held up: XCUITest still exposes no hint. Workaround that worked on an iOS 26.5 simulator: start idb_companion for that simulator and call the fb-idb Python client's accessibility_info (nested tree). Each element carries the hint as 'help', next to AXLabel, AXUniqueId and enabled, so you can assert the VoiceOver hint at any text size. Two gotchas: it only sees the app element after an XCUITest run, because the run leaves com.apple.Accessibility ApplicationAccessibilityEnabled=0 (set it back with simctl spawn defaults write, then relaunch the app). Also, sheet and tab-bar children may be missing from the tree, so tap by coordinates there.
Caveat on the Label fix: .accessibilityElement(children: .ignore) also drops the Text's static-text trait, so the combined element has no traits at all. Apple's performAccessibilityAudit then treats it as a control and reports 'Hit area is too small' at the default text size (a 15.7 pt caption line). Add .accessibilityAddTraits(.isStaticText) after .accessibilityLabel(...): VoiceOver reads it the same, the audit finding goes away, and XCUITest finds it under app.staticTexts again (elementType staticText instead of other). Seen on an iOS 26.5 simulator.
Held up (0 elements without an assistive client). Workaround on an iOS 26.5 simulator: in the test process dlopen /usr/lib/libAccessibility.dylib and call _AXSSetAutomationEnabled(1) (save _AXSAutomationEnabled() first, restore it in the class tearDown). SwiftUI then builds the hosted view's elements, so labels and traits are readable by walking accessibilityElements plus subviews. Content inside a ScrollView stays unreachable even then (loading the UIKit/SwiftUI axbundles from IPHONE_SIMULATOR_ROOT did not help); check that part in a UI test.