Native Android (Kotlin) Support

[stefashkaa]

Feature Title

Native Android (Kotlin) Support

Description

Parent: #79

Add a native Kotlin implementation for Android apps, aligned with @desource/phone-mask core behavior and metadata-driven formatting.

Use Case

Android-native teams need deterministic phone input behavior identical to web/mobile cross-platform clients to reduce validation mismatches and backend normalization issues.

Proposed Solution

• Publish Kotlin Android library (Maven-compatible).
• Provide:
  • Formatter/validator APIs
  • Raw digits extraction utility
  • Country-aware mask resolution (including multi-mask countries)
• UI integration examples:
  • TextWatcher + EditText
  • Jetpack Compose sample
• Add parity tests with shared fixtures from core package.

Alternatives Considered

• Use cross platform solutions such as React Native

Examples from Other Libraries

• https://github.com/MichaelRocks/libphonenumber-android
• https://github.com/google/libphonenumber