# Smaage Frontend Prototype

## Install Requirements

```bash
uv sync
```

## Run
```bash
uv run -m frontend
```

## Navigation

```mermaid
stateDiagram-v2
    [*] --> Main

    state "Main View<br>(timer + weight)" as Main
    state "Menu<br>(carousel)" as Menu
    state "Bluetooth Pairing<br>(waiting for connection)" as BTPairing
    state "Recipe Selection<br>(carousel)" as RecipeSelection
    state "Do Recipe<br>(step-by-step)" as DoRecipe
    state "Edit Recipe<br>(step list)" as EditRecipe
    state "Edit Recipe – Move Mode<br>(reorder steps)" as MoveMode
    state "Edit Step – Type Selection<br>(list view)" as TypeSelect
    state "Edit Step – Value Entry<br>(morse input)" as ValueEntry
    state "Edit Step – Goal Time Entry<br>(morse input)" as GoalTime

    Main --> Menu : both long press
    Main --> RecipeSelection : right long press

    Menu --> Main : left long press [back]
    Menu --> BTPairing : right long press [BT Pair]

    BTPairing --> Menu : left long press [cancel]

    RecipeSelection --> Main : left long press
    RecipeSelection --> DoRecipe : right long press [on recipe → run]
    RecipeSelection --> EditRecipe : both long press [on recipe → edit]<br>or right long press [on + → add]

    DoRecipe --> Main : left long press [back]<br>or right press [last step → done]

    EditRecipe --> RecipeSelection : left long press [back]<br>or right long press [on save]
    EditRecipe --> TypeSelect : right long press [on step]<br>or right long press [on + → add step]
    EditRecipe --> ValueEntry : right long press [on name]
    EditRecipe --> MoveMode : both long press [on step]

    MoveMode --> EditRecipe : both long press [confirm]<br>or left long press [cancel]

    TypeSelect --> ValueEntry : right long press [type with value]
    TypeSelect --> EditRecipe : right long press [type w/o value → saved]<br>or right long press [delete → deleted]<br>or left long press [back]

    ValueEntry --> EditRecipe : left long press [save]<br>or left press [cancel]
    ValueEntry --> GoalTime : left long press [WEIGH_WITH_TIMER]

    GoalTime --> EditRecipe : left long press [save]<br>or left press [cancel]
```

## Tools

### `export_loading_frames.py`

Renders the loading screen animation and exports every unique frame as both PNG files and a NumPy array.

**Usage**
```bash
uv run export_loading_frames.py [--out-dir <directory>]
```

| Argument | Default | Description |
|---|---|---|
| `--out-dir` | `frames/` | Directory to write output files into |

**Outputs**

| File | Description |
|---|---|
| `frames/frame_XXXX.png` | One PNG per unique frame, zero-padded index |
| `frames/frames.npy` | NumPy array of shape `(N, H, W)`, dtype `bool` |

Consecutive duplicate frames are collapsed so only visually distinct frames are exported. The script prints the total number of frames rendered and the number of unique frames kept.