design

The MixOS design-token system. A design source is a strict-data document (theme.conf.mix) holding OKLCH colour primitives, metrics, type scales, semantic text pairs and the button family's mapping rules, plus modifier blocks per scheme and mode. Breeze and Adwaita each provide light and dark chrome palettes and a Studio-based style; scheme and style remain independent. The append-only compatibility table supplies both palettes, styles and terminal defaults to older sources with defaulted-scheme provenance. An authored scheme binding retains its source colours. A scheme modifier without that binding is incomplete: the whole compatibility scheme supplies its colours and semantic pairs. Authors defining their own new scheme provide both its palette and its style binding. Missing bindings for the original nine schemes remain errors.

Breeze keeps its surface colours, blue accent and selection opacity. Six foreground/action values are adjusted to meet the contrast requirement after egui's rounded, premultiplied sRGB blending. Text is checked on all seven resting, hovered and pressed surfaces, including their accent-soft tints. Primary-button ink is checked at 100%, 93% and 85% opacity on all five resting surfaces. The minimum rendered ratios are:

The reference inputs measured 4.283:1 and 4.261:1 for light faint/accent text on tinted pressed, 3.601:1 and 3.789:1 for dark faint/accent text there, and 3.813:1 for the light primary button at 85% on chrome. Dark danger measured 2.742:1 on tinted pressed, below its 3:1 interactive-surface floor. These adjustments preserve the contrast requirements rather than importing those failures.

The compiler flattens it for one DesignContext (scheme, mode, contrast, optional app) into a resolved design: gamut-mapped colours with WCAG contrast checked, resolved metrics and typography, and a total button table keyed by variant, size, interaction and focus. Every failure is a stable, source-addressed diagnostic.

The crate is headless and has no renderer dependency. Its only dependencies are strict (the source format) and serde.

• parse_design_source / parse_legacy_v0_source read a source; the embedded default is EMBEDDED_DEFAULT_SOURCE.
• compile_design produces a DesignCompileResult; apply_compiled_design stamps a revision onto an accepted candidate.
• Scheme, Mode, Contrast are the closed selection axes; active_typography reads a typography role with embedded defaults.
• The default selection, used when nothing chooses a theme, is studio, dark. DesignContext::revision_one() is revision one's ocean, light, which the v0 equivalence gate and the revision-one parity tests pin.

Build and test with cargo test -p design.

The source is libs/design.