TenantAtlas/app/Support/OpsUx/SummaryCountsNormalizer.php

<?php

declare(strict_types=1);

namespace App\Support\OpsUx;

final class SummaryCountsNormalizer
{
    /**
     * @param  array<string, mixed>  $summaryCounts
     * @return array<string, int>
     */
    public static function normalize(array $summaryCounts): array
    {
        $allowedKeys = array_flip(OperationSummaryKeys::all());

        $sanitized = [];

        foreach ($summaryCounts as $key => $value) {
            $key = trim((string) $key);

            if ($key === '' || ! isset($allowedKeys[$key])) {
                continue;
            }

            if (is_int($value)) {
                $sanitized[$key] = $value;

                continue;
            }

            if (is_float($value) && is_finite($value)) {
                $sanitized[$key] = (int) round($value);

                continue;
            }

            if (is_numeric($value)) {
                $sanitized[$key] = (int) $value;
            }
        }

        $ordered = [];

        foreach (OperationSummaryKeys::all() as $key) {
            if (array_key_exists($key, $sanitized)) {
                $ordered[$key] = $sanitized[$key];
            }
        }

        return $ordered;
    }

    /**
     * @param  array<string, mixed>  $summaryCounts
     */
    public static function renderSummaryLine(array $summaryCounts): ?string
    {
        $normalized = self::normalize($summaryCounts);

        if ($normalized === []) {
            return null;
        }

        $parts = [];

        foreach ($normalized as $key => $value) {
            if ($value === 0) {
                continue;
            }

            $parts[] = self::humanizeKey($key).': '.$value;
        }

        if ($parts === []) {
            return null;
        }

        return implode(' · ', $parts);
    }

    /**
     * Convert a snake_case summary key to a human-readable label.
     */
    private static function humanizeKey(string $key): string
    {
        return match ($key) {
            'items' => 'Affected items',
            'tenants' => 'Tenants',
            'finding_count' => 'Findings',
            'report_count' => 'Reports',
            'operation_count' => 'Operations',
            default => ucfirst(str_replace('_', ' ', $key)),
        };
    }
}