aboutsummaryrefslogtreecommitdiff
path: root/docs/theme-studio-palette-ramps-spec.org
Commit message (Collapse)AuthorAgeFilesLines
* docs(theme-studio): record the palette-ramps spec Ready verificationCraig Jennings12 days1-4/+8
| | | | Codex re-reviewed the updated palette-ramps spec and confirmed it implementation-ready; the history gets a Ready-verification entry and the metadata table is realigned. The spec was already built and shipped, so this just closes its review trail.
* docs(theme-studio): fold Codex review into palette-ramps specCraig Jennings13 days1-21/+84
| | | | | | | | | | Resolved both open decisions. The contrast target is WCAG AA by default, with AAA selectable and APCA shown as a diagnostic only. The v1 foreground set is the distinct syntax-assignment hexes plus the default foreground, with locked background-only roles excluded. Pinned what the review flagged as underspecified: a closed five-face covered set (region, hl-line, highlight, lazy-highlight, isearch), ramp defaults and palette-insertion rules (n/stepL/chromaEase, naming, collisions, clamp display), and explicit-state structured-error contracts for ramp, fgSetFor, floor, and lMax. Package and non-overlay UI cells stay single-pair in v1. Closed the v1 face set rather than keeping the review's open-ended "any face the buffer renders text over" clause, since an open set reintroduces the gap the foreground-set decision exists to close. Kept throwing for genuine programmer error while returning structured results for bad user input, matching colormath.js. The spec is implementation-ready. The six implementation tasks get created once Craig confirms the go. Review file consumed and deleted.
* docs(theme-studio): spec palette ramp generation + background-contrast safetyCraig Jennings13 days1-0/+152
Design doc (spec-create workflow) for two coupled v1 features: generating a harmonized tonal ramp from a base color, and a worst-case-contrast readout that caps a background tint at the lightness where every foreground on it stays readable. Cross-linked from the color-harmony task; harmonic fill deferred to vNext.