Repository navigation
Releases: seidlmatus/country_code_plus
Releases · seidlmatus/country_code_plus
Release list
v5.2.1
country_codes_plus 5.2.0
Release Notes
5.2.0 - 2026-08-30
This release adds Web support, AX/SZ country data, null-safe code lookups,
flag emoji, longest-prefix phone-number matching, deterministic CLDR locale
inference, indexed lookups, integrity validation, and refreshed pub.dev
metadata/docs. No intentional breaking public API changes were introduced.
5.1.2 - 2026-07-04
Highlights:
- Update Android build tooling to Kotlin 2.3.20 and migrate the plugin Gradle build to the current Kotlin DSL.
- Update the example app to Android Gradle Plugin 9.0.1 and Gradle 9.1.0 while retaining Java 17.
- Refresh locked Flutter test dependencies (
metaandtest_api). - Remove the obsolete
android.enableR8option, disable the unused Jetifier compatibility layer, and ignore generated iOS Swift Package Manager files. - Replace placeholder iOS and macOS CocoaPods metadata with the package's actual description, homepage, and author.
- Replace the deprecated iOS simulator
VALID_ARCHSsetting withEXCLUDED_ARCHS. - Refresh the example's Apple platform projects for current Flutter/Xcode: iOS 13 with UIScene lifecycle and macOS 10.15 with the modern app delegate, plus Swift Package Manager integration on both platforms.
Notes:
- Patch release with no Dart API changes.
5.1.1 - 2026-05-31
Highlights:
- Export
CountrySubdivisionfrom the legacycountry_codes.dartentrypoint. - Add country lookup/search helpers for alpha-3 codes, dial codes, and country search.
- Add value equality,
hashCode, andtoString()support to public model classes. - Reuse cached subdivision objects for global subdivision searches to avoid rebuilding the full dataset on every query.
- Clean up analyzer findings and tighten country data typing.
- Add regression coverage for country lookup helpers, model value behavior, legacy entrypoint compatibility, sub-region locale fallback, and empty-region platform responses.
- Refresh lockfile metadata for current Flutter/Dart tooling.
- Fix Swift Package Manager manifests for Flutter's
FlutterFrameworkdependency and align the iOS CI checkout path with the package identity. - Add release process documentation.
Notes:
- Patch release with no breaking API changes.
5.1.0 - 2026-03-03
Highlights:
- Add
CountryCodes.lookupDetails()returningCountryLookupResultwith explicit lookup status. - Add subdivision discovery helpers:
searchSubdivisions()andsubdivisionTypesForCountry(). - Extend
DialCodeFormatterwith configurable separator and international-prefix preservation control. - Expand tests and example app coverage for all new APIs and formatter modes.
- Update documentation sections and usage snippets across package and example docs.
Notes:
- Minor release with additive API changes and no breaking removals.
5.0.5 - 2026-03-03
Highlights:
- Harden
CountryCodes.init()to safely handle null/short/invalid platform channel payloads. - Add
detailsForLocaleOrNull()as a null-safe lookup API while preserving existingdetailsForLocale(). - Improve
detailsFromAlpha2()UX with case-insensitive input and clearArgumentErrormessaging. - Prevent
DialCodeFormatterfrom crashing when a dial code cannot be resolved. - Expand tests for init payload validation, formatter safety, and alpha2 lookup behavior.
- Improve README/example guidance for safe initialization and add visible donation links.
Notes:
- Patch release with no breaking API changes.
5.0.4 - 2026-03-01
Highlights:
- Add Kosovo (
XK) to the built-in country list returned byCountryCodes.countryCodes(). - Include alpha-3 code (
XKX), dial code (+383), and locale mapping (sq_XK). - Add subdivision lookup APIs:
subdivisions(),subdivisionsForCountry(alpha2), andsubdivisionFromCode(code). - Add ISO 3166-2 subdivision datasets for all supported countries in the package, with manual fallback entries for
XK.
Notes:
- Adds one new country entry with no breaking API changes.
5.0.3 - 2026-03-01
Highlights:
- Add
Package.swiftmanifests for iOS and macOS under the plugin package layout expected by Flutter tooling. - Add Swift source targets for SPM with equivalent method-channel behavior.
Notes:
- No Dart API changes; this release improves Apple platform package integration metadata.
5.0.2 - 2026-03-01
Highlights:
- Improve pub.dev package page quality with updated README badges and installation snippet.
- Replace the generic example README with clear package-specific guidance.
- Align repository metadata checks for the next pub.dev analysis run.
Notes:
- No API changes; this is a documentation and release-quality update.
5.0.1 - 02/09/2026
Highlights:
- Fix Android plugin registration by aligning the main class location with the Android package.
- Add
lib/country_codes_plus.dartentrypoint and keep the legacy entrypoint as a re-export. - Refresh dev dependency tooling (update
lintsto 6.1.0 and related transitive updates).
Notes:
- No API changes; this is a patch release to address Android plugin discovery.
5.0.0 - 02/09/2026
Highlights:
- Package renamed to
country_codes_plus(update imports and dependency names). - Example app and platform configs aligned with the new package name.
Notes:
- This is a breaking change for consumers using
country_codes_plus.
4.0.0 - 02/07/2026
Highlights:
- Locale fallback improvements for language-only locales (e.g.,
Locale('en')defaults toUS) with tests. - Android locale selection now respects multi-locale priority; iOS/macOS use auto-updating locales.
- Added validation tests for ISO/dial codes and platform channel init.
- CI now runs
dart analyze, unit tests, and example builds for Android/iOS. - Documentation updates covering edge cases and web support limitations.
- Android build now targets Java 17 bytecode for Kotlin/Java sources.
- Updated Android Gradle tooling (AGP/Kotlin/Gradle) and migrated the example to Flutter's plugins DSL.
- Disabled Jetifier for the example app after verifying all dependencies are AndroidX.
Notes:
- API remains compatible with 3.3.x for typical usage.