ProgressCircle

modelValue is the current progress, read against max. It's clamped into range, so a value past the maximum closes the ring rather than winding past it.

max is the value that counts as a full ring. Set it to the real total and pass raw numbers as modelValue rather than converting to a percentage yourself.

color themes the filled arc. The track behind it stays neutral, so the arc is what carries the meaning.

size is the ring's diameter in pixels. The line width and the centred readout scale with it, so a small ring stays legible rather than becoming a thin smudge.

outline draws a hairline boundary with a background-coloured track inset inside it, instead of the solid track. It reads lighter on a busy surface, where a filled track would compete with what's around it.

lg switches to the thicker line width. Pair it with a larger size for a ring that has to read as the main thing on a card rather than as an indicator beside a label.

label is the text below the ring, naming what's progressing.

showValue centres the percentage inside the ring. Without it the ring is a shape with no number — fine beside a figure you're already printing, thin on its own.

indeterminate spins the arc instead of holding it at a fixed angle, for work that's underway but whose completion you can't measure. modelValue, buffer and showValue are all ignored while it's set.

buffering sweeps a bright highlight around the buffer ring, saying the gap ahead of the arc is actively filling in. It's the same sweep Shimmer and ProgressBar use, so everything loading on a screen moves in step.

buffer draws a dimmed ring behind the arc — how far ahead the data has loaded compared with where playback or processing has actually reached.