# clanbite_ranks_progress_metrics_for_balance()

Progress toward the next tier from a balance and normalized ladder levels.

```php
clanbite_ranks_progress_metrics_for_balance( int $points, array $levels ): array
```

## Parameters

- `$points` (int) Points balance (clamped ≥ 0).
- `$levels` (list<array{label: string, min_points: int, icon_url: string}>) Levels sorted ascending by `min_points`.

## Return

`array{current_level: string, next_level: string, next_min_points: int, points_to_next: int, progress_percent: int, is_max_level: bool}`
