serializer * round trip re-emits the stored entry byte for byte. * * Rows whose identifying field is empty are skipped: an added-then-abandoned builder row must not * produce an entry. No grammar check happens here — the row form types validate each serialized * entry through AssociationEntryParser before the data handler runs. */ class AssociationRowSerializer { /** * Static-only class. */ private function __construct() { } /** * @param list $rows * * @return list */ public static function formEntries(array $rows): array { return self::entries($rows, static fn (array $row): string => self::joinParts( $row['form_id'] ?? '', $row['path'] ?? '', $row['mode'] ?? '' )); } /** * @param list $rows * * @return list */ public static function gridEntries(array $rows): array { return self::entries($rows, static fn (array $row): string => self::joinParts( $row['grid_id'] ?? '', $row['column_id'] ?? '', $row['mode'] ?? '' )); } /** * @param list $rows * * @return list */ public static function apiEntries(array $rows): array { return self::entries($rows, static fn (array $row): string => self::joinParts( $row['uri'] ?? '', $row['methods'] ?? '' )); } /** * Serializes one row per entry through $serializeRow, dropping the rows that serialize to * nothing (empty identifying field). * * @param list> $rows * @param callable(array): string $serializeRow * * @return list */ private static function entries(array $rows, callable $serializeRow): array { $entries = []; foreach ($rows as $row) { $entry = $serializeRow($row); if ('' !== $entry) { $entries[] = $entry; } } return $entries; } /** * Joins the entry's parts with ":" up to the last non-empty one — "product", "product:name", * "product:name:after". An empty leading part empties the whole entry (a path or mode without * an id is not an entry), and a part after a gap is dropped (a mode without a path/column has * no anchor to apply to — the presenter never produces that shape either). */ private static function joinParts(?string ...$parts): string { $kept = []; foreach ($parts as $part) { $part = trim((string) $part); if ('' === $part) { break; } $kept[] = $part; } return implode(':', $kept); } }