From 64837a210512404cf8ce2e97283642f2f6ef9576 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Mon, 22 Jun 2026 06:37:54 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20Add=20accessibility?=
 =?UTF-8?q?=20combine=20to=20empty=20states=20in=20ContentView,=20NodeModu?=
 =?UTF-8?q?lesSection,=20and=20ProcessesView?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

diff --git a/.jules/palette.md b/.jules/palette.md
index 3c5833e..adb5534 100644
--- a/.jules/palette.md
+++ b/.jules/palette.md
@@ -98,3 +98,7 @@ 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 - Grouping Empty State Information
+**Learning:** When displaying an empty state comprising multiple elements (e.g., an icon and several lines of text), VoiceOver reads them sequentially as disjointed items. This can be confusing and fails to convey the unified message that the list or page is empty.
+**Action:** Apply `.accessibilityElement(children: .combine)` to the container (e.g., `VStack`) wrapping the empty state content to group the information logically, providing screen reader users with immediate context.
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
diff --git a/Sources/Cacheout/Views/NodeModulesSection.swift b/Sources/Cacheout/Views/NodeModulesSection.swift
index 13159a3..58c9e7f 100644
--- a/Sources/Cacheout/Views/NodeModulesSection.swift
+++ b/Sources/Cacheout/Views/NodeModulesSection.swift
@@ -117,6 +117,7 @@ struct NodeModulesSection: View {
                 }
                 .frame(maxWidth: .infinity, alignment: .center)
                 .padding(.vertical, 24)
+                .accessibilityElement(children: .combine)
             }
         }
     }
diff --git a/Sources/Cacheout/Views/ProcessesView.swift b/Sources/Cacheout/Views/ProcessesView.swift
index 633338d..0872003 100644
--- a/Sources/Cacheout/Views/ProcessesView.swift
+++ b/Sources/Cacheout/Views/ProcessesView.swift
@@ -87,6 +87,7 @@ struct ProcessesView: View {
                 }
                 .frame(maxWidth: .infinity, alignment: .center)
                 .padding(.vertical, 24)
+                .accessibilityElement(children: .combine)
             } else {
                 ForEach(Array(viewModel.topProcesses.enumerated()), id: \.element.pid) { index, process in
                     processRow(process, rank: index + 1)