ENH docblock types

[lekoala]

Description

Fix/improve return types for public facing apis

Manual testing steps

Nothing, just phpstan being happy

Issues

• Improve phpdoc types #11173
• proper return types #11149

Pull request checklist

• The target branch is correct
  • See picking the right version
• All commits are relevant to the purpose of the PR (e.g. no debug statements, unrelated refactoring, or arbitrary linting)
  • Small amounts of additional linting are usually okay, but if it makes it hard to concentrate on the relevant changes, ask for the unrelated changes to be reverted, and submitted as a separate PR.
• The commit messages follow our commit message guidelines
• The PR follows our contribution guidelines
• Code changes follow our coding conventions
• This change is covered with tests (or tests aren't necessary for this change)
• Any relevant User Help/Developer documentation is updated; for impactful changes, information is added to the changelog for the intended release
• CI is green

[kinglozzer]

One minor tweak, otherwise good to merge

[GuySartorelli]

Can you please tick all of the appropriate checkboxes? It's intended both as a "have I done everything I need to?" checklist for you, as well as a "Is the contributor finished working on this or is it clear there is still more to do?" list for maintainers.
As it stands, with none of the boxes ticked, it looks like this isn't even ready to be reviewed.

[GuySartorelli]

Please also link to an open issue - we can't track closed issues

[lekoala]

@GuySartorelli issue created #11173

[GuySartorelli]

LGTM, it's an all 'round incremental improvement with no discernable side effects.

Please change the commit message from FIX to either MNT or ENH - FIX is for bugs that affect code, but this doesn't affect any of the actual code.

[GuySartorelli]

Ahh, I didn't notice this has a bunch of commits, so I'll have to squash merge anyway, so I can change the commit message during that process.