Round faces: a bar as concentric arcs with a legend in the middle; larger title, gap line and face text; Read-only in the ring's gap; a round dashboard unpadded on a phone; reduced-motion ring assertion

docs/interface/dashboards.md

@@ -226,7 +226,8 @@ restrict API permissions and does not disable controls in edit mode.
 For a round screen such as a rotary knob, set the canvas to **Round** in the
 dashboard settings, or pick the **Knob** preset (360×360). A round canvas is
 square (`shape: "round"` forces `canvas_height` to `canvas_width`), and nothing
-outside its circle is drawn.
+outside its circle is drawn. It fills the screen at any width: a phone neither
+stacks nor pads it.
 
 A round dashboard has no grid. It shows one widget at a time, each drawn as the
 whole face, in the order of `widgets`; `layout` is not read. In the editor, the
@@ -244,8 +245,8 @@ the screen.
 A Slider's reading (**Beside it**) is written large in the middle, under its
 label; the slider's own title and value move to the line in the ring's gap.
 
-Value, Switch, Button, Clock, Icon, Notification and Text have faces of their
-own. Every other type is drawn as its rectangular body in the middle of the
+Value, Bar, Switch, Button, Clock, Icon, Notification and Text have faces of
+their own. Every other type is drawn as its rectangular body in the middle of the
 face, and the editor marks it **Poor fit for round**.
 
 ### Moving between faces
@@ -275,7 +276,7 @@ look's muted text colour.
 | Part | Value |
 |---|---|
 | Face | circle of diameter S at (c, c) |
-| Title | one line centred at y = c − 80, 15, muted, at most 200 wide; the widget's title, or the label of a slider's reading |
+| Title | one line centred at y = c − 80, 18, muted, at most 200 wide; the widget's title, or the label of a slider's reading |
 | Middle | a 240 × 128 box centred at (c, c); what a face draws in its middle is centred in it and clipped to it |
 | Centre reading | centred at (c, c), line height 1, its unit after it at 0.4 em, muted. Size: 72, or 240 ÷ (0.6 × the characters written) rounded down where that is smaller, never below 24 |
 | Ring band | 40 along the edge |
@@ -285,20 +286,21 @@ look's muted text colour.
 | Selector | a value arc from the start to the selected option (none at the first), a dot 6 across per option at i/(n−1) of the sweep (one option: the middle), the selected one under the handle; its label as the centre reading, at most 36 |
 | Colour | hue h at h/360 of the sweep in 150 strokes of 2°, red at both ends; the handle filled with the colour; a swatch 96 across in the middle, with a hairline border |
 | Gauge | track and value arc, no handle; the value as the centre reading |
-| Gap line | centred at y = S − 28, 13, at most 160 wide |
+| Gap line | centred at y = S − 28, 15, at most 140 wide, clear of the ring's end caps |
 | Value | the reading as the centre reading, to its precision; a word shrinks like any other |
-| Switch | a disc 128 across centred at (c, c): the look's button, filled when on and tonal when off, with a power glyph 40 over the word On or Off at 15; a press toggles |
-| Button | a disc 128 across centred at (c, c), tonal, its label at 15 over at most three lines; a press sends its value |
-| Clock | the time (hours and minutes, the device's locale) sized as a centre reading, over the date (weekday, day, month) at 15, muted, 4 apart; the pair centred at (c, c) |
-| Icon | the glyph 96 across over its label at 15, muted, 4 apart; the pair centred at (c, c). Nothing matched: a dash at 72, muted |
-| Notification | the title at 15, medium (an error in the destructive colour, led by ⚠), over the body at 15, muted; centred lines in the middle |
-| Text | centred lines at 15: `#` at 1.35 em and `##` medium, `###` muted, list items led by a bullet; in the middle |
-| Not wired | the problem, at 15, muted, in the middle; a ring type draws no ring |
+| Bar | an arc per row, the first outermost, each over the ring's sweep (start 120°, 300°) with round caps: a track in the look's track paint and the row's value arc in its data colour, on its own scale (none at the minimum). n rows share a band 64 thick inward from c − 12, 3 apart: stroke s = min(16, (64 − 3(n − 1)) / n), centre-line radius rᵢ = c − 12 − s/2 − i(s + 3), so up to three rows are 16 thick and the first is on the ring (c − 20). The middle is the legend, a line per row in order: a dot 8 across in the row's colour, 8, the label (muted, cut with an ellipsis), 8, the value and unit to the row's precision (— for none). Lines of 22 at 17 for up to 5 rows, 18 at 15 for 6–7, 16 at 13 for 8; the block centred at (c, c), as wide as its widest line but at most 240 and at most the width of the disc inside the innermost arc (radius c − 12 − n·s − 3(n − 1)) at the block's top and bottom, less 16. The title is at most that disc's width at the title's line (y = c − 89), less 8 |
+| Switch | a disc 128 across centred at (c, c): the look's button, filled when on and tonal when off, with a power glyph 40 over the word On or Off at 17; a press toggles |
+| Button | a disc 128 across centred at (c, c), tonal, its label at 17 over at most three lines; a press sends its value |
+| Clock | the time (hours and minutes, the device's locale) sized as a centre reading, over the date (weekday, day, month) at 17, muted, 4 apart; the pair centred at (c, c) |
+| Icon | the glyph 96 across over its label at 17, muted, 4 apart; the pair centred at (c, c). Nothing matched: a dash at 72, muted |
+| Notification | the title at 17, medium (an error in the destructive colour, led by ⚠), over the body at 17, muted; centred lines in the middle |
+| Text | centred lines at 17: `#` at 1.35 em and `##` medium, `###` muted, list items led by a bullet; in the middle |
+| Not wired | the problem, at 17, muted, in the middle; a ring type draws no ring |
 | Any other type | its rectangular body, without a card, from y = c − 64 to c + S/(2√2), x = c ± S/(2√2) (Knob: 53–307 × 116–307) |
 | Page dots | one per face, from two faces: dots 6 across on targets 16 apart (closer when more than 128 wide would be needed), centred at y = S − 12; the current one in the text colour, the others muted at half opacity |
 | Dashboard name | a pill centred at (c, c), 36 high: the icon 16 and the title at 15, medium, at most 220 wide, on the frosted surface; for 1000 ms |
 | Paging | faces slide sideways, dashboards up and down; see [Motion](#motion) |
-| Locked | controls do nothing and read as disabled; the ring at 0.45 opacity |
+| Locked | controls do nothing and read as disabled; the ring at 0.45 opacity. **Read-only** in the gap line's place (centred at y = S − 28): a lock glyph 15 and the word at 15, 6 apart, muted. A face whose gap line is in use leads that line with the lock glyph instead. Nothing is drawn outside the circle |
 
 Paint follows the look: Fluksio draws a muted track, a primary value and a
 handle of the ground colour ringed in primary; Material a tonal track and a