chore: prepare major release 5.0.0

[phil-davis]

5.0.0 (2026-06-15)

• Drop PHP 7 #767 Drop PHP 7.4 8.0 8.1 and support PHP 8.2 and up (@phil-davis)
• fix: minor code fixes #769 fix: minor code fixes (@phil-davis)
• PHP 7.4 types #586 PHP types (@tcitworld @phil-davis)

This major release v5 declares function parameter and return types across the
codebase. Users will need to be careful to call functions/methods with the
correct types.

Support for PHP below 8.2 has been dropped.
This release supports PHP 8.2 and up.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.66%. Comparing base (af78936) to head (fb5863d).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff            @@
##             master     #770   +/-   ##
=========================================
  Coverage     98.66%   98.66%           
  Complexity     1759     1759           
=========================================
  Files            71       71           
  Lines          5165     5165           
=========================================
  Hits           5096     5096           
  Misses           69       69           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[phil-davis]

Notes:
We haven't increased the phpstan level here. There could be lots of changes to do, such as #498 (that has been sitting there for years). Or adding array shape PHPdoc throughout, and so on. But that all requires quite a bit of effort.

We have applied rector to the code, and having all the parameter and return types is "a good thing".

I am proposing to make this major version 5, so that everyone can decide when they want to upgrade.