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 (meta and test_api).
• Remove the obsolete android.enableR8 option, 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_ARCHS setting with EXCLUDED_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 CountrySubdivision from the legacy country_codes.dart entrypoint.
• Add country lookup/search helpers for alpha-3 codes, dial codes, and country search.
• Add value equality, hashCode, and toString() 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 FlutterFramework dependency 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() returning CountryLookupResult with explicit lookup status.
• Add subdivision discovery helpers: searchSubdivisions() and subdivisionTypesForCountry().
• Extend DialCodeFormatter with 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 existing detailsForLocale().
• Improve detailsFromAlpha2() UX with case-insensitive input and clear ArgumentError messaging.
• Prevent DialCodeFormatter from 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 by CountryCodes.countryCodes().
• Include alpha-3 code (XKX), dial code (+383), and locale mapping (sq_XK).
• Add subdivision lookup APIs: subdivisions(), subdivisionsForCountry(alpha2), and subdivisionFromCode(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.swift manifests 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.dart entrypoint and keep the legacy entrypoint as a re-export.
• Refresh dev dependency tooling (update lints to 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 to US) 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.