makeover-immediate 0.1.0

The immediate-mode renderer for makeover-layout. Immediate mode is the constraint that matters, not the library: no cascade, no retained tree, one stroke per widget. Backed by egui.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# makeover-immediate

The immediate-mode renderer for [`makeover-layout`](https://makenot.work/git/max/makeover-layout).

It is the harshest renderer the description has to survive: no `box-shadow`,
no `inset`, no cascade, no retained tree to mutate, and one stroke per widget
with no per-side control. A two-tone lit edge is not something egui can be
configured into producing, so it is painted by hand here, once, rather than in
every consuming app.

Named for the mode rather than the library, the way `makeover-tui` is named
for the target and not for ratatui. Immediate mode is the constraint that
separates this renderer from the other two; egui is the backend it is written
against.

## What it owns

The expression, and nothing else. Two mitred polylines for a bevel, a `Frame`
for a filled region, and the decision of what to do when an intent has no colour
yet.

It owns no colours and no sizes. `Palette` is handed in already resolved, and
every radius, margin and stroke width arrives in `FrameStyle`. That is why there
is no dependency on `makeover`: the app already resolves a theme, and pinning a
renderer to a colour crate's version would buy nothing.

## Usage

```rust
use makeover_immediate::{frame, FrameStyle, Palette};
use makeover_layout::Depth;

frame(ui, Depth::Raised, &palette, style, |ui| {
    ui.label("a card laid on the panel it sits in");
});
```

A pressed control is `Depth::Raised.pressed()`. A stylesheet can say that once
and let the cascade carry it; an immediate-mode renderer has nowhere to put it,
so every call site decides, which is exactly why the description states the rule
instead of each widget re-deriving it.

## Status

Unpublished, and depends on `makeover-layout` by path while both are. The
sequencing decision is that neither goes to crates.io until a second renderer
has exercised the vocabulary, since a description with one renderer is an API
with extra steps.

First consumer is audiofiles, the only Make Creative app that is egui and the
only one with no CSS. Design lives in the wiki note `makeover-immediate`; the backlog
is in GoingsOn under the project of the same name.

## Licence

MIT.