3.0.2

Major release (3.x). Breaking: drops Laravel 11.

ℹ️ Install this one: composer require raiolanetworks/atlas:^3.0.2. Tags 3.0.0/3.0.1 are early duplicates of the same v3 merge; 3.0.2 is the complete release (adds the upgrade guide).

Removed (breaking)

• Laravel 11 support. It reached end of security life (2026-03-12); every 11.x release now carries unpatched advisories and is no longer installable via Composer. Requires laravel/framework ^12.60 || ^13.10.

Added

• Laravel 13 support (testbench 11, Pest 4). CI covers Laravel 12 & 13 on PHP 8.3/8.4.
• State hierarchy: admin_level & parent_id columns, State::parent()/children() relationships and topLevel()/adminLevel() scopes. parent_id populated for 10 countries (340 divisions: ES, FR, IT, BE, IE, LK, FJ, BA, GQ, KN).
• Ceuta & Melilla added as city entries.

Changed

• Country native is now required (non-null), with a migration that backfills existing nulls from name.

Fixed

• Security (GHSA-5vg9-5847-vvmq): framework floor raised so no CRLF-vulnerable Laravel version can be resolved.
• Whitespace normalized across 874 country/state/city name fields; Côte d'Ivoire native; Belgium "Flanders" type.

Upgrading

See UPGRADE.md (two upgrade paths + foreign-key safety) and the CHANGELOG.

⚠️ Getting the new data needs a re-seed (php artisan atlas:states/atlas:cities/atlas:countries) — destructive (empties & re-inserts, preserves primary keys), run in a maintenance window.