The type for sparklines. A sparkline holds a circular buffer of recent values with fixed capacity. Old values are automatically evicted when the buffer is full.

The type for sparkline rendering styles.

• `Bars: vertical bars using block glyphs (▁▂▃▄▅▆▇█) with fractional heights.
• `Braille: connected line segments using 2×4 Braille dot grids per cell.

create ~capacity () is a sparkline buffer.

• style is the rendering style. Defaults to Ansi.Style.default.
• auto_max, when true (the default), updates max_value dynamically when larger values are pushed.
• max_value is the initial maximum for scaling. Values exceeding it are clipped unless auto_max is true. Defaults to 1.0 if None or negative.
• capacity is the buffer size. Clamped to >= 1.

Negative values are clamped to 0.0 on push.

clear t empties the buffer. Capacity and configuration are unchanged.

push t v appends v to the buffer, evicting the oldest value if the buffer is full. Negative v is clamped to 0.0. If auto_max is true and v exceeds max_value, max_value is updated.

push_all t vs is List.iter (push t) vs.

set_max t m sets the scaling maximum. If m <= 0 it is set to 1.0.

draw t ~kind grid ~width ~height renders the sparkline to grid. Only the most recent width values are shown, right-aligned, scaled by max_value.

• columns_only, when true, skips the background fill. Defaults to false.
• x and y are grid offsets. Default 0.
• width and height are clamped to >= 1.

draw_values ~kind vs grid ~width ~height renders vs directly without persistent state. Creates a temporary sparkline with capacity equal to width, pushes all vs, and draws.

• style defaults to Ansi.Style.default.
• x and y are grid offsets. Default 0.