v26.0.0-beta.0

BREAKING CHANGES

• SVG globe icon
  • The globe icon is now an SVG that is baked into the JS, allowing you to change the size/colour easily.
  • BREAKING: if you previously used your own globe icon image then you will need to update your code to switch to using the new baked-in SVG, and style it however you like.
• Use Intl.DisplayNames for country names
  • You can use the new option countryNameLocale to control this.
  • BREAKING change: country names in various languages may have changed as a result of this.
• feat(vue): add typescript support
  • TypeScript type definitions are provided
  • BREAKING: you will now need to pass your local value with the v-model attribute rather than the value attribute, more info
• Rename validationNumberTypes and change default
  • BREAKING: validationNumberTypes options is now called allowedNumberTypes, and defaults to ["MOBILE", "FIXED_LINE"], which will hopefully reduce confusion.
  • BREAKING: if you're relying on the default setting and don't want to accept fixed_line numbers, you will now need to set allowedNumberTypes to just ["MOBILE"] during initialisation
• Remove autocomplete=off
  • As modern browsers trigger input event so we can keep selected country in sync with autocompleted number.
  • BREAKING: Hopefully nothing will actually change here, users will just be able to autocomplete their numbers when they couldn't before, but there is always a chance that some version of some browser will misbehave somehow.
• Simplify i18n keys
  • Previously we had confusing duplication between zeroSearchResults, oneSearchResult, multipleSearchResults keys and the searchResultsText function, which did the same thing.
  • BREAKING: Renamed zeroSearchResults to searchEmptyState (this is now just used for the visible text), and renamed searchResultsText to searchSummaryAria to better reflect what it is used for, and got rid of duplicate keys.
• Remove deprecated isMobileUserAgent
  • BREAKING: This may change the default useFullscreenPopup behaviour on some devices, though it really shouldn't. In fact, it should be more stable and predictable now.
• CSS: use image-set instead of media query
  • BREAKING: when you override the flags image paths in your CSS, you will need to change it to use image-set instead of the old media query
• New option: allowNumberExtensions
  • BREAKING: This defaults to false, so if you want to accept number extensions you will need to set this to true.

v25.15.0

Provide a CSS build without relative asset paths. Closes #2059

v25.14.1

Update Kyrgyzstan name in Russian localization

v25.14.0

feat: add Svelte 5 component wrapper - thanks to @gh-sandeep!

v25.13.3

Update LPN to v9.0.21

v25.13.2

Set aria-selected on selection rather than on highlight. Closes #2113

v25.13.1

Fix bug: init with shared number selects lower priority country

v25.13.0

• Support eastern numerals (see #2105)
• Fix: cant paste first digit in strictMode

v25.12.6

• Update utils to libphonenumber v9.0.20
• Fix a11y focus issue. Closes #2104

v25.12.5

Update utils to libphonenumber v9.0.18