diff options
| author | Craig Jennings <c@cjennings.net> | 2026-07-02 01:07:33 -0400 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-07-02 01:07:33 -0400 |
| commit | 67e767466ba63e6e673e4157b68d58948a493462 (patch) | |
| tree | 174dee2e69bb7945fe59408aff465b4605f6c66a /docs/design | |
| parent | 25e74fcb57ae467a39ecabe41568a986db08ebe4 (diff) | |
| download | dotemacs-67e767466ba63e6e673e4157b68d58948a493462.tar.gz dotemacs-67e767466ba63e6e673e4157b68d58948a493462.zip | |
docs: sort three theme-studio specs into docs/specs with status headings
First spec-sort pass under the docs-lifecycle convention: color-families -> READY (its status field carried the 2026-06-10 confirmation), palette-columns and palette-ramps -> DRAFT. Each got the authoritative status heading with an :ID: UUID; six inbound links rewritten. subr-mock-migration-spec is -spec-named but lacks the spec spine, so it stays put until it's renamed or retrofitted.
Diffstat (limited to 'docs/design')
| -rw-r--r-- | docs/design/theme-studio-color-harmony.org | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/design/theme-studio-color-harmony.org b/docs/design/theme-studio-color-harmony.org index b07ccb42..f722d4ee 100644 --- a/docs/design/theme-studio-color-harmony.org +++ b/docs/design/theme-studio-color-harmony.org @@ -5,7 +5,7 @@ Color harmony in a theme palette is mostly calculable. Work in OKLCH, borrow the hue from a semantic accent, fix lightness and chroma across a tier, and let three hard constraints bound the free dials: contrast (WCAG, with APCA as a diagnostic), ΔE separation between palette entries, and the sRGB gamut. What remains for taste is small and deliberate: which hues carry which semantic roles, and how warm or cool the whole page should sit. -This document captures the method worked out on 2026-06-09. The ramp generator and background-contrast safety shipped in theme-studio implement the first two applications (see [[file:../theme-studio-palette-ramps-spec.org][the palette-ramps spec]]); harmonic fill remains a future feature. +This document captures the method worked out on 2026-06-09. The ramp generator and background-contrast safety shipped in theme-studio implement the first two applications (see [[file:../specs/theme-studio-palette-ramps-spec.org][the palette-ramps spec]]); harmonic fill remains a future feature. * Why OKLCH @@ -60,7 +60,7 @@ A background-over-text effect (region, hl-line, highlight, lazy-highlight, isear The right question: define the face's foreground set (the distinct syntax hexes plus the default fg), and rate the background by its floor, the minimum contrast over that set. The limiting foreground (the argmin) names which color caps you. From the floor follows L_max: at a chosen hue and chroma, the lightest background whose floor still clears the target. The usable background lightness is capped by the darkest or nearest foreground in the set, not by the average. -This shipped in theme-studio: the five covered overlay faces show the worst-case floor and name the limiting foreground, and the OKLCH picker shades the lightness band that is too light for the selected face (the lMax ceiling). Contracts and defaults live in the [[file:../theme-studio-palette-ramps-spec.org][ramps spec]]. +This shipped in theme-studio: the five covered overlay faces show the worst-case floor and name the limiting foreground, and the OKLCH picker shades the lightness band that is too light for the selected face (the lMax ceiling). Contracts and defaults live in the [[file:../specs/theme-studio-palette-ramps-spec.org][ramps spec]]. * Ramp generation (shipped) |