Skip to content

Commit de5ef35

Browse files
iexitdeviexitdev
committed
docs(release): record accessibility local baseline
1 parent b4984e0 commit de5ef35

6 files changed

Lines changed: 160 additions & 61 deletions

‎docs/release/accessibility-qa.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Accessibility QA Protocol
22

3-
Status on May 5, 2026: protocol ready, native screen-reader evidence missing. Structured gate evidence lives in [native-accessibility-qa.json](evidence/native-accessibility-qa.json), with the page-by-page assistive-technology matrix in [native-accessibility-matrix.json](evidence/native-accessibility-matrix.json). Use the generated [native QA checklist](native-qa-checklists.md) for row-by-row execution.
3+
Status on May 6, 2026: protocol ready, local baseline recorded, native screen-reader evidence missing. Structured gate evidence lives in [native-accessibility-qa.json](evidence/native-accessibility-qa.json), with the page-by-page assistive-technology matrix in [native-accessibility-matrix.json](evidence/native-accessibility-matrix.json). Use the generated [native QA checklist](native-qa-checklists.md) for row-by-row execution.
44

55
This protocol covers the manual VoiceOver and TalkBack checks required before production beta/RC can claim native accessibility confidence. Automated tests verify generated summaries and data table helpers, but they do not prove native assistive-technology behavior.
66

@@ -22,6 +22,7 @@ Current automated coverage:
2222
- ProgressChart clamped-value summary and data table helpers
2323
- ContributionGraph empty-day summary and data table helpers
2424
- Expo showcase representative data details panels for each page that requires table-fallback QA
25+
- local baseline artifact: [accessibility-local-baseline-2026-05-06.md](artifacts/accessibility-local-baseline-2026-05-06.md)
2526

2627
## Manual Device Matrix
2728

‎docs/release/artifacts/accessibility-local-baseline-2026-05-06.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
# Accessibility Local Baseline Evidence
2+
3+
Date: 2026-05-06
4+
Commit: `b4984e0`
5+
Build surface: local repository checks only
6+
7+
This artifact records the automated accessibility baseline required before native assistive-technology QA. It is suitable only for `partial` accessibility matrix evidence. It does not prove VoiceOver or TalkBack focus order, announcements, rotor/navigation behavior, tooltip/selection focus behavior, or native table-fallback announcements.
8+
9+
## Commands
10+
11+
```sh
12+
npm run test:unit -- packages/react-native/test/chart-accessibility.test.ts packages/react-native/test/line-accessibility.test.ts apps/expo-showcase/src/showcaseAccessibilityDetails.test.ts
13+
npm run showcase:typecheck
14+
npm run release:qa:checklists:check
15+
```
16+
17+
## Results
18+
19+
- Accessibility-focused unit tests passed. Vitest reported 3 test files and 12 tests passing for chart summary/data-table helpers, LineChart accessibility helpers, and the Expo showcase data-details coverage guard.
20+
- Showcase typecheck passed for `@chart-kit/expo-showcase`.
21+
- Native QA checklist sync passed; `docs/release/native-qa-checklists.md` is in sync with the accessibility matrix.
22+
23+
## Scope
24+
25+
Covered by this local baseline:
26+
27+
- generated summary helpers for LineChart, BarChart, CombinedChart, CandlestickChart, PieChart, ProgressChart, and ContributionGraph
28+
- data-table helper coverage for major chart families
29+
- representative collapsed `Data details` panels in the Expo showcase for the pages that require table-fallback QA
30+
- generated row-by-row accessibility checklist consistency
31+
- TypeScript coverage for the native showcase wiring
32+
33+
Not covered by this local baseline:
34+
35+
- iOS VoiceOver navigation or announcements
36+
- Android TalkBack navigation or announcements
37+
- native focus order across chart, menu, legend, tooltip, and data-details controls
38+
- native screen-reader behavior for selected values, scrub/crosshair state, range selectors, or interactive legends
39+
- native contrast review with assistive technologies enabled
40+
- physical-device or simulator/emulator screen-reader evidence

‎docs/release/evidence/native-accessibility-matrix.json‎

Lines changed: 82 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"schemaVersion": 1,
3-
"status": "pending",
4-
"lastUpdated": "2026-05-05",
3+
"status": "partial",
4+
"lastUpdated": "2026-05-06",
55
"source": "docs/release/accessibility-qa.md",
66
"assistiveTech": [
77
{
@@ -90,113 +90,161 @@
9090
"id": "ios-voiceover-line-charts",
9191
"assistiveTechId": "ios-voiceover",
9292
"pageId": "line-charts",
93-
"status": "pending",
94-
"evidence": []
93+
"status": "partial",
94+
"evidence": [
95+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
96+
],
97+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
9598
},
9699
{
97100
"id": "ios-voiceover-bar-charts",
98101
"assistiveTechId": "ios-voiceover",
99102
"pageId": "bar-charts",
100-
"status": "pending",
101-
"evidence": []
103+
"status": "partial",
104+
"evidence": [
105+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
106+
],
107+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
102108
},
103109
{
104110
"id": "ios-voiceover-combined-preview",
105111
"assistiveTechId": "ios-voiceover",
106112
"pageId": "combined-preview",
107-
"status": "pending",
108-
"evidence": []
113+
"status": "partial",
114+
"evidence": [
115+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
116+
],
117+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
109118
},
110119
{
111120
"id": "ios-voiceover-financial-preview",
112121
"assistiveTechId": "ios-voiceover",
113122
"pageId": "financial-preview",
114-
"status": "pending",
115-
"evidence": []
123+
"status": "partial",
124+
"evidence": [
125+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
126+
],
127+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
116128
},
117129
{
118130
"id": "ios-voiceover-pie-donut",
119131
"assistiveTechId": "ios-voiceover",
120132
"pageId": "pie-donut",
121-
"status": "pending",
122-
"evidence": []
133+
"status": "partial",
134+
"evidence": [
135+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
136+
],
137+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
123138
},
124139
{
125140
"id": "ios-voiceover-progress",
126141
"assistiveTechId": "ios-voiceover",
127142
"pageId": "progress",
128-
"status": "pending",
129-
"evidence": []
143+
"status": "partial",
144+
"evidence": [
145+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
146+
],
147+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
130148
},
131149
{
132150
"id": "ios-voiceover-heatmaps",
133151
"assistiveTechId": "ios-voiceover",
134152
"pageId": "heatmaps",
135-
"status": "pending",
136-
"evidence": []
153+
"status": "partial",
154+
"evidence": [
155+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
156+
],
157+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
137158
},
138159
{
139160
"id": "ios-voiceover-compatibility",
140161
"assistiveTechId": "ios-voiceover",
141162
"pageId": "compatibility",
142-
"status": "pending",
143-
"evidence": []
163+
"status": "partial",
164+
"evidence": [
165+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
166+
],
167+
"notes": "Automated summary/data-table and showcase data-details evidence only; native iOS VoiceOver review still required."
144168
},
145169
{
146170
"id": "android-talkback-line-charts",
147171
"assistiveTechId": "android-talkback",
148172
"pageId": "line-charts",
149-
"status": "pending",
150-
"evidence": []
173+
"status": "partial",
174+
"evidence": [
175+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
176+
],
177+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
151178
},
152179
{
153180
"id": "android-talkback-bar-charts",
154181
"assistiveTechId": "android-talkback",
155182
"pageId": "bar-charts",
156-
"status": "pending",
157-
"evidence": []
183+
"status": "partial",
184+
"evidence": [
185+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
186+
],
187+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
158188
},
159189
{
160190
"id": "android-talkback-combined-preview",
161191
"assistiveTechId": "android-talkback",
162192
"pageId": "combined-preview",
163-
"status": "pending",
164-
"evidence": []
193+
"status": "partial",
194+
"evidence": [
195+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
196+
],
197+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
165198
},
166199
{
167200
"id": "android-talkback-financial-preview",
168201
"assistiveTechId": "android-talkback",
169202
"pageId": "financial-preview",
170-
"status": "pending",
171-
"evidence": []
203+
"status": "partial",
204+
"evidence": [
205+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
206+
],
207+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
172208
},
173209
{
174210
"id": "android-talkback-pie-donut",
175211
"assistiveTechId": "android-talkback",
176212
"pageId": "pie-donut",
177-
"status": "pending",
178-
"evidence": []
213+
"status": "partial",
214+
"evidence": [
215+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
216+
],
217+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
179218
},
180219
{
181220
"id": "android-talkback-progress",
182221
"assistiveTechId": "android-talkback",
183222
"pageId": "progress",
184-
"status": "pending",
185-
"evidence": []
223+
"status": "partial",
224+
"evidence": [
225+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
226+
],
227+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
186228
},
187229
{
188230
"id": "android-talkback-heatmaps",
189231
"assistiveTechId": "android-talkback",
190232
"pageId": "heatmaps",
191-
"status": "pending",
192-
"evidence": []
233+
"status": "partial",
234+
"evidence": [
235+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
236+
],
237+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
193238
},
194239
{
195240
"id": "android-talkback-compatibility",
196241
"assistiveTechId": "android-talkback",
197242
"pageId": "compatibility",
198-
"status": "pending",
199-
"evidence": []
243+
"status": "partial",
244+
"evidence": [
245+
"docs/release/artifacts/accessibility-local-baseline-2026-05-06.md"
246+
],
247+
"notes": "Automated summary/data-table and showcase data-details evidence only; native Android TalkBack review still required."
200248
}
201249
]
202250
}

‎docs/release/evidence/native-accessibility-qa.json‎

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
22
"schemaVersion": 1,
3-
"status": "missing",
3+
"status": "partial",
44
"requiredFor": ["H5", "H6"],
5-
"lastUpdated": "2026-05-05",
5+
"lastUpdated": "2026-05-06",
66
"summary": "Automated summary and data-table helper coverage exists, but native VoiceOver and TalkBack evidence has not been captured.",
77
"matrix": "docs/release/evidence/native-accessibility-matrix.json",
88
"completedEntries": [],
@@ -21,11 +21,21 @@
2121
}
2222
],
2323
"missingEvidence": [
24-
"iOS VoiceOver pass across required pages",
25-
"Android TalkBack pass across required pages",
26-
"screen-reader focus order evidence",
27-
"chart summary announcement evidence",
28-
"selection, tooltip, range selector, and legend focus-trap checks",
29-
"table fallback announcement checks"
24+
"ios-voiceover-line-charts is partial; evidence is required before this matrix can be complete.",
25+
"ios-voiceover-bar-charts is partial; evidence is required before this matrix can be complete.",
26+
"ios-voiceover-combined-preview is partial; evidence is required before this matrix can be complete.",
27+
"ios-voiceover-financial-preview is partial; evidence is required before this matrix can be complete.",
28+
"ios-voiceover-pie-donut is partial; evidence is required before this matrix can be complete.",
29+
"ios-voiceover-progress is partial; evidence is required before this matrix can be complete.",
30+
"ios-voiceover-heatmaps is partial; evidence is required before this matrix can be complete.",
31+
"ios-voiceover-compatibility is partial; evidence is required before this matrix can be complete.",
32+
"android-talkback-line-charts is partial; evidence is required before this matrix can be complete.",
33+
"android-talkback-bar-charts is partial; evidence is required before this matrix can be complete.",
34+
"android-talkback-combined-preview is partial; evidence is required before this matrix can be complete.",
35+
"android-talkback-financial-preview is partial; evidence is required before this matrix can be complete.",
36+
"android-talkback-pie-donut is partial; evidence is required before this matrix can be complete.",
37+
"android-talkback-progress is partial; evidence is required before this matrix can be complete.",
38+
"android-talkback-heatmaps is partial; evidence is required before this matrix can be complete.",
39+
"android-talkback-compatibility is partial; evidence is required before this matrix can be complete."
3040
]
3141
}

0 commit comments

Comments
 (0)