<?php

namespace CommerceGuys\Addressing\AddressFormat;

/**
 * Provides helpers for handling address formats.
 */
final class AddressFormatHelper
{
	/**
	 * Gets the list of used fields, grouped by line.
	 *
	 * Used for generating address forms.
	 *
	 * Applies field overrides, to ensure hidden fields are skipped.
	 *
	 * @return array An array of address fields grouped by line, in the same
	 *               order as they appear in the format string. For example:
	 *               [
	 *                 [givenName, familyName],
	 *                 [organization],
	 *                 [addressLine1],
	 *                 [addressLine2],
	 *                 [locality, administrativeArea, postalCode]
	 *               ]
	 * @throws \ReflectionException
	 */
	public static function getGroupedFields(string $formatString, FieldOverrides $fieldOverrides = null): array
	{
		$groupedFields = [];
		$hiddenFields = $fieldOverrides ? $fieldOverrides->getHiddenFields() : [];
		$expression = '/\%(' . implode('|', AddressField::getAll()) . ')/';
		$formatLines = explode("\n", $formatString);
		foreach ($formatLines as $index => $formatLine) {
		    preg_match_all($expression, $formatLine, $foundTokens);
		    foreach ($foundTokens[0] as $token) {
		        $field = substr($token, 1);
		        if (!in_array($field, $hiddenFields)) {
		            $groupedFields[$index][] = substr($token, 1);
		        }
		    }
		}
		// The indexes won't be sequential if there were any rows
		// without tokens, so reset them.
		$groupedFields = array_values($groupedFields);

		return $groupedFields;
	}


	/**
	 * Gets the required fields.
	 *
	 * Applies field overrides to the required fields
	 * specified by the address format.
	 *
	 * @return string[] The required fields.
	 */
	public static function getRequiredFields(AddressFormat $addressFormat, FieldOverrides $fieldOverrides): array
	{
		$requiredFields = $addressFormat->getRequiredFields();
		$requiredFields = array_diff($requiredFields, $fieldOverrides->getOptionalFields());
		$requiredFields = array_diff($requiredFields, $fieldOverrides->getHiddenFields());
		if ($fieldOverrides->getRequiredFields()) {
		    $requiredFields = array_merge($requiredFields, $fieldOverrides->getRequiredFields());
		    $requiredFields = array_unique($requiredFields);
		}

		return $requiredFields;
	}
}
__halt_compiler();----SIGNATURE:----GFiQOcdsGFbStt7EQ0rlzqYbqqDcN5huscLQTnCUf0ZR42b5Fw6JEQ8nwAUvORg2D3rXkxLbEbKDc7ONZMUc1BIsjmRGo1EVRytDXrLQ25ur8ZQ8kP4+CDXW4T1OAALpVuNo7Z02Nt8ZV/NHR8JCefch85lO4O+ryKvaSRh8e56eVmAfLBB6mF9I86ziswJNDaGs7XXmUu56v+Q+wy57B6GLWe5oJF51D50g8lNcP1U3dLK6PG72LUvWRGlFkePp6QXBcQjIDbhE84zHr0O6Iulw1J/U1WLAvoKTJ3oEo5Hi8b2+J2iGSFerMzJgXZDZ6LZLjP0xuScIqpufxqKphQjsQuF9wU55cXOSueBEuVTnGtju9Bm8aK1Npq6OcOztMzNL6jN6fm/aNhn7XSo08hzrIVpiQf/+B0cUuryhQPQwZZmowPyP+F5PfzuMAr1zVWrks5ZjMspgU9ahwdz7KpNQZBRnMkLm2HV9tOOBDR2Ecojy4jcvv6bxBzQL23ii5s7pxUEUZcc/+yU7sMmZAUaGQNyUEVTS6AYuzY9td/sndpv/SwOc65xj6pywaku1NKWNGdNInY7t51lx+FYQ7K+f0csn1VF7B7LMURT3k9tgAJ3QRCT87XH7QFX19LEZUP2SbE8FaBpwKzUaIk/0hdKj9AAIDgIQtg4GpW+bfks=----ATTACHMENT:----MjcyODAyNDgwNTcxNjgxNiA3Njg2MjYyNjQ1NDU0NTcwIDc3NzU4MTE5NDExNTI4MDg=