ProgressModel class

A progress bar widget with optional animation support.

The progress bar can be rendered statically using viewAs or animated using the update loop and setPercent commands.

Example (Static)

// Simple static progress bar
final progress = ProgressModel(width: 40);
print(progress.viewAs(0.5)); // 50% complete

Example (Animated)

class DownloadModel implements Model {
  final ProgressModel progress;
  final double downloaded;

  DownloadModel({ProgressModel? progress, this.downloaded = 0})
      : progress = progress ?? ProgressModel();

  @override
  (Model, Cmd?) update(Msg msg) {
    // Handle progress animation frames
    final (newProgress, cmd) = progress.update(msg);
    if (newProgress != progress) {
      return (
        DownloadModel(progress: newProgress as ProgressModel, downloaded: downloaded),
        cmd,
      );
    }

    // Handle download progress updates
    if (msg is DownloadProgressMsg) {
      final newPercent = msg.bytes / msg.total;
      final (updatedProgress, animCmd) = progress.setPercent(newPercent);
      return (
        DownloadModel(progress: updatedProgress, downloaded: newPercent),
        animCmd,
      );
    }

    return (this, null);
  }

  @override
  String view() => progress.view();
}