Improve psalm annotations to make it easier to use in userland

[vjik]

Q	A
Is bugfix?	❌
New feature?	❌
Breaks BC?	❌

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 83.67%. Comparing base (6d81bd5) to head (63b3643).
Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff            @@
##             master     #267   +/-   ##
=========================================
  Coverage     83.67%   83.67%           
  Complexity      629      629           
=========================================
  Files            51       51           
  Lines          2138     2138           
=========================================
  Hits           1789     1789           
  Misses          349      349           

☔ View full report in Codecov by Sentry.
📢 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.