agama-project / agama / 26594439732 / 3 – web

81%

master: 81%

push

github

refactor(web): improve discoverability of "progress monitor" (#3560)

## Summary

Refine `ProgressStatusMonitor` from a transient spinner into an
always-visible progress status widget that communicates installer
background activity consistently without implying overall system
readiness.

Also adds vertical alignment controls to the `Icon` component to improve
inline icon/text alignment across the UI.

## Background

Previously, `ProgressStatusMonitor` was hidden whenever no background
tasks were running. This caused two UX issues:

*   Short-lived tasks caused the spinner to flash briefly and disappear
* Users had no persistent indication that a background status widget
even existed
    
## Solution

### Two States

#### Idle

*   Icon: `list_alt_check` - Neutral styling (no success color)

The original proposal used a generic checkmark icon, but that visually
suggested “everything is ready” even when blocking issues could still
exist elsewhere in the installer. `list_alt_check`, however,
communicates _task tracking_ and _completed activity_ without implying
installation success or readiness

*   Popover text:
    
    *   “No pending tasks”
    *   “All background tasks completed”
        

#### Busy

*   Spinner shown immediately while background tasks are running
*   Popover displays task count and progress details
    

## Layout Changes

`ProgressStatusMonitor` is now injected automatically at the layout
level via `Page`.

### Default placement

Rightmost item in the header:

```text
[Review and Install] [ProgressStatusMonitor]
```

### Overview page override

The overview page manually positions the monitor between the language
selector and options menu:

```text
[Language] [ProgressStatusMonitor] [Options]
```

4368 of 6395 branches covered (68.3%)

Branch coverage included in aggregate %.

15314 of 19014 relevant lines covered (80.54%)

87.32 hits per line