Skip to content

Release 0.0.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Sep 16:15
· 37 commits to master since this release
v0.0.1
4e20f39

First release. A pure Kotlin Multiplatform port of Google's libphonenumber focused on byte-stable phone→E.164 normalization.

Added

  • PhoneNumberUtil.parse(number, defaultRegion) handling international (+), IDD-dialed, and national formats; PhoneNumber.formatToE164(); and isValid(number, defaultRegion).
  • METADATA_VERSION / PhoneNumberUtil.metadataVersion exposing the embedded metadata epoch as a stable, readable id.
  • Embedded metadata epoch 9.0.38 generated to Kotlin from the pinned libphonenumber XML (254 regions), with no runtime resource loading — so it works on wasmJs and native.
  • Own deterministic regex matcher (PhonePattern) used on every target, so output is byte-identical across JVM, Android, JS, wasmJs, and native (works around Kotlin/Native + Kotlin/Wasm regex bug KT-89187; related KT-57906).
  • Faithful national-prefix and carrier-code stripping with transform rules; deterministic Unicode digit normalization (fullwidth, Arabic-Indic, Eastern Arabic-Indic).
  • Region resolution across shared calling codes for isValid (per-type patterns), matching libphonenumber's number-type logic.

Verified

  • Ground-truth against libphonenumber Java 9.0.38: 735 dialings across 245 regions produce identical E.164, with isValid agreement.
  • Cross-target conformance corpus passes byte-identically on JVM, JS, wasmJs, macOS (native), and iOS simulator.

Packaging

  • Targets: JVM, Android, iOS, macOS, tvOS, watchOS, Linux, MingW, JS, and wasmJs.
  • Apache-2.0 LICENSE and a NOTICE attributing the derived work to libphonenumber.
  • Maven Central publication and Swift Package Manager (XCFramework) integration via the vanniktech-mavenPublish plugin.
Assets 3
Loading