Close #169 semantic accessibility gaps for Layer 4 methods

[schatt]

Final Record

Scope

• In scope: Semantic accessibility evidence for View-returning Layer 4 platform*_L4 APIs (Complete accessibility for Layer 4 platform* methods #169): hosted UIKit traits, values, identifiers, and a canonical method-to-criterion matrix (LAYER4_SEMANTIC_ACCESSIBILITY_MATRIX.md).
• Out of scope: Assistive-tech/visual matrix (Add assistive-tech and visual adaptability coverage to close #169 #255), system actions (Close #169 system-action contract gaps (openURL + remote notifications) #256), standalone drop-in harness (Add UI tests for standalone drop-in functions #150).

Decisions

• Hosted trees: Assertions use Layer4SemanticAccessibilityCriterionTests against hosted roots from BaseTestClass / TestSetupUtilities to observe real trait and identifier propagation where ViewInspector is insufficient.

Delivered API

• No new public API; production touch was limited to aligned Layer 4 surfaces (e.g. map hosting where needed for semantic tests). Primary deliverable is test + matrix evidence.

Tests

• Added/updated: Layer4SemanticAccessibilityCriterionTests.swift — hosted semantic coverage for CloudKit, navigation, sheet/popover, share/print, splits, forms, maps, row actions, context menu, app navigation, settings, camera (iOS), etc.
• Matrix: LAYER4_SEMANTIC_ACCESSIBILITY_MATRIX.md updated to reflect criterion test mapping.
• Result: Landed on next with parent orchestration merge; tip 2c67d7ff.

References

• Parent Complete accessibility for Layer 4 platform* methods #169 (closed); orchestration branch done/169-layer4-platform-a11y
• Boundary: Add assistive-tech and visual adaptability coverage to close #169 #255 (assistive/visual), Close #169 system-action contract gaps (openURL + remote notifications) #256 (system actions)

[schatt]

Progress: #254 semantic criteria (hosted UIKit)

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

Landed

• Helpers (AccessibilityTestUtilities): hostedUIKitAccessibilityHierarchyContains, hostedUIKitAccessibilityTraitMatch, hostedUIKitAccessibilityValuePresent for traversing hosted UIView + accessibility container children (Issue Close #169 semantic accessibility gaps for Layer 4 methods #254).
• Tests (Layer4SemanticAccessibilityCriterionTests, UIKit + not watchOS): hosted semantic checks for
  platformCloudKitSyncButton_L4 (.button + SixLayer.main.ui id),
  platformCloudKitProgress_L4 (value or progress-like traits),
  platformCloudKitSyncStatus_L4 (informative traits + platformCloudKitSyncStatus identifier).
• Matrix: Development/Tests/SixLayerFrameworkUnitTests/Layers/Layer4-Component/LAYER4_SEMANTIC_ACCESSIBILITY_MATRIX.md — criterion × API table; CloudKit rows linked to tests; remaining platform*_L4 rows marked TBD for follow-up.

Verification

• xcodebuild test scheme SLF-iOS-UnitTests, destination iPhone 17 simulator, -only-testing:SixLayerFrameworkUnitTests_iOS/Layer4SemanticAccessibilityCriterionTests, isolated -derivedDataPath (green).

Commits (range)

• cc981020 — UIKit hosted helpers
• 564cc573 — semantic criterion tests
• 42a42485 — semantic matrix doc

#254 is not fully closed until the matrix clears TBD for all in-scope View-returning APIs per the issue acceptance criteria.

[schatt]

Update: full CloudKit L4 semantic row coverage (#254)

Branch: b7.7.1

Added hosted semantic tests

• testPlatformCloudKitAccountStatus_L4_exposesInformativeSemanticSurface
• testPlatformCloudKitServiceStatus_L4_hostedEmitsIdentifiersAndInformativeSurface (default CloudKitService only — avoids post-init mutation racing checkAccountStatus())
• testPlatformCloudKitStatusBadge_L4_idle_exposesImageOrInformativeSemanticSurface
• testPlatformCloudKitStatusBadge_L4_syncing_exposesProgressOrImageSemanticSurface

Docs

• LAYER4_SEMANTIC_ACCESSIBILITY_MATRIX.md — all CloudKit platform*_L4 rows now link to concrete tests where applicable.

Verification

• xcodebuild test · SLF-iOS-UnitTests · -only-testing:SixLayerFrameworkUnitTests_iOS/Layer4SemanticAccessibilityCriterionTests · iPhone 17 simulator · -derivedDataPath /tmp/SixLayerDD-254test2 → TEST SUCCEEDED (6 tests).

Commits

• a433bb1a — tests
• 5ca297b6 — semantic matrix
• 5517673d — Add assistive-tech and visual adaptability coverage to close #169 #255 assistive matrix (partial rows for same APIs)

Remaining #254 matrix TBD rows: navigation, sheets, photos, maps, share/print, splits, forms, app navigation.