PhoneNumberKit 5.0 moves to a new home and splits the UI components into a separate package. The core parsing/formatting API is unchanged.

The library now lives at github.com/PhoneNumberKit/PhoneNumberKit.

- .package(url: "https://github.com/marmelroy/PhoneNumberKit", from: "4.0.0")
+ .package(url: "https://github.com/PhoneNumberKit/PhoneNumberKit", from: "5.0.0")

In Xcode: remove the old marmelroy/PhoneNumberKit package dependency and add https://github.com/PhoneNumberKit/PhoneNumberKit.

If you used CocoaPods or Carthage: those transports are no longer published. Migrate to SPM. The last CocoaPods release is 4.3.0 from the original repository (deprecated, frozen).

PhoneNumberTextField and the country-code picker moved to a new package, PhoneNumberKitUI.

+ .package(url: "https://github.com/PhoneNumberKit/PhoneNumberKitUI", from: "1.0.0")

- import PhoneNumberKit
+ import PhoneNumberKit
+ import PhoneNumberKitUI   // for PhoneNumberTextField, CountryCodePicker, CountryCodePickerOptions

The CountryCodePicker configuration type (commonCountryCodes, forceModalPresentation, alwaysShowsSearchBar) now lives in PhoneNumberKitUI.

• Unqualified usage still works once you import PhoneNumberKitUI:

  CountryCodePicker.commonCountryCodes = ["US", "GB"]

• Module-qualified usage must change:

  - PhoneNumberKit.CountryCodePicker.commonCountryCodes = ["US", "GB"]
  + CountryCodePicker.commonCountryCodes = ["US", "GB"]

The deployment floor was raised. If you target below these, stay on 4.x:

PhoneNumberUtility, PhoneNumber, PartialFormatter, parsing, formatting, and validation keep the same API. A straight URL swap is enough for core-only consumers.