Implement PhoneNumberMatcher for regional contexts

[SamiKammoun]

Implementation for PhoneNumberMatcher that supports regional phone number validations. The main functionality is encapsulated in the NewPhoneNumberMatcherForRegion function, which efficiently identifies and validates phone numbers within a given textual sequence based on specified regional criteria.

Key Features:

• Regional phone number parsing and validation.
• Phone number parsing and validation for unknown regions.

My implementation is a bit verbose and may make unnecessary extractions. Making it less verbose always led me to make some sacrifices. I left it to the user to define his own level of leniency instead.

[rowanseymour]

Hi @SamiKammoun can you link to equivalent functionality in libphonenumber so we can compare?

[SamiKammoun]

I don't know if this fork should follow the Java implementation.
I found this and it's not even close to what I have done 🙄
However, I found out that another open PR #89 has a similar implementation. It wasn't merged because it is a breaking change.
Do I have to implement the same logic? or can we just make PR #89 non breaking ?

[rowanseymour]

Unfortunately the aim of this library is to be a strict port of libphonenumber so we only accept code changes to keep us up to date with code changes in libphonenumber. I've updated the README to clarify this.

[SamiKammoun]

I can see that. Closing that PR for now.