agama-project / agama / 26594439732

81%

Build Type

push

github

Committed by web-flow

Commit Message

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]
```

Coverage Stats

4368 of 6395 branches covered (68.3%)

Branch coverage included in aggregate %.

22 of 22 new or added lines in 4 files covered. (100.0%)

15 existing lines in 2 files now uncovered.

23778 of 28167 relevant lines covered (84.42%)

96.74 hits per line