# makeover-layout

The renderer-agnostic half of the make-family design system.

`makeover` answers *what colour*, and varies by theme. `makeover-geometry`
answers *how much space*, and varies by density and surface. This crate answers
*what the thing is*, and varies by nothing.

## The deferral rule

A description names intents and relationships, never values. Say `Fill::Raised`,
never `#D9DDF4`. Say `Gap::Peer`, never `6px`. What is left once colour and
spacing are deferred is composition: which edges are lit, what inverts on press,
what nests in what.

The constraint that shapes it: a renderer that can only paint rectangles has to
be able to express the result. egui has no `box-shadow: inset` and one stroke per
widget with no per-side control. A terminal has box-drawing characters and one
cell of resolution, and cannot draw a two-tone lit edge at all. So this crate
names the intent, and each renderer picks an expression it can produce, including
dropping half of one.

## What is here

Depth, and only depth: `Bevel`, `Edge`, `Fill`, `Depth`. Fill and bevel are named
together, because naming them apart is what let them disagree. Every consumer had
at least one region carrying a raised bevel over a recessed fill; audiofiles
fixed it and wrote the bug down, Balanced Breakfast still had twelve of them a
year later. `Depth` makes that unrepresentable.

The vocabulary was read off audiofiles, the only implementation written by a
consumer with no CSS, then checked against both webview apps.

## What is not here yet

Badge versus chip, toast versus banner, the list row's parts, heading levels,
segmented controls, and whether a description names loading state at all. Each is
a naming decision rather than a transcription, and each is tracked as a subtask
of the extraction task. Guessing at them now is how a description becomes a
framework.

## Status

Not published. Per the sequencing decision, 0.1.0 does not go to crates.io until
a second renderer has exercised the vocabulary; a description with one renderer
is an API with extra steps. Design and open questions live in the wiki note
`makeover-layout`; the backlog is in GoingsOn under the project of the same name.

## Licence

MIT.