Toilville/toilville-design
Watch
5
1
Fork
You've already forked toilville-design
 0
Code Issues 9 Pull requests Projects Releases Packages Wiki Activity Actions

docs(alignment): record dark-accent ownership decision #66

Merged
peterswimm merged 1 commit from docs/dark-accent-ownership into main 2026-07-25 18:51:57 +00:00
Conversation 0 Commits 1 Files changed 1 +22 -10
peterswimm commented 2026-07-25 18:45:42 +00:00
Owner
Copy link

Records the dark-accent ownership decision (2026-07-25) in the strategy doc so no one re-attempts to force dark coupling and regresses contrast.

The finding: the DTCG and the Rituals app use opposite, incompatible dark-accent schemes — the app inverts accent lightness (light/pastel fills + dark on-accent text via textOnAccentDark), the DTCG darkens accents for white on-accent text (wcag.py._darken_accent). Both are WCAG-AA; forcing either direction regresses the app's textOnAccentDark/accentError contrast test. So align_check governs the light map only, and dark divergence is expected, not drift.

Also updates the shipped status now that the Swift emitter (#64) and the app-side coupling (#190) have landed. Docs only.

Records the **dark-accent ownership decision** (2026-07-25) in the strategy doc so no one re-attempts to force dark coupling and regresses contrast. **The finding:** the DTCG and the Rituals app use *opposite, incompatible* dark-accent schemes — the app inverts accent lightness (light/pastel fills + dark on-accent text via `textOnAccentDark`), the DTCG darkens accents for white on-accent text (`wcag.py._darken_accent`). Both are WCAG-AA; forcing either direction regresses the app's `textOnAccentDark`/`accentError` contrast test. So `align_check` governs the **light** map only, and dark divergence is **expected, not drift**. Also updates the shipped status now that the **Swift emitter** (#64) and the **app-side coupling** (#190) have landed. Docs only.
docs(alignment): record dark-accent ownership decision + Swift/coupling status
Some checks failed
UDG dist drift gate / dist/ matches dtcg + udg sources (pull_request) Failing after 17s
Details
Test Generator / lint-workflows (pull_request) Successful in 23s
Details
Security Scans / Gitleaks secret scan (pull_request) Successful in 25s
Details
Test Generator / lint-prose (pull_request) Successful in 24s
Details
Security Scans / Trivy filesystem scan (pull_request) Successful in 30s
Details
Test Generator / test (pull_request) Successful in 3m12s
Details
89a14518ba 
Dark accents stay app-owned (decision 2026-07-25): the Rituals app inverts accent
lightness in dark (light accent fills + dark on-accent text via textOnAccentDark)
vs the DTCG's darkened accents + white on-accent text — both WCAG-AA but
incompatible, so align_check governs the light map only and dark divergence is
expected, not drift. Also flip the shipped status: the Swift emitter (#64) and the
app-side coupling (#190) are now in.
peterswimm deleted branch docs/dark-accent-ownership 2026-07-25 18:51:57 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
priority
P1
 Urgent — no working icon yet (custom art pending) or a shipping asset

  
priority
P2
 High — has an accessible stand-in; bespoke art wanted

  
priority
P3
 Medium — stage visual headers

  
priority
P4
 Low — behavioral dimension family

  
bug
Something is not working

  
duplicate
This issue or pull request already exists

  
enhancement
New feature

  
help wanted
Need some help

  
invalid
Something is wrong

  
question
More information is needed

  
wontfix
This won't be fixed

No labels
priority
P1
priority
P2
priority
P3
priority
P4
bug
duplicate
enhancement
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Toilville/toilville-design!66
No description provided.