diff --git a/docs/ui/DESIGN.md b/docs/ui/DESIGN.md index 25d55cb2..95914fdc 100644 --- a/docs/ui/DESIGN.md +++ b/docs/ui/DESIGN.md @@ -2,7 +2,7 @@ Companion to `docs/BRIEF.md` §12 (UI spec). Suggested repo placement: `docs/ui/DESIGN.md` (this file), `docs/ui/mockups/*.html` (open in any browser; -each file is one screen at its natural size, links between screens work), `branding/` +each file is one screen at its natural size, `Editor.html` two steps and the crop states one below the other; links between screens work), `branding/` (icon sources). The mockups are the visual target; where a mockup and the brief disagree on behaviour, the brief wins; where they disagree on looks, the mockup wins. @@ -59,6 +59,31 @@ Label column left of controls: 116 px in panels, 180 px in Settings. pill at the right whose tooltip gives the advisor's reason; touching it turns the track Sun (manual), shows the value, and a `⟲` reset button returns to Auto. Not applicable = greyed value "n/a" with the reason in its tooltip. +- **Setting rows** (side panels, label on the left, value or control on the right; owner review 1, R5/R6): + *number* = label, value in TextMuted with tabular figures, the slider on the line below (Straighten + −15…15° by 0.1, `−1.2°`; Crop size `85 %`, Crop X/Y `+0.40` · `Centred`); *switch* = label and a 36 × 20 switch at the + right (off = TextMuted outline and knob, on = Accent fill, OnAccent knob; `role="switch"`), one toggle is one + undo step; *icon actions* = label, the value (Rotation `90°`), then 28 px icon-only buttons (a quarter turn per press, as the user sees + the picture: the direction swaps while exactly one of Mirror and Flip is on); *info* = label + and a read-only value (Output size). A row that does not apply shows "n/a" in TextFaint with the reason in + its tooltip (Crop X when the crop fills the width, Strength when the filter is None). A **group** inside a + panel is a 1 px Stroke divider, then its name in Text.Body 600 with the group's tooltip (Look on Exposure). +- **Crop overlay** (preview, Camera step; owner review 1, R5): the box is drawn over the whole view frame (oriented, + straightened) and is always locked to the output aspect. States (tiles under the Camera screen in `Editor.html`): + - *Shown*: Crop mask on, any step: Scrim (#99000000 dark, #66000000 light) outside, 1 px TextMuted outline. + In "how it will look" mode the outside is hidden instead, as today; handles and outline still draw. + - *Editable*: Camera step, mask on (its default there) and the project editable: 1.5 px Accent outline and + 8 handles (4 corners, 4 edge midpoints), 8 × 8 screen px whatever the zoom, Card fill, 1.5 px Accent stroke. + The preview tooltip becomes "Drag to move · drag a handle to resize…" (`Tooltips.Editor.Preview.CropEdit`). + - *Dragging*: rule-of-thirds lines inside the box (1 px Text at 50 %); only the overlay moves until mouse up, + which commits one undo step; Esc cancels. Corners anchor the opposite corner, edges the opposite edge + (centred on the other axis), Alt resizes about the centre; the minimum is 10 % of the largest box. + - *Straightening*: while the Straighten slider is dragged or focused, a fine 8 × 8 grid over the whole view + (1 px Text at 30 %). + - *Locked* (read-only, newer format, busy): drawn as Shown, no handles, drag pans. + Hit-test order: a handle within 6 screen px, the wipe divider, inside the box (move, SizeAll cursor), outside + (pan). Cursors SizeNWSE/SizeNESW on corners, SizeWE/SizeNS on edges. Keyboard with the preview focused: + arrows move 1 %, Shift+arrows 10 %, + and − resize 2 % about the centre. Double-click keeps Fit / 1:1. - **Status glyphs**: `●` green Analysed · `○` faint Not analysed · `●` Proxies · `▶ n` rendered · `●` accent Synced/Remote · `◐` amber Analysing · `▲ n` warnings · `✕ n` errors. - **Chips**: 24 px pills, Card fill, Stroke border; selected/recommended = Accent border and text. @@ -104,7 +129,10 @@ Category charts without a time axis (horizontal bars, stacked bars) still lay ou their island: labels on the reading side, bars growing away from it; time axes and month grids never flip. `branding/ui-icons/icons.py` is the one source: it writes `Icons.xaml` and the web admin's `icons.js`. Settings is a toothed gear (8 teeth, outer radius 6.5, valleys on 4.6, centre hole 1.7: `gear()` in `icons.py`); a circle with rays -is the Sun icon only. +is the Sun icon only. The Camera step's orientation icons (owner review 1, R6): RotateLeft / RotateRight = a rounded +picture under a quarter-circle arrow (`turn_arrow()`), Mirror / Flip = an outline triangle and a filled one across a +dashed axis, Straighten = a tilted line over a level one with its angle arc. They describe the picture, not the +reading direction, so they never mirror in RTL. ## 6. App icon (`branding/`) @@ -120,8 +148,8 @@ from the SVG geometry (no raster assets checked in as sources). Badges only at | Mockup | Brief | Notes | |---|---|---| | `Main.html` | §12.2 Library | grid/list, year·camera·status filters, selection panel | -| `Editor.html` | §12.3 Edit | Exposure step: step bar, title ▾ (Change sequence), wipe compare, curves, advisor Auto pills, Previous · n / m · Next | -| `Export.html` | §12.3 / §11.4 | the Export step: step bar with Export current, preset cards with size/time estimate, Output panel, batch, Previous · 8 / 8 · Next sequence | +| `Editor.html` | §12.3 Edit | three parts, one below the other. Exposure step: step bar, title ▾ (Change sequence), wipe compare (the corrected side carries the look), curves, advisor Auto pills, the Look group (Filter, Strength) at the end of the panel, Previous · n / m · Next. Camera step (`#camera`): the whole view frame with a 9:16 crop being edited (handles), the zoom-keyframe curve under the filmstrip, rows Aspect · Rotation (Rotate left/right and the value) · Mirror · Flip · Straighten · Crop size · Crop X · Crop Y, the keyframes line, then Optimise section · Reset framing · Reset (Reset framing disabled, with `ResetFramingNone`, when nothing is set). Crop overlay states: Shown, Editable, Dragging, Straightening, Locked | +| `Export.html` | §12.3 / §11.4 | the Export step: step bar with Export current, preset cards with size/time estimate, Output panel, batch, Previous · 8 / 8 · Next sequence. Resolution edits the preset's box; the **Output size** row under it shows what is rendered: the chosen proportions fitted in the box (4K at 9:16 = 2160 × 3840; "source" keeps the preset), the preset name unchanged; when the encoder caps it, the value reads "1296 × 2304 (capped)" with `Tooltips.Editor.Export.OutputCapped`. The preview mask is the output's footprint in the view frame | | `Import.html` | §12.4 / §13 | card profile, sessions, plan, verification, after-import actions | | `Archive.html` | §12.5 | tree, mass operations, stats, verify/rebuild, maintenance | | `Jobs.html` | §12.6 | filters, queue order, expandable log, retry/open/folder; a `Queue · Scheduled` segmented control first in the toolbar (owner review 2, R10): Scheduled is a table (on switch, name, action, when, next run, last result, Run now · Edit · Reset or Delete), the selected schedule's last runs under it (Show in queue), New schedule at the toolbar's end and the editor as an in-window dialog; jobs a schedule queued carry an Accent `Scheduled` pill after their target | @@ -135,5 +163,5 @@ from the SVG geometry (no raster assets checked in as sources). Badges only at | `Icon.html` | §17 | construction, sizes, variants, wordmark | Missing on purpose (build from the brief and this kit): the Settings › About page, Login dialog, Jobs › Scheduled and its editor, the Edit picker -and the other steps (Analysis, Frames, Motion, Camera, Time, Stack), Import "Show plan", +and the other steps (Analysis, Frames, Motion, Time, Stack), Import "Show plan", Archive rebuild dialog, the admin Archive/Jobs/Settings/Logs pages. Reuse the shell and the kit; do not invent new colours. diff --git a/docs/ui/mockups/Editor.html b/docs/ui/mockups/Editor.html index 39bcf4a2..a4f461ef 100644 --- a/docs/ui/mockups/Editor.html +++ b/docs/ui/mockups/Editor.html @@ -41,9 +41,9 @@ a{color:#4cc2ff}a:hover{color:#8ad8ff}