SegmentedControl

Single-selection segmented control for choosing one option from a compact set.

Two layout variants cover the full supported range of 2–8 segments:

• Horizontal — single row, 2–5 segments

• Vertical — two balanced rows, 4–8 segments with a configurable indicator shape

State is fully caller-controlled: store selectedIndex yourself and update it in each segment's onClick lambda.

var selected by remember { mutableIntStateOf(0) }
SegmentedControl.Horizontal(selectedIndex = selected) {
    singleLine("Day",  selected = selected == 0, onClick = { selected = 0 })
    singleLine("Week", selected = selected == 1, onClick = { selected = 1 })
}

The component throws IllegalArgumentException at composition time if the segment count falls outside the allowed range for the chosen variant, or if selectedIndex is out of bounds.