From 031e314183057cd773a2e2eceed01a03bf2d999a Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 26 Jun 2026 06:21:03 +0000
Subject: [PATCH] Palette: Add .accessibilityElement(children: .combine) to
 ContentView empty state

Added `.accessibilityElement(children: .combine)` to the `ContentView.swift` empty state view to ensure VoiceOver reads the empty state message and its sub-text as a single unified statement rather than disjointed fragments. Also documented this learning in `.jules/palette.md`.

Co-authored-by: acebytes <2820910+acebytes@users.noreply.github.com>
---
 .jules/palette.md                        | 3 +++
 Sources/Cacheout/Views/ContentView.swift | 1 +
 2 files changed, 4 insertions(+)

diff --git a/.jules/palette.md b/.jules/palette.md
index 3c5833e..0b318bd 100644
--- a/.jules/palette.md
+++ b/.jules/palette.md
@@ -98,3 +98,6 @@ grep -nE "accessibilityLabel|accessibilityValue|accessibilityAddTraits" <candida
 ## 2024-05-27 - Dashboard Stat Grouping
 **Learning:** VoiceOver users have to swipe multiple times to hear a single statistic if its label and value are separate text elements in a dashboard card. This creates a fragmented and tedious reading experience.
 **Action:** Always apply `.accessibilityElement(children: .combine)` to SwiftUI stat cards or metric views that group a title and a value. Apply it at the OUTERMOST modifier position (after `.padding()` and `.background()`) so the entire visible card is one element. Applying it inside the chrome is a common mistake.
+## 2024-05-28 - Unified Empty State Accessibility
+**Learning:** VoiceOver reads empty state text and icons as disjointed, fragmented phrases, which degrades the experience of users encountering an empty state.
+**Action:** Apply `.accessibilityElement(children: .combine)` to containers (e.g., `VStack`) wrapping empty state views to ensure VoiceOver announces the empty state as a single unified message.
diff --git a/Sources/Cacheout/Views/ContentView.swift b/Sources/Cacheout/Views/ContentView.swift
index 6951bd3..ff824c4 100644
--- a/Sources/Cacheout/Views/ContentView.swift
+++ b/Sources/Cacheout/Views/ContentView.swift
@@ -190,6 +190,7 @@ struct ContentView: View {
                 .foregroundStyle(.tertiary)
             Spacer()
         }
+        .accessibilityElement(children: .combine)
     }
 
     // MARK: - Bottom Bar