Add assistive-tech and visual adaptability coverage to close #169

[schatt]

Final Record

Scope

• In scope: Assistive-tech and visual adaptability evidence for Layer 4 platform*_L4 surfaces (Complete accessibility for Layer 4 platform* methods #169): VoiceOver / Switch Control / Dynamic Type / high contrast proxies on hosted trees, plus LAYER4_ASSISTIVE_VISUAL_EVIDENCE_MATRIX.md. iOS hosted unit-test lane is the primary automation record; cross-platform column remains partial until macOS parity is explicitly recorded.
• Out of scope: Pure semantic trait/value matrix (Close #169 semantic accessibility gaps for Layer 4 methods #254), system actions (Close #169 system-action contract gaps (openURL + remote notifications) #256), standalone drop-in (Add UI tests for standalone drop-in functions #150).

Decisions

• Dynamic Type: Per-API tests with .dynamicTypeSize(.accessibility3) (and related) on hosted roots.
• High contrast: UIKit accessibilityContrast: .high trait override on the hosting controller after layout where SwiftUI contrast environment is not writable.
• Maps: MKMapView fallbacks when MapKit absorbs wrapper accessibility ids (aligned with Close #169 semantic accessibility gaps for Layer 4 methods #254).
• Sweeps: Batch tests (testLayer4CloudKitFamily_…, etc.) combine VO / Switch Control proxies and SixLayer id overlap under contrast.

Delivered API

• Shared test helpers: hostedTreeHasVoiceOverDiscoverableNode, hostedTreeHasSwitchControlActivationCandidate, hostedTreesRetainOverlappingSixLayerAccessibilityKeys in AccessibilityTestUtilities.swift.
• SixLayerFrameworkUnitTests_iOS includes Layer4AssistiveVisualAdaptabilityCriterionTests.swift (XcodeGen project.pbxproj).

Tests

• Added/updated: Layer4AssistiveVisualAdaptabilityCriterionTests.swift — Dynamic Type stability, matrix sweeps, and remaining API-specific Dynamic Type tests (form container, maps, camera, app nav, etc.).
• Matrix: LAYER4_ASSISTIVE_VISUAL_EVIDENCE_MATRIX.md — criterion columns marked done for iOS hosted lane.
• Result: Landed on next; tip 2c67d7ff.

References

• Parent Complete accessibility for Layer 4 platform* methods #169 (closed); branch done/169-layer4-platform-a11y
• Related: Close #169 semantic accessibility gaps for Layer 4 methods #254 (semantic), Close #169 system-action contract gaps (openURL + remote notifications) #256 (closed)

[schatt]

Progress: #255 assistive-tech / visual matrix

UTC: 2026-04-24 (push on b7.7.1)

Landed

• Evidence matrix (skeleton): Development/Tests/SixLayerFrameworkUnitTests/Layers/Layer4-Component/LAYER4_ASSISTIVE_VISUAL_EVIDENCE_MATRIX.md
  • Columns: VoiceOver, Switch Control, Dynamic Type, high contrast, cross-platform.
  • Partial entries for the three CloudKit surfaces that now have hosted semantic unit tests (Close #169 semantic accessibility gaps for Layer 4 methods #254); remaining rows TBD with pointers to Layer4UITests where structure is already exercised.

Commit

• a9be12ce — assistive/visual matrix doc

#255 remains open until each applicable method has documented evidence (automation and/or dated manual runs) per the matrix, not only placeholders.

[schatt]

Update: CloudKit rows → partial (#255)

Branch: b7.7.1

LAYER4_ASSISTIVE_VISUAL_EVIDENCE_MATRIX.md now marks account, service, and status badge APIs as partial (hosted semantic / identifier automation on iOS), with notes for remaining VoiceOver copy, Dynamic Type, contrast, and cross-platform manual or UITest sign-off.

Commit: 5517673d

[schatt]

Update: share/print rows marked partial (#255)

LAYER4_ASSISTIVE_VISUAL_EVIDENCE_MATRIX.md now has a platformShare_L4 / platformPrint_L4 row marked partial based on hosted semantic trigger coverage, with remaining work called out for explicit assistive walkthrough of share/print dialogs.

Commit: af2bc0dc
Branch: b7/b7.7.1 (pushed)